@itwin/core-backend 5.9.0-dev.1 → 5.9.0-dev.10

package/lib/esm/LineStyle.js.map

@@ -1 +1 @@
-{"version":3,"file":"LineStyle.js","sourceRoot":"","sources":["../../src/LineStyle.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAc,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAqB,WAAW,EAAE,UAAU,EAAkB,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAgB,SAAS,EAAE,MAAM,WAAW,CAAC;AAGpD,SAAS,qBAAqB,CAAC,UAAsB;IACnD,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,CAAC,CAAC;QACX,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,CAAC,CAAC;QACX,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,CAAC,CAAC;QACX,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,CAAC,CAAC;QACX,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,CAAC,CAAC;QACX,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,CAAC,CAAC;QACX,KAAK,UAAU,CAAC,KAAK;YACnB,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,CAAC,CAAC,CAAC,mBAAmB;IAClC,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,KAAW,mBAAmB,CAuanC;AAvaD,WAAiB,mBAAmB;IAElC,4CAA4C;IAC5C,IAAY,aAaX;IAbD,WAAY,aAAa;QACvB,kEAAkE;QAClE,+DAAe,CAAA;QACf,+DAA+D;QAC/D,yDAAY,CAAA;QACZ,oEAAoE;QACpE,mEAAiB,CAAA;QACjB,kEAAkE;QAClE,+DAAe,CAAA;QACf,wEAAwE;QACxE,yDAAY,CAAA;QACZ,kEAAkE;QAClE,+DAAe,CAAA;IACjB,CAAC,EAbW,aAAa,GAAb,iCAAa,KAAb,iCAAa,QAaxB;IAED,oCAAoC;IACpC,IAAY,UAaX;IAbD,WAAY,UAAU;QACpB,sCAAsC;QACtC,yCAAU,CAAA;QACV,qCAAqC;QACrC,2CAAW,CAAA;QACX,mHAAmH;QACnH,yCAAU,CAAA;QACV,qNAAqN;QACrN,6CAAY,CAAA;QACZ,4CAA4C;QAC5C,yDAAkB,CAAA;QAClB,2CAA2C;QAC3C,wDAAiB,CAAA;IACnB,CAAC,EAbW,UAAU,GAAV,8BAAU,KAAV,8BAAU,QAarB;IAED,iFAAiF;IACjF,IAAY,WASX;IATD,WAAY,WAAW;QACrB,0CAA0C;QAC1C,6CAAQ,CAAA;QACR,wIAAwI;QACxI,6CAAQ,CAAA;QACR,yIAAyI;QACzI,+CAAS,CAAA;QACT,yIAAyI;QACzI,6CAAQ,CAAA;IACV,CAAC,EATW,WAAW,GAAX,+BAAW,KAAX,+BAAW,QAStB;IAED;;OAEG;IACH,IAAY,SAeX;IAfD,WAAY,SAAS;QACnB,0CAA0C;QAC1C,6CAAU,CAAA;QACV,oEAAoE;QACpE,yCAAQ,CAAA;QACR,sDAAsD;QACtD,iDAAY,CAAA;QACZ,kCAAkC;QAClC,+CAAW,CAAA;QACX,mCAAmC;QACnC,+CAAW,CAAA;QACX,kCAAkC;QAClC,+CAAW,CAAA;QACX,+BAA+B;QAC/B,wCAAQ,CAAA;IACV,CAAC,EAfW,SAAS,GAAT,6BAAS,KAAT,6BAAS,QAepB;IAoBD,2EAA2E;IAC3E,IAAY,oBAWX;IAXD,WAAY,oBAAoB;QAC9B,kCAAkC;QAClC,+DAAW,CAAA;QACX,mHAAmH;QACnH,yEAAgB,CAAA;QAChB,qHAAqH;QACrH,yEAAgB,CAAA;QAChB,sGAAsG;QACtG,sEAAc,CAAA;QACd,iDAAiD;QACjD,kFAAoB,CAAA;IACtB,CAAC,EAXW,oBAAoB,GAApB,wCAAoB,KAApB,wCAAoB,QAW/B;IAmBD,8CAA8C;IAC9C,IAAY,gBAOX;IAPD,WAAY,gBAAgB;QAC1B,8BAA8B;QAC9B,uDAAU,CAAA;QACV,kCAAkC;QAClC,uDAAW,CAAA;QACX,oCAAoC;QACpC,6DAAc,CAAA;IAChB,CAAC,EAPW,gBAAgB,GAAhB,oCAAgB,KAAhB,oCAAgB,QAO3B;IA0BD,6DAA6D;IAC7D,IAAY,aA+BX;IA/BD,WAAY,aAAa;QACvB,sBAAsB;QACtB,iDAAW,CAAA;QACX,iCAAiC;QACjC,qDAAa,CAAA;QACb,8BAA8B;QAC9B,+CAAU,CAAA;QACV,iCAAiC;QACjC,qDAAa,CAAA;QACb,kCAAkC;QAClC,+DAAoB,CAAA;QACpB,gCAAgC;QAChC,yDAAiB,CAAA;QACjB,4BAA4B;QAC5B,gEAAoB,CAAA;QACpB,yCAAyC;QACzC,sEAAuB,CAAA;QACvB,uDAAuD;QACvD,0EAAyB,CAAA;QACzB,mCAAmC;QACnC,yDAAgB,CAAA;QAChB,iCAAiC;QACjC,uDAAe,CAAA;QACf,yBAAyB;QACzB,8DAAkB,CAAA;QAClB,6BAA6B;QAC7B,sEAAsB,CAAA;QACtB,8DAA8D;QAC9D,6DAAiB,CAAA;QACjB,gEAAgE;QAChE,+DAAkB,CAAA;IACpB,CAAC,EA/BW,aAAa,GAAb,iCAAa,KAAb,iCAAa,QA+BxB;IAyED,0DAA0D;IAC1D,IAAY,UASX;IATD,WAAY,UAAU;QACpB,mBAAmB;QACnB,2CAAW,CAAA;QACX,oFAAoF;QACpF,+CAAa,CAAA;QACb,qGAAqG;QACrG,uDAAiB,CAAA;QACjB,sEAAsE;QACtE,qDAAe,CAAA;IACjB,CAAC,EATW,UAAU,GAAV,8BAAU,KAAV,8BAAU,QASrB;IAcD,2DAA2D;IAC3D,MAAa,KAAK;QAEhB,iEAAiE;QAC1D,MAAM,CAAC,4BAA4B,CAAC,MAAgB,EAAE,KAAyB;YACpF,MAAM,SAAS,GAAsB,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;YACrF,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,8BAA8B,CAAC,SAAS,CAAC,CAAC;YAChE,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1D,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,aAAa,EAAE,CAAC;QACzE,CAAC;QAED;;WAEG;QACI,MAAM,CAAC,0BAA0B,CAAC,MAAgB,EAAE,KAAuB;YAChF,qDAAqD;YACrD,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACjG,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAe,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC5E,IAAI,CAAC,QAAQ;oBACX,OAAO,SAAS,CAAC;gBAEnB,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBAElC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBACnC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBACnC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACrC,CAAC;YAED,MAAM,SAAS,GAAsB,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;YACrF,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,8BAA8B,CAAC,SAAS,CAAC,CAAC;YAChE,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1D,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,WAAW,EAAE,CAAC;QACvE,CAAC;QAED,+DAA+D;QACxD,MAAM,CAAC,0BAA0B,CAAC,MAAgB,EAAE,KAAuB;YAChF,MAAM,SAAS,GAAsB,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;YACtF,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,8BAA8B,CAAC,SAAS,CAAC,CAAC;YAChE,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1D,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,WAAW,EAAE,CAAC;QACvE,CAAC;QAED,2DAA2D;QACpD,MAAM,CAAC,uBAAuB,CAAC,MAAgB,EAAE,KAAoB;YAC1E,MAAM,SAAS,GAAsB,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;YACrF,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,8BAA8B,CAAC,SAAS,CAAC,CAAC;YAChE,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1D,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC;QACpE,CAAC;QAED,+DAA+D;QACxD,MAAM,CAAC,qBAAqB,CAAC,MAAgB,EAAE,KAAuB,EAAE,KAAiB;YAC9F,MAAM,eAAe,GAAsB,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;YAC9F,eAAe,CAAC,EAAE,GAAG,MAAM,CAAC,8BAA8B,CAAC,eAAe,CAAC,CAAC;YAC5E,MAAM,CAAC,gBAAgB,CAAC,eAAe,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YAC3D,KAAK,CAAC,OAAO,GAAG,eAAe,CAAC,EAAE,CAAC;YACnC,MAAM,SAAS,GAAsB,EAAE,IAAI,EAAE,mBAAmB,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;YAC5F,SAAS,CAAC,EAAE,GAAG,MAAM,CAAC,8BAA8B,CAAC,SAAS,CAAC,CAAC;YAChE,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1D,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,WAAW,EAAE,CAAC;QACvE,CAAC;QAED,+DAA+D;QACxD,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAAwB,EAAE,IAAY;YAC/E,OAAO,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;QAChG,CAAC;QAED;;WAEG;QACI,MAAM,CAAC,WAAW,CAAC,MAAgB,EAAE,YAAwB,EAAE,IAAY,EAAE,KAAiB;YACnG,IAAI,SAAS,KAAK,KAAK,CAAC,KAAK;gBAC3B,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,yEAAyE;YAE5G,MAAM,OAAO,GAAmB;gBAC9B,aAAa,EAAE,mBAAmB;gBAClC,KAAK,EAAE,YAAY;gBACnB,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC;gBACtD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;aAC5B,CAAC;YAEF,OAAO,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC;QAED,mFAAmF;QAC5E,MAAM,CAAC,sBAAsB,CAAC,KAAc;YACjD,IAAI,KAAK,KAAK,SAAS;gBACrB,OAAO,YAAY,CAAC;YAEtB,OAAO,cAAc,KAAK,EAAE,CAAC;QAC/B,CAAC;QAED;;;;;;;;WAQG;QACI,MAAM,CAAC,0BAA0B,CAAC,MAAgB,EAAE,YAAwB,EAAE,KAAc;YACjG,MAAM,IAAI,GAAG,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;YACzD,IAAI,SAAS,KAAK,IAAI;gBACpB,OAAO,IAAI,CAAC;YAEd,IAAI,KAAK,KAAK,SAAS;gBACrB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;YAEzJ,MAAM,iBAAiB,GAAG,IAAI,CAAC,4BAA4B,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;YAC7L,IAAI,SAAS,KAAK,iBAAiB;gBACjC,MAAM,IAAI,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAAC;YAElF,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACpL,CAAC;QAED;;UAEE;QACK,MAAM,CAAC,sBAAsB,CAAC,UAAsB;YACzD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;YACnD,IAAI,CAAC,CAAC,KAAK,QAAQ;gBACjB,OAAO,SAAS,CAAC;YAEnB,OAAO,wBAAwB,QAAQ,EAAE,CAAC;QAC5C,CAAC;QAED;;;;WAIG;QACI,MAAM,CAAC,0BAA0B,CAAC,MAAgB,EAAE,YAAwB,EAAE,UAAsB;YACzG,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;YACnD,IAAI,CAAC,CAAC,KAAK,QAAQ;gBACjB,MAAM,IAAI,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;YAEnE,MAAM,IAAI,GAAG,wBAAwB,QAAQ,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;YACzD,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5I,CAAC;KACF;IA/IY,yBAAK,QA+IjB,CAAA;AACH,CAAC,EAvagB,mBAAmB,KAAnB,mBAAmB,QAuanC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module ElementGeometry\n */\n\nimport { Id64String, IModelStatus } from \"@itwin/core-bentley\";\nimport { FilePropertyProps, IModelError, LinePixels, LineStyleProps } from \"@itwin/core-common\";\nimport { GeometryPart, LineStyle } from \"./Element\";\nimport { IModelDb } from \"./IModelDb\";\n\nfunction getLinePixelsLineCode(linePixels: LinePixels): number {\n  switch (linePixels) {\n    case LinePixels.Code1:\n      return 1;\n    case LinePixels.Code2:\n      return 2;\n    case LinePixels.Code3:\n      return 3;\n    case LinePixels.Code4:\n      return 4;\n    case LinePixels.Code5:\n      return 5;\n    case LinePixels.Code6:\n      return 6;\n    case LinePixels.Code7:\n      return 7;\n    default:\n      return -1; // Invalid value...\n  }\n}\n\n/** A line style definition is a uniquely named pattern that repeats as it is displayed along a curve path. In the absence of a line style, curve display is limited to solid lines with a width in pixels.\n * There are three varieties of line styles:\n * - A style described by a stroke pattern (series of dashes and gaps) that may also include symbol graphics.\n * - A style using pre-defined pixel bit patterns [[LinePixels]] for dashed display (Code1-Code7).\n * - A style that uses a texture.\n *\n * A definition is defined by one or more components. A component is saved as a \"file property\" and can be referenced by other components. The line style definition references a component\n * by file property id and type and is saved as a dictionary element.\n * @public\n */\nexport namespace LineStyleDefinition {\n\n  /** Line style component type identifiers */\n  export enum ComponentType {\n    /** Component type for [[LineStyleDefinition.PointSymbolProps]] */\n    PointSymbol = 1,\n    /** Component type for [[LineStyleDefinition.CompoundProps]] */\n    Compound = 2,\n    /** Component type for [[LineStyleDefinition.StrokePatternProps]] */\n    StrokePattern = 3,\n    /** Component type for [[LineStyleDefinition.StrokePointProps]] */\n    StrokePoint = 4,\n    /** Component type for [[LinePixels]], never saved as a file property */\n    Internal = 6,\n    /** Component type for [[LineStyleDefinition.RasterImageProps]] */\n    RasterImage = 7,\n  }\n\n  /** Mask of values for StrokeMode */\n  export enum StrokeMode {\n    /** Stroke represents a blank space */\n    Gap = 0x00,\n    /** Stroke represents a solid dash */\n    Dash = 0x01,\n    /** Treat stroke as rigid and continue past a corner to complete the stroke as opposed to breaking at the corner */\n    Ray = 0x02,\n    /** Stroke length can be stretched when [[LineStyleDefinition.StrokePatternOptions.Iteration]] and [[LineStyleDefinition.StrokePatternOptions.AutoPhase]] options are set, applicable to both Gap and Dash strokes */\n    Scale = 0x04,\n    /** Invert stroke in first stroke pattern */\n    FirstInvert = 0x08,\n    /** Invert stroke in last stroke pattern */\n    LastInvert = 0x10,\n  }\n\n  /** Define constant width or tapered strokes with distance specified in meters */\n  export enum StrokeWidth {\n    /** Stroke draws as one pixel wide line */\n    None = 0,\n    /** Half [[LineStyleDefinition.StrokeProps.orgWidth]] and [[LineStyleDefinition.StrokeProps.endWidth]] applied to left side of stroke */\n    Left = 1,\n    /** Half [[LineStyleDefinition.StrokeProps.orgWidth]] and [[LineStyleDefinition.StrokeProps.endWidth]] applied to right side of stroke */\n    Right = 2,\n    /** Half [[LineStyleDefinition.StrokeProps.orgWidth]] and [[LineStyleDefinition.StrokeProps.endWidth]] applied to both sides of stroke */\n    Full = 3,\n  }\n\n  /** Controls appearance of stroke end caps. If StrokeCap is >= Hexagon, the end cap is stroked as an arc and the value of\n   * StrokeCap indicates the number of vectors in the arc.\n   */\n  export enum StrokeCap {\n    /** Stroke displays as a closed polygon */\n    Closed = 0,\n    /** Stroke displays lines at specified width instead of a polygon */\n    Open = 1,\n    /** Stroke length extended by half the stroke width */\n    Extended = 2,\n    /** Stroke end cap is a hexagon */\n    Hexagon = 3,\n    /** Stroke end cap is an octagon */\n    Octagon = 4,\n    /** Stroke end cap is a decagon */\n    Decagon = 5,\n    /** Stroke end cap is an arc */\n    Arc = 30,\n  }\n\n  /** A stroke representing either a dash or gap in a stroke pattern */\n  export interface StrokeProps {\n    /** Length of stroke in meters */\n    length: number;\n    /** Width at start of stroke. Behavior controlled by [[LineStyleDefinition.StrokeWidth]], choose value other than [[LineStyleDefinition.StrokeWidth.None]] */\n    orgWidth?: number;\n    /** Width at end of stroke, same as start width if not present. Behavior controlled by [[LineStyleDefinition.StrokeWidth]], choose value other than [[LineStyleDefinition.StrokeWidth.None]] */\n    endWidth?: number;\n    /** Type and behavior of stroke */\n    strokeMode?: StrokeMode;\n    /** How to apply orgWidth and endWidth to stroke */\n    widthMode?: StrokeWidth;\n    /** Appearance of stroke end cap */\n    capMode?: StrokeCap;\n  }\n\n  export type Strokes = StrokeProps[];\n\n  /** Options to control how stroke pattern is applied to underlying curve */\n  export enum StrokePatternOptions {\n    /** Use default stroke behavior */\n    None = 0x00,\n    /** [[LineStyleDefinition.StrokePatternProps.phase]] represents fractional distance into first stroke of pattern */\n    AutoPhase = 0x01,\n    /** Use [[LineStyleDefinition.StrokePatternProps.maxIter]] to limit the number of iterations of the stroke pattern */\n    Iteration = 0x08,\n    /** Single segment mode restarts the stroke pattern at corners instead of continuing around corners */\n    Segment = 0x10,\n    /** Center the line style and stretch the ends */\n    CenterStretch = 0x20,\n  }\n\n  /** Stroke pattern component definition [[LineStyleDefinition.ComponentType.StrokePattern]].\n   * A stroke pattern component consists of a series of dashes and gaps having specified lengths and widths in meters. Simple dash-dot type line styles that do not\n   * include point symbols can be created by referencing a stroke pattern component by its file property id.\n   */\n  export interface StrokePatternProps {\n    /** Name for this stroke pattern */\n    descr: string;\n    /** Skip into the pattern before starting to draw. Value treated as fraction of the first stroke when [[LineStyleDefinition.StrokePatternOptions.AutoPhase]] set. Value used as distance when [[LineStyleDefinition.StrokePatternOptions.CenterStretch]] is not set. */\n    phase?: number;\n    /** Options mask for this stroke pattern */\n    options?: StrokePatternOptions;\n    /** The entire stroke pattern will be repeated no more than maxIter on curve or segment when [[LineStyleDefinition.StrokePatternOptions.Iteration]] is set and stroke pattern includes stretchable strokes. */\n    maxIter?: number;\n    /** Array of strokes, maximum number that will be used is 32 */\n    strokes: Strokes;\n  }\n\n  /** Flags to identify point symbol behavior */\n  export enum PointSymbolFlags {\n    /** Default symbol behavior */\n    None = 0x0,\n    /** Symbol includes 3d geometry */\n    Is3d = 0x01,\n    /** Symbol does not allow scaling */\n    NoScale = 0x02,\n  }\n\n  /** Point symbol component definition [[LineStyleDefinition.ComponentType.PointSymbol]].\n   * A point symbol component identifies a GeometryPart for reference by a [[LineStyleDefinition.SymbolProps]].\n   */\n  export interface PointSymbolProps {\n    /** GeometryPart Id to use as a pattern symbol */\n    geomPartId: Id64String;\n    /** GeometryPart.bbox.low.x */\n    baseX?: number;\n    /** GeometryPart.bbox.low.y */\n    baseY?: number;\n    /** GeometryPart.bbox.low.z */\n    baseZ?: number;\n    /** GeometryPart.bbox.high.x */\n    sizeX?: number;\n    /** GeometryPart.bbox.high.y */\n    sizeY?: number;\n    /** GeometryPart.bbox.high.z */\n    sizeZ?: number;\n    /** Symbol behavior flags */\n    symFlags?: PointSymbolFlags;\n    /** Symbol scale, defaults to 1 */\n    scale?: number;\n  }\n\n  /** Symbol options for location, orientation, and behavior */\n  export enum SymbolOptions {\n    /** No point symbol */\n    None = 0x00,\n    /** Symbol at origin of stroke */\n    Origin = 0x01,\n    /** Symbol at end of stroke */\n    End = 0x02,\n    /** symbol at center of stroke */\n    Center = 0x03,\n    /** Symbol at curve start point */\n    CurveOrigin = 0x0004,\n    /** Symbol at curve end point */\n    CurveEnd = 0x0008,\n    /** Symbol at each vertex */\n    CurveVertex = 0x0010,\n    /** Adjust symbol rotation left->right */\n    AdjustRotation = 0x0020,\n    /** Angle of symbol not relative to stroke direction */\n    AbsoluteRotation = 0x0040,\n    /** No scale on variable strokes */\n    NoScale = 0x0100,\n    /** No clip on partial strokes */\n    NoClip = 0x0200,\n    /** No partial strokes */\n    NoPartial = 0x0400,\n    /** Project partial origin */\n    ProjectOrigin = 0x0800,\n    /** Use color from symbol instead of inheriting curve color */\n    UseColor = 0x4000,\n    /** Use weight from symbol instead of inheriting curve weight */\n    UseWeight = 0x8000,\n  }\n\n  /** Identifies a symbol and its location and orientation relative to a stroke pattern */\n  export interface SymbolProps {\n    /** The file property id of the symbol component, assumed to be [[LineStyleDefinition.ComponentType.PointSymbol]] if symType is undefined. */\n    symId: number;\n    /** The component type, leave undefined if symId is a [[LineStyleDefinition.ComponentType.PointSymbol]] */\n    symType?: ComponentType;\n    /** The 0 based stroke index for base stroke pattern [[LineStyleDefinition.ComponentType.StrokePattern]] component */\n    strokeNum?: number;\n    /** Symbol x offset distance in meters */\n    xOffset?: number;\n    /** Symbol y offset distance in meters */\n    yOffset?: number;\n    /** Symbol rotation in radians */\n    angle?: number;\n    /** Must set location for symbol as default value is [[LineStyleDefinition.SymbolOptions.None]] */\n    mod1?: SymbolOptions;\n  }\n\n  export type Symbols = SymbolProps[];\n\n  /** Stroke point component definition [[LineStyleDefinition.ComponentType.StrokePoint]].\n   * A stroke point component identifies the locations of point symbol components relative to a base stroke pattern component.\n   */\n  export interface StrokePointProps {\n    /** Name for this stroke point component */\n    descr: string;\n    /** The file property id of the stroke component, assumed to be [[LineStyleDefinition.ComponentType.StrokePattern]] if lcType is undefined */\n    lcId: number;\n    /** The component type, leave undefined if lcId is a [[LineStyleDefinition.ComponentType.StrokePattern]] */\n    lcType?: ComponentType;\n    /** Array of symbols */\n    symbols: Symbols;\n  }\n\n  /** Raster component definition [[LineStyleDefinition.ComponentType.RasterImage]].\n   * A raster component identifies a texture for a line style.\n   */\n  export interface RasterImageProps {\n    /** Name for this raster image component */\n    descr: string;\n    /** Raster width */\n    x: number;\n    /** Raster height */\n    y: number;\n    /** True width flag */\n    trueWidth?: number;\n    /** Raster flags */\n    flags?: number;\n    /** The file property id of raster image */\n    imageId?: number;\n  }\n\n  /** Identifies a component by file property id and type */\n  export interface ComponentProps {\n    /** The file property id of [[LineStyleDefinition.ComponentType.StrokePattern]] or [[LineStyleDefinition.ComponentType.StrokePoint]] component */\n    id: number;\n    /** The type of component for specified file property id */\n    type: ComponentType;\n    /** Offset distance for this component, default is 0 */\n    offset?: number;\n  }\n\n  export type Components = ComponentProps[];\n\n  /** Compound component definition [[LineStyleDefinition.ComponentType.Compound]].\n   * A compound component is used to link stroke pattern and stroke point components to create a style that displays dashes, gaps, and symbols.\n   */\n  export interface CompoundProps {\n    comps: Components;\n  }\n\n  /** Flags to describe a style or control style behavior */\n  export enum StyleFlags {\n    /** Use defaults */\n    None = 0x00,\n    /** Only snap to center line and not individual strokes and symbols of line style */\n    NoSnap = 0x04,\n    /** Style represents a continuous line with width (determined by looking at components if not set) */\n    Continuous = 0x08,\n    /** Style represents physical geometry and should be scaled as such */\n    Physical = 0x80,\n  }\n\n  /** The line style definition element data */\n  export interface StyleProps {\n    /** The file property id for either a [[LineStyleDefinition.ComponentType.StrokePattern]] or [[LineStyleDefinition.ComponentType.Compound]] component */\n    compId: number;\n    /** The type of component for specified file property id */\n    compType: ComponentType;\n    /** Style behavior flags. Defaults to [[LineStyleDefinition.StyleFlags.NoSnap]] if left undefined */\n    flags?: StyleFlags;\n    /** Style scale, defaults to 1 */\n    unitDef?: number;\n  }\n\n  /** Helper methods for creating and querying line styles */\n  export class Utils {\n\n    /** Create a file property for a new stroke pattern component. */\n    public static createStrokePatternComponent(iModel: IModelDb, props: StrokePatternProps): StyleProps {\n      const fileProps: FilePropertyProps = { name: \"LineCodeV1\", namespace: \"dgn_LStyle\" };\n      fileProps.id = iModel.queryNextAvailableFileProperty(fileProps);\n      iModel.saveFileProperty(fileProps, JSON.stringify(props));\n      return { compId: fileProps.id, compType: ComponentType.StrokePattern };\n    }\n\n    /** Create a file property for a new point symbol component.\n     * If base and size parameters are not supplied, queries GeometryPart by id to set them.\n     */\n    public static createPointSymbolComponent(iModel: IModelDb, props: PointSymbolProps): StyleProps | undefined {\n      // if part extents weren't supplied, set them up now.\n      if (!props.baseX && !props.baseY && !props.baseZ && !props.sizeX && !props.sizeY && !props.sizeZ) {\n        const geomPart = iModel.elements.getElement<GeometryPart>(props.geomPartId);\n        if (!geomPart)\n          return undefined;\n\n        props.baseX = geomPart.bbox.low.x;\n        props.baseY = geomPart.bbox.low.y;\n        props.baseZ = geomPart.bbox.low.z;\n\n        props.sizeX = geomPart.bbox.high.x;\n        props.sizeY = geomPart.bbox.high.y;\n        props.sizeZ = geomPart.bbox.high.z;\n      }\n\n      const fileProps: FilePropertyProps = { name: \"PointSymV1\", namespace: \"dgn_LStyle\" };\n      fileProps.id = iModel.queryNextAvailableFileProperty(fileProps);\n      iModel.saveFileProperty(fileProps, JSON.stringify(props));\n      return { compId: fileProps.id, compType: ComponentType.PointSymbol };\n    }\n\n    /** Create a file property for a new stroke point component. */\n    public static createStrokePointComponent(iModel: IModelDb, props: StrokePointProps): StyleProps {\n      const fileProps: FilePropertyProps = { name: \"LinePointV1\", namespace: \"dgn_LStyle\" };\n      fileProps.id = iModel.queryNextAvailableFileProperty(fileProps);\n      iModel.saveFileProperty(fileProps, JSON.stringify(props));\n      return { compId: fileProps.id, compType: ComponentType.StrokePoint };\n    }\n\n    /** Create a file property for a new compound component. */\n    public static createCompoundComponent(iModel: IModelDb, props: CompoundProps): StyleProps {\n      const fileProps: FilePropertyProps = { name: \"CompoundV1\", namespace: \"dgn_LStyle\" };\n      fileProps.id = iModel.queryNextAvailableFileProperty(fileProps);\n      iModel.saveFileProperty(fileProps, JSON.stringify(props));\n      return { compId: fileProps.id, compType: ComponentType.Compound };\n    }\n\n    /** Create a file property for a new raster image component. */\n    public static createRasterComponent(iModel: IModelDb, props: RasterImageProps, image: Uint8Array): StyleProps | undefined {\n      const rasterFileProps: FilePropertyProps = { name: \"RasterImageV1\", namespace: \"dgn_LStyle\" };\n      rasterFileProps.id = iModel.queryNextAvailableFileProperty(rasterFileProps);\n      iModel.saveFileProperty(rasterFileProps, undefined, image);\n      props.imageId = rasterFileProps.id;\n      const fileProps: FilePropertyProps = { name: \"RasterComponentV1\", namespace: \"dgn_LStyle\" };\n      fileProps.id = iModel.queryNextAvailableFileProperty(fileProps);\n      iModel.saveFileProperty(fileProps, JSON.stringify(props));\n      return { compId: fileProps.id, compType: ComponentType.RasterImage };\n    }\n\n    /** Query for an existing line style with the supplied name. */\n    public static queryStyle(imodel: IModelDb, scopeModelId: Id64String, name: string): Id64String | undefined {\n      return imodel.elements.queryElementIdByCode(LineStyle.createCode(imodel, scopeModelId, name));\n    }\n\n    /** Insert a new line style with the supplied name.\n     * @throws [[IModelError]] if unable to insert the line style definition element.\n     */\n    public static createStyle(imodel: IModelDb, scopeModelId: Id64String, name: string, props: StyleProps): Id64String {\n      if (undefined === props.flags)\n        props.flags = StyleFlags.NoSnap; // If flags weren't supplied, default to not snapping to stroke geometry.\n\n      const lsProps: LineStyleProps = {\n        classFullName: \"BisCore:LineStyle\",\n        model: scopeModelId,\n        code: LineStyle.createCode(imodel, scopeModelId, name),\n        data: JSON.stringify(props),\n      };\n\n      return imodel.elements.insertElement(lsProps);\n    }\n\n    /** Get the name that can be use to query for an existing continuous line style. */\n    public static getContinuousStyleName(width?: number): string {\n      if (width === undefined)\n        return \"Continuous\";\n\n      return `Continuous-${width}`;\n    }\n\n    /** Query for a continuous line style that can be used to create curves with physical width instead of weight in pixels and create one if it does not already exist.\n     * There are 2 ways to define a continuous line style:\n     * - Width is not specified in the style itself and instead will be supplied as an override for each curve that is drawn.\n     *  - Defined using [[LineStyleDefinition.ComponentType.Internal]] with component id 0 [[LinePixels.Solid]] which has special behavior of being affected by width overrides.\n     * - Width is specified in the style.\n     *  - Defined using a single stroke component that is a long dash.\n     *\n     * @throws [[IModelError]] if unable to insert the line style definition element.\n     */\n    public static getOrCreateContinuousStyle(imodel: IModelDb, scopeModelId: Id64String, width?: number): Id64String {\n      const name = this.getContinuousStyleName(width);\n      const lsId = this.queryStyle(imodel, scopeModelId, name);\n      if (undefined !== lsId)\n        return lsId;\n\n      if (width === undefined)\n        return this.createStyle(imodel, scopeModelId, name, { compId: 0, compType: ComponentType.Internal, flags: StyleFlags.Continuous | StyleFlags.NoSnap });\n\n      const strokePatternData = this.createStrokePatternComponent(imodel, { descr: name, strokes: [{ length: 1e37, orgWidth: width, strokeMode: StrokeMode.Dash, widthMode: StrokeWidth.Full }] });\n      if (undefined === strokePatternData)\n        throw new IModelError(IModelStatus.BadArg, \"Unable to insert stroke component\");\n\n      return this.createStyle(imodel, scopeModelId, name, { compId: strokePatternData.compId, compType: strokePatternData.compType, flags: StyleFlags.Continuous | StyleFlags.NoSnap });\n    }\n\n    /** Get the name that can be use to query for an existing [[LinePixels]] line style.\n     * @note Returns undefined for line pixels value that is not Code1 to Code7.\n    */\n    public static getLinePixelsStyleName(linePixels: LinePixels): string | undefined {\n      const lineCode = getLinePixelsLineCode(linePixels);\n      if (-1 === lineCode)\n        return undefined;\n\n      return `LinePixelsCodeNumber-${lineCode}`;\n    }\n\n    /** Query for a line style using the supplied [[LinePixels]] value (Code1-Code7) and create one if it does not already exist.\n     * Most applications should instead use [[createStrokePatternComponent]] to define a style with physical dash and gap lengths.\n     * Unlike other components, [[LineStyleDefinition.ComponentType.Internal]] uses the line code as the compId instead of a file property id.\n     * @throws [[IModelError]] if supplied an invalid [[LinePixels]] value or if unable to insert the line style definition element.\n     */\n    public static getOrCreateLinePixelsStyle(imodel: IModelDb, scopeModelId: Id64String, linePixels: LinePixels): Id64String {\n      const lineCode = getLinePixelsLineCode(linePixels);\n      if (-1 === lineCode)\n        throw new IModelError(IModelStatus.BadArg, \"Invalid LinePixels\");\n\n      const name = `LinePixelsCodeNumber-${lineCode}`;\n      const lsId = this.queryStyle(imodel, scopeModelId, name);\n      return (undefined === lsId ? this.createStyle(imodel, scopeModelId, name, { compId: lineCode, compType: ComponentType.Internal }) : lsId);\n    }\n  }\n}\n"]}
+{"version":3,"file":"LineStyle.js","sourceRoot":"","sources":["../../src/LineStyle.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module ElementGeometry\n */\n\nimport { Id64String, IModelStatus } from \"@itwin/core-bentley\";\nimport { FilePropertyProps, IModelError, LinePixels, LineStyleProps } from \"@itwin/core-common\";\nimport { EditTxn } from \"./EditTxn\";\nimport { GeometryPart, LineStyle } from \"./Element\";\nimport { IModelDb } from \"./IModelDb\";\nimport { _implicitTxn } from \"./internal/Symbols\";\n\nfunction getLinePixelsLineCode(linePixels: LinePixels): number {\n  switch (linePixels) {\n    case LinePixels.Code1:\n      return 1;\n    case LinePixels.Code2:\n      return 2;\n    case LinePixels.Code3:\n      return 3;\n    case LinePixels.Code4:\n      return 4;\n    case LinePixels.Code5:\n      return 5;\n    case LinePixels.Code6:\n      return 6;\n    case LinePixels.Code7:\n      return 7;\n    default:\n      return -1; // Invalid value...\n  }\n}\n\n/** A line style definition is a uniquely named pattern that repeats as it is displayed along a curve path. In the absence of a line style, curve display is limited to solid lines with a width in pixels.\n * There are three varieties of line styles:\n * - A style described by a stroke pattern (series of dashes and gaps) that may also include symbol graphics.\n * - A style using pre-defined pixel bit patterns [[LinePixels]] for dashed display (Code1-Code7).\n * - A style that uses a texture.\n *\n * A definition is defined by one or more components. A component is saved as a \"file property\" and can be referenced by other components. The line style definition references a component\n * by file property id and type and is saved as a dictionary element.\n * @public\n */\nexport namespace LineStyleDefinition {\n\n  /** Line style component type identifiers */\n  export enum ComponentType {\n    /** Component type for [[LineStyleDefinition.PointSymbolProps]] */\n    PointSymbol = 1,\n    /** Component type for [[LineStyleDefinition.CompoundProps]] */\n    Compound = 2,\n    /** Component type for [[LineStyleDefinition.StrokePatternProps]] */\n    StrokePattern = 3,\n    /** Component type for [[LineStyleDefinition.StrokePointProps]] */\n    StrokePoint = 4,\n    /** Component type for [[LinePixels]], never saved as a file property */\n    Internal = 6,\n    /** Component type for [[LineStyleDefinition.RasterImageProps]] */\n    RasterImage = 7,\n  }\n\n  /** Mask of values for StrokeMode */\n  export enum StrokeMode {\n    /** Stroke represents a blank space */\n    Gap = 0x00,\n    /** Stroke represents a solid dash */\n    Dash = 0x01,\n    /** Treat stroke as rigid and continue past a corner to complete the stroke as opposed to breaking at the corner */\n    Ray = 0x02,\n    /** Stroke length can be stretched when [[LineStyleDefinition.StrokePatternOptions.Iteration]] and [[LineStyleDefinition.StrokePatternOptions.AutoPhase]] options are set, applicable to both Gap and Dash strokes */\n    Scale = 0x04,\n    /** Invert stroke in first stroke pattern */\n    FirstInvert = 0x08,\n    /** Invert stroke in last stroke pattern */\n    LastInvert = 0x10,\n  }\n\n  /** Define constant width or tapered strokes with distance specified in meters */\n  export enum StrokeWidth {\n    /** Stroke draws as one pixel wide line */\n    None = 0,\n    /** Half [[LineStyleDefinition.StrokeProps.orgWidth]] and [[LineStyleDefinition.StrokeProps.endWidth]] applied to left side of stroke */\n    Left = 1,\n    /** Half [[LineStyleDefinition.StrokeProps.orgWidth]] and [[LineStyleDefinition.StrokeProps.endWidth]] applied to right side of stroke */\n    Right = 2,\n    /** Half [[LineStyleDefinition.StrokeProps.orgWidth]] and [[LineStyleDefinition.StrokeProps.endWidth]] applied to both sides of stroke */\n    Full = 3,\n  }\n\n  /** Controls appearance of stroke end caps. If StrokeCap is >= Hexagon, the end cap is stroked as an arc and the value of\n   * StrokeCap indicates the number of vectors in the arc.\n   */\n  export enum StrokeCap {\n    /** Stroke displays as a closed polygon */\n    Closed = 0,\n    /** Stroke displays lines at specified width instead of a polygon */\n    Open = 1,\n    /** Stroke length extended by half the stroke width */\n    Extended = 2,\n    /** Stroke end cap is a hexagon */\n    Hexagon = 3,\n    /** Stroke end cap is an octagon */\n    Octagon = 4,\n    /** Stroke end cap is a decagon */\n    Decagon = 5,\n    /** Stroke end cap is an arc */\n    Arc = 30,\n  }\n\n  /** A stroke representing either a dash or gap in a stroke pattern */\n  export interface StrokeProps {\n    /** Length of stroke in meters */\n    length: number;\n    /** Width at start of stroke. Behavior controlled by [[LineStyleDefinition.StrokeWidth]], choose value other than [[LineStyleDefinition.StrokeWidth.None]] */\n    orgWidth?: number;\n    /** Width at end of stroke, same as start width if not present. Behavior controlled by [[LineStyleDefinition.StrokeWidth]], choose value other than [[LineStyleDefinition.StrokeWidth.None]] */\n    endWidth?: number;\n    /** Type and behavior of stroke */\n    strokeMode?: StrokeMode;\n    /** How to apply orgWidth and endWidth to stroke */\n    widthMode?: StrokeWidth;\n    /** Appearance of stroke end cap */\n    capMode?: StrokeCap;\n  }\n\n  export type Strokes = StrokeProps[];\n\n  /** Options to control how stroke pattern is applied to underlying curve */\n  export enum StrokePatternOptions {\n    /** Use default stroke behavior */\n    None = 0x00,\n    /** [[LineStyleDefinition.StrokePatternProps.phase]] represents fractional distance into first stroke of pattern */\n    AutoPhase = 0x01,\n    /** Use [[LineStyleDefinition.StrokePatternProps.maxIter]] to limit the number of iterations of the stroke pattern */\n    Iteration = 0x08,\n    /** Single segment mode restarts the stroke pattern at corners instead of continuing around corners */\n    Segment = 0x10,\n    /** Center the line style and stretch the ends */\n    CenterStretch = 0x20,\n  }\n\n  /** Stroke pattern component definition [[LineStyleDefinition.ComponentType.StrokePattern]].\n   * A stroke pattern component consists of a series of dashes and gaps having specified lengths and widths in meters. Simple dash-dot type line styles that do not\n   * include point symbols can be created by referencing a stroke pattern component by its file property id.\n   */\n  export interface StrokePatternProps {\n    /** Name for this stroke pattern */\n    descr: string;\n    /** Skip into the pattern before starting to draw. Value treated as fraction of the first stroke when [[LineStyleDefinition.StrokePatternOptions.AutoPhase]] set. Value used as distance when [[LineStyleDefinition.StrokePatternOptions.CenterStretch]] is not set. */\n    phase?: number;\n    /** Options mask for this stroke pattern */\n    options?: StrokePatternOptions;\n    /** The entire stroke pattern will be repeated no more than maxIter on curve or segment when [[LineStyleDefinition.StrokePatternOptions.Iteration]] is set and stroke pattern includes stretchable strokes. */\n    maxIter?: number;\n    /** Array of strokes, maximum number that will be used is 32 */\n    strokes: Strokes;\n  }\n\n  /** Flags to identify point symbol behavior */\n  export enum PointSymbolFlags {\n    /** Default symbol behavior */\n    None = 0x0,\n    /** Symbol includes 3d geometry */\n    Is3d = 0x01,\n    /** Symbol does not allow scaling */\n    NoScale = 0x02,\n  }\n\n  /** Point symbol component definition [[LineStyleDefinition.ComponentType.PointSymbol]].\n   * A point symbol component identifies a GeometryPart for reference by a [[LineStyleDefinition.SymbolProps]].\n   */\n  export interface PointSymbolProps {\n    /** GeometryPart Id to use as a pattern symbol */\n    geomPartId: Id64String;\n    /** GeometryPart.bbox.low.x */\n    baseX?: number;\n    /** GeometryPart.bbox.low.y */\n    baseY?: number;\n    /** GeometryPart.bbox.low.z */\n    baseZ?: number;\n    /** GeometryPart.bbox.high.x */\n    sizeX?: number;\n    /** GeometryPart.bbox.high.y */\n    sizeY?: number;\n    /** GeometryPart.bbox.high.z */\n    sizeZ?: number;\n    /** Symbol behavior flags */\n    symFlags?: PointSymbolFlags;\n    /** Symbol scale, defaults to 1 */\n    scale?: number;\n  }\n\n  /** Symbol options for location, orientation, and behavior */\n  export enum SymbolOptions {\n    /** No point symbol */\n    None = 0x00,\n    /** Symbol at origin of stroke */\n    Origin = 0x01,\n    /** Symbol at end of stroke */\n    End = 0x02,\n    /** symbol at center of stroke */\n    Center = 0x03,\n    /** Symbol at curve start point */\n    CurveOrigin = 0x0004,\n    /** Symbol at curve end point */\n    CurveEnd = 0x0008,\n    /** Symbol at each vertex */\n    CurveVertex = 0x0010,\n    /** Adjust symbol rotation left->right */\n    AdjustRotation = 0x0020,\n    /** Angle of symbol not relative to stroke direction */\n    AbsoluteRotation = 0x0040,\n    /** No scale on variable strokes */\n    NoScale = 0x0100,\n    /** No clip on partial strokes */\n    NoClip = 0x0200,\n    /** No partial strokes */\n    NoPartial = 0x0400,\n    /** Project partial origin */\n    ProjectOrigin = 0x0800,\n    /** Use color from symbol instead of inheriting curve color */\n    UseColor = 0x4000,\n    /** Use weight from symbol instead of inheriting curve weight */\n    UseWeight = 0x8000,\n  }\n\n  /** Identifies a symbol and its location and orientation relative to a stroke pattern */\n  export interface SymbolProps {\n    /** The file property id of the symbol component, assumed to be [[LineStyleDefinition.ComponentType.PointSymbol]] if symType is undefined. */\n    symId: number;\n    /** The component type, leave undefined if symId is a [[LineStyleDefinition.ComponentType.PointSymbol]] */\n    symType?: ComponentType;\n    /** The 0 based stroke index for base stroke pattern [[LineStyleDefinition.ComponentType.StrokePattern]] component */\n    strokeNum?: number;\n    /** Symbol x offset distance in meters */\n    xOffset?: number;\n    /** Symbol y offset distance in meters */\n    yOffset?: number;\n    /** Symbol rotation in radians */\n    angle?: number;\n    /** Must set location for symbol as default value is [[LineStyleDefinition.SymbolOptions.None]] */\n    mod1?: SymbolOptions;\n  }\n\n  export type Symbols = SymbolProps[];\n\n  /** Stroke point component definition [[LineStyleDefinition.ComponentType.StrokePoint]].\n   * A stroke point component identifies the locations of point symbol components relative to a base stroke pattern component.\n   */\n  export interface StrokePointProps {\n    /** Name for this stroke point component */\n    descr: string;\n    /** The file property id of the stroke component, assumed to be [[LineStyleDefinition.ComponentType.StrokePattern]] if lcType is undefined */\n    lcId: number;\n    /** The component type, leave undefined if lcId is a [[LineStyleDefinition.ComponentType.StrokePattern]] */\n    lcType?: ComponentType;\n    /** Array of symbols */\n    symbols: Symbols;\n  }\n\n  /** Raster component definition [[LineStyleDefinition.ComponentType.RasterImage]].\n   * A raster component identifies a texture for a line style.\n   */\n  export interface RasterImageProps {\n    /** Name for this raster image component */\n    descr: string;\n    /** Raster width */\n    x: number;\n    /** Raster height */\n    y: number;\n    /** True width flag */\n    trueWidth?: number;\n    /** Raster flags */\n    flags?: number;\n    /** The file property id of raster image */\n    imageId?: number;\n  }\n\n  /** Identifies a component by file property id and type */\n  export interface ComponentProps {\n    /** The file property id of [[LineStyleDefinition.ComponentType.StrokePattern]] or [[LineStyleDefinition.ComponentType.StrokePoint]] component */\n    id: number;\n    /** The type of component for specified file property id */\n    type: ComponentType;\n    /** Offset distance for this component, default is 0 */\n    offset?: number;\n  }\n\n  export type Components = ComponentProps[];\n\n  /** Compound component definition [[LineStyleDefinition.ComponentType.Compound]].\n   * A compound component is used to link stroke pattern and stroke point components to create a style that displays dashes, gaps, and symbols.\n   */\n  export interface CompoundProps {\n    comps: Components;\n  }\n\n  /** Flags to describe a style or control style behavior */\n  export enum StyleFlags {\n    /** Use defaults */\n    None = 0x00,\n    /** Only snap to center line and not individual strokes and symbols of line style */\n    NoSnap = 0x04,\n    /** Style represents a continuous line with width (determined by looking at components if not set) */\n    Continuous = 0x08,\n    /** Style represents physical geometry and should be scaled as such */\n    Physical = 0x80,\n  }\n\n  /** The line style definition element data */\n  export interface StyleProps {\n    /** The file property id for either a [[LineStyleDefinition.ComponentType.StrokePattern]] or [[LineStyleDefinition.ComponentType.Compound]] component */\n    compId: number;\n    /** The type of component for specified file property id */\n    compType: ComponentType;\n    /** Style behavior flags. Defaults to [[LineStyleDefinition.StyleFlags.NoSnap]] if left undefined */\n    flags?: StyleFlags;\n    /** Style scale, defaults to 1 */\n    unitDef?: number;\n  }\n\n  /** Helper methods for creating and querying line styles */\n  export class Utils {\n    /** Create a file property for a new stroke pattern component using an explicit EditTxn.\n     * @beta\n     */\n    public static createStrokePatternComponent(txn: EditTxn, props: StrokePatternProps): StyleProps;\n    /** Create a file property for a new stroke pattern component.\n     * @deprecated Use createStrokePatternComponent(txn, ...) instead.\n     */\n    public static createStrokePatternComponent(iModel: IModelDb, props: StrokePatternProps): StyleProps;\n    public static createStrokePatternComponent(txnOrIModel: EditTxn | IModelDb, props: StrokePatternProps): StyleProps {\n      const txn = txnOrIModel instanceof EditTxn ? txnOrIModel : txnOrIModel[_implicitTxn];\n      const fileProps: FilePropertyProps = { name: \"LineCodeV1\", namespace: \"dgn_LStyle\" };\n      fileProps.id = txn.iModel.queryNextAvailableFileProperty(fileProps);\n      txn.saveFileProperty(fileProps, JSON.stringify(props));\n      return { compId: fileProps.id, compType: ComponentType.StrokePattern };\n    }\n\n    /** Create a file property for a new point symbol component using an explicit EditTxn.\n     * If base and size parameters are not supplied, queries GeometryPart by id to set them.\n      * @beta\n     */\n    public static createPointSymbolComponent(txn: EditTxn, props: PointSymbolProps): StyleProps | undefined;\n    /** Create a file property for a new point symbol component.\n     * If base and size parameters are not supplied, queries GeometryPart by id to set them.\n     * @deprecated Use createPointSymbolComponent(txn, ...) instead.\n     */\n    public static createPointSymbolComponent(iModel: IModelDb, props: PointSymbolProps): StyleProps | undefined;\n    public static createPointSymbolComponent(txnOrIModel: EditTxn | IModelDb, props: PointSymbolProps): StyleProps | undefined {\n      const txn = txnOrIModel instanceof EditTxn ? txnOrIModel : txnOrIModel[_implicitTxn];\n      const iModel = txn.iModel;\n      // if part extents weren't supplied, set them up now.\n      if (!props.baseX && !props.baseY && !props.baseZ && !props.sizeX && !props.sizeY && !props.sizeZ) {\n        const geomPart = iModel.elements.getElement<GeometryPart>(props.geomPartId);\n        if (!geomPart)\n          return undefined;\n\n        props.baseX = geomPart.bbox.low.x;\n        props.baseY = geomPart.bbox.low.y;\n        props.baseZ = geomPart.bbox.low.z;\n\n        props.sizeX = geomPart.bbox.high.x;\n        props.sizeY = geomPart.bbox.high.y;\n        props.sizeZ = geomPart.bbox.high.z;\n      }\n\n      const fileProps: FilePropertyProps = { name: \"PointSymV1\", namespace: \"dgn_LStyle\" };\n      fileProps.id = iModel.queryNextAvailableFileProperty(fileProps);\n      txn.saveFileProperty(fileProps, JSON.stringify(props));\n      return { compId: fileProps.id, compType: ComponentType.PointSymbol };\n    }\n\n    /** Create a file property for a new stroke point component using an explicit EditTxn.\n     * @beta\n     */\n    public static createStrokePointComponent(txn: EditTxn, props: StrokePointProps): StyleProps;\n    /** Create a file property for a new stroke point component.\n     * @deprecated Use createStrokePointComponent(txn, ...) instead.\n     */\n    public static createStrokePointComponent(iModel: IModelDb, props: StrokePointProps): StyleProps;\n    public static createStrokePointComponent(txnOrIModel: EditTxn | IModelDb, props: StrokePointProps): StyleProps {\n      const txn = txnOrIModel instanceof EditTxn ? txnOrIModel : txnOrIModel[_implicitTxn];\n      const fileProps: FilePropertyProps = { name: \"LinePointV1\", namespace: \"dgn_LStyle\" };\n      fileProps.id = txn.iModel.queryNextAvailableFileProperty(fileProps);\n      txn.saveFileProperty(fileProps, JSON.stringify(props));\n      return { compId: fileProps.id, compType: ComponentType.StrokePoint };\n    }\n\n    /** Create a file property for a new compound component using an explicit EditTxn.\n     * @beta\n     */\n    public static createCompoundComponent(txn: EditTxn, props: CompoundProps): StyleProps;\n    /** Create a file property for a new compound component.\n     * @deprecated Use createCompoundComponent(txn, ...) instead.\n     */\n    public static createCompoundComponent(iModel: IModelDb, props: CompoundProps): StyleProps;\n    public static createCompoundComponent(txnOrIModel: EditTxn | IModelDb, props: CompoundProps): StyleProps {\n      const txn = txnOrIModel instanceof EditTxn ? txnOrIModel : txnOrIModel[_implicitTxn];\n      const fileProps: FilePropertyProps = { name: \"CompoundV1\", namespace: \"dgn_LStyle\" };\n      fileProps.id = txn.iModel.queryNextAvailableFileProperty(fileProps);\n      txn.saveFileProperty(fileProps, JSON.stringify(props));\n      return { compId: fileProps.id, compType: ComponentType.Compound };\n    }\n\n    /** Create a file property for a new raster image component using an explicit EditTxn.\n     * @beta\n     */\n    public static createRasterComponent(txn: EditTxn, props: RasterImageProps, image: Uint8Array): StyleProps | undefined;\n    /** Create a file property for a new raster image component.\n     * @deprecated Use createRasterComponent(txn, ...) instead.\n     */\n    public static createRasterComponent(iModel: IModelDb, props: RasterImageProps, image: Uint8Array): StyleProps | undefined;\n    public static createRasterComponent(txnOrIModel: EditTxn | IModelDb, props: RasterImageProps, image: Uint8Array): StyleProps | undefined {\n      const txn = txnOrIModel instanceof EditTxn ? txnOrIModel : txnOrIModel[_implicitTxn];\n      const iModel = txn.iModel;\n      const rasterFileProps: FilePropertyProps = { name: \"RasterImageV1\", namespace: \"dgn_LStyle\" };\n      rasterFileProps.id = iModel.queryNextAvailableFileProperty(rasterFileProps);\n      txn.saveFileProperty(rasterFileProps, undefined, image);\n      props.imageId = rasterFileProps.id;\n      const fileProps: FilePropertyProps = { name: \"RasterComponentV1\", namespace: \"dgn_LStyle\" };\n      fileProps.id = iModel.queryNextAvailableFileProperty(fileProps);\n      txn.saveFileProperty(fileProps, JSON.stringify(props));\n      return { compId: fileProps.id, compType: ComponentType.RasterImage };\n    }\n\n    /** Query for an existing line style with the supplied name. */\n    public static queryStyle(imodel: IModelDb, scopeModelId: Id64String, name: string): Id64String | undefined {\n      return imodel.elements.queryElementIdByCode(LineStyle.createCode(imodel, scopeModelId, name));\n    }\n\n    /** Insert a new line style with the supplied name using an explicit EditTxn.\n     * @throws [[IModelError]] if unable to insert the line style definition element.\n     * @beta\n     */\n    public static createStyle(txn: EditTxn, scopeModelId: Id64String, name: string, props: StyleProps): Id64String;\n    /** Insert a new line style with the supplied name.\n     * @throws [[IModelError]] if unable to insert the line style definition element.\n     * @deprecated Use createStyle(txn, ...) instead.\n     */\n    public static createStyle(imodel: IModelDb, scopeModelId: Id64String, name: string, props: StyleProps): Id64String;\n    public static createStyle(txnOrIModel: EditTxn | IModelDb, scopeModelId: Id64String, name: string, props: StyleProps): Id64String {\n      const txn = txnOrIModel instanceof EditTxn ? txnOrIModel : txnOrIModel[_implicitTxn];\n      const imodel = txn.iModel;\n      if (undefined === props.flags)\n        props.flags = StyleFlags.NoSnap; // If flags weren't supplied, default to not snapping to stroke geometry.\n\n      const lsProps: LineStyleProps = {\n        classFullName: \"BisCore:LineStyle\",\n        model: scopeModelId,\n        code: LineStyle.createCode(imodel, scopeModelId, name),\n        data: JSON.stringify(props),\n      };\n\n      return txn.insertElement(lsProps);\n    }\n\n    /** Get the name that can be use to query for an existing continuous line style. */\n    public static getContinuousStyleName(width?: number): string {\n      if (width === undefined)\n        return \"Continuous\";\n\n      return `Continuous-${width}`;\n    }\n\n    /** Query for a continuous line style that can be used to create curves with physical width instead of weight in pixels and create one if it does not already exist.\n     * There are 2 ways to define a continuous line style:\n     * - Width is not specified in the style itself and instead will be supplied as an override for each curve that is drawn.\n     *  - Defined using [[LineStyleDefinition.ComponentType.Internal]] with component id 0 [[LinePixels.Solid]] which has special behavior of being affected by width overrides.\n     * - Width is specified in the style.\n     *  - Defined using a single stroke component that is a long dash.\n     * @param txn Optional explicit EditTxn to use if the style must be created.\n     * @throws [[IModelError]] if unable to insert the line style definition element.\n     * @beta\n     */\n    public static getOrCreateContinuousStyle(imodel: IModelDb, scopeModelId: Id64String, width?: number, txn?: EditTxn): Id64String {\n      const writeTxn = txn ?? imodel[_implicitTxn];\n      const name = this.getContinuousStyleName(width);\n      const lsId = this.queryStyle(imodel, scopeModelId, name);\n      if (undefined !== lsId)\n        return lsId;\n\n      if (width === undefined)\n        return this.createStyle(writeTxn, scopeModelId, name, { compId: 0, compType: ComponentType.Internal, flags: StyleFlags.Continuous | StyleFlags.NoSnap });\n\n      const strokePatternData = this.createStrokePatternComponent(writeTxn, { descr: name, strokes: [{ length: 1e37, orgWidth: width, strokeMode: StrokeMode.Dash, widthMode: StrokeWidth.Full }] });\n      if (undefined === strokePatternData)\n        throw new IModelError(IModelStatus.BadArg, \"Unable to insert stroke component\");\n\n      return this.createStyle(writeTxn, scopeModelId, name, { compId: strokePatternData.compId, compType: strokePatternData.compType, flags: StyleFlags.Continuous | StyleFlags.NoSnap });\n    }\n\n    /** Get the name that can be use to query for an existing [[LinePixels]] line style.\n     * @note Returns undefined for line pixels value that is not Code1 to Code7.\n    */\n    public static getLinePixelsStyleName(linePixels: LinePixels): string | undefined {\n      const lineCode = getLinePixelsLineCode(linePixels);\n      if (-1 === lineCode)\n        return undefined;\n\n      return `LinePixelsCodeNumber-${lineCode}`;\n    }\n\n    /** Query for a line style using the supplied [[LinePixels]] value (Code1-Code7) and create one if it does not already exist.\n     * Most applications should instead use [[createStrokePatternComponent]] to define a style with physical dash and gap lengths.\n     * Unlike other components, [[LineStyleDefinition.ComponentType.Internal]] uses the line code as the compId instead of a file property id.\n    * @param txn Optional explicit EditTxn to use if the style must be created.\n     * @throws [[IModelError]] if supplied an invalid [[LinePixels]] value or if unable to insert the line style definition element.\n      * @beta\n     */\n    public static getOrCreateLinePixelsStyle(imodel: IModelDb, scopeModelId: Id64String, linePixels: LinePixels, txn?: EditTxn): Id64String {\n      const lineCode = getLinePixelsLineCode(linePixels);\n      if (-1 === lineCode)\n        throw new IModelError(IModelStatus.BadArg, \"Invalid LinePixels\");\n\n      const name = `LinePixelsCodeNumber-${lineCode}`;\n      const lsId = this.queryStyle(imodel, scopeModelId, name);\n      return (undefined === lsId ? this.createStyle(txn ?? imodel[_implicitTxn], scopeModelId, name, { compId: lineCode, compType: ComponentType.Internal }) : lsId);\n    }\n  }\n}\n"]}

package/lib/esm/LockControl.d.ts

@@ -49,6 +49,9 @@ export interface LockControl {
      * If any required lock is not available, this method throws an exception and *none* of the requested locks are acquired.
      * @note Acquiring the exclusive lock on an element requires also obtaining a shared lock on all its owner elements. This method will
      * attempt to acquire all necessary locks for both sets of input ids.
+     * @note Calling this method after reversing or reinstating a Txn indicates the start of a brand new Txn with the current Txn ID,
+     * making it invalid to call [[abandonLocksForReversedTxn]] or [[acquireLocksForReinstatingTxn]] for previously-reversed
+     * Txns with the current ID or greater.
      */
     acquireLocks(arg: {
         /** if present, one or more elements to obtain shared lock */
@@ -56,18 +59,99 @@ export interface LockControl {
         /** if present, one or more elements to obtain exclusive lock */
         exclusive?: Id64Arg;
     }): Promise<void>;
-    /** Release all locks currently held by this briefcase from the locker server.
+    /** Release all locks currently held by this briefcase from the lock server after editing the associated elements.
      * This is typically done on your behalf by [[BriefcaseDb.pushChanges]].
+     * If you are abandoning changes instead of pushing them, you should call [[abandonAllLocks]] instead.
      * You may want to do it manually when abandoning all of your briefcase's local changes.
      * You cannot release your locks if your briefcase contains local changes.
      * @throws Error if the briefcase has local changes, or if any other error occurs while releasing the locks.
      */
     releaseAllLocks(): Promise<void>;
+    /**
+     * Abandons all locks currently held by this briefcase when none of the associated elements have
+     * been or will be modified. This is only valid to do when none of the elements protected by
+     * the currently-held locks have been edited, or if all edits have been reversed or abandoned without
+     * pushing them.
+     * @beta
+     *
+     * The locks are released on the IModelHub, but the changeset associated with the locks is not updated,
+     * reflecting the fact that the associated elements were not edited.
+     */
+    abandonAllLocks(): Promise<void>;
     /**
      * Release all locks currently held by this Briefcase from the lock server.
      * Not possible to release locks unless push or abandon all changes. Should only be called internally.
      * @internal
      */
     [_releaseAllLocks]: () => Promise<void>;
+    /**
+     * Abandons the locks that were acquired during a given Txn and all later Txns, all of which must already
+     * have been reversed.
+     * @beta
+     *
+     * @param txnId The ID of the first Txn whose locks should be abandoned. This must either be a Txn that has
+     * already been reversed, or the [[TxnManager.getCurrentTxnId]]. In either case, the current Txn must not
+     * have any unsaved changes.
+     * @returns A promise that resolves to true if any locks were successfully abandoned. False if there were no locks to abandon,
+     * which may be the case if the Txns did not acquire any locks or if they were already abandoned. The Promise rejects
+     * with an ITwinError if the Txn has not been reversed, the current Txn has unsaved changes, or if any other error occurs
+     * while releasing the locks.
+     * @note This method also implicitly calls [[abandonLocksForCurrentUnsavedTxn]]. Locks acquired in the current,
+     * unsaved Txn will be abandoned when calling this method. However, they can not be re-acquired using
+     * [[acquireLocksForReinstatingTxn]]. This is because there is no way to recover these unsaved changes after abandoning
+     * them, so it is rarely useful to re-acquire the locks associated with irrecoverable changes.
+     */
+    abandonLocksForReversedTxn(txnId: Id64String): Promise<boolean>;
+    /**
+     * Abandons the locks that were acquired during the current, unsaved Txn. Any changes in the unsaved Txn must be abandoned
+     * before calling this method.
+     * @beta
+     *
+     * @returns A promise that resolves to true if any locks were successfully abandoned. False if there were no locks to abandon,
+     * which may be the case if the current Txn did not acquire any locks or if they were already abandoned. The Promise rejects
+     * with an ITwinError if the current Txn has unsaved changes, or if any other error occurs while releasing the locks.
+     */
+    abandonLocksForCurrentUnsavedTxn(): Promise<boolean>;
+    /**
+     * Re-acquire the locks that were previously acquired during a given Txn and all previous Txns. These locks are
+     * expected to have previously been released with {@link LockControl.abandonLocksForReversedTxn}. This is used
+     * just before reinstating a previously-reversed Txn to ensure that the necessary locks are held for the
+     * reinstated changes.
+     * @beta
+     *
+     * It is possible that the locks may no longer be available, in which case the returned Promise will reject
+     * with an exception.
+     *
+     * @param txnId The ID of the last Txn whose locks should be re-acquired.
+     * @returns A promise that resolves to true if any locks were successfully acquired. False if there were no locks to acquire,
+     * which may be the case if the Txn in question did not acquire any locks or if they were already re-acquired. The Promise
+     * rejects with an ITwinError if the Txn does not exist, the current Txn has unsaved changes, the locks cannot be acquired,
+     * or if any other error occurs while acquiring the locks.
+     */
+    acquireLocksForReinstatingTxn(txnId: Id64String): Promise<boolean>;
+    /**
+     * Checks whether the locks originally acquired for a specified reversed Txn, and all earlier Txns, were either not abandoned
+     * or have already been re-acquired.
+     * @beta
+     *
+     * If this method returns true, it is safe to reinstate the given Txn with [[TxnManager.reinstateTxn]]. If it returns false,
+     * the necessary locks must be acquired first, either by calling [[TxnManager.reinstateTxnAsync]] or by explicitly calling
+     * [[acquireLocksForReinstatingTxn]] first.
+     *
+     * @param txnId The ID of the Txn to check.
+     * @returns True if the necessary locks are currently held, false otherwise.
+     */
+    holdsNecessaryLocksForReinstatingTxn(txnId: Id64String): boolean;
+    /**
+     * Clears the records of locks acquired for a given Txn and all later Txns from the local lock database. Call this after
+     * a Txn becomes unreachable. This allows an ID to potentially be reused for a different Txn in the future.
+     * @beta
+     *
+     * After invoking this method, {@link LockControl.abandonLocksForReversedTxn} and {@link LockControl.acquireLocksForReinstatingTxn} will no
+     * longer be able to operate on this Txn or any later Txns.
+     *
+     * @param txnId The ID of the first Txn whose lock records should be cleared.
+     */
+    clearTxnLockRecords(txnId: Id64String): void;
 }
 //# sourceMappingURL=LockControl.d.ts.map

package/lib/esm/LockControl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LockControl.d.ts","sourceRoot":"","sources":["../../src/LockControl.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE7G;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,eAAe;IACf,QAAQ,CAAC,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAEhC;;;OAGG;IACH,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;;OAGG;IACH,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,KAAK,IAAI,CAAC;IAE/C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1E;;;OAGG;IACH,eAAe,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvE;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC;IAE5C;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC;IAEzC;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE;QAChB,6DAA6D;QAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,gEAAgE;QAChE,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB;;;;;OAKG;IACH,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;OAIG;IACH,CAAC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}
+{"version":3,"file":"LockControl.d.ts","sourceRoot":"","sources":["../../src/LockControl.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE7G;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,eAAe;IACf,QAAQ,CAAC,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAEhC;;;OAGG;IACH,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;;OAGG;IACH,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,KAAK,IAAI,CAAC;IAE/C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1E;;;OAGG;IACH,eAAe,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvE;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC;IAE5C;;OAEG;IACH,eAAe,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC;IAEzC;;;;;;;;OAQG;IACH,YAAY,CAAC,GAAG,EAAE;QAChB,6DAA6D;QAC7D,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,gEAAgE;QAChE,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB;;;;;;OAMG;IACH,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;;;;;;OASG;IACH,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjC;;;;OAIG;IACH,CAAC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;;;;;;;;;;;;;;OAgBG;IACH,0BAA0B,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhE;;;;;;;;OAQG;IACH,gCAAgC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAErD;;;;;;;;;;;;;;;OAeG;IACH,6BAA6B,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnE;;;;;;;;;;;OAWG;IACH,oCAAoC,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;IAEjE;;;;;;;;;OASG;IACH,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC9C"}

package/lib/esm/LockControl.js.map

@@ -1 +1 @@
-{"version":3,"file":"LockControl.js","sourceRoot":"","sources":["../../src/LockControl.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module iModels\n */\n\nimport { Id64Arg, Id64String } from \"@itwin/core-bentley\";\nimport { _close, _elementWasCreated, _implementationProhibited, _releaseAllLocks } from \"./internal/Symbols\";\n\n/**\n * Interface for acquiring element locks to [coordinate simultaneous edits]($docs/learning/backend/ConcurrencyControl.md) from multiple briefcases.\n * @see [[IModelDb.locks]] to access the locks for an iModel.\n * @public\n */\nexport interface LockControl {\n  /** @internal*/\n  readonly [_implementationProhibited]: unknown;\n\n  /**\n   * true if this LockControl uses a server-based concurrency approach.\n   */\n  readonly isServerBased: boolean;\n\n  /**\n   * Close the local lock control database\n   * @internal\n   */\n  [_close]: () => void;\n\n  /**\n   * Notification that a new element was just created. Called by [[Element.onInserted]]\n   * @internal\n   */\n  [_elementWasCreated]: (id: Id64String) => void;\n\n  /**\n   * Throw if locks are required and the exclusive lock is not held on the supplied element.\n   * Note: there is no need to check the shared locks on parents/models since an element cannot hold the exclusive lock without first obtaining them.\n   * Called by functions like [[Element.onUpdate]], [[Element.onDelete]], etc.\n   */\n  checkExclusiveLock(id: Id64String, type: string, operation: string): void;\n\n  /**\n   * Throw if locks are required and a shared lock is not held on the supplied element.\n   * Called by [[Element.onInsert]] to ensure shared lock is held on the new element's model and parent element.\n   */\n  checkSharedLock(id: Id64String, type: string, operation: string): void;\n\n  /**\n   * Determine whether the owning iModel currently holds the exclusive lock on the specified element.\n   */\n  holdsExclusiveLock(id: Id64String): boolean;\n\n  /**\n   * Determine whether the owning iModel currently holds a shared lock on the specified element.\n   */\n  holdsSharedLock(id: Id64String): boolean;\n\n  /**\n   * Acquire locks on one or more elements from the lock server, if required and not already held.\n   * If any required lock is not available, this method throws an exception and *none* of the requested locks are acquired.\n   * @note Acquiring the exclusive lock on an element requires also obtaining a shared lock on all its owner elements. This method will\n   * attempt to acquire all necessary locks for both sets of input ids.\n   */\n  acquireLocks(arg: {\n    /** if present, one or more elements to obtain shared lock */\n    shared?: Id64Arg;\n    /** if present, one or more elements to obtain exclusive lock */\n    exclusive?: Id64Arg;\n  }): Promise<void>;\n\n  /** Release all locks currently held by this briefcase from the locker server.\n   * This is typically done on your behalf by [[BriefcaseDb.pushChanges]].\n   * You may want to do it manually when abandoning all of your briefcase's local changes.\n   * You cannot release your locks if your briefcase contains local changes.\n   * @throws Error if the briefcase has local changes, or if any other error occurs while releasing the locks.\n   */\n  releaseAllLocks(): Promise<void>;\n\n  /**\n   * Release all locks currently held by this Briefcase from the lock server.\n   * Not possible to release locks unless push or abandon all changes. Should only be called internally.\n   * @internal\n   */\n  [_releaseAllLocks]: () => Promise<void>;\n}\n"]}
+{"version":3,"file":"LockControl.js","sourceRoot":"","sources":["../../src/LockControl.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module iModels\n */\n\nimport { Id64Arg, Id64String } from \"@itwin/core-bentley\";\nimport { _close, _elementWasCreated, _implementationProhibited, _releaseAllLocks } from \"./internal/Symbols\";\n\n/**\n * Interface for acquiring element locks to [coordinate simultaneous edits]($docs/learning/backend/ConcurrencyControl.md) from multiple briefcases.\n * @see [[IModelDb.locks]] to access the locks for an iModel.\n * @public\n */\nexport interface LockControl {\n  /** @internal*/\n  readonly [_implementationProhibited]: unknown;\n\n  /**\n   * true if this LockControl uses a server-based concurrency approach.\n   */\n  readonly isServerBased: boolean;\n\n  /**\n   * Close the local lock control database\n   * @internal\n   */\n  [_close]: () => void;\n\n  /**\n   * Notification that a new element was just created. Called by [[Element.onInserted]]\n   * @internal\n   */\n  [_elementWasCreated]: (id: Id64String) => void;\n\n  /**\n   * Throw if locks are required and the exclusive lock is not held on the supplied element.\n   * Note: there is no need to check the shared locks on parents/models since an element cannot hold the exclusive lock without first obtaining them.\n   * Called by functions like [[Element.onUpdate]], [[Element.onDelete]], etc.\n   */\n  checkExclusiveLock(id: Id64String, type: string, operation: string): void;\n\n  /**\n   * Throw if locks are required and a shared lock is not held on the supplied element.\n   * Called by [[Element.onInsert]] to ensure shared lock is held on the new element's model and parent element.\n   */\n  checkSharedLock(id: Id64String, type: string, operation: string): void;\n\n  /**\n   * Determine whether the owning iModel currently holds the exclusive lock on the specified element.\n   */\n  holdsExclusiveLock(id: Id64String): boolean;\n\n  /**\n   * Determine whether the owning iModel currently holds a shared lock on the specified element.\n   */\n  holdsSharedLock(id: Id64String): boolean;\n\n  /**\n   * Acquire locks on one or more elements from the lock server, if required and not already held.\n   * If any required lock is not available, this method throws an exception and *none* of the requested locks are acquired.\n   * @note Acquiring the exclusive lock on an element requires also obtaining a shared lock on all its owner elements. This method will\n   * attempt to acquire all necessary locks for both sets of input ids.\n   * @note Calling this method after reversing or reinstating a Txn indicates the start of a brand new Txn with the current Txn ID,\n   * making it invalid to call [[abandonLocksForReversedTxn]] or [[acquireLocksForReinstatingTxn]] for previously-reversed\n   * Txns with the current ID or greater.\n   */\n  acquireLocks(arg: {\n    /** if present, one or more elements to obtain shared lock */\n    shared?: Id64Arg;\n    /** if present, one or more elements to obtain exclusive lock */\n    exclusive?: Id64Arg;\n  }): Promise<void>;\n\n  /** Release all locks currently held by this briefcase from the lock server after editing the associated elements.\n   * This is typically done on your behalf by [[BriefcaseDb.pushChanges]].\n   * If you are abandoning changes instead of pushing them, you should call [[abandonAllLocks]] instead.\n   * You may want to do it manually when abandoning all of your briefcase's local changes.\n   * You cannot release your locks if your briefcase contains local changes.\n   * @throws Error if the briefcase has local changes, or if any other error occurs while releasing the locks.\n   */\n  releaseAllLocks(): Promise<void>;\n\n  /**\n   * Abandons all locks currently held by this briefcase when none of the associated elements have\n   * been or will be modified. This is only valid to do when none of the elements protected by\n   * the currently-held locks have been edited, or if all edits have been reversed or abandoned without\n   * pushing them.\n   * @beta\n   *\n   * The locks are released on the IModelHub, but the changeset associated with the locks is not updated,\n   * reflecting the fact that the associated elements were not edited.\n   */\n  abandonAllLocks(): Promise<void>;\n\n  /**\n   * Release all locks currently held by this Briefcase from the lock server.\n   * Not possible to release locks unless push or abandon all changes. Should only be called internally.\n   * @internal\n   */\n  [_releaseAllLocks]: () => Promise<void>;\n\n  /**\n   * Abandons the locks that were acquired during a given Txn and all later Txns, all of which must already\n   * have been reversed.\n   * @beta\n   *\n   * @param txnId The ID of the first Txn whose locks should be abandoned. This must either be a Txn that has\n   * already been reversed, or the [[TxnManager.getCurrentTxnId]]. In either case, the current Txn must not\n   * have any unsaved changes.\n   * @returns A promise that resolves to true if any locks were successfully abandoned. False if there were no locks to abandon,\n   * which may be the case if the Txns did not acquire any locks or if they were already abandoned. The Promise rejects\n   * with an ITwinError if the Txn has not been reversed, the current Txn has unsaved changes, or if any other error occurs\n   * while releasing the locks.\n   * @note This method also implicitly calls [[abandonLocksForCurrentUnsavedTxn]]. Locks acquired in the current,\n   * unsaved Txn will be abandoned when calling this method. However, they can not be re-acquired using\n   * [[acquireLocksForReinstatingTxn]]. This is because there is no way to recover these unsaved changes after abandoning\n   * them, so it is rarely useful to re-acquire the locks associated with irrecoverable changes.\n   */\n  abandonLocksForReversedTxn(txnId: Id64String): Promise<boolean>;\n\n  /**\n   * Abandons the locks that were acquired during the current, unsaved Txn. Any changes in the unsaved Txn must be abandoned\n   * before calling this method.\n   * @beta\n   *\n   * @returns A promise that resolves to true if any locks were successfully abandoned. False if there were no locks to abandon,\n   * which may be the case if the current Txn did not acquire any locks or if they were already abandoned. The Promise rejects\n   * with an ITwinError if the current Txn has unsaved changes, or if any other error occurs while releasing the locks.\n   */\n  abandonLocksForCurrentUnsavedTxn(): Promise<boolean>;\n\n  /**\n   * Re-acquire the locks that were previously acquired during a given Txn and all previous Txns. These locks are\n   * expected to have previously been released with {@link LockControl.abandonLocksForReversedTxn}. This is used\n   * just before reinstating a previously-reversed Txn to ensure that the necessary locks are held for the\n   * reinstated changes.\n   * @beta\n   *\n   * It is possible that the locks may no longer be available, in which case the returned Promise will reject\n   * with an exception.\n   *\n   * @param txnId The ID of the last Txn whose locks should be re-acquired.\n   * @returns A promise that resolves to true if any locks were successfully acquired. False if there were no locks to acquire,\n   * which may be the case if the Txn in question did not acquire any locks or if they were already re-acquired. The Promise\n   * rejects with an ITwinError if the Txn does not exist, the current Txn has unsaved changes, the locks cannot be acquired,\n   * or if any other error occurs while acquiring the locks.\n   */\n  acquireLocksForReinstatingTxn(txnId: Id64String): Promise<boolean>;\n\n  /**\n   * Checks whether the locks originally acquired for a specified reversed Txn, and all earlier Txns, were either not abandoned\n   * or have already been re-acquired.\n   * @beta\n   *\n   * If this method returns true, it is safe to reinstate the given Txn with [[TxnManager.reinstateTxn]]. If it returns false,\n   * the necessary locks must be acquired first, either by calling [[TxnManager.reinstateTxnAsync]] or by explicitly calling\n   * [[acquireLocksForReinstatingTxn]] first.\n   *\n   * @param txnId The ID of the Txn to check.\n   * @returns True if the necessary locks are currently held, false otherwise.\n   */\n  holdsNecessaryLocksForReinstatingTxn(txnId: Id64String): boolean;\n\n  /**\n   * Clears the records of locks acquired for a given Txn and all later Txns from the local lock database. Call this after\n   * a Txn becomes unreachable. This allows an ID to potentially be reused for a different Txn in the future.\n   * @beta\n   *\n   * After invoking this method, {@link LockControl.abandonLocksForReversedTxn} and {@link LockControl.acquireLocksForReinstatingTxn} will no\n   * longer be able to operate on this Txn or any later Txns.\n   *\n   * @param txnId The ID of the first Txn whose lock records should be cleared.\n   */\n  clearTxnLockRecords(txnId: Id64String): void;\n}\n"]}

package/lib/esm/Material.d.ts

@@ -4,6 +4,7 @@
 import { Id64String } from "@itwin/core-bentley";
 import { Code, CodeScopeProps, ElementProps, NormalMapProps, RenderMaterialProps, RgbFactorProps, TextureMapProps } from "@itwin/core-common";
 import { DefinitionElement } from "./Element";
+import { EditTxn } from "./EditTxn";
 import { IModelDb } from "./IModelDb";
 import { IModelElementCloneContext } from "./IModelElementCloneContext";
 import { CustomHandledProperty, DeserializeEntityArgs, ECSqlRow } from "./Entity";
@@ -76,12 +77,18 @@ export declare class RenderMaterialElement extends DefinitionElement {
     static create(iModelDb: IModelDb, definitionModelId: Id64String, materialName: string, params: RenderMaterialElementParams): RenderMaterialElement;
     /**
      * Insert a new RenderMaterial into a model.
-     * @param iModelDb Insert into this iModel
+     * @param txn The EditTxn to use
      * @param definitionModelId Insert the new Texture into this DefinitionModel
      * @param materialName The name/CodeValue of the RenderMaterial
      * @param params Parameters object which describes how to construct the RenderMaterial
      * @returns The Id of the newly inserted RenderMaterial element.
      * @throws [[IModelError]] if unable to insert the element.
+     * @beta
+     */
+    static insert(txn: EditTxn, definitionModelId: Id64String, materialName: string, params: RenderMaterialElementParams): Id64String;
+    /**
+     * Insert a new RenderMaterial into a model.
+     * @deprecated Use RenderMaterialElement.insert(txn, ...) instead.
      */
     static insert(iModelDb: IModelDb, definitionModelId: Id64String, materialName: string, params: RenderMaterialElementParams): Id64String;
     /** @beta */

package/lib/esm/Material.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Material.d.ts","sourceRoot":"","sources":["../../src/Material.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Material.d.ts","sourceRoot":"","sources":["../../src/Material.ts"],"names":[],"mappings":"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"}

package/lib/esm/Material.js

@@ -8,6 +8,8 @@
 import { Id64, JsonUtils } from "@itwin/core-bentley";
 import { BisCodeSpec, Code, } from "@itwin/core-common";
 import { DefinitionElement } from "./Element";
+import { EditTxn } from "./EditTxn";
+import { _implicitTxn } from "./internal/Symbols";
 /* eslint-disable @typescript-eslint/naming-convention */
 /** A PhysicalMaterial defines the matter that makes up physical elements.
  * @note See [[RenderMaterialElement]] for the DefinitionElement used to define rendering characteristics.
@@ -178,18 +180,10 @@ export class RenderMaterialElement extends DefinitionElement {
         };
         return new RenderMaterialElement(renderMaterialProps, iModelDb);
     }
-    /**
-     * Insert a new RenderMaterial into a model.
-     * @param iModelDb Insert into this iModel
-     * @param definitionModelId Insert the new Texture into this DefinitionModel
-     * @param materialName The name/CodeValue of the RenderMaterial
-     * @param params Parameters object which describes how to construct the RenderMaterial
-     * @returns The Id of the newly inserted RenderMaterial element.
-     * @throws [[IModelError]] if unable to insert the element.
-     */
-    static insert(iModelDb, definitionModelId, materialName, params) {
-        const renderMaterial = this.create(iModelDb, definitionModelId, materialName, params);
-        return iModelDb.elements.insertElement(renderMaterial.toJSON());
+    static insert(txnOrDb, definitionModelId, materialName, params) {
+        const txn = txnOrDb instanceof EditTxn ? txnOrDb : txnOrDb[_implicitTxn];
+        const renderMaterial = this.create(txn.iModel, definitionModelId, materialName, params);
+        return renderMaterial.insert(txn);
     }
     /** @beta */
     static async onCloned(context, sourceProps, targetProps) {

package/lib/esm/Material.js.map

@@ -1 +1 @@
-{"version":3,"file":"Material.js","sourceRoot":"","sources":["../../src/Material.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAc,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EACL,WAAW,EAAE,IAAI,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAK9C,yDAAyD;AAEzD;;;GAGG;AACH,MAAM,OAAgB,gBAAiB,SAAQ,iBAAiB;IACvD,MAAM,KAAc,SAAS,KAAa,OAAO,kBAAkB,CAAC,CAAC,CAAC;IAC7E;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,iBAAiC,EAAE,IAAY;QACxF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;QACpF,OAAO,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IACD;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAA6B,QAAkB,EAAE,iBAAiC,EAAE,IAAY;QAClH,MAAM,YAAY,GAA2B;YAC3C,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,KAAK,EAAE,iBAAiB;YACxB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,CAAC;SACzD,CAAC;QACF,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACvD,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,iBAAiB;IACnD,MAAM,KAAc,SAAS,KAAa,OAAO,gBAAgB,CAAC,CAAC,CAAC;IAE3E,+EAA+E;IACxE,WAAW,CAAS;IAC3B,+CAA+C;IACxC,WAAW,CAAU;IAE5B,YAAoB,KAA0B,EAAE,MAAgB;QAC9D,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACvC,CAAC;IAEe,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAAyB,CAAC;QAClD,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACnC,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACnC,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACO,MAAM,CAAmB,mBAAmB,GAA4B;QAChF,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE;KACjD,CAAC;IAEF;;;;OAIG;IACI,MAAM,CAAU,WAAW,CAAC,KAA4B;QAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAwB,CAAC;QAChE,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC;QAC3B,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC/D,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAU,SAAS,CAAC,KAA0B,EAAE,MAAgB;QAC3E,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,UAAU,CAAC,MAAgB,EAAE,YAA4B,EAAE,IAAY;QACnF,MAAM,QAAQ,GAAa,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;QAClF,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACpH,CAAC;IACD;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,YAAoB,EAAE,MAAmC;QAC/H,IAAI,IAA8C,CAAC;QACnD,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC;QAC3C,IAAI,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAG1C,SAAS,MAAM,CAAyB,GAAW,EAAE,GAAM;gBACzD,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC;gBAC9B,IAAI,GAAG,IAAI,SAAS,KAAK,GAAG,CAAC,GAAG,CAAC;oBAC/B,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;qBACjB,IAAI,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;oBAC9D,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACrC,CAAC;YAED,MAAM,SAAS,GAAW,EAAE,CAAC;YAC7B,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;YACnC,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YAClC,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;YACnC,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;YACvC,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;YACrC,MAAM,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;YACpC,MAAM,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAC;YAC5C,MAAM,CAAC,SAAS,EAAE,iCAAiC,CAAC,CAAC;YACrD,MAAM,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAC;YAChD,MAAM,CAAC,SAAS,EAAE,sCAAsC,CAAC,CAAC;YAC1D,MAAM,CAAC,SAAS,EAAE,sCAAsC,CAAC,CAAC;YAE1D,IAAI,GAAG,EAAE,CAAC;YACV,IAAI,MAAM,CAAC,UAAU;gBACnB,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,UAAU,EAAE,GAAG,SAAS,EAAE,CAAC;YAExD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,IAAI,CAAC,MAAM,GAAG;oBACZ,GAAG,MAAM,CAAC,SAAS;oBACnB,GAAG,SAAS;iBACb,CAAC;gBAEF,OAAQ,IAAI,CAAC,MAAc,CAAC,KAAK,CAAC;YACpC,CAAC;QACH,CAAC;QAED,MAAM,mBAAmB,GAAwB;YAC/C,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,YAAY,CAAC;YAChE,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,cAAc,EAAE;gBACd,cAAc,EAAE;oBACd,cAAc,EAAE;wBACd,YAAY,EAAE,MAAM,CAAC,KAAK,KAAK,SAAS;wBACxC,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,gBAAgB,EAAE,MAAM,CAAC,aAAa,KAAK,SAAS;wBACpD,cAAc,EAAE,MAAM,CAAC,aAAa;wBACpC,SAAS,EAAE,MAAM,CAAC,MAAM,KAAK,SAAS;wBACtC,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,WAAW,EAAE,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;wBAC7D,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,UAAU,EAAE,MAAM,CAAC,OAAO,KAAK,SAAS;wBACxC,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,WAAW,EAAE,MAAM,CAAC,QAAQ,KAAK,SAAS;wBAC1C,QAAQ,EAAE,MAAM,CAAC,QAAQ;wBACzB,UAAU,EAAE,MAAM,CAAC,OAAO,KAAK,SAAS;wBACxC,OAAO,EAAE,MAAM,CAAC,OAAO;wBACvB,eAAe,EAAE,MAAM,CAAC,YAAY,KAAK,SAAS;wBAClD,aAAa,EAAE,MAAM,CAAC,YAAY;wBAClC,GAAG,EAAE,IAAI;wBACT,UAAU;qBACX;iBACF;aACF;YACD,KAAK,EAAE,iBAAiB;YACxB,SAAS,EAAE,KAAK;SACjB,CAAC;QAEF,OAAO,IAAI,qBAAqB,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM,CAAC,MAAM,CAAC,QAAkB,EAAE,iBAA6B,EAAE,YAAoB,EAAE,MAAmC;QAC/H,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QACtF,OAAO,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,YAAY;IACF,MAAM,CAAU,KAAK,CAAC,QAAQ,CAAC,OAAkC,EAAE,WAAyB,EAAE,WAAyB;QAC/H,MAAM,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;QACxD,KAAK,MAAM,OAAO,IAAI,WAAW,CAAC,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;YAC5F,IAAI,OAAO,OAAO,KAAK,QAAQ;gBAC7B,SAAS;YACX,MAAM,SAAS,GAAG,WAAW,CAAC,cAAc,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACxF,qEAAqE;YACrE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,WAAW,CAAC,cAAc,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;gBAClF,SAAS;YACX,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS;gBACzE,SAAS;YACX,WAAW,CAAC,cAAc,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,SAAS,GAAG,OAAO,CAAC,mBAAmB,CAAC,SAAS,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;QACrJ,CAAC;IACH,CAAC;;AAGH,cAAc;AACd,WAAiB,qBAAqB;IACpC;;;;OAIG;IACH,MAAa,MAAM;QACjB,mEAAmE;QAC5D,WAAW,CAAS;QAC3B,qDAAqD;QAC9C,WAAW,CAAU;QAC5B,iHAAiH;QAC1G,KAAK,CAAkB;QAC9B,kEAAkE;QAC3D,aAAa,CAAkB;QACtC;;WAEG;QACI,MAAM,CAAU;QACvB;;;;WAIG;QACI,QAAQ,CAAU;QACzB,wEAAwE;QACjE,OAAO,CAAU;QACxB,yEAAyE;QAClE,QAAQ,CAAU;QACzB,wBAAwB;QACjB,OAAO,CAAU;QACxB,wBAAwB;QACjB,YAAY,CAAY;QAC/B;;;WAGG;QACI,UAAU,CAAmB;QACpC;;;;WAIG;QACI,SAAS,CAKd;QAEF,gJAAgJ;QAChJ,YAAmB,WAAmB;YACpC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QACjC,CAAC;KACF;IAhDY,4BAAM,SAgDlB,CAAA;AACH,CAAC,EAvDgB,qBAAqB,KAArB,qBAAqB,QAuDrC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Elements\n */\n\nimport { Id64, Id64String, JsonUtils } from \"@itwin/core-bentley\";\nimport {\n  BisCodeSpec, Code, CodeScopeProps, CodeSpec, DefinitionElementProps, ElementProps, NormalMapProps, RenderMaterialAssetMapsProps, RenderMaterialProps, RgbFactorProps, TextureMapProps,\n} from \"@itwin/core-common\";\nimport { DefinitionElement } from \"./Element\";\nimport { IModelDb } from \"./IModelDb\";\nimport { IModelElementCloneContext } from \"./IModelElementCloneContext\";\nimport { CustomHandledProperty, DeserializeEntityArgs, ECSqlRow } from \"./Entity\";\n\n/* eslint-disable @typescript-eslint/naming-convention */\n\n/** A PhysicalMaterial defines the matter that makes up physical elements.\n * @note See [[RenderMaterialElement]] for the DefinitionElement used to define rendering characteristics.\n * @public\n */\nexport abstract class PhysicalMaterial extends DefinitionElement {\n  public static override get className(): string { return \"PhysicalMaterial\"; }\n  /** Create a Code for a PhysicalMaterial given a name that is meant to be unique within the scope of the specified DefinitionModel.\n   * @param iModel  The IModelDb\n   * @param definitionModelId The Id of the DefinitionModel that will contain the PhysicalMaterial and provide the scope for its name.\n   * @param name The name (codeValue) of the PhysicalMaterial\n   */\n  public static createCode(iModel: IModelDb, definitionModelId: CodeScopeProps, name: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.physicalMaterial);\n    return new Code({ spec: codeSpec.id, scope: definitionModelId, value: name });\n  }\n  /** Create a PhysicalMaterial\n   * @param iModelDb The IModelDb\n   * @param definitionModelId The Id of the DefinitionModel that will contain the PhysicalMaterial and provide the scope for its name.\n   * @param name The name (codeValue) of the PhysicalMaterial\n   * @returns The newly constructed PhysicalMaterial\n   * @throws [[IModelError]] if there is a problem creating the PhysicalMaterial\n   */\n  public static create<T extends PhysicalMaterial>(iModelDb: IModelDb, definitionModelId: CodeScopeProps, name: string): T {\n    const elementProps: DefinitionElementProps = {\n      classFullName: this.classFullName,\n      model: definitionModelId,\n      code: this.createCode(iModelDb, definitionModelId, name),\n    };\n    return iModelDb.elements.createElement(elementProps);\n  }\n}\n\n/** Defines a rendering material.\n * @note See [[PhysicalMaterial]] for the DefinitionElement used to define the matter that makes up physical elements.\n * @public\n */\nexport class RenderMaterialElement extends DefinitionElement {\n  public static override get className(): string { return \"RenderMaterial\"; }\n\n  /** The name of a palette that can be used to categorize multiple materials. */\n  public paletteName: string;\n  /** An optional description of the material. */\n  public description?: string;\n\n  private constructor(props: RenderMaterialProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.paletteName = props.paletteName;\n    this.description = props.description;\n  }\n\n  public override toJSON(): RenderMaterialProps {\n    const val = super.toJSON() as RenderMaterialProps;\n    val.paletteName = this.paletteName;\n    val.description = this.description;\n    return val;\n  }\n\n  /**\n   * RenderMaterialElement custom HandledProps includes 'paletteName'.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override readonly _customHandledProps: CustomHandledProperty[] = [\n    { propertyName: \"paletteName\", source: \"Class\" },\n  ];\n\n  /**\n   * RenderMaterialElement deserializes 'paletteName'.\n   * @inheritdoc\n   * @beta\n   */\n  public static override deserialize(props: DeserializeEntityArgs): RenderMaterialProps {\n    const elProps = super.deserialize(props) as RenderMaterialProps;\n    const instance = props.row;\n    elProps.paletteName = JsonUtils.asString(instance.paletteName);\n    return elProps;\n  }\n\n  /**\n   * RenderMaterialElement serializes 'paletteName'.\n   * @inheritdoc\n   * @beta\n   */\n  public static override serialize(props: RenderMaterialProps, iModel: IModelDb): ECSqlRow {\n    const inst = super.serialize(props, iModel);\n    inst.paletteName = props.paletteName;\n    return inst;\n  }\n\n  /** Create a Code for a RenderMaterial given a name that is meant to be unique within the scope of the specified DefinitionModel.\n   * @param iModel  The IModelDb\n   * @param scopeModelId The Id of the DefinitionModel that contains the RenderMaterial and provides the scope for its name.\n   * @param name The RenderMaterial name\n   */\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, name: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.renderMaterial);\n    return 0 === name.length ? Code.createEmpty() : new Code({ spec: codeSpec.id, scope: scopeModelId, value: name });\n  }\n  /**\n   * Create a RenderMaterial with given parameters.\n   * @param iModelDb The iModel\n   * @param definitionModelId The [[DefinitionModel]]\n   * @param materialName The name/CodeValue of the RenderMaterial\n   * @param params Parameters object which describes how to construct the RenderMaterial\n   * @returns The newly constructed RenderMaterial element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, materialName: string, params: RenderMaterialElementParams): RenderMaterialElement {\n    let maps: RenderMaterialAssetMapsProps | undefined;\n    const pbr_normal = params.normalMap?.scale;\n    if (params.patternMap || params.normalMap) {\n      // If both normal and pattern map are present, their texture mapping modes, angles, scales, etc are expected to match.\n      type TexMap = Omit<TextureMapProps, \"TextureId\">;\n      function choose<K extends keyof TexMap>(obj: TexMap, key: K): void {\n        const pat = params.patternMap;\n        if (pat && undefined !== pat[key])\n          obj[key] = pat[key];\n        else if (params.normalMap && undefined !== params.normalMap[key])\n          obj[key] = params.normalMap[key];\n      }\n\n      const baseProps: TexMap = {};\n      choose(baseProps, \"pattern_angle\");\n      choose(baseProps, \"pattern_u_flip\");\n      choose(baseProps, \"pattern_flip\");\n      choose(baseProps, \"pattern_scale\");\n      choose(baseProps, \"pattern_offset\");\n      choose(baseProps, \"pattern_scalemode\");\n      choose(baseProps, \"pattern_mapping\");\n      choose(baseProps, \"pattern_weight\");\n      choose(baseProps, \"pattern_useconstantlod\");\n      choose(baseProps, \"pattern_constantlod_repetitions\");\n      choose(baseProps, \"pattern_constantlod_offset\");\n      choose(baseProps, \"pattern_constantlod_mindistanceclamp\");\n      choose(baseProps, \"pattern_constantlod_maxdistanceclamp\");\n\n      maps = {};\n      if (params.patternMap)\n        maps.Pattern = { ...params.patternMap, ...baseProps };\n\n      if (params.normalMap) {\n        maps.Normal = {\n          ...params.normalMap,\n          ...baseProps,\n        };\n\n        delete (maps.Normal as any).scale;\n      }\n    }\n\n    const renderMaterialProps: RenderMaterialProps = {\n      classFullName: this.classFullName,\n      code: this.createCode(iModelDb, definitionModelId, materialName),\n      paletteName: params.paletteName,\n      description: params.description,\n      jsonProperties: {\n        materialAssets: {\n          renderMaterial: {\n            HasBaseColor: params.color !== undefined,\n            color: params.color,\n            HasSpecularColor: params.specularColor !== undefined,\n            specular_color: params.specularColor,\n            HasFinish: params.finish !== undefined,\n            finish: params.finish,\n            HasTransmit: params.transmit !== undefined ? true : undefined,\n            transmit: params.transmit,\n            HasDiffuse: params.diffuse !== undefined,\n            diffuse: params.diffuse,\n            HasSpecular: params.specular !== undefined,\n            specular: params.specular,\n            HasReflect: params.reflect !== undefined,\n            reflect: params.reflect,\n            HasReflectColor: params.reflectColor !== undefined,\n            reflect_color: params.reflectColor,\n            Map: maps,\n            pbr_normal,\n          },\n        },\n      },\n      model: definitionModelId,\n      isPrivate: false,\n    };\n\n    return new RenderMaterialElement(renderMaterialProps, iModelDb);\n  }\n\n  /**\n   * Insert a new RenderMaterial into a model.\n   * @param iModelDb Insert into this iModel\n   * @param definitionModelId Insert the new Texture into this DefinitionModel\n   * @param materialName The name/CodeValue of the RenderMaterial\n   * @param params Parameters object which describes how to construct the RenderMaterial\n   * @returns The Id of the newly inserted RenderMaterial element.\n   * @throws [[IModelError]] if unable to insert the element.\n   */\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, materialName: string, params: RenderMaterialElementParams): Id64String {\n    const renderMaterial = this.create(iModelDb, definitionModelId, materialName, params);\n    return iModelDb.elements.insertElement(renderMaterial.toJSON());\n  }\n\n  /** @beta */\n  protected static override async onCloned(context: IModelElementCloneContext, sourceProps: ElementProps, targetProps: ElementProps) {\n    await super.onCloned(context, sourceProps, targetProps);\n    for (const mapName in sourceProps.jsonProperties?.materialAssets?.renderMaterial?.Map ?? {}) {\n      if (typeof mapName !== \"string\")\n        continue;\n      const sourceMap = sourceProps.jsonProperties.materialAssets.renderMaterial.Map[mapName];\n      // sourceMap could be null/undefined, keep it the same in targetProps\n      if (!sourceMap) {\n        targetProps.jsonProperties.materialAssets.renderMaterial.Map[mapName] = sourceMap;\n        continue;\n      }\n      if (!Id64.isValid(sourceMap.TextureId) || sourceMap.TextureId === undefined)\n        continue;\n      targetProps.jsonProperties.materialAssets.renderMaterial.Map[mapName].TextureId = context.findTargetElementId(sourceMap.TextureId ?? Id64.invalid);\n    }\n  }\n}\n\n/** @public */\nexport namespace RenderMaterialElement {\n  /** Parameters used to construct a [[RenderMaterial]].\n   * The persistent JSON representation - [RenderMaterialAssetProps]($common) - is quite verbose and unwieldy. This representation simplifies it somewhat.\n   * @see [[RenderMaterialElement.create]] and [[RenderMaterialElement.insert]] to create a [[RenderMaterial]] from parameters of this type.\n   * @deprecated in 3.6 - might be removed in next major version. Because it is not useful to use a `class` - just use [[RenderMaterialElementParams]] directly instead.\n   */\n  export class Params {\n    /** A required palette name that categorizes this RenderMaterial */\n    public paletteName: string;\n    /** An optional description of this RenderMaterial */\n    public description?: string;\n    /** If defined, the color to use for surface fill or diffuse illumination, overriding the surface's own color. */\n    public color?: RgbFactorProps;\n    /** The color to use for specular illumination. Default: black. */\n    public specularColor?: RgbFactorProps;\n    /** The specular exponent describing the surface's shininess, in the range 0 through 128.\n     * Default: 0.\n     */\n    public finish?: number;\n    /** A transparency to be applied to the surface, ranging from 0 (fully opaque) to 1 (fully transparent).\n     * If defined, then the material transparency overrides the transparency of whatever surface the material is applied to.\n     * If undefined, the material has no effect on surface transparency.\n     * Default: undefined.\n     */\n    public transmit?: number;\n    /** The surface's diffuse reflectivity from 0.0 to 1.0. Default: 0.6. */\n    public diffuse?: number;\n    /** The surface's specular reflectivity from 0.0 to 1.0. Default: 0.0. */\n    public specular?: number;\n    /** Currently unused. */\n    public reflect?: number;\n    /** Currently unused. */\n    public reflectColor?: number[];\n    /** Specifies a texture image to map onto the surface, replacing or mixing with the surface's own color and transparency.\n     * @note With the exception of `TextureId`, the [TextureMapProps]($common) of [[patternMap]] and [[normalMap]] are expected to be identical. If a property is defined in both\n     * [[patternMap]]] and [[normalMap]], the value in [[patternMap]] takes precedence.\n     */\n    public patternMap?: TextureMapProps;\n    /** Specifies a [normal map](https://en.wikipedia.org/wiki/Normal_mapping) to apply to the surface to simulate more surface detail than is present in the\n     * surface's geometry.\n     * @note With the exception of `TextureId`, the [TextureMapProps]($common) of [[patternMap]] and [[normalMap]] are expected to be identical. If a property is defined in both\n     * [[patternMap]]] and [[normalMap]], the value in [[patternMap]] takes precedence.\n     */\n    public normalMap?: NormalMapProps & {\n      /** A factor by which to multiply the components of the normal vectors read from the texture.\n       * Default: 1.\n       */\n      scale?: number;\n    };\n\n    /** Construct a new RenderMaterial.Params object with the specified paletteName. Alter the public members on that object to specify settings. */\n    public constructor(paletteName: string) {\n      this.paletteName = paletteName;\n    }\n  }\n}\n\n/** Parameters used to create a [[RenderMaterial]] element.\n * The persistent JSON representation - [RenderMaterialAssetProps]($common) - is quite verbose and unwieldy. This representation simplifies it somewhat.\n * @see [[RenderMaterialElement.create]] and [[RenderMaterialElement.insert]] to create a [[RenderMaterial]] from parameters of this type.\n * @public\n */\nexport interface RenderMaterialElementParams extends RenderMaterialElement.Params { // eslint-disable-line @typescript-eslint/no-deprecated, @typescript-eslint/no-empty-object-type\n}\n"]}
+{"version":3,"file":"Material.js","sourceRoot":"","sources":["../../src/Material.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Elements\n */\n\nimport { Id64, Id64String, JsonUtils } from \"@itwin/core-bentley\";\nimport {\n  BisCodeSpec, Code, CodeScopeProps, CodeSpec, DefinitionElementProps, ElementProps, NormalMapProps, RenderMaterialAssetMapsProps, RenderMaterialProps, RgbFactorProps, TextureMapProps,\n} from \"@itwin/core-common\";\nimport { DefinitionElement } from \"./Element\";\nimport { EditTxn } from \"./EditTxn\";\nimport { IModelDb } from \"./IModelDb\";\nimport { IModelElementCloneContext } from \"./IModelElementCloneContext\";\nimport { CustomHandledProperty, DeserializeEntityArgs, ECSqlRow } from \"./Entity\";\nimport { _implicitTxn } from \"./internal/Symbols\";\n\n/* eslint-disable @typescript-eslint/naming-convention */\n\n/** A PhysicalMaterial defines the matter that makes up physical elements.\n * @note See [[RenderMaterialElement]] for the DefinitionElement used to define rendering characteristics.\n * @public\n */\nexport abstract class PhysicalMaterial extends DefinitionElement {\n  public static override get className(): string { return \"PhysicalMaterial\"; }\n  /** Create a Code for a PhysicalMaterial given a name that is meant to be unique within the scope of the specified DefinitionModel.\n   * @param iModel  The IModelDb\n   * @param definitionModelId The Id of the DefinitionModel that will contain the PhysicalMaterial and provide the scope for its name.\n   * @param name The name (codeValue) of the PhysicalMaterial\n   */\n  public static createCode(iModel: IModelDb, definitionModelId: CodeScopeProps, name: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.physicalMaterial);\n    return new Code({ spec: codeSpec.id, scope: definitionModelId, value: name });\n  }\n  /** Create a PhysicalMaterial\n   * @param iModelDb The IModelDb\n   * @param definitionModelId The Id of the DefinitionModel that will contain the PhysicalMaterial and provide the scope for its name.\n   * @param name The name (codeValue) of the PhysicalMaterial\n   * @returns The newly constructed PhysicalMaterial\n   * @throws [[IModelError]] if there is a problem creating the PhysicalMaterial\n   */\n  public static create<T extends PhysicalMaterial>(iModelDb: IModelDb, definitionModelId: CodeScopeProps, name: string): T {\n    const elementProps: DefinitionElementProps = {\n      classFullName: this.classFullName,\n      model: definitionModelId,\n      code: this.createCode(iModelDb, definitionModelId, name),\n    };\n    return iModelDb.elements.createElement(elementProps);\n  }\n}\n\n/** Defines a rendering material.\n * @note See [[PhysicalMaterial]] for the DefinitionElement used to define the matter that makes up physical elements.\n * @public\n */\nexport class RenderMaterialElement extends DefinitionElement {\n  public static override get className(): string { return \"RenderMaterial\"; }\n\n  /** The name of a palette that can be used to categorize multiple materials. */\n  public paletteName: string;\n  /** An optional description of the material. */\n  public description?: string;\n\n  private constructor(props: RenderMaterialProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.paletteName = props.paletteName;\n    this.description = props.description;\n  }\n\n  public override toJSON(): RenderMaterialProps {\n    const val = super.toJSON() as RenderMaterialProps;\n    val.paletteName = this.paletteName;\n    val.description = this.description;\n    return val;\n  }\n\n  /**\n   * RenderMaterialElement custom HandledProps includes 'paletteName'.\n   * @inheritdoc\n   * @beta\n   */\n  protected static override readonly _customHandledProps: CustomHandledProperty[] = [\n    { propertyName: \"paletteName\", source: \"Class\" },\n  ];\n\n  /**\n   * RenderMaterialElement deserializes 'paletteName'.\n   * @inheritdoc\n   * @beta\n   */\n  public static override deserialize(props: DeserializeEntityArgs): RenderMaterialProps {\n    const elProps = super.deserialize(props) as RenderMaterialProps;\n    const instance = props.row;\n    elProps.paletteName = JsonUtils.asString(instance.paletteName);\n    return elProps;\n  }\n\n  /**\n   * RenderMaterialElement serializes 'paletteName'.\n   * @inheritdoc\n   * @beta\n   */\n  public static override serialize(props: RenderMaterialProps, iModel: IModelDb): ECSqlRow {\n    const inst = super.serialize(props, iModel);\n    inst.paletteName = props.paletteName;\n    return inst;\n  }\n\n  /** Create a Code for a RenderMaterial given a name that is meant to be unique within the scope of the specified DefinitionModel.\n   * @param iModel  The IModelDb\n   * @param scopeModelId The Id of the DefinitionModel that contains the RenderMaterial and provides the scope for its name.\n   * @param name The RenderMaterial name\n   */\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, name: string): Code {\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.renderMaterial);\n    return 0 === name.length ? Code.createEmpty() : new Code({ spec: codeSpec.id, scope: scopeModelId, value: name });\n  }\n  /**\n   * Create a RenderMaterial with given parameters.\n   * @param iModelDb The iModel\n   * @param definitionModelId The [[DefinitionModel]]\n   * @param materialName The name/CodeValue of the RenderMaterial\n   * @param params Parameters object which describes how to construct the RenderMaterial\n   * @returns The newly constructed RenderMaterial element.\n   * @throws [[IModelError]] if unable to create the element.\n   */\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, materialName: string, params: RenderMaterialElementParams): RenderMaterialElement {\n    let maps: RenderMaterialAssetMapsProps | undefined;\n    const pbr_normal = params.normalMap?.scale;\n    if (params.patternMap || params.normalMap) {\n      // If both normal and pattern map are present, their texture mapping modes, angles, scales, etc are expected to match.\n      type TexMap = Omit<TextureMapProps, \"TextureId\">;\n      function choose<K extends keyof TexMap>(obj: TexMap, key: K): void {\n        const pat = params.patternMap;\n        if (pat && undefined !== pat[key])\n          obj[key] = pat[key];\n        else if (params.normalMap && undefined !== params.normalMap[key])\n          obj[key] = params.normalMap[key];\n      }\n\n      const baseProps: TexMap = {};\n      choose(baseProps, \"pattern_angle\");\n      choose(baseProps, \"pattern_u_flip\");\n      choose(baseProps, \"pattern_flip\");\n      choose(baseProps, \"pattern_scale\");\n      choose(baseProps, \"pattern_offset\");\n      choose(baseProps, \"pattern_scalemode\");\n      choose(baseProps, \"pattern_mapping\");\n      choose(baseProps, \"pattern_weight\");\n      choose(baseProps, \"pattern_useconstantlod\");\n      choose(baseProps, \"pattern_constantlod_repetitions\");\n      choose(baseProps, \"pattern_constantlod_offset\");\n      choose(baseProps, \"pattern_constantlod_mindistanceclamp\");\n      choose(baseProps, \"pattern_constantlod_maxdistanceclamp\");\n\n      maps = {};\n      if (params.patternMap)\n        maps.Pattern = { ...params.patternMap, ...baseProps };\n\n      if (params.normalMap) {\n        maps.Normal = {\n          ...params.normalMap,\n          ...baseProps,\n        };\n\n        delete (maps.Normal as any).scale;\n      }\n    }\n\n    const renderMaterialProps: RenderMaterialProps = {\n      classFullName: this.classFullName,\n      code: this.createCode(iModelDb, definitionModelId, materialName),\n      paletteName: params.paletteName,\n      description: params.description,\n      jsonProperties: {\n        materialAssets: {\n          renderMaterial: {\n            HasBaseColor: params.color !== undefined,\n            color: params.color,\n            HasSpecularColor: params.specularColor !== undefined,\n            specular_color: params.specularColor,\n            HasFinish: params.finish !== undefined,\n            finish: params.finish,\n            HasTransmit: params.transmit !== undefined ? true : undefined,\n            transmit: params.transmit,\n            HasDiffuse: params.diffuse !== undefined,\n            diffuse: params.diffuse,\n            HasSpecular: params.specular !== undefined,\n            specular: params.specular,\n            HasReflect: params.reflect !== undefined,\n            reflect: params.reflect,\n            HasReflectColor: params.reflectColor !== undefined,\n            reflect_color: params.reflectColor,\n            Map: maps,\n            pbr_normal,\n          },\n        },\n      },\n      model: definitionModelId,\n      isPrivate: false,\n    };\n\n    return new RenderMaterialElement(renderMaterialProps, iModelDb);\n  }\n\n  /**\n   * Insert a new RenderMaterial into a model.\n   * @param txn The EditTxn to use\n   * @param definitionModelId Insert the new Texture into this DefinitionModel\n   * @param materialName The name/CodeValue of the RenderMaterial\n   * @param params Parameters object which describes how to construct the RenderMaterial\n   * @returns The Id of the newly inserted RenderMaterial element.\n   * @throws [[IModelError]] if unable to insert the element.\n   * @beta\n   */\n  public static insert(txn: EditTxn, definitionModelId: Id64String, materialName: string, params: RenderMaterialElementParams): Id64String;\n  /**\n   * Insert a new RenderMaterial into a model.\n   * @deprecated Use RenderMaterialElement.insert(txn, ...) instead.\n   */\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, materialName: string, params: RenderMaterialElementParams): Id64String;\n  public static insert(txnOrDb: EditTxn | IModelDb, definitionModelId: Id64String, materialName: string, params: RenderMaterialElementParams): Id64String {\n    const txn = txnOrDb instanceof EditTxn ? txnOrDb : txnOrDb[_implicitTxn];\n    const renderMaterial = this.create(txn.iModel, definitionModelId, materialName, params);\n    return renderMaterial.insert(txn);\n  }\n\n  /** @beta */\n  protected static override async onCloned(context: IModelElementCloneContext, sourceProps: ElementProps, targetProps: ElementProps) {\n    await super.onCloned(context, sourceProps, targetProps);\n    for (const mapName in sourceProps.jsonProperties?.materialAssets?.renderMaterial?.Map ?? {}) {\n      if (typeof mapName !== \"string\")\n        continue;\n      const sourceMap = sourceProps.jsonProperties.materialAssets.renderMaterial.Map[mapName];\n      // sourceMap could be null/undefined, keep it the same in targetProps\n      if (!sourceMap) {\n        targetProps.jsonProperties.materialAssets.renderMaterial.Map[mapName] = sourceMap;\n        continue;\n      }\n      if (!Id64.isValid(sourceMap.TextureId) || sourceMap.TextureId === undefined)\n        continue;\n      targetProps.jsonProperties.materialAssets.renderMaterial.Map[mapName].TextureId = context.findTargetElementId(sourceMap.TextureId ?? Id64.invalid);\n    }\n  }\n}\n\n/** @public */\nexport namespace RenderMaterialElement {\n  /** Parameters used to construct a [[RenderMaterial]].\n   * The persistent JSON representation - [RenderMaterialAssetProps]($common) - is quite verbose and unwieldy. This representation simplifies it somewhat.\n   * @see [[RenderMaterialElement.create]] and [[RenderMaterialElement.insert]] to create a [[RenderMaterial]] from parameters of this type.\n   * @deprecated in 3.6 - might be removed in next major version. Because it is not useful to use a `class` - just use [[RenderMaterialElementParams]] directly instead.\n   */\n  export class Params {\n    /** A required palette name that categorizes this RenderMaterial */\n    public paletteName: string;\n    /** An optional description of this RenderMaterial */\n    public description?: string;\n    /** If defined, the color to use for surface fill or diffuse illumination, overriding the surface's own color. */\n    public color?: RgbFactorProps;\n    /** The color to use for specular illumination. Default: black. */\n    public specularColor?: RgbFactorProps;\n    /** The specular exponent describing the surface's shininess, in the range 0 through 128.\n     * Default: 0.\n     */\n    public finish?: number;\n    /** A transparency to be applied to the surface, ranging from 0 (fully opaque) to 1 (fully transparent).\n     * If defined, then the material transparency overrides the transparency of whatever surface the material is applied to.\n     * If undefined, the material has no effect on surface transparency.\n     * Default: undefined.\n     */\n    public transmit?: number;\n    /** The surface's diffuse reflectivity from 0.0 to 1.0. Default: 0.6. */\n    public diffuse?: number;\n    /** The surface's specular reflectivity from 0.0 to 1.0. Default: 0.0. */\n    public specular?: number;\n    /** Currently unused. */\n    public reflect?: number;\n    /** Currently unused. */\n    public reflectColor?: number[];\n    /** Specifies a texture image to map onto the surface, replacing or mixing with the surface's own color and transparency.\n     * @note With the exception of `TextureId`, the [TextureMapProps]($common) of [[patternMap]] and [[normalMap]] are expected to be identical. If a property is defined in both\n     * [[patternMap]]] and [[normalMap]], the value in [[patternMap]] takes precedence.\n     */\n    public patternMap?: TextureMapProps;\n    /** Specifies a [normal map](https://en.wikipedia.org/wiki/Normal_mapping) to apply to the surface to simulate more surface detail than is present in the\n     * surface's geometry.\n     * @note With the exception of `TextureId`, the [TextureMapProps]($common) of [[patternMap]] and [[normalMap]] are expected to be identical. If a property is defined in both\n     * [[patternMap]]] and [[normalMap]], the value in [[patternMap]] takes precedence.\n     */\n    public normalMap?: NormalMapProps & {\n      /** A factor by which to multiply the components of the normal vectors read from the texture.\n       * Default: 1.\n       */\n      scale?: number;\n    };\n\n    /** Construct a new RenderMaterial.Params object with the specified paletteName. Alter the public members on that object to specify settings. */\n    public constructor(paletteName: string) {\n      this.paletteName = paletteName;\n    }\n  }\n}\n\n/** Parameters used to create a [[RenderMaterial]] element.\n * The persistent JSON representation - [RenderMaterialAssetProps]($common) - is quite verbose and unwieldy. This representation simplifies it somewhat.\n * @see [[RenderMaterialElement.create]] and [[RenderMaterialElement.insert]] to create a [[RenderMaterial]] from parameters of this type.\n * @public\n */\nexport interface RenderMaterialElementParams extends RenderMaterialElement.Params { // eslint-disable-line @typescript-eslint/no-deprecated, @typescript-eslint/no-empty-object-type\n}\n"]}