@itwin/core-frontend 3.2.0-dev.9 → 3.3.0-dev.0

package/lib/cjs/render/GraphicBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"GraphicBuilder.js","sourceRoot":"","sources":["../../../src/render/GraphicBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { Id64String } from \"@itwin/core-bentley\";\r\nimport {\r\n  AnyCurvePrimitive, Arc3d, Loop, Path, Point2d, Point3d, Polyface, Range3d, SolidPrimitive, Transform,\r\n} from \"@itwin/core-geometry\";\r\nimport { AnalysisStyle, ColorDef, Frustum, GraphicParams, LinePixels, Npc } from \"@itwin/core-common\";\r\nimport { IModelConnection } from \"../IModelConnection\";\r\nimport { Viewport } from \"../Viewport\";\r\nimport { RenderGraphic } from \"./RenderGraphic\";\r\nimport { GraphicPrimitive } from \"./GraphicPrimitive\";\r\n\r\n/**\r\n * Describes the type of a [[GraphicBuilder]], which defines the coordinate system in which the builder's geometry is defined and\r\n * controls the behavior of the [[RenderGraphic]] produced by the builder.\r\n * @note For those types for which depth-testing is disabled, the order in which the individual geometric primitives are drawn determines which geometry draws on top of other geometry.\r\n *  - Within a [[GraphicList]], each [[RenderGraphic]] is rendered in the order in which it appears in the list; and\r\n *  - Within a single [[RenderGraphic]], each geometric primitive is rendered in the ordered in which it was added to the GraphicBuilder.\r\n * @public\r\n */\r\nexport enum GraphicType {\r\n  /**\r\n   * Renders behind all other graphics. For example, the border of a [[SheetViewState]] is of this type.\r\n   * Coordinates: [[CoordSystem.View]].\r\n   * [[RenderMode]]: [[RenderMode.SmoothShade]].\r\n   * Lighting: none.\r\n   * Depth-testing: disabled.\r\n   * @see [[Decorations.viewBackground]]\r\n   */\r\n  ViewBackground,\r\n  /** Used for the scene itself, dynamics, and 'normal' decorations. */\r\n  /**\r\n   * Renders as if it were part of the scene. All of the [[ViewFlags]] applied to the view's normal geometry also applies to these types of decorations.\r\n   * Coordinates: [[CoordSystem.World]].\r\n   * Lighting and [[RenderMode]]: from view.\r\n   * Depth-testing: enabled.\r\n   * @see [[Decorations.normal]].\r\n   */\r\n  Scene,\r\n  /** Renders within the scene. Coordinates: world. RenderMode: smooth. Lighting: default. Z-testing: enabled */\r\n  /** Renders within the scene, but ignores the view's [[ViewFlags]].\r\n   * Coordinates: [[CoordSystem.World]].\r\n   * Lighting: default.\r\n   * [[RenderMode]]: [[RenderMode.SmoothShade]].\r\n   * Depth-testing: enabled.\r\n   * @see [[Decorations.world]].\r\n   */\r\n  WorldDecoration,\r\n  /**\r\n   * Renders as an overlay on top of the scene. These decorations differ from [[GraphicType.WorldDecoration]] only in that depth-testing is disabled.\r\n   * For example, the ACS triad and [[WindowAreaTool]] decorations are of this type.\r\n   * Coordinates: [[CoordSystem.World]].\r\n   * [[RenderMode]]: [[RenderMode.SmoothShade]]\r\n   * Lighting: default.\r\n   * Depth-testing: disabled.\r\n   * Renders atop the scene. Coordinates: world. RenderMode: smooth. Lighting: none. Z-testing: disabled\r\n   * @note Overlay decorations typically employ some degree of transparency to ensure that they do not fully obscure the scene.\r\n   * @see [[Decorations.worldOverlay]]\r\n   */\r\n  WorldOverlay,\r\n  /**\r\n   * Renders as an overlay on top of the scene. These decorations differ from [[GraphicType.WorldOverlay]] only in that their geometry is defined in view coordinates rather than world.\r\n   * Coordinates: [[CoordSystem.View]].\r\n   * [[RenderMode]]: [[RenderMode.SmoothShade]]\r\n   * Lighting: default.\r\n   * Depth-testing: disabled.\r\n   * @note For more flexibility in defining view overlay decorations, consider using a [[CanvasDecorationList]].\r\n   * @see [[Decorations.viewOverlay]]\r\n   */\r\n  ViewOverlay,\r\n}\r\n\r\n/** Options used when constructing a `Batch` - that is, a [[RenderGraphic]] with an associated [FeatureTable]($common) describing individual [Feature]($common)s within the\r\n * graphic. Individual features can be resymbolized in a variety of ways including flashing and hiliting.\r\n * For example, to prevent graphics produced by [[readElementGraphics]] from being hilited when their corresponding element is in the [[SelectionSet]],\r\n * pass `{ noHilite: true }` to [[readElementGraphics]].\r\n * @public\r\n */\r\nexport interface BatchOptions {\r\n  /** Identifies the [[Tile]] associated with the batch, chiefly for debugging purposes.\r\n   * @beta\r\n   */\r\n  tileId?: string;\r\n  /** If true, features within the batch will not be flashed on mouseover. */\r\n  noFlash?: boolean;\r\n  /** If true, features within the batch will not be hilited when their corresponding element is in the [[SelectionSet]]. */\r\n  noHilite?: boolean;\r\n  /** If true, features within the batch will not be emphasized when the corresponding [[Feature]] is emphasized using [FeatureOverrides]($common). */\r\n  noEmphasis?: boolean;\r\n  /** If true, the contents of the batch will only be drawn by [[Viewport.readPixels]], not [[Viewport.renderFrame]], causing them to be locatable but invisible. */\r\n  locateOnly?: boolean;\r\n}\r\n\r\n/** Options used as part of [[GraphicBuilderOptions]] to describe a [pickable]($docs/learning/frontend/ViewDecorations#pickable-view-graphic-decorations) [[RenderGraphic]].\r\n * @public\r\n */\r\nexport interface PickableGraphicOptions extends BatchOptions {\r\n  /** Unique identifier for the graphic.\r\n   * @see [[IModelConnection.transientIds]] to obtain a unique Id in the context of an iModel.\r\n   */\r\n  id: Id64String;\r\n}\r\n\r\n/** Options for creating a [[GraphicBuilder]] used by functions like [[DecorateContext.createGraphic]] and [[RenderSystem.createGraphic]].\r\n * @see [[ViewportGraphicBuilderOptions]] to create a graphic builder for a [[Viewport]].\r\n * @see [[CustomGraphicBuilderOptions]] to create a graphic builder unassociated with any [[Viewport]].\r\n * @public\r\n */\r\nexport interface GraphicBuilderOptions {\r\n  /** The type of graphic to produce. */\r\n  type: GraphicType;\r\n\r\n  /** The local-to-world transform in which the builder's geometry is to be defined - by default, an identity transform. */\r\n  placement?: Transform;\r\n\r\n  /** If the graphic is to be pickable, specifies the pickable Id and other options. */\r\n  pickable?: PickableGraphicOptions;\r\n\r\n  /** If true, the order in which geometry is added to the builder is preserved.\r\n   * This is useful for overlay and background graphics because they draw without using the depth buffer. For example, to draw an overlay containing a red shape with a white outline,\r\n   * you would add the shape to the GraphicBuilder first, followed by the outline, to ensure the outline draws \"in front of\" the shape.\r\n   * It defaults to true for overlays and background graphics, and false for other graphic types.\r\n   * It is not useful for other types of graphics and imposes a performance penalty due to increased number of draw calls.\r\n   * For overlay and background graphics that do not need to draw in any particular order, the performance penalty can be eliminated by setting this to `false`.\r\n   */\r\n  preserveOrder?: boolean;\r\n\r\n  /** Controls whether normals are generated for surfaces. Normals allow 3d geometry to receive lighting; without them the geometry will be unaffected by lighting.\r\n   * By default, normals are generated only for graphics of type [[GraphicType.Scene]]; or for any type of graphic if [[GraphicBuilder.wantEdges]] is true, because\r\n   * normals are required to prevent z-fighting between surfaces and their edges. This default can be overridden by explicitly specifying `true` or `false`.\r\n   * @see [[GraphicType]] for a description of whether and how different types of graphics are affected by lighting.\r\n   */\r\n  wantNormals?: boolean;\r\n\r\n  /** Controls whether edges are generated for surfaces.\r\n   * Edges are only displayed if [ViewFlags.renderMode]($common) is not [RenderMode.SmoothShade]($common) or [ViewFlags.visibleEdges]($common) is `true`.\r\n   * Since all decoration graphics except [[GraphicType.Scene]] are drawn in smooth shaded mode with no visible edges, by default edges are only produced for scene graphics, and\r\n   * - if a [[Viewport]] is supplied with the options - only if [ViewFlags.edgesRequired]($common) is true for the viewport.\r\n   * That default can be overridden by explicitly specifying `true` or `false`. This can be useful for non-scene decorations contained in a [[GraphicBranch]] that applies [ViewFlagOverrides]($common)\r\n   * that change the edge display settings; or for scene decorations that might be cached for reuse after the viewport's edge settings are changed.\r\n   * @note Edges will tend to z-fight with their surfaces unless the graphic is [[pickable]].\r\n   */\r\n  generateEdges?: boolean;\r\n\r\n  /** If defined, specifies a point about which the graphic will rotate such that it always faces the viewer.\r\n   * This can be particular useful for planar regions to create a billboarding effect - e.g., to implement [[Marker]]-like WebGL decorations.\r\n   * The graphic's [[placement]] transform is not applied to the point.\r\n   * @note This has no effect for graphics displayed in a 2d view.\r\n   */\r\n  viewIndependentOrigin?: Point3d;\r\n}\r\n\r\n/** Options for creating a [[GraphicBuilder]] to produce a [[RenderGraphic]] to be displayed in a specific [[Viewport]].\r\n * The level of detail of the graphic will be computed from the position of its geometry within the viewport's [Frustum]($common).\r\n * Default values for [[GraphicBuilderOptions.wantNormals]] and [[GraphicBuilderOptions.generateEdges]] will be determined by the viewport's [ViewFlags]($common).\r\n * The [[GraphicBuilder.iModel]] will be set to the viewport's [[IModelConnection]].\r\n * @public\r\n */\r\nexport interface ViewportGraphicBuilderOptions extends GraphicBuilderOptions {\r\n  /** The viewport in which the resultant [[RenderGraphic]] is to be drawn. */\r\n  viewport: Viewport;\r\n\r\n  /** If true, [[ViewState.getAspectRatioSkew]] will be taken into account when computing the level of detail for the produced graphics. */\r\n  applyAspectRatioSkew?: boolean;\r\n\r\n  iModel?: never;\r\n  computeChordTolerance?: never;\r\n}\r\n\r\n/** Arguments used to compute the chord tolerance (level of detail) of the [[RenderGraphic]]s produced by a [[GraphicBuilder]].\r\n * Generally, the chord tolerance should be roughly equivalent to the size in meters of one pixel on screen where the graphic is to be displayed.\r\n * For [[GraphicType.ViewOverlay]] and [[GraphicType.ViewBackground]], which already define their geometry in pixels, the chord tolerance should typically be 1.\r\n * @see [[CustomGraphicBuilderOptions.computeChordTolerance]].\r\n * @public\r\n */\r\nexport interface ComputeChordToleranceArgs {\r\n  /** The graphic builder being used to produce the graphics. */\r\n  readonly graphic: GraphicBuilder;\r\n  /** A function that computes a range enclosing all of the geometry that was added to the builder. */\r\n  readonly computeRange: () => Range3d;\r\n}\r\n\r\n/** Options for creating a [[GraphicBuilder]] to produce a [[RenderGraphic]] that is not associated with any particular [[Viewport]] and may not be associated with\r\n * any particular [[IModelConnection]].\r\n * This is primarily useful when the same graphic is to be saved and reused for display in multiple viewports and for which a chord tolerance can be computed\r\n * independently of each viewport's [Frustum]($common).\r\n * @public\r\n */\r\nexport interface CustomGraphicBuilderOptions extends GraphicBuilderOptions {\r\n  /** Optionally, the IModelConnection with which the graphic is associated. */\r\n  iModel?: IModelConnection;\r\n  /** A function that can compute the level of detail for the graphics produced by the builder. */\r\n  computeChordTolerance: (args: ComputeChordToleranceArgs) => number;\r\n\r\n  applyAspectRatioSkew?: never;\r\n  viewport?: never;\r\n}\r\n\r\n/** Provides methods for constructing a [[RenderGraphic]] from geometric primitives.\r\n * GraphicBuilder is primarily used for creating [[Decorations]] to be displayed inside a [[Viewport]].\r\n *\r\n * The typical process for constructing a [[RenderGraphic]] proceeds as follows:\r\n *  1. Use [[DecorateContext.createGraphic]] or [[RenderSystem.createGraphic]] to obtain a builder.\r\n *  2. Set up the symbology using [[GraphicBuilder.activateGraphicParams]] or [[GraphicBuilder.setSymbology]].\r\n *  3. Add one or more geometric primitives using methods like [[GraphicBuilder.addShape]] and [[GraphicBuilder.addLineString]], possibly setting new symbology in between.\r\n *  4. Use [[GraphicBuilder.finish]] to produce the finished [[RenderGraphic]].\r\n *\r\n * @note Most of the methods which add geometry to the builder take ownership of their inputs rather than cloning them.\r\n * So, for example, if you pass an array of points to addLineString(), you should not subsequently modify that array.\r\n *\r\n * @public\r\n */\r\nexport abstract class GraphicBuilder {\r\n  /** The local coordinate system transform applied to this builder's geometry.\r\n   * @see [[GraphicBuilderOptions.placement]].\r\n   */\r\n  public readonly placement: Transform;\r\n\r\n  /** The iModel associated with this builder, if any. */\r\n  public readonly iModel?: IModelConnection;\r\n\r\n  /** The type of graphic to be produced by this builder.\r\n   * @see [[GraphicBuilderOptions.type]].\r\n   */\r\n  public readonly type: GraphicType;\r\n\r\n  /** If the graphic is to be pickable, specifies the pickable Id and other options. */\r\n  public readonly pickable?: Readonly<PickableGraphicOptions>;\r\n\r\n  /** If true, the order in which geometry is added to the builder is preserved.\r\n   * @see [[GraphicBuilderOptions.preserveOrder]] for more details.\r\n   */\r\n  public readonly preserveOrder: boolean;\r\n\r\n  /** Controls whether normals are generated for surfaces.\r\n   * @note Normals are required for proper edge display, so by default they are always produced if [[wantEdges]] is `true`.\r\n   * @see [[GraphicBuilderOptions.wantNormals]] for more details.\r\n   */\r\n  public readonly wantNormals: boolean;\r\n\r\n  /** Controls whether edges are generated for surfaces.\r\n   * @see [[GraphicBuilderOptions.generateEdges]] for more details.\r\n   */\r\n  public readonly wantEdges: boolean;\r\n\r\n  /** @alpha */\r\n  public readonly analysisStyle?: AnalysisStyle;\r\n\r\n  protected readonly _computeChordTolerance: (args: ComputeChordToleranceArgs) => number;\r\n  protected readonly _options: CustomGraphicBuilderOptions | ViewportGraphicBuilderOptions;\r\n\r\n  /** @internal */\r\n  protected constructor(options: ViewportGraphicBuilderOptions | CustomGraphicBuilderOptions) {\r\n    // Stored for potential use later in creating a new GraphicBuilder from this one (see PrimitiveBuilder.finishGraphic).\r\n    this._options = options;\r\n\r\n    const vp = options.viewport;\r\n    this.placement = options.placement ?? Transform.createIdentity();\r\n    this.iModel = vp?.iModel ?? options.iModel;\r\n    this.type = options.type;\r\n    this.pickable = options.pickable;\r\n    this.wantEdges = options.generateEdges ?? (this.type === GraphicType.Scene && (!vp || vp.viewFlags.edgesRequired()));\r\n    this.wantNormals = options.wantNormals ?? (this.wantEdges || this.type === GraphicType.Scene);\r\n    this.preserveOrder = options.preserveOrder ?? (this.isOverlay || this.isViewBackground);\r\n\r\n    if (!options.viewport) {\r\n      this._computeChordTolerance = options.computeChordTolerance;\r\n      return;\r\n    }\r\n\r\n    this.analysisStyle = options.viewport.displayStyle.settings.analysisStyle;\r\n\r\n    this._computeChordTolerance = (args: ComputeChordToleranceArgs) => {\r\n      let pixelSize = 1;\r\n      if (!this.isViewCoordinates) {\r\n        // Compute the horizontal distance in meters between two adjacent pixels at the center of the geometry.\r\n        pixelSize = options.viewport.getPixelSizeAtPoint(args.computeRange().center);\r\n        pixelSize = options.viewport.target.adjustPixelSizeForLOD(pixelSize);\r\n\r\n        // Aspect ratio skew > 1.0 stretches the view in Y. In that case use the smaller vertical pixel distance for our stroke tolerance.\r\n        const skew = options.applyAspectRatioSkew ? options.viewport.view.getAspectRatioSkew() : 0;\r\n        if (skew > 1)\r\n          pixelSize /= skew;\r\n      }\r\n\r\n      return pixelSize * 0.25;\r\n    };\r\n  }\r\n\r\n  /** The Id to be associated with the graphic for picking.\r\n   * @see [[GraphicBuilderOptions.pickable]] for more options.\r\n   */\r\n  public get pickId(): Id64String | undefined {\r\n    return this.pickable?.id;\r\n  }\r\n\r\n  /** Whether the builder's geometry is defined in [[CoordSystem.View]] coordinates.\r\n   * @see [[isWorldCoordinates]].\r\n   */\r\n  public get isViewCoordinates(): boolean {\r\n    return this.type === GraphicType.ViewBackground || this.type === GraphicType.ViewOverlay;\r\n  }\r\n\r\n  /** Whether the builder's geometry is defined in [[CoordSystem.World]] coordinates.\r\n   * @see [[isViewCoordinates]].\r\n   */\r\n  public get isWorldCoordinates(): boolean {\r\n    return !this.isViewCoordinates;\r\n  }\r\n\r\n  /** True if the builder produces a graphic of [[GraphicType.Scene]]. */\r\n  public get isSceneGraphic(): boolean {\r\n    return this.type === GraphicType.Scene;\r\n  }\r\n\r\n  /** True if the builder produces a graphic of [[GraphicType.ViewBackground]]. */\r\n  public get isViewBackground(): boolean {\r\n    return this.type === GraphicType.ViewBackground;\r\n  }\r\n\r\n  /** True if the builder produces a graphic of [[GraphicType.WorldOverlay]] or [[GraphicType.ViewOerlay]]. */\r\n  public get isOverlay(): boolean {\r\n    return this.type === GraphicType.ViewOverlay || this.type === GraphicType.WorldOverlay;\r\n  }\r\n\r\n  /**\r\n   * Processes the accumulated symbology and geometry to produce a renderable graphic.\r\n   * This function can only be called once; after the [[RenderGraphic]] has been extracted the [[GraphicBuilder]] should no longer be used.\r\n   */\r\n  public abstract finish(): RenderGraphic;\r\n\r\n  /** Sets the current active symbology for this builder. Any new geometry subsequently added to the builder will be drawn using the specified symbology.\r\n   * @param graphicParams The symbology to apply to subsequent geometry.\r\n   * @see [[GraphicBuilder.setSymbology]] for a convenient way to set common symbology options.\r\n   */\r\n  public abstract activateGraphicParams(graphicParams: GraphicParams): void;\r\n\r\n  /**\r\n   * Appends a 3d line string to the builder.\r\n   * @param points Array of vertices in the line string.\r\n   */\r\n  public abstract addLineString(points: Point3d[]): void;\r\n\r\n  /**\r\n   * Appends a 2d line string to the builder.\r\n   * @param points Array of vertices in the line string.\r\n   * @param zDepth Z value in local coordinates to use for each point.\r\n   */\r\n  public abstract addLineString2d(points: Point2d[], zDepth: number): void;\r\n\r\n  /**\r\n   * Appends a 3d point string to the builder. The points are drawn disconnected, with a diameter in pixels defined by the builder's active [[GraphicParams.rasterWidth]].\r\n   * @param points Array of vertices in the point string.\r\n   */\r\n  public abstract addPointString(points: Point3d[]): void;\r\n\r\n  /**\r\n   * Appends a 2d point string to the builder. The points are drawn disconnected, with a diameter in pixels defined by the builder's active [[GraphicParams.rasterWidth]].\r\n   * @param points Array of vertices in the point string.\r\n   * @param zDepth Z value in local coordinates to use for each point.\r\n   */\r\n  public abstract addPointString2d(points: Point2d[], zDepth: number): void;\r\n\r\n  /**\r\n   * Appends a closed 3d planar region to the builder.\r\n   * @param points Array of vertices of the shape.\r\n   */\r\n  public abstract addShape(points: Point3d[]): void;\r\n\r\n  /**\r\n   * Appends a closed 2d region to the builder.\r\n   * @param points Array of vertices of the shape.\r\n   * @param zDepth Z value in local coordinates to use for each point.\r\n   */\r\n  public abstract addShape2d(points: Point2d[], zDepth: number): void;\r\n\r\n  /**\r\n   * Appends a 3d open arc or closed ellipse to the builder.\r\n   * @param arc Description of the arc or ellipse.\r\n   * @param isEllipse If true, and if the arc defines a full sweep, then draw as a closed ellipse instead of an arc.\r\n   * @param filled If true, and isEllipse is also true, then draw ellipse filled.\r\n   */\r\n  public abstract addArc(arc: Arc3d, isEllipse: boolean, filled: boolean): void;\r\n\r\n  /**\r\n   * Appends a 2d open arc or closed ellipse to the builder.\r\n   * @param arc Description of the arc or ellipse.\r\n   * @param isEllipse If true, and if the arc defines a full sweep, then draw as a closed ellipse instead of an arc.\r\n   * @param filled If true, and isEllipse is also true, then draw ellipse filled.\r\n   * @param zDepth Z value in local coordinates to use for each point in the arc or ellipse.\r\n   */\r\n  public abstract addArc2d(ellipse: Arc3d, isEllipse: boolean, filled: boolean, zDepth: number): void;\r\n\r\n  /** Append a 3d open path to the builder. */\r\n  public abstract addPath(path: Path): void;\r\n\r\n  /** Append a 3d planar region to the builder. */\r\n  public abstract addLoop(loop: Loop): void;\r\n\r\n  /** Append a [CurvePrimitive]($core-geometry) to the builder. */\r\n  public addCurvePrimitive(curve: AnyCurvePrimitive): void {\r\n    switch (curve.curvePrimitiveType) {\r\n      case \"lineString\":\r\n        this.addLineString(curve.points);\r\n        break;\r\n      case \"lineSegment\":\r\n        this.addLineString([curve.startPoint(), curve.endPoint()]);\r\n        break;\r\n      case \"arc\":\r\n        this.addArc(curve, false, false);\r\n        break;\r\n      default:\r\n        const path = new Path();\r\n        if (path.tryAddChild(curve))\r\n          this.addPath(path);\r\n\r\n        break;\r\n    }\r\n  }\r\n\r\n  /** Append a mesh to the builder.\r\n   * @param meshData Describes the mesh\r\n   * @param filled If the mesh describes a planar region, indicates whether its interior area should be drawn with fill in [[RenderMode.Wireframe]].\r\n   */\r\n  public abstract addPolyface(meshData: Polyface, filled: boolean): void;\r\n\r\n  /** Append a solid primitive to the builder. */\r\n  public abstract addSolidPrimitive(solidPrimitive: SolidPrimitive): void;\r\n\r\n  /** Append any primitive to the builder.\r\n   * @param primitive The graphic primitive to append.\r\n   */\r\n  public addPrimitive(primitive: GraphicPrimitive): void {\r\n    switch (primitive.type) {\r\n      case \"linestring\":\r\n        this.addLineString(primitive.points);\r\n        break;\r\n      case \"linestring2d\":\r\n        this.addLineString2d(primitive.points, primitive.zDepth);\r\n        break;\r\n      case \"pointstring\":\r\n        this.addPointString(primitive.points);\r\n        break;\r\n      case \"pointstring2d\":\r\n        this.addPointString2d(primitive.points, primitive.zDepth);\r\n        break;\r\n      case \"shape\":\r\n        this.addShape(primitive.points);\r\n        break;\r\n      case \"shape2d\":\r\n        this.addShape2d(primitive.points, primitive.zDepth);\r\n        break;\r\n      case \"arc\":\r\n        this.addArc(primitive.arc, true === primitive.isEllipse, true === primitive.filled);\r\n        break;\r\n      case \"arc2d\":\r\n        this.addArc2d(primitive.arc, true === primitive.isEllipse, true === primitive.filled, primitive.zDepth);\r\n        break;\r\n      case \"path\":\r\n        this.addPath(primitive.path);\r\n        break;\r\n      case \"loop\":\r\n        this.addLoop(primitive.loop);\r\n        break;\r\n      case \"polyface\":\r\n        this.addPolyface(primitive.polyface, true === primitive.filled);\r\n        break;\r\n      case \"solidPrimitive\":\r\n        this.addSolidPrimitive(primitive.solidPrimitive);\r\n        break;\r\n    }\r\n  }\r\n\r\n  /** Add Range3d edges. Useful for debugging. */\r\n  public addRangeBox(range: Range3d) {\r\n    this.addFrustum(Frustum.fromRange(range));\r\n  }\r\n\r\n  /** Add Frustum edges. Useful for debugging. */\r\n  public addFrustum(frustum: Frustum) {\r\n    this.addRangeBoxFromCorners(frustum.points);\r\n  }\r\n\r\n  /** Add range edges from corner points */\r\n  public addRangeBoxFromCorners(p: Point3d[]) {\r\n    this.addLineString([\r\n      p[Npc.LeftBottomFront],\r\n      p[Npc.LeftTopFront],\r\n      p[Npc.RightTopFront],\r\n      p[Npc.RightBottomFront],\r\n      p[Npc.RightBottomRear],\r\n      p[Npc.RightTopRear],\r\n      p[Npc.LeftTopRear],\r\n      p[Npc.LeftBottomRear],\r\n      p[Npc.LeftBottomFront].clone(),\r\n      p[Npc.RightBottomFront].clone(),\r\n    ]);\r\n\r\n    this.addLineString([p[Npc.LeftTopFront].clone(), p[Npc.LeftTopRear].clone()]);\r\n    this.addLineString([p[Npc.RightTopFront].clone(), p[Npc.RightTopRear].clone()]);\r\n    this.addLineString([p[Npc.LeftBottomRear].clone(), p[Npc.RightBottomRear].clone()]);\r\n  }\r\n\r\n  /** Sets the current active symbology for this builder. Any new geometry subsequently added will be drawn using the specified symbology.\r\n   * @param lineColor The color in which to draw lines.\r\n   * @param fillColor The color in which to draw filled regions.\r\n   * @param lineWidth The width in pixels to draw lines. The renderer will clamp this value to an integer in the range [1, 32].\r\n   * @param linePixels The pixel pattern in which to draw lines.\r\n   * @see [[GraphicBuilder.activateGraphicParams]] for additional symbology options.\r\n   */\r\n  public setSymbology(lineColor: ColorDef, fillColor: ColorDef, lineWidth: number, linePixels = LinePixels.Solid) {\r\n    this.activateGraphicParams(GraphicParams.fromSymbology(lineColor, fillColor, lineWidth, linePixels));\r\n  }\r\n\r\n  /** Set the current active symbology for this builder to be a blanking fill before adding a planar region.\r\n   * A planar region drawn with blanking fill renders behind other geometry in the same graphic.\r\n   * Blanking fill is not affected by the fill [[ViewFlags]] being disabled.\r\n   * An example would be to add a line to a graphic containing a shape with blanking fill so that the line is always shown in front of the fill.\r\n   * @param fillColor The color in which to draw filled regions.\r\n   */\r\n  public setBlankingFill(fillColor: ColorDef) { this.activateGraphicParams(GraphicParams.fromBlankingFill(fillColor)); }\r\n}\r\n"]}
+{"version":3,"file":"GraphicBuilder.js","sourceRoot":"","sources":["../../../src/render/GraphicBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { assert, Id64String } from \"@itwin/core-bentley\";\r\nimport {\r\n  AnyCurvePrimitive, Arc3d, Loop, Path, Point2d, Point3d, Polyface, Range3d, SolidPrimitive, Transform,\r\n} from \"@itwin/core-geometry\";\r\nimport { AnalysisStyle, ColorDef, Feature, Frustum, GeometryClass, GraphicParams, LinePixels, Npc } from \"@itwin/core-common\";\r\nimport { IModelConnection } from \"../IModelConnection\";\r\nimport { Viewport } from \"../Viewport\";\r\nimport { RenderGraphic } from \"./RenderGraphic\";\r\nimport { GraphicPrimitive } from \"./GraphicPrimitive\";\r\n\r\n/**\r\n * Describes the type of a [[GraphicBuilder]], which defines the coordinate system in which the builder's geometry is defined and\r\n * controls the behavior of the [[RenderGraphic]] produced by the builder.\r\n * @note For those types for which depth-testing is disabled, the order in which the individual geometric primitives are drawn determines which geometry draws on top of other geometry.\r\n *  - Within a [[GraphicList]], each [[RenderGraphic]] is rendered in the order in which it appears in the list; and\r\n *  - Within a single [[RenderGraphic]], each geometric primitive is rendered in the ordered in which it was added to the GraphicBuilder.\r\n * @public\r\n * @extensions\r\n */\r\nexport enum GraphicType {\r\n  /**\r\n   * Renders behind all other graphics. For example, the border of a [[SheetViewState]] is of this type.\r\n   * Coordinates: [[CoordSystem.View]].\r\n   * [[RenderMode]]: [[RenderMode.SmoothShade]].\r\n   * Lighting: none.\r\n   * Depth-testing: disabled.\r\n   * @see [[Decorations.viewBackground]]\r\n   */\r\n  ViewBackground,\r\n  /** Used for the scene itself, dynamics, and 'normal' decorations. */\r\n  /**\r\n   * Renders as if it were part of the scene. All of the [[ViewFlags]] applied to the view's normal geometry also applies to these types of decorations.\r\n   * Coordinates: [[CoordSystem.World]].\r\n   * Lighting and [[RenderMode]]: from view.\r\n   * Depth-testing: enabled.\r\n   * @see [[Decorations.normal]].\r\n   */\r\n  Scene,\r\n  /** Renders within the scene. Coordinates: world. RenderMode: smooth. Lighting: default. Z-testing: enabled */\r\n  /** Renders within the scene, but ignores the view's [[ViewFlags]].\r\n   * Coordinates: [[CoordSystem.World]].\r\n   * Lighting: default.\r\n   * [[RenderMode]]: [[RenderMode.SmoothShade]].\r\n   * Depth-testing: enabled.\r\n   * @see [[Decorations.world]].\r\n   */\r\n  WorldDecoration,\r\n  /**\r\n   * Renders as an overlay on top of the scene. These decorations differ from [[GraphicType.WorldDecoration]] only in that depth-testing is disabled.\r\n   * For example, the ACS triad and [[WindowAreaTool]] decorations are of this type.\r\n   * Coordinates: [[CoordSystem.World]].\r\n   * [[RenderMode]]: [[RenderMode.SmoothShade]]\r\n   * Lighting: default.\r\n   * Depth-testing: disabled.\r\n   * Renders atop the scene. Coordinates: world. RenderMode: smooth. Lighting: none. Z-testing: disabled\r\n   * @note Overlay decorations typically employ some degree of transparency to ensure that they do not fully obscure the scene.\r\n   * @see [[Decorations.worldOverlay]]\r\n   */\r\n  WorldOverlay,\r\n  /**\r\n   * Renders as an overlay on top of the scene. These decorations differ from [[GraphicType.WorldOverlay]] only in that their geometry is defined in view coordinates rather than world.\r\n   * Coordinates: [[CoordSystem.View]].\r\n   * [[RenderMode]]: [[RenderMode.SmoothShade]]\r\n   * Lighting: default.\r\n   * Depth-testing: disabled.\r\n   * @note For more flexibility in defining view overlay decorations, consider using a [[CanvasDecorationList]].\r\n   * @see [[Decorations.viewOverlay]]\r\n   */\r\n  ViewOverlay,\r\n}\r\n\r\n/** Options used when constructing a `Batch` - that is, a [[RenderGraphic]] with an associated [FeatureTable]($common) describing individual [Feature]($common)s within the\r\n * graphic. Individual features can be resymbolized in a variety of ways including flashing and hiliting.\r\n * For example, to prevent graphics produced by [[readElementGraphics]] from being hilited when their corresponding element is in the [[SelectionSet]],\r\n * pass `{ noHilite: true }` to [[readElementGraphics]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface BatchOptions {\r\n  /** Identifies the [[Tile]] associated with the batch, chiefly for debugging purposes.\r\n   * @beta\r\n   */\r\n  tileId?: string;\r\n  /** If true, features within the batch will not be flashed on mouseover. */\r\n  noFlash?: boolean;\r\n  /** If true, features within the batch will not be hilited when their corresponding element is in the [[SelectionSet]]. */\r\n  noHilite?: boolean;\r\n  /** If true, features within the batch will not be emphasized when the corresponding [[Feature]] is emphasized using [FeatureOverrides]($common). */\r\n  noEmphasis?: boolean;\r\n  /** If true, the contents of the batch will only be drawn by [[Viewport.readPixels]], not [[Viewport.renderFrame]], causing them to be locatable but invisible. */\r\n  locateOnly?: boolean;\r\n}\r\n\r\n/** Options used as part of [[GraphicBuilderOptions]] to describe a [pickable]($docs/learning/frontend/ViewDecorations#pickable-view-graphic-decorations) [[RenderGraphic]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface PickableGraphicOptions extends BatchOptions {\r\n  /** A unique identifier for the graphic.\r\n   * @see [[IModelConnection.transientIds]] to obtain a unique Id in the context of an iModel.\r\n   * @see [[GraphicBuilder.activatePickableId]] or [[GraphicBuilder.activateFeature]] to change the pickable object while adding geometry.\r\n   */\r\n  id: Id64String;\r\n  /** Optional Id of the subcategory with which the graphic should be associated. */\r\n  subCategoryId?: Id64String;\r\n  /** Optional geometry class for the graphic - defaults to [GeometryClass.Primary]($common). */\r\n  geometryClass?: GeometryClass;\r\n  /** The optional Id of the model with which the graphic should be associated. */\r\n  modelId?: Id64String;\r\n}\r\n\r\n/** Options for creating a [[GraphicBuilder]] used by functions like [[DecorateContext.createGraphic]] and [[RenderSystem.createGraphic]].\r\n * @see [[ViewportGraphicBuilderOptions]] to create a graphic builder for a [[Viewport]].\r\n * @see [[CustomGraphicBuilderOptions]] to create a graphic builder unassociated with any [[Viewport]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicBuilderOptions {\r\n  /** The type of graphic to produce. */\r\n  type: GraphicType;\r\n\r\n  /** The local-to-world transform in which the builder's geometry is to be defined - by default, an identity transform. */\r\n  placement?: Transform;\r\n\r\n  /** If the graphic is to be pickable, specifies the pickable Id and other options. */\r\n  pickable?: PickableGraphicOptions;\r\n\r\n  /** If true, the order in which geometry is added to the builder is preserved.\r\n   * This is useful for overlay and background graphics because they draw without using the depth buffer. For example, to draw an overlay containing a red shape with a white outline,\r\n   * you would add the shape to the GraphicBuilder first, followed by the outline, to ensure the outline draws \"in front of\" the shape.\r\n   * It defaults to true for overlays and background graphics, and false for other graphic types.\r\n   * It is not useful for other types of graphics and imposes a performance penalty due to increased number of draw calls.\r\n   * For overlay and background graphics that do not need to draw in any particular order, the performance penalty can be eliminated by setting this to `false`.\r\n   */\r\n  preserveOrder?: boolean;\r\n\r\n  /** Controls whether normals are generated for surfaces. Normals allow 3d geometry to receive lighting; without them the geometry will be unaffected by lighting.\r\n   * By default, normals are generated only for graphics of type [[GraphicType.Scene]]; or for any type of graphic if [[GraphicBuilder.wantEdges]] is true, because\r\n   * normals are required to prevent z-fighting between surfaces and their edges. This default can be overridden by explicitly specifying `true` or `false`.\r\n   * @see [[GraphicType]] for a description of whether and how different types of graphics are affected by lighting.\r\n   */\r\n  wantNormals?: boolean;\r\n\r\n  /** Controls whether edges are generated for surfaces.\r\n   * Edges are only displayed if [ViewFlags.renderMode]($common) is not [RenderMode.SmoothShade]($common) or [ViewFlags.visibleEdges]($common) is `true`.\r\n   * Since all decoration graphics except [[GraphicType.Scene]] are drawn in smooth shaded mode with no visible edges, by default edges are only produced for scene graphics, and\r\n   * - if a [[Viewport]] is supplied with the options - only if [ViewFlags.edgesRequired]($common) is true for the viewport.\r\n   * That default can be overridden by explicitly specifying `true` or `false`. This can be useful for non-scene decorations contained in a [[GraphicBranch]] that applies [ViewFlagOverrides]($common)\r\n   * that change the edge display settings; or for scene decorations that might be cached for reuse after the viewport's edge settings are changed.\r\n   * @note Edges will tend to z-fight with their surfaces unless the graphic is [[pickable]].\r\n   */\r\n  generateEdges?: boolean;\r\n\r\n  /** If defined, specifies a point about which the graphic will rotate such that it always faces the viewer.\r\n   * This can be particular useful for planar regions to create a billboarding effect - e.g., to implement [[Marker]]-like WebGL decorations.\r\n   * The graphic's [[placement]] transform is not applied to the point.\r\n   * @note This has no effect for graphics displayed in a 2d view.\r\n   */\r\n  viewIndependentOrigin?: Point3d;\r\n}\r\n\r\n/** Options for creating a [[GraphicBuilder]] to produce a [[RenderGraphic]] to be displayed in a specific [[Viewport]].\r\n * The level of detail of the graphic will be computed from the position of its geometry within the viewport's [Frustum]($common).\r\n * Default values for [[GraphicBuilderOptions.wantNormals]] and [[GraphicBuilderOptions.generateEdges]] will be determined by the viewport's [ViewFlags]($common).\r\n * The [[GraphicBuilder.iModel]] will be set to the viewport's [[IModelConnection]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ViewportGraphicBuilderOptions extends GraphicBuilderOptions {\r\n  /** The viewport in which the resultant [[RenderGraphic]] is to be drawn. */\r\n  viewport: Viewport;\r\n\r\n  /** If true, [[ViewState.getAspectRatioSkew]] will be taken into account when computing the level of detail for the produced graphics. */\r\n  applyAspectRatioSkew?: boolean;\r\n\r\n  iModel?: never;\r\n  computeChordTolerance?: never;\r\n}\r\n\r\n/** Arguments used to compute the chord tolerance (level of detail) of the [[RenderGraphic]]s produced by a [[GraphicBuilder]].\r\n * Generally, the chord tolerance should be roughly equivalent to the size in meters of one pixel on screen where the graphic is to be displayed.\r\n * For [[GraphicType.ViewOverlay]] and [[GraphicType.ViewBackground]], which already define their geometry in pixels, the chord tolerance should typically be 1.\r\n * @see [[CustomGraphicBuilderOptions.computeChordTolerance]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ComputeChordToleranceArgs {\r\n  /** The graphic builder being used to produce the graphics. */\r\n  readonly graphic: GraphicBuilder;\r\n  /** A function that computes a range enclosing all of the geometry that was added to the builder. */\r\n  readonly computeRange: () => Range3d;\r\n}\r\n\r\n/** Options for creating a [[GraphicBuilder]] to produce a [[RenderGraphic]] that is not associated with any particular [[Viewport]] and may not be associated with\r\n * any particular [[IModelConnection]].\r\n * This is primarily useful when the same graphic is to be saved and reused for display in multiple viewports and for which a chord tolerance can be computed\r\n * independently of each viewport's [Frustum]($common).\r\n * @public\r\n * @extensions\r\n */\r\nexport interface CustomGraphicBuilderOptions extends GraphicBuilderOptions {\r\n  /** Optionally, the IModelConnection with which the graphic is associated. */\r\n  iModel?: IModelConnection;\r\n  /** A function that can compute the level of detail for the graphics produced by the builder. */\r\n  computeChordTolerance: (args: ComputeChordToleranceArgs) => number;\r\n\r\n  applyAspectRatioSkew?: never;\r\n  viewport?: never;\r\n}\r\n\r\n/** Provides methods for constructing a [[RenderGraphic]] from geometric primitives.\r\n * GraphicBuilder is primarily used for creating [[Decorations]] to be displayed inside a [[Viewport]].\r\n *\r\n * The typical process for constructing a [[RenderGraphic]] proceeds as follows:\r\n *  1. Use [[DecorateContext.createGraphic]] or [[RenderSystem.createGraphic]] to obtain a builder.\r\n *  2. Set up the symbology using [[GraphicBuilder.activateGraphicParams]] or [[GraphicBuilder.setSymbology]].\r\n *  3. Add one or more geometric primitives using methods like [[GraphicBuilder.addShape]] and [[GraphicBuilder.addLineString]], possibly setting new symbology in between.\r\n *  4. Use [[GraphicBuilder.finish]] to produce the finished [[RenderGraphic]].\r\n *\r\n * @note Most of the methods which add geometry to the builder take ownership of their inputs rather than cloning them.\r\n * So, for example, if you pass an array of points to addLineString(), you should not subsequently modify that array.\r\n *\r\n * @public\r\n * @extensions\r\n */\r\nexport abstract class GraphicBuilder {\r\n  /** The local coordinate system transform applied to this builder's geometry.\r\n   * @see [[GraphicBuilderOptions.placement]].\r\n   */\r\n  public readonly placement: Transform;\r\n\r\n  /** The iModel associated with this builder, if any. */\r\n  public readonly iModel?: IModelConnection;\r\n\r\n  /** The type of graphic to be produced by this builder.\r\n   * @see [[GraphicBuilderOptions.type]].\r\n   */\r\n  public readonly type: GraphicType;\r\n\r\n  /** If the graphic is to be pickable, specifies the pickable Id and other options. */\r\n  public readonly pickable?: Readonly<PickableGraphicOptions>;\r\n\r\n  /** If true, the order in which geometry is added to the builder is preserved.\r\n   * @see [[GraphicBuilderOptions.preserveOrder]] for more details.\r\n   */\r\n  public readonly preserveOrder: boolean;\r\n\r\n  /** Controls whether normals are generated for surfaces.\r\n   * @note Normals are required for proper edge display, so by default they are always produced if [[wantEdges]] is `true`.\r\n   * @see [[GraphicBuilderOptions.wantNormals]] for more details.\r\n   */\r\n  public readonly wantNormals: boolean;\r\n\r\n  /** Controls whether edges are generated for surfaces.\r\n   * @see [[GraphicBuilderOptions.generateEdges]] for more details.\r\n   */\r\n  public readonly wantEdges: boolean;\r\n\r\n  /** @alpha */\r\n  public readonly analysisStyle?: AnalysisStyle;\r\n\r\n  protected readonly _computeChordTolerance: (args: ComputeChordToleranceArgs) => number;\r\n  protected readonly _options: CustomGraphicBuilderOptions | ViewportGraphicBuilderOptions;\r\n\r\n  /** @internal */\r\n  protected constructor(options: ViewportGraphicBuilderOptions | CustomGraphicBuilderOptions) {\r\n    // Stored for potential use later in creating a new GraphicBuilder from this one (see PrimitiveBuilder.finishGraphic).\r\n    this._options = options;\r\n\r\n    const vp = options.viewport;\r\n    this.placement = options.placement ?? Transform.createIdentity();\r\n    this.iModel = vp?.iModel ?? options.iModel;\r\n    this.type = options.type;\r\n    this.pickable = options.pickable;\r\n    this.wantEdges = options.generateEdges ?? (this.type === GraphicType.Scene && (!vp || vp.viewFlags.edgesRequired()));\r\n    this.wantNormals = options.wantNormals ?? (this.wantEdges || this.type === GraphicType.Scene);\r\n    this.preserveOrder = options.preserveOrder ?? (this.isOverlay || this.isViewBackground);\r\n\r\n    if (!options.viewport) {\r\n      this._computeChordTolerance = options.computeChordTolerance;\r\n      return;\r\n    }\r\n\r\n    this.analysisStyle = options.viewport.displayStyle.settings.analysisStyle;\r\n\r\n    this._computeChordTolerance = (args: ComputeChordToleranceArgs) => {\r\n      let pixelSize = 1;\r\n      if (!this.isViewCoordinates) {\r\n        // Compute the horizontal distance in meters between two adjacent pixels at the center of the geometry.\r\n        pixelSize = options.viewport.getPixelSizeAtPoint(args.computeRange().center);\r\n        pixelSize = options.viewport.target.adjustPixelSizeForLOD(pixelSize);\r\n\r\n        // Aspect ratio skew > 1.0 stretches the view in Y. In that case use the smaller vertical pixel distance for our stroke tolerance.\r\n        const skew = options.applyAspectRatioSkew ? options.viewport.view.getAspectRatioSkew() : 0;\r\n        if (skew > 1)\r\n          pixelSize /= skew;\r\n      }\r\n\r\n      return pixelSize * 0.25;\r\n    };\r\n  }\r\n\r\n  /** The Id to be associated with the graphic for picking.\r\n   * @see [[GraphicBuilderOptions.pickable]] for more options.\r\n   * @deprecated This provides only the **first** pickable Id for this graphic - you should keep track of the **current** pickable Id yourself.\r\n   */\r\n  public get pickId(): Id64String | undefined {\r\n    return this.pickable?.id;\r\n  }\r\n\r\n  /** Whether the builder's geometry is defined in [[CoordSystem.View]] coordinates.\r\n   * @see [[isWorldCoordinates]].\r\n   */\r\n  public get isViewCoordinates(): boolean {\r\n    return this.type === GraphicType.ViewBackground || this.type === GraphicType.ViewOverlay;\r\n  }\r\n\r\n  /** Whether the builder's geometry is defined in [[CoordSystem.World]] coordinates.\r\n   * @see [[isViewCoordinates]].\r\n   */\r\n  public get isWorldCoordinates(): boolean {\r\n    return !this.isViewCoordinates;\r\n  }\r\n\r\n  /** True if the builder produces a graphic of [[GraphicType.Scene]]. */\r\n  public get isSceneGraphic(): boolean {\r\n    return this.type === GraphicType.Scene;\r\n  }\r\n\r\n  /** True if the builder produces a graphic of [[GraphicType.ViewBackground]]. */\r\n  public get isViewBackground(): boolean {\r\n    return this.type === GraphicType.ViewBackground;\r\n  }\r\n\r\n  /** True if the builder produces a graphic of [[GraphicType.WorldOverlay]] or [[GraphicType.ViewOerlay]]. */\r\n  public get isOverlay(): boolean {\r\n    return this.type === GraphicType.ViewOverlay || this.type === GraphicType.WorldOverlay;\r\n  }\r\n\r\n  /**\r\n   * Processes the accumulated symbology and geometry to produce a renderable graphic.\r\n   * This function can only be called once; after the [[RenderGraphic]] has been extracted the [[GraphicBuilder]] should no longer be used.\r\n   */\r\n  public abstract finish(): RenderGraphic;\r\n\r\n  /** Sets the current active symbology for this builder. Any new geometry subsequently added to the builder will be drawn using the specified symbology.\r\n   * @param graphicParams The symbology to apply to subsequent geometry.\r\n   * @see [[GraphicBuilder.setSymbology]] for a convenient way to set common symbology options.\r\n   */\r\n  public abstract activateGraphicParams(graphicParams: GraphicParams): void;\r\n\r\n  /** Called by [[activateFeature]] after validation to change the [Feature]($common) to be associated with subsequently-added geometry.\r\n   * This default implementation does nothing.\r\n   */\r\n  protected _activateFeature(_feature: Feature): void { }\r\n\r\n  /** Change the [Feature]($common) to be associated with subsequently-added geometry. This permits multiple features to be batched together into a single graphic\r\n   * for more efficient rendering.\r\n   * @note This method has no effect if [[GraphicBuilderOptions.pickable]] was not supplied to the GraphicBuilder's constructor.\r\n   */\r\n  public activateFeature(feature: Feature): void {\r\n    assert(undefined !== this._options.pickable, \"GraphicBuilder.activateFeature has no effect if PickableGraphicOptions were not supplied\");\r\n    if (this._options.pickable)\r\n      this._activateFeature(feature);\r\n  }\r\n\r\n  /** Change the pickable Id to be associated with subsequently-added geometry. This permits multiple pickable objects to be batched  together into a single graphic\r\n   * for more efficient rendering. This method calls [[activateFeature]], using the subcategory Id and [GeometryClass]($common) specified in [[GraphicBuilder.pickable]]\r\n   * at construction, if any.\r\n   * @note This method has no effect if [[GraphicBuilderOptions.pickable]] was not supplied to the GraphicBuilder's constructor.\r\n   */\r\n  public activatePickableId(id: Id64String): void {\r\n    const pick = this._options.pickable;\r\n    this.activateFeature(new Feature(id, pick?.subCategoryId, pick?.geometryClass));\r\n  }\r\n\r\n  /**\r\n   * Appends a 3d line string to the builder.\r\n   * @param points Array of vertices in the line string.\r\n   */\r\n  public abstract addLineString(points: Point3d[]): void;\r\n\r\n  /**\r\n   * Appends a 2d line string to the builder.\r\n   * @param points Array of vertices in the line string.\r\n   * @param zDepth Z value in local coordinates to use for each point.\r\n   */\r\n  public abstract addLineString2d(points: Point2d[], zDepth: number): void;\r\n\r\n  /**\r\n   * Appends a 3d point string to the builder. The points are drawn disconnected, with a diameter in pixels defined by the builder's active [[GraphicParams.rasterWidth]].\r\n   * @param points Array of vertices in the point string.\r\n   */\r\n  public abstract addPointString(points: Point3d[]): void;\r\n\r\n  /**\r\n   * Appends a 2d point string to the builder. The points are drawn disconnected, with a diameter in pixels defined by the builder's active [[GraphicParams.rasterWidth]].\r\n   * @param points Array of vertices in the point string.\r\n   * @param zDepth Z value in local coordinates to use for each point.\r\n   */\r\n  public abstract addPointString2d(points: Point2d[], zDepth: number): void;\r\n\r\n  /**\r\n   * Appends a closed 3d planar region to the builder.\r\n   * @param points Array of vertices of the shape.\r\n   */\r\n  public abstract addShape(points: Point3d[]): void;\r\n\r\n  /**\r\n   * Appends a closed 2d region to the builder.\r\n   * @param points Array of vertices of the shape.\r\n   * @param zDepth Z value in local coordinates to use for each point.\r\n   */\r\n  public abstract addShape2d(points: Point2d[], zDepth: number): void;\r\n\r\n  /**\r\n   * Appends a 3d open arc or closed ellipse to the builder.\r\n   * @param arc Description of the arc or ellipse.\r\n   * @param isEllipse If true, and if the arc defines a full sweep, then draw as a closed ellipse instead of an arc.\r\n   * @param filled If true, and isEllipse is also true, then draw ellipse filled.\r\n   */\r\n  public abstract addArc(arc: Arc3d, isEllipse: boolean, filled: boolean): void;\r\n\r\n  /**\r\n   * Appends a 2d open arc or closed ellipse to the builder.\r\n   * @param arc Description of the arc or ellipse.\r\n   * @param isEllipse If true, and if the arc defines a full sweep, then draw as a closed ellipse instead of an arc.\r\n   * @param filled If true, and isEllipse is also true, then draw ellipse filled.\r\n   * @param zDepth Z value in local coordinates to use for each point in the arc or ellipse.\r\n   */\r\n  public abstract addArc2d(ellipse: Arc3d, isEllipse: boolean, filled: boolean, zDepth: number): void;\r\n\r\n  /** Append a 3d open path to the builder. */\r\n  public abstract addPath(path: Path): void;\r\n\r\n  /** Append a 3d planar region to the builder. */\r\n  public abstract addLoop(loop: Loop): void;\r\n\r\n  /** Append a [CurvePrimitive]($core-geometry) to the builder. */\r\n  public addCurvePrimitive(curve: AnyCurvePrimitive): void {\r\n    switch (curve.curvePrimitiveType) {\r\n      case \"lineString\":\r\n        this.addLineString(curve.points);\r\n        break;\r\n      case \"lineSegment\":\r\n        this.addLineString([curve.startPoint(), curve.endPoint()]);\r\n        break;\r\n      case \"arc\":\r\n        this.addArc(curve, false, false);\r\n        break;\r\n      default:\r\n        const path = new Path();\r\n        if (path.tryAddChild(curve))\r\n          this.addPath(path);\r\n\r\n        break;\r\n    }\r\n  }\r\n\r\n  /** Append a mesh to the builder.\r\n   * @param meshData Describes the mesh\r\n   * @param filled If the mesh describes a planar region, indicates whether its interior area should be drawn with fill in [[RenderMode.Wireframe]].\r\n   */\r\n  public abstract addPolyface(meshData: Polyface, filled: boolean): void;\r\n\r\n  /** Append a solid primitive to the builder. */\r\n  public abstract addSolidPrimitive(solidPrimitive: SolidPrimitive): void;\r\n\r\n  /** Append any primitive to the builder.\r\n   * @param primitive The graphic primitive to append.\r\n   */\r\n  public addPrimitive(primitive: GraphicPrimitive): void {\r\n    switch (primitive.type) {\r\n      case \"linestring\":\r\n        this.addLineString(primitive.points);\r\n        break;\r\n      case \"linestring2d\":\r\n        this.addLineString2d(primitive.points, primitive.zDepth);\r\n        break;\r\n      case \"pointstring\":\r\n        this.addPointString(primitive.points);\r\n        break;\r\n      case \"pointstring2d\":\r\n        this.addPointString2d(primitive.points, primitive.zDepth);\r\n        break;\r\n      case \"shape\":\r\n        this.addShape(primitive.points);\r\n        break;\r\n      case \"shape2d\":\r\n        this.addShape2d(primitive.points, primitive.zDepth);\r\n        break;\r\n      case \"arc\":\r\n        this.addArc(primitive.arc, true === primitive.isEllipse, true === primitive.filled);\r\n        break;\r\n      case \"arc2d\":\r\n        this.addArc2d(primitive.arc, true === primitive.isEllipse, true === primitive.filled, primitive.zDepth);\r\n        break;\r\n      case \"path\":\r\n        this.addPath(primitive.path);\r\n        break;\r\n      case \"loop\":\r\n        this.addLoop(primitive.loop);\r\n        break;\r\n      case \"polyface\":\r\n        this.addPolyface(primitive.polyface, true === primitive.filled);\r\n        break;\r\n      case \"solidPrimitive\":\r\n        this.addSolidPrimitive(primitive.solidPrimitive);\r\n        break;\r\n    }\r\n  }\r\n\r\n  /** Add Range3d edges. Useful for debugging. */\r\n  public addRangeBox(range: Range3d) {\r\n    this.addFrustum(Frustum.fromRange(range));\r\n  }\r\n\r\n  /** Add Frustum edges. Useful for debugging. */\r\n  public addFrustum(frustum: Frustum) {\r\n    this.addRangeBoxFromCorners(frustum.points);\r\n  }\r\n\r\n  /** Add range edges from corner points */\r\n  public addRangeBoxFromCorners(p: Point3d[]) {\r\n    this.addLineString([\r\n      p[Npc.LeftBottomFront],\r\n      p[Npc.LeftTopFront],\r\n      p[Npc.RightTopFront],\r\n      p[Npc.RightBottomFront],\r\n      p[Npc.RightBottomRear],\r\n      p[Npc.RightTopRear],\r\n      p[Npc.LeftTopRear],\r\n      p[Npc.LeftBottomRear],\r\n      p[Npc.LeftBottomFront].clone(),\r\n      p[Npc.RightBottomFront].clone(),\r\n    ]);\r\n\r\n    this.addLineString([p[Npc.LeftTopFront].clone(), p[Npc.LeftTopRear].clone()]);\r\n    this.addLineString([p[Npc.RightTopFront].clone(), p[Npc.RightTopRear].clone()]);\r\n    this.addLineString([p[Npc.LeftBottomRear].clone(), p[Npc.RightBottomRear].clone()]);\r\n  }\r\n\r\n  /** Sets the current active symbology for this builder. Any new geometry subsequently added will be drawn using the specified symbology.\r\n   * @param lineColor The color in which to draw lines.\r\n   * @param fillColor The color in which to draw filled regions.\r\n   * @param lineWidth The width in pixels to draw lines. The renderer will clamp this value to an integer in the range [1, 32].\r\n   * @param linePixels The pixel pattern in which to draw lines.\r\n   * @see [[GraphicBuilder.activateGraphicParams]] for additional symbology options.\r\n   */\r\n  public setSymbology(lineColor: ColorDef, fillColor: ColorDef, lineWidth: number, linePixels = LinePixels.Solid) {\r\n    this.activateGraphicParams(GraphicParams.fromSymbology(lineColor, fillColor, lineWidth, linePixels));\r\n  }\r\n\r\n  /** Set the current active symbology for this builder to be a blanking fill before adding a planar region.\r\n   * A planar region drawn with blanking fill renders behind other geometry in the same graphic.\r\n   * Blanking fill is not affected by the fill [[ViewFlags]] being disabled.\r\n   * An example would be to add a line to a graphic containing a shape with blanking fill so that the line is always shown in front of the fill.\r\n   * @param fillColor The color in which to draw filled regions.\r\n   */\r\n  public setBlankingFill(fillColor: ColorDef) { this.activateGraphicParams(GraphicParams.fromBlankingFill(fillColor)); }\r\n}\r\n"]}

package/lib/cjs/render/GraphicPrimitive.d.ts

@@ -4,6 +4,7 @@
 import { Arc3d, Loop, Path, Point2d, Point3d, Polyface, SolidPrimitive } from "@itwin/core-geometry";
 /** Base interface for a 2d [[GraphicPrimitive]] that can be supplied to [[GraphicBuilder.addPrimitive]].
  * @public
+ * @extensions
  */
 export interface GraphicPrimitive2d {
     /** Z value in local coordinates to use for each point. */
@@ -12,6 +13,7 @@ export interface GraphicPrimitive2d {
 /** A [[GraphicPrimitive]] representing a line string that can be supplied to [[GraphicBuilder.addPrimitive]].
  * @see [[GraphicBuilder.addLineString]].
  * @public
+ * @extensions
  */
 export interface GraphicLineString {
     type: "linestring";
@@ -20,6 +22,7 @@ export interface GraphicLineString {
 /** A [[GraphicPrimitive]] representing a 2d line string that can be supplied to [[GraphicBuilder.addPrimitive]].
  * @see [[GraphicBuilder.addLineString2d]].
  * @public
+ * @extensions
  */
 export interface GraphicLineString2d extends GraphicPrimitive2d {
     type: "linestring2d";
@@ -28,6 +31,7 @@ export interface GraphicLineString2d extends GraphicPrimitive2d {
 /** A [[GraphicPrimitive]] representing a point string that can be supplied to [[GraphicBuilder.addPrimitive]].
  * @see [[GraphicBuilder.addPointString]].
  * @public
+ * @extensions
  */
 export interface GraphicPointString {
     type: "pointstring";
@@ -36,6 +40,7 @@ export interface GraphicPointString {
 /** A [[GraphicPrimitive]] representing a 2d point string that can be supplied to [[GraphicBuilder.addPrimitive]].
  * @see [[GraphicBuilder.addPointString2d]].
  * @public
+ * @extensions
  */
 export interface GraphicPointString2d extends GraphicPrimitive2d {
     type: "pointstring2d";
@@ -44,6 +49,7 @@ export interface GraphicPointString2d extends GraphicPrimitive2d {
 /** A [[GraphicPrimitive]] representing a closed 3d planar region that can be supplied to [[GraphicBuilder.addPrimitive]].
  * @see [[GraphicBuilder.addShape]].
  * @public
+ * @extensions
  */
 export interface GraphicShape {
     type: "shape";
@@ -52,6 +58,7 @@ export interface GraphicShape {
 /** A [[GraphicPrimitive]] representing a closed 2d region that can be supplied to [[GraphicBuilder.addPrimitive]].
  * @see [[GraphicBuilder.addShape2d]].
  * @public
+ * @extensions
  */
 export interface GraphicShape2d extends GraphicPrimitive2d {
     type: "shape2d";
@@ -60,6 +67,7 @@ export interface GraphicShape2d extends GraphicPrimitive2d {
 /** A [[GraphicPrimitive]] representing a 3d open arc or closed ellipse that can be supplied to [[GraphicBuilder.addPrimitive]].
  * @see [[GraphicBuilder.addArc]].
  * @public
+ * @extensions
  */
 export interface GraphicArc {
     type: "arc";
@@ -70,6 +78,7 @@ export interface GraphicArc {
 /** A [[GraphicPrimitive]] representing a 2d open arc or closed ellipse that can be supplied to [[GraphicBuilder.addPrimitive]].
  * @see [[GraphicBuilder.addArc2d]].
  * @public
+ * @extensions
  */
 export interface GraphicArc2d {
     type: "arc2d";
@@ -81,6 +90,7 @@ export interface GraphicArc2d {
 /** A [[GraphicPrimitive]] representing a 3d open path that can be supplied to [[GraphicBuilder.addPrimitive]].
  * @see [[GraphicBuilder.addPath]].
  * @public
+ * @extensions
  */
 export interface GraphicPath {
     type: "path";
@@ -89,6 +99,7 @@ export interface GraphicPath {
 /** A [[GraphicPrimitive]] representing a 3d planar region that can be supplied to [[GraphicBuilder.addPrimitive]].
  * @see [[GraphicBuilder.addLoop]].
  * @public
+ * @extensions
  */
 export interface GraphicLoop {
     type: "loop";
@@ -97,6 +108,7 @@ export interface GraphicLoop {
 /** A [[GraphicPrimitive]] representing a mesh that can be supplied to [[GraphicBuilder.addPrimitive]].
  * @see [[GraphicBuilder.addPolyface]].
  * @public
+ * @extensions
  */
 export interface GraphicPolyface {
     type: "polyface";
@@ -106,6 +118,7 @@ export interface GraphicPolyface {
 /** A [[GraphicPrimitive]] representing a [SolidPrimitive]($core-geometry) to be supplied to [[GraphicBuilder.addPrimitive]].
  * @see [[GraphicBuilder.addSolidPrimitive]].
  * @public
+ * @extensions
  */
 export interface GraphicSolidPrimitive {
     type: "solidPrimitive";
@@ -131,6 +144,7 @@ export interface GraphicSolidPrimitive {
  *  }
  * ```
  * @public
+ * @extensions
  */
 export declare type GraphicPrimitive = GraphicLineString | GraphicLineString2d | GraphicPointString | GraphicPointString2d | GraphicShape | GraphicShape2d | GraphicArc | GraphicArc2d | GraphicPath | GraphicLoop | GraphicPolyface | GraphicSolidPrimitive;
 //# sourceMappingURL=GraphicPrimitive.d.ts.map

package/lib/cjs/render/GraphicPrimitive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GraphicPrimitive.d.ts","sourceRoot":"","sources":["../../../src/render/GraphicPrimitive.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAErG;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,KAAK,CAAC;IACX,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,KAAK,CAAC;IACX,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,oBAAY,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,oBAAoB,GAAG,YAAY,GAAG,cAAc,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,qBAAqB,CAAC"}
+{"version":3,"file":"GraphicPrimitive.d.ts","sourceRoot":"","sources":["../../../src/render/GraphicPrimitive.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAErG;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,KAAK,CAAC;IACX,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,KAAK,CAAC;IACX,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,oBAAY,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,oBAAoB,GAAG,YAAY,GAAG,cAAc,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,qBAAqB,CAAC"}

package/lib/cjs/render/GraphicPrimitive.js.map

@@ -1 +1 @@
-{"version":3,"file":"GraphicPrimitive.js","sourceRoot":"","sources":["../../../src/render/GraphicPrimitive.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { Arc3d, Loop, Path, Point2d, Point3d, Polyface, SolidPrimitive } from \"@itwin/core-geometry\";\r\n\r\n/** Base interface for a 2d [[GraphicPrimitive]] that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @public\r\n */\r\nexport interface GraphicPrimitive2d {\r\n  /** Z value in local coordinates to use for each point. */\r\n  zDepth: number;\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a line string that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addLineString]].\r\n * @public\r\n */\r\nexport interface GraphicLineString {\r\n  type: \"linestring\";\r\n  points: Point3d[];\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a 2d line string that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addLineString2d]].\r\n * @public\r\n */\r\nexport interface GraphicLineString2d extends GraphicPrimitive2d {\r\n  type: \"linestring2d\";\r\n  points: Point2d[];\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a point string that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addPointString]].\r\n * @public\r\n */\r\nexport interface GraphicPointString {\r\n  type: \"pointstring\";\r\n  points: Point3d[];\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a 2d point string that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addPointString2d]].\r\n * @public\r\n */\r\nexport interface GraphicPointString2d extends GraphicPrimitive2d {\r\n  type: \"pointstring2d\";\r\n  points: Point2d[];\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a closed 3d planar region that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addShape]].\r\n * @public\r\n */\r\nexport interface GraphicShape {\r\n  type: \"shape\";\r\n  points: Point3d[];\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a closed 2d region that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addShape2d]].\r\n * @public\r\n */\r\nexport interface GraphicShape2d extends GraphicPrimitive2d {\r\n  type: \"shape2d\";\r\n  points: Point2d[];\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a 3d open arc or closed ellipse that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addArc]].\r\n * @public\r\n */\r\nexport interface GraphicArc {\r\n  type: \"arc\";\r\n  arc: Arc3d;\r\n  isEllipse?: boolean;\r\n  filled?: boolean;\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a 2d open arc or closed ellipse that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addArc2d]].\r\n * @public\r\n */\r\nexport interface GraphicArc2d {\r\n  type: \"arc2d\";\r\n  arc: Arc3d;\r\n  isEllipse?: boolean;\r\n  filled?: boolean;\r\n  zDepth: number;\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a 3d open path that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addPath]].\r\n * @public\r\n */\r\nexport interface GraphicPath {\r\n  type: \"path\";\r\n  path: Path;\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a 3d planar region that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addLoop]].\r\n * @public\r\n */\r\nexport interface GraphicLoop {\r\n  type: \"loop\";\r\n  loop: Loop;\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a mesh that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addPolyface]].\r\n * @public\r\n */\r\nexport interface GraphicPolyface {\r\n  type: \"polyface\";\r\n  polyface: Polyface;\r\n  filled?: boolean;\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a [SolidPrimitive]($core-geometry) to be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addSolidPrimitive]].\r\n * @public\r\n */\r\nexport interface GraphicSolidPrimitive {\r\n  type: \"solidPrimitive\";\r\n  solidPrimitive: SolidPrimitive;\r\n}\r\n\r\n/** Union type representing a graphic primitive that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * Each primitive type corresponds to one of GraphicBuilder's `addXXX` methods. This is useful when the precise type of\r\n * geometry is not known at the point at which it is added to the builder. As a simple example:\r\n * ```ts\r\n *  function getPrimitives(): GraphicPrimitive[] {\r\n *    const primitives: GraphicPrimitive[] = [{ type: \"polyface\", polyface: getPolyface(), filled: true }];\r\n *    if (someCondition())\r\n *      primitives.push({ type: \"linestring\", points: getPoints() });\r\n *    else\r\n *      primitives.push({ type: \"arc\", arc: getArc(), isEllipse: true });\r\n *\r\n *    return primitives;\r\n *  }\r\n *\r\n *  function addGraphics(builder: GraphicBuilder) {\r\n *    for (const primitive of getPrimitives())\r\n *      builder.addPrimitive(primitive);\r\n *  }\r\n * ```\r\n * @public\r\n */\r\nexport type GraphicPrimitive = GraphicLineString | GraphicLineString2d | GraphicPointString | GraphicPointString2d | GraphicShape | GraphicShape2d | GraphicArc | GraphicArc2d | GraphicPath | GraphicLoop | GraphicPolyface | GraphicSolidPrimitive;\r\n"]}
+{"version":3,"file":"GraphicPrimitive.js","sourceRoot":"","sources":["../../../src/render/GraphicPrimitive.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { Arc3d, Loop, Path, Point2d, Point3d, Polyface, SolidPrimitive } from \"@itwin/core-geometry\";\r\n\r\n/** Base interface for a 2d [[GraphicPrimitive]] that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicPrimitive2d {\r\n  /** Z value in local coordinates to use for each point. */\r\n  zDepth: number;\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a line string that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addLineString]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicLineString {\r\n  type: \"linestring\";\r\n  points: Point3d[];\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a 2d line string that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addLineString2d]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicLineString2d extends GraphicPrimitive2d {\r\n  type: \"linestring2d\";\r\n  points: Point2d[];\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a point string that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addPointString]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicPointString {\r\n  type: \"pointstring\";\r\n  points: Point3d[];\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a 2d point string that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addPointString2d]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicPointString2d extends GraphicPrimitive2d {\r\n  type: \"pointstring2d\";\r\n  points: Point2d[];\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a closed 3d planar region that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addShape]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicShape {\r\n  type: \"shape\";\r\n  points: Point3d[];\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a closed 2d region that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addShape2d]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicShape2d extends GraphicPrimitive2d {\r\n  type: \"shape2d\";\r\n  points: Point2d[];\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a 3d open arc or closed ellipse that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addArc]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicArc {\r\n  type: \"arc\";\r\n  arc: Arc3d;\r\n  isEllipse?: boolean;\r\n  filled?: boolean;\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a 2d open arc or closed ellipse that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addArc2d]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicArc2d {\r\n  type: \"arc2d\";\r\n  arc: Arc3d;\r\n  isEllipse?: boolean;\r\n  filled?: boolean;\r\n  zDepth: number;\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a 3d open path that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addPath]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicPath {\r\n  type: \"path\";\r\n  path: Path;\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a 3d planar region that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addLoop]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicLoop {\r\n  type: \"loop\";\r\n  loop: Loop;\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a mesh that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addPolyface]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicPolyface {\r\n  type: \"polyface\";\r\n  polyface: Polyface;\r\n  filled?: boolean;\r\n}\r\n\r\n/** A [[GraphicPrimitive]] representing a [SolidPrimitive]($core-geometry) to be supplied to [[GraphicBuilder.addPrimitive]].\r\n * @see [[GraphicBuilder.addSolidPrimitive]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface GraphicSolidPrimitive {\r\n  type: \"solidPrimitive\";\r\n  solidPrimitive: SolidPrimitive;\r\n}\r\n\r\n/** Union type representing a graphic primitive that can be supplied to [[GraphicBuilder.addPrimitive]].\r\n * Each primitive type corresponds to one of GraphicBuilder's `addXXX` methods. This is useful when the precise type of\r\n * geometry is not known at the point at which it is added to the builder. As a simple example:\r\n * ```ts\r\n *  function getPrimitives(): GraphicPrimitive[] {\r\n *    const primitives: GraphicPrimitive[] = [{ type: \"polyface\", polyface: getPolyface(), filled: true }];\r\n *    if (someCondition())\r\n *      primitives.push({ type: \"linestring\", points: getPoints() });\r\n *    else\r\n *      primitives.push({ type: \"arc\", arc: getArc(), isEllipse: true });\r\n *\r\n *    return primitives;\r\n *  }\r\n *\r\n *  function addGraphics(builder: GraphicBuilder) {\r\n *    for (const primitive of getPrimitives())\r\n *      builder.addPrimitive(primitive);\r\n *  }\r\n * ```\r\n * @public\r\n * @extensions\r\n */\r\nexport type GraphicPrimitive = GraphicLineString | GraphicLineString2d | GraphicPointString | GraphicPointString2d | GraphicShape | GraphicShape2d | GraphicArc | GraphicArc2d | GraphicPath | GraphicLoop | GraphicPolyface | GraphicSolidPrimitive;\r\n"]}

package/lib/cjs/render/ParticleCollectionBuilder.d.ts

@@ -8,6 +8,7 @@ import { Viewport } from "../Viewport";
 import { RenderGraphic } from "./RenderGraphic";
 /** Parameters used to construct a [[ParticleCollectionBuilder]].
  * @public
+ * @extensions
  */
 export interface ParticleCollectionBuilderParams {
     /** The image mapped to each particle quad.
@@ -38,6 +39,7 @@ export interface ParticleCollectionBuilderParams {
 /** Describes a particle to to add to a particle collection via [[ParticleCollectionBuilder.addParticle]].
  * The x, y, and z coordinates represent the centroid of the particle quad in the collection's coordinate space.
  * @public
+ * @extensions
  */
 export interface ParticleProps extends XYAndZ {
     /** The size of the particle, in the collection's coordinate space. If omitted, it defaults to the size supplied to the collection by [[ParticleCollectionBuilderParams.size]].
@@ -60,6 +62,7 @@ export interface ParticleProps extends XYAndZ {
    * [Fire and Smoke](https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=fire-sample&imodel=Villa) particle effects.
  * @see [SnowEffect]($frontend-devtools) for an example of a particle effect.
  * @public
+ * @extensions
  */
 export interface ParticleCollectionBuilder {
     /** The default transparency for newly-added particles as an integer in [0,255], used by [[ParticleCollectionBuilder.addParticle]] if [[ParticleProps.transparency]] is omitted.

package/lib/cjs/render/ParticleCollectionBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParticleCollectionBuilder.d.ts","sourceRoot":"","sources":["../../../src/render/ParticleCollectionBuilder.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAkD,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC/G,OAAO,EAC8G,aAAa,EACjI,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,OAAO,EAAE,aAAa,CAAC;IAEvB;;OAEG;IACH,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IAErB,uGAAuG;IACvG,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,yDAAyD;IACzD,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAc,SAAQ,MAAM;IAC3C;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEtB,6KAA6K;IAC7K,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,sIAAsI;IACtI,cAAc,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB,iIAAiI;IACjI,IAAI,EAAE,KAAK,CAAC;IAEZ;;;;OAIG;IACH,WAAW,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAE/C;;;OAGG;IACH,MAAM,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;CACzC;AAED,cAAc;AACd,yBAAiB,yBAAyB,CAAC;IACzC;;OAEG;IACH,SAAgB,MAAM,CAAC,MAAM,EAAE,+BAA+B,GAAG,yBAAyB,CAEzF;CACF"}
+{"version":3,"file":"ParticleCollectionBuilder.d.ts","sourceRoot":"","sources":["../../../src/render/ParticleCollectionBuilder.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAkD,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC/G,OAAO,EAC8G,aAAa,EACjI,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMhD;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,OAAO,EAAE,aAAa,CAAC;IAEvB;;OAEG;IACH,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IAErB,uGAAuG;IACvG,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,yDAAyD;IACzD,QAAQ,EAAE,QAAQ,CAAC;IAEnB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAc,SAAQ,MAAM;IAC3C;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAEtB,6KAA6K;IAC7K,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,sIAAsI;IACtI,cAAc,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB,iIAAiI;IACjI,IAAI,EAAE,KAAK,CAAC;IAEZ;;;;OAIG;IACH,WAAW,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAE/C;;;OAGG;IACH,MAAM,EAAE,MAAM,aAAa,GAAG,SAAS,CAAC;CACzC;AAED,cAAc;AACd,yBAAiB,yBAAyB,CAAC;IACzC;;OAEG;IACH,SAAgB,MAAM,CAAC,MAAM,EAAE,+BAA+B,GAAG,yBAAyB,CAEzF;CACF"}

package/lib/cjs/render/ParticleCollectionBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"ParticleCollectionBuilder.js","sourceRoot":"","sources":["../../../src/render/ParticleCollectionBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { Id64String } from \"@itwin/core-bentley\";\r\nimport { Matrix3d, Point2d, Point3d, Range3d, Transform, Vector2d, XAndY, XYAndZ } from \"@itwin/core-geometry\";\r\nimport {\r\n  ColorDef, ColorIndex, Feature, FeatureIndex, FeatureTable, FillFlags, PackedFeatureTable, QParams3d, QPoint3dList, RenderTexture,\r\n} from \"@itwin/core-common\";\r\nimport { Viewport } from \"../Viewport\";\r\nimport { RenderGraphic } from \"./RenderGraphic\";\r\nimport { GraphicBranch } from \"./GraphicBranch\";\r\nimport { MeshParams } from \"./primitives/VertexTable\";\r\nimport { MeshArgs } from \"./primitives/mesh/MeshPrimitives\";\r\nimport { DisplayParams } from \"./primitives/DisplayParams\";\r\n\r\n/** Parameters used to construct a [[ParticleCollectionBuilder]].\r\n * @public\r\n */\r\nexport interface ParticleCollectionBuilderParams {\r\n  /** The image mapped to each particle quad.\r\n   * @note The texture should be disposed of when no longer needed to free up WebGL resources. For example, if a [[Decorator]] creates the texture, the\r\n   * texture should probably be disposed of when the decorator is removed from the [[ViewManager]].\r\n   */\r\n  texture: RenderTexture;\r\n\r\n  /** The default extents of the particle quad. Individual particles may apply a scale to these extents to produce particles of varying dimensions.\r\n   * Must be positive.\r\n   */\r\n  size: XAndY | number;\r\n\r\n  /** The initial transparency of the particles as an integer in [0,255]. Defaults to zero if omitted. */\r\n  transparency?: number;\r\n\r\n  /** The origin of the particle collection in world coordinates. Defaults to (0, 0, 0). */\r\n  origin?: XYAndZ;\r\n\r\n  /** If the particles are to be pickable, a unique identifier to associate with the resultant [[RenderGraphic]].\r\n   * @see [[IModelConnection.transientIdSequence]] to obtain an Id that is unique within an iModel.\r\n   */\r\n  pickableId?: Id64String;\r\n\r\n  /** The viewport in which the particles will be drawn. */\r\n  viewport: Viewport;\r\n\r\n  /** If true, the finished graphic will be defined in view coordinates, for use as a decoration of type [[GraphicType.ViewBackground]] or [[GraphicType.ViewOverlay]].\r\n   * Defaults to false, indicating the graphic will be defined in world coordinates.\r\n   * @see [[CoordSystem.View]] and [[CoordSystem.World]].\r\n   */\r\n  isViewCoords?: boolean;\r\n}\r\n\r\n/** Describes a particle to to add to a particle collection via [[ParticleCollectionBuilder.addParticle]].\r\n * The x, y, and z coordinates represent the centroid of the particle quad in the collection's coordinate space.\r\n * @public\r\n */\r\nexport interface ParticleProps extends XYAndZ {\r\n  /** The size of the particle, in the collection's coordinate space. If omitted, it defaults to the size supplied to the collection by [[ParticleCollectionBuilderParams.size]].\r\n   * Supplying a `number` produces a square; supplying a non-uniform `XAndY` produces a rectangle. Must be positive.\r\n   */\r\n  size?: XAndY | number;\r\n\r\n  /** The transparency with which to draw the particle as an integer in [0,255]. If omitted, it defaults to the current value of [[ParticleCollectionBuilder.transparency]]. */\r\n  transparency?: number;\r\n\r\n  /** A rotation matrix to orient the particle.  If supplied then the particle will not be automatically oriented towards the camera. */\r\n  rotationMatrix?: Matrix3d;\r\n}\r\n\r\n/** Interface for producing a collection of particles suitable for use in particle effects.\r\n * Particle effects involve animating hundreds or thousands of small particles to simulate phenomena like smoke, fire, snow, etc.\r\n * A particle collection represents each particle as a quad (rectangle) displaying an image. The position of each particle corresponds to the\r\n * centroid of its quad. The transparency and size of each particle can be specified individually. By default, the quads will always rotate to face the camera\r\n * such that the image is fully visible.\r\n *\r\n * Creating a particle collection using a ParticleCollectionBuilder is far more efficient (in both CPU and GPU usage) than doing so using a [[GraphicBuilder]].\r\n * @see interactive demonstrations of [Snow and Rain](https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=snow-rain-sample&imodel=Villa) and\r\n   * [Fire and Smoke](https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=fire-sample&imodel=Villa) particle effects.\r\n * @see [SnowEffect]($frontend-devtools) for an example of a particle effect.\r\n * @public\r\n */\r\nexport interface ParticleCollectionBuilder {\r\n  /** The default transparency for newly-added particles as an integer in [0,255], used by [[ParticleCollectionBuilder.addParticle]] if [[ParticleProps.transparency]] is omitted.\r\n   * Changing this value has no effect on the transparency of previously-added particles.\r\n   */\r\n  transparency: number;\r\n\r\n  /** The default size of each particle, used by [[ParticleCollectionBuilder.addParticle]] if [[ParticleProps.size]] is omitted. */\r\n  size: XAndY;\r\n\r\n  /** Add a particle to the collection.\r\n   * If `size` is omitted, `this.size` is used.\r\n   * If `transparency` is omitted, `this.transparency` is used.\r\n   * @throws Error if particle size is defined and not greater than zero.\r\n   */\r\n  addParticle: (particle: ParticleProps) => void;\r\n\r\n  /** Produces a finished graphic from the accumulated particles.\r\n   * It returns the finished graphic, or `undefined` if the collection contains no particles or the [[RenderSystem]] failed to produce the graphic.\r\n   * @note After this method returns, the particle collection is empty.\r\n   */\r\n  finish: () => RenderGraphic | undefined;\r\n}\r\n\r\n/** @public */\r\nexport namespace ParticleCollectionBuilder {\r\n  /** Creates a new ParticleCollectionBuilder.\r\n   * @throws Error if size is not greater than zero.\r\n   */\r\n  export function create(params: ParticleCollectionBuilderParams): ParticleCollectionBuilder {\r\n    return new Builder(params);\r\n  }\r\n}\r\n\r\nclass Particle {\r\n  public readonly centroid: Point3d;\r\n  public readonly transparency: number;\r\n  public readonly width: number;\r\n  public readonly height: number;\r\n  public readonly rotationMatrix?: Matrix3d;\r\n\r\n  public constructor(centroid: XYAndZ, width: number, height: number, transparency: number, rotationMatrix?: Matrix3d) {\r\n    this.centroid = Point3d.fromJSON(centroid);\r\n    this.transparency = transparency;\r\n    this.width = width;\r\n    this.height = height;\r\n    this.rotationMatrix = rotationMatrix;\r\n  }\r\n}\r\n\r\nclass Builder implements ParticleCollectionBuilder {\r\n  private readonly _viewport: Viewport;\r\n  private readonly _isViewCoords: boolean;\r\n  private readonly _pickableId?: Id64String;\r\n  private readonly _texture: RenderTexture;\r\n  private readonly _size: Vector2d;\r\n  private _transparency: number;\r\n  private _hasVaryingTransparency = false;\r\n  private readonly _localToWorldTransform: Transform;\r\n  private readonly _range = Range3d.createNull();\r\n  private _particlesOpaque: Particle[] = [];\r\n  private _particlesTranslucent: Particle[] = [];\r\n\r\n  public constructor(params: ParticleCollectionBuilderParams) {\r\n    this._viewport = params.viewport;\r\n    this._isViewCoords = true === params.isViewCoords;\r\n    this._pickableId = params.pickableId;\r\n    this._texture = params.texture;\r\n    this._transparency = undefined !== params.transparency ? clampTransparency(params.transparency) : 0;\r\n    this._localToWorldTransform = params.origin ? Transform.createTranslationXYZ(params.origin.x, params.origin.y, params.origin.z) : Transform.createIdentity();\r\n\r\n    if (\"number\" === typeof params.size)\r\n      this._size = new Vector2d(params.size, params.size);\r\n    else\r\n      this._size = Vector2d.fromJSON(params.size);\r\n\r\n    if (this._size.x <= 0 || this._size.y <= 0)\r\n      throw new Error(\"Particle size must be greater than zero\");\r\n  }\r\n\r\n  public get size(): XAndY {\r\n    return this._size;\r\n  }\r\n\r\n  public get transparency() {\r\n    return this._transparency;\r\n  }\r\n\r\n  public set transparency(transparency: number) {\r\n    transparency = clampTransparency(transparency);\r\n    if (transparency !== this._transparency) {\r\n      this._transparency = transparency;\r\n      this._hasVaryingTransparency = this._particlesTranslucent.length > 0;\r\n    }\r\n  }\r\n\r\n  public addParticle(props: ParticleProps): void {\r\n    const size = props.size ?? this._size;\r\n    let width, height;\r\n    if (\"number\" === typeof size) {\r\n      width = height = size;\r\n    } else {\r\n      width = size.x;\r\n      height = size.y;\r\n    }\r\n\r\n    if (width <= 0 || height <= 0)\r\n      throw new Error(\"A particle must have a size greater than zero\");\r\n\r\n    const transparency = undefined !== props.transparency ? clampTransparency(props.transparency) : this.transparency;\r\n    if (transparency !== this.transparency && this._particlesTranslucent.length > 0)\r\n      this._hasVaryingTransparency = true;\r\n\r\n    const particle = new Particle(props, width, height, transparency, props.rotationMatrix);\r\n    if (transparency > 0)\r\n      this._particlesTranslucent.push(particle);\r\n    else\r\n      this._particlesOpaque.push(particle);\r\n    this._range.extendPoint(particle.centroid);\r\n  }\r\n\r\n  public finish(): RenderGraphic | undefined {\r\n    if (0 === this._particlesTranslucent.length + this._particlesOpaque.length)\r\n      return undefined;\r\n\r\n    // Order-independent transparency doesn't work well with opaque geometry - it will look semi-transparent.\r\n    // If we have a mix of opaque and transparent particles, put them in separate graphics to be rendered in separate passes.\r\n    const opaque = this.createGraphic(this._particlesOpaque, 0);\r\n    const transparent = this.createGraphic(this._particlesTranslucent, this._hasVaryingTransparency ? undefined : this._transparency);\r\n\r\n    // Empty the collection before any return statements.\r\n    const range = this._range.clone();\r\n    this._range.setNull();\r\n    this._particlesOpaque.length = 0;\r\n    this._particlesTranslucent.length = 0;\r\n    this._hasVaryingTransparency = false;\r\n\r\n    if (!transparent && !opaque)\r\n      return undefined;\r\n\r\n    // Transform from origin to collection, then to world.\r\n    const toCollection = Transform.createTranslation(range.center);\r\n    const toWorld = toCollection.multiplyTransformTransform(this._localToWorldTransform);\r\n    const branch = new GraphicBranch(true);\r\n    if (opaque)\r\n      branch.add(opaque);\r\n\r\n    if (transparent)\r\n      branch.add(transparent);\r\n\r\n    let graphic = this._viewport.target.renderSystem.createGraphicBranch(branch, toWorld);\r\n\r\n    // If we have a pickable Id, produce a batch.\r\n    // NB: We pass this._pickableId as the FeatureTable's modelId so that it will be treated like a reality model or a map -\r\n    // specifically, it can be located and display a tooltip, but can't be selected.\r\n    const featureTable = this._pickableId ? new FeatureTable(1, this._pickableId) : undefined;\r\n    if (featureTable) {\r\n      this._localToWorldTransform.multiplyRange(range, range);\r\n      featureTable.insert(new Feature(this._pickableId));\r\n      graphic = this._viewport.target.renderSystem.createBatch(graphic, PackedFeatureTable.pack(featureTable), range);\r\n    }\r\n\r\n    return graphic;\r\n  }\r\n\r\n  private createGraphic(particles: Particle[], uniformTransparency: number | undefined): RenderGraphic | undefined {\r\n    const numParticles = particles.length;\r\n    if (numParticles <= 0)\r\n      return undefined;\r\n\r\n    // To keep scale values close to 1, compute mean size to use as size of quad.\r\n    const meanSize = new Vector2d();\r\n    let maxSize = 0;\r\n    for (const particle of particles) {\r\n      meanSize.x += particle.width;\r\n      meanSize.y += particle.height;\r\n      if (particle.width > maxSize)\r\n        maxSize = particle.width;\r\n      if (particle.height > maxSize)\r\n        maxSize = particle.height;\r\n    }\r\n    meanSize.x /= numParticles;\r\n    meanSize.y /= numParticles;\r\n\r\n    // Define InstancedGraphicParams for particles.\r\n    const rangeCenter = this._range.center;\r\n    const floatsPerTransform = 12;\r\n    const transforms = new Float32Array(floatsPerTransform * numParticles);\r\n    const bytesPerOverride = 8;\r\n    const symbologyOverrides = undefined === uniformTransparency ? new Uint8Array(bytesPerOverride * numParticles) : undefined;\r\n\r\n    const viewToWorld = this._viewport.view.getRotation().transpose();\r\n    let tfIndex = 0;\r\n    let ovrIndex = 0;\r\n    for (const particle of particles) {\r\n      const scaleX = particle.width / meanSize.x;\r\n      const scaleY = particle.height / meanSize.y;\r\n      if (this._isViewCoords) {\r\n        // Particles already face the camera in view coords - just apply the scale.\r\n        transforms[tfIndex + 0] = scaleX;\r\n        transforms[tfIndex + 5] = scaleY;\r\n        transforms[tfIndex + 10] = 1;\r\n      } else if (undefined !== particle.rotationMatrix) {\r\n        // Scale rotation matrix relative to size of quad.\r\n        transforms[tfIndex + 0] = particle.rotationMatrix.coffs[0] * scaleX;\r\n        transforms[tfIndex + 1] = particle.rotationMatrix.coffs[1] * scaleY;\r\n        transforms[tfIndex + 2] = particle.rotationMatrix.coffs[2];\r\n        transforms[tfIndex + 4] = particle.rotationMatrix.coffs[3] * scaleX;\r\n        transforms[tfIndex + 5] = particle.rotationMatrix.coffs[4] * scaleY;\r\n        transforms[tfIndex + 6] = particle.rotationMatrix.coffs[5];\r\n        transforms[tfIndex + 8] = particle.rotationMatrix.coffs[6] * scaleX;\r\n        transforms[tfIndex + 9] = particle.rotationMatrix.coffs[7] * scaleY;\r\n        transforms[tfIndex + 10] = particle.rotationMatrix.coffs[8];\r\n      } else {\r\n        // Rotate about origin by inverse view matrix so quads always face the camera and scale relative to size of quad.\r\n        transforms[tfIndex + 0] = viewToWorld.coffs[0] * scaleX;\r\n        transforms[tfIndex + 1] = viewToWorld.coffs[1] * scaleY;\r\n        transforms[tfIndex + 2] = viewToWorld.coffs[2];\r\n        transforms[tfIndex + 4] = viewToWorld.coffs[3] * scaleX;\r\n        transforms[tfIndex + 5] = viewToWorld.coffs[4] * scaleY;\r\n        transforms[tfIndex + 6] = viewToWorld.coffs[5];\r\n        transforms[tfIndex + 8] = viewToWorld.coffs[6] * scaleX;\r\n        transforms[tfIndex + 9] = viewToWorld.coffs[7] * scaleY;\r\n        transforms[tfIndex + 10] = viewToWorld.coffs[8];\r\n      }\r\n\r\n      // Translate relative to center of particles range.\r\n      transforms[tfIndex + 3] = particle.centroid.x - rangeCenter.x;\r\n      transforms[tfIndex + 7] = particle.centroid.y - rangeCenter.y;\r\n      transforms[tfIndex + 11] = particle.centroid.z - rangeCenter.z;\r\n\r\n      tfIndex += floatsPerTransform;\r\n\r\n      if (symbologyOverrides) {\r\n        // See FeatureOverrides.buildLookupTable() for layout.\r\n        symbologyOverrides[ovrIndex + 0] = 1 << 2; // OvrFlags.Alpha\r\n        symbologyOverrides[ovrIndex + 7] = 0xff - particle.transparency;\r\n\r\n        ovrIndex += bytesPerOverride;\r\n      }\r\n    }\r\n\r\n    // Produce instanced quads.\r\n    // Note: We do not need to allocate an array of featureIds. If we have a pickableId, all particles refer to the same Feature, with index 0.\r\n    // So we leave the vertex attribute disabled causing the shader to receive the default (0, 0, 0) which happens to correspond to our feature index.\r\n    const quad = createQuad(meanSize, this._texture, uniformTransparency ?? 0x7f);\r\n    const transformCenter = new Point3d(0, 0, 0);\r\n    const range = computeRange(this._range, rangeCenter, maxSize);\r\n    const instances = { count: numParticles, transforms, transformCenter, symbologyOverrides, range };\r\n    return this._viewport.target.renderSystem.createMesh(quad, instances);\r\n  }\r\n}\r\n\r\nfunction createQuad(size: XAndY, texture: RenderTexture, transparency: number): MeshParams {\r\n  const halfWidth = size.x / 2;\r\n  const halfHeight = size.y / 2;\r\n  const corners = [\r\n    new Point3d(-halfWidth, -halfHeight, 0), new Point3d(halfWidth, -halfHeight, 0),\r\n    new Point3d(-halfWidth, halfHeight, 0), new Point3d(halfWidth, halfHeight, 0),\r\n  ];\r\n\r\n  const range = new Range3d();\r\n  range.low = corners[0];\r\n  range.high = corners[3];\r\n\r\n  const points = new QPoint3dList(QParams3d.fromRange(range));\r\n  for (const corner of corners)\r\n    points.add(corner);\r\n\r\n  const colors = new ColorIndex();\r\n  colors.initUniform(ColorDef.white.withTransparency(transparency));\r\n\r\n  const quadArgs: MeshArgs = {\r\n    points,\r\n    vertIndices: [0, 1, 2, 2, 1, 3],\r\n    fillFlags: FillFlags.None,\r\n    isPlanar: true,\r\n    colors,\r\n    features: new FeatureIndex(),\r\n    textureMapping: {\r\n      texture,\r\n      uvParams: [new Point2d(0, 1), new Point2d(1, 1), new Point2d(0, 0), new Point2d(1, 0)],\r\n    },\r\n  };\r\n\r\n  return MeshParams.create(quadArgs);\r\n}\r\n\r\nfunction clampTransparency(transparency: number): number {\r\n  transparency = Math.min(255, transparency, Math.max(0, transparency));\r\n  transparency = Math.floor(transparency);\r\n  if (transparency < DisplayParams.minTransparency)\r\n    transparency = 0;\r\n\r\n  return transparency;\r\n}\r\n\r\nfunction computeRange(centroidRange: Range3d, center: Point3d, maxSize: number): Range3d {\r\n  const range2 = centroidRange.clone();\r\n  range2.low.subtractInPlace(center);\r\n  range2.high.subtractInPlace(center);\r\n  const halfSize = maxSize * 0.5;\r\n  range2.low.x -= halfSize;\r\n  range2.low.y -= halfSize;\r\n  range2.low.z -= halfSize;\r\n  range2.high.x += halfSize;\r\n  range2.high.y += halfSize;\r\n  range2.high.z += halfSize;\r\n  return range2;\r\n}\r\n"]}
+{"version":3,"file":"ParticleCollectionBuilder.js","sourceRoot":"","sources":["../../../src/render/ParticleCollectionBuilder.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { Id64String } from \"@itwin/core-bentley\";\r\nimport { Matrix3d, Point2d, Point3d, Range3d, Transform, Vector2d, XAndY, XYAndZ } from \"@itwin/core-geometry\";\r\nimport {\r\n  ColorDef, ColorIndex, Feature, FeatureIndex, FeatureTable, FillFlags, PackedFeatureTable, QParams3d, QPoint3dList, RenderTexture,\r\n} from \"@itwin/core-common\";\r\nimport { Viewport } from \"../Viewport\";\r\nimport { RenderGraphic } from \"./RenderGraphic\";\r\nimport { GraphicBranch } from \"./GraphicBranch\";\r\nimport { MeshParams } from \"./primitives/VertexTable\";\r\nimport { MeshArgs } from \"./primitives/mesh/MeshPrimitives\";\r\nimport { DisplayParams } from \"./primitives/DisplayParams\";\r\n\r\n/** Parameters used to construct a [[ParticleCollectionBuilder]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ParticleCollectionBuilderParams {\r\n  /** The image mapped to each particle quad.\r\n   * @note The texture should be disposed of when no longer needed to free up WebGL resources. For example, if a [[Decorator]] creates the texture, the\r\n   * texture should probably be disposed of when the decorator is removed from the [[ViewManager]].\r\n   */\r\n  texture: RenderTexture;\r\n\r\n  /** The default extents of the particle quad. Individual particles may apply a scale to these extents to produce particles of varying dimensions.\r\n   * Must be positive.\r\n   */\r\n  size: XAndY | number;\r\n\r\n  /** The initial transparency of the particles as an integer in [0,255]. Defaults to zero if omitted. */\r\n  transparency?: number;\r\n\r\n  /** The origin of the particle collection in world coordinates. Defaults to (0, 0, 0). */\r\n  origin?: XYAndZ;\r\n\r\n  /** If the particles are to be pickable, a unique identifier to associate with the resultant [[RenderGraphic]].\r\n   * @see [[IModelConnection.transientIdSequence]] to obtain an Id that is unique within an iModel.\r\n   */\r\n  pickableId?: Id64String;\r\n\r\n  /** The viewport in which the particles will be drawn. */\r\n  viewport: Viewport;\r\n\r\n  /** If true, the finished graphic will be defined in view coordinates, for use as a decoration of type [[GraphicType.ViewBackground]] or [[GraphicType.ViewOverlay]].\r\n   * Defaults to false, indicating the graphic will be defined in world coordinates.\r\n   * @see [[CoordSystem.View]] and [[CoordSystem.World]].\r\n   */\r\n  isViewCoords?: boolean;\r\n}\r\n\r\n/** Describes a particle to to add to a particle collection via [[ParticleCollectionBuilder.addParticle]].\r\n * The x, y, and z coordinates represent the centroid of the particle quad in the collection's coordinate space.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ParticleProps extends XYAndZ {\r\n  /** The size of the particle, in the collection's coordinate space. If omitted, it defaults to the size supplied to the collection by [[ParticleCollectionBuilderParams.size]].\r\n   * Supplying a `number` produces a square; supplying a non-uniform `XAndY` produces a rectangle. Must be positive.\r\n   */\r\n  size?: XAndY | number;\r\n\r\n  /** The transparency with which to draw the particle as an integer in [0,255]. If omitted, it defaults to the current value of [[ParticleCollectionBuilder.transparency]]. */\r\n  transparency?: number;\r\n\r\n  /** A rotation matrix to orient the particle.  If supplied then the particle will not be automatically oriented towards the camera. */\r\n  rotationMatrix?: Matrix3d;\r\n}\r\n\r\n/** Interface for producing a collection of particles suitable for use in particle effects.\r\n * Particle effects involve animating hundreds or thousands of small particles to simulate phenomena like smoke, fire, snow, etc.\r\n * A particle collection represents each particle as a quad (rectangle) displaying an image. The position of each particle corresponds to the\r\n * centroid of its quad. The transparency and size of each particle can be specified individually. By default, the quads will always rotate to face the camera\r\n * such that the image is fully visible.\r\n *\r\n * Creating a particle collection using a ParticleCollectionBuilder is far more efficient (in both CPU and GPU usage) than doing so using a [[GraphicBuilder]].\r\n * @see interactive demonstrations of [Snow and Rain](https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=snow-rain-sample&imodel=Villa) and\r\n   * [Fire and Smoke](https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=fire-sample&imodel=Villa) particle effects.\r\n * @see [SnowEffect]($frontend-devtools) for an example of a particle effect.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ParticleCollectionBuilder {\r\n  /** The default transparency for newly-added particles as an integer in [0,255], used by [[ParticleCollectionBuilder.addParticle]] if [[ParticleProps.transparency]] is omitted.\r\n   * Changing this value has no effect on the transparency of previously-added particles.\r\n   */\r\n  transparency: number;\r\n\r\n  /** The default size of each particle, used by [[ParticleCollectionBuilder.addParticle]] if [[ParticleProps.size]] is omitted. */\r\n  size: XAndY;\r\n\r\n  /** Add a particle to the collection.\r\n   * If `size` is omitted, `this.size` is used.\r\n   * If `transparency` is omitted, `this.transparency` is used.\r\n   * @throws Error if particle size is defined and not greater than zero.\r\n   */\r\n  addParticle: (particle: ParticleProps) => void;\r\n\r\n  /** Produces a finished graphic from the accumulated particles.\r\n   * It returns the finished graphic, or `undefined` if the collection contains no particles or the [[RenderSystem]] failed to produce the graphic.\r\n   * @note After this method returns, the particle collection is empty.\r\n   */\r\n  finish: () => RenderGraphic | undefined;\r\n}\r\n\r\n/** @public */\r\nexport namespace ParticleCollectionBuilder {\r\n  /** Creates a new ParticleCollectionBuilder.\r\n   * @throws Error if size is not greater than zero.\r\n   */\r\n  export function create(params: ParticleCollectionBuilderParams): ParticleCollectionBuilder {\r\n    return new Builder(params);\r\n  }\r\n}\r\n\r\nclass Particle {\r\n  public readonly centroid: Point3d;\r\n  public readonly transparency: number;\r\n  public readonly width: number;\r\n  public readonly height: number;\r\n  public readonly rotationMatrix?: Matrix3d;\r\n\r\n  public constructor(centroid: XYAndZ, width: number, height: number, transparency: number, rotationMatrix?: Matrix3d) {\r\n    this.centroid = Point3d.fromJSON(centroid);\r\n    this.transparency = transparency;\r\n    this.width = width;\r\n    this.height = height;\r\n    this.rotationMatrix = rotationMatrix;\r\n  }\r\n}\r\n\r\nclass Builder implements ParticleCollectionBuilder {\r\n  private readonly _viewport: Viewport;\r\n  private readonly _isViewCoords: boolean;\r\n  private readonly _pickableId?: Id64String;\r\n  private readonly _texture: RenderTexture;\r\n  private readonly _size: Vector2d;\r\n  private _transparency: number;\r\n  private _hasVaryingTransparency = false;\r\n  private readonly _localToWorldTransform: Transform;\r\n  private readonly _range = Range3d.createNull();\r\n  private _particlesOpaque: Particle[] = [];\r\n  private _particlesTranslucent: Particle[] = [];\r\n\r\n  public constructor(params: ParticleCollectionBuilderParams) {\r\n    this._viewport = params.viewport;\r\n    this._isViewCoords = true === params.isViewCoords;\r\n    this._pickableId = params.pickableId;\r\n    this._texture = params.texture;\r\n    this._transparency = undefined !== params.transparency ? clampTransparency(params.transparency) : 0;\r\n    this._localToWorldTransform = params.origin ? Transform.createTranslationXYZ(params.origin.x, params.origin.y, params.origin.z) : Transform.createIdentity();\r\n\r\n    if (\"number\" === typeof params.size)\r\n      this._size = new Vector2d(params.size, params.size);\r\n    else\r\n      this._size = Vector2d.fromJSON(params.size);\r\n\r\n    if (this._size.x <= 0 || this._size.y <= 0)\r\n      throw new Error(\"Particle size must be greater than zero\");\r\n  }\r\n\r\n  public get size(): XAndY {\r\n    return this._size;\r\n  }\r\n\r\n  public get transparency() {\r\n    return this._transparency;\r\n  }\r\n\r\n  public set transparency(transparency: number) {\r\n    transparency = clampTransparency(transparency);\r\n    if (transparency !== this._transparency) {\r\n      this._transparency = transparency;\r\n      this._hasVaryingTransparency = this._particlesTranslucent.length > 0;\r\n    }\r\n  }\r\n\r\n  public addParticle(props: ParticleProps): void {\r\n    const size = props.size ?? this._size;\r\n    let width, height;\r\n    if (\"number\" === typeof size) {\r\n      width = height = size;\r\n    } else {\r\n      width = size.x;\r\n      height = size.y;\r\n    }\r\n\r\n    if (width <= 0 || height <= 0)\r\n      throw new Error(\"A particle must have a size greater than zero\");\r\n\r\n    const transparency = undefined !== props.transparency ? clampTransparency(props.transparency) : this.transparency;\r\n    if (transparency !== this.transparency && this._particlesTranslucent.length > 0)\r\n      this._hasVaryingTransparency = true;\r\n\r\n    const particle = new Particle(props, width, height, transparency, props.rotationMatrix);\r\n    if (transparency > 0)\r\n      this._particlesTranslucent.push(particle);\r\n    else\r\n      this._particlesOpaque.push(particle);\r\n    this._range.extendPoint(particle.centroid);\r\n  }\r\n\r\n  public finish(): RenderGraphic | undefined {\r\n    if (0 === this._particlesTranslucent.length + this._particlesOpaque.length)\r\n      return undefined;\r\n\r\n    // Order-independent transparency doesn't work well with opaque geometry - it will look semi-transparent.\r\n    // If we have a mix of opaque and transparent particles, put them in separate graphics to be rendered in separate passes.\r\n    const opaque = this.createGraphic(this._particlesOpaque, 0);\r\n    const transparent = this.createGraphic(this._particlesTranslucent, this._hasVaryingTransparency ? undefined : this._transparency);\r\n\r\n    // Empty the collection before any return statements.\r\n    const range = this._range.clone();\r\n    this._range.setNull();\r\n    this._particlesOpaque.length = 0;\r\n    this._particlesTranslucent.length = 0;\r\n    this._hasVaryingTransparency = false;\r\n\r\n    if (!transparent && !opaque)\r\n      return undefined;\r\n\r\n    // Transform from origin to collection, then to world.\r\n    const toCollection = Transform.createTranslation(range.center);\r\n    const toWorld = toCollection.multiplyTransformTransform(this._localToWorldTransform);\r\n    const branch = new GraphicBranch(true);\r\n    if (opaque)\r\n      branch.add(opaque);\r\n\r\n    if (transparent)\r\n      branch.add(transparent);\r\n\r\n    let graphic = this._viewport.target.renderSystem.createGraphicBranch(branch, toWorld);\r\n\r\n    // If we have a pickable Id, produce a batch.\r\n    // NB: We pass this._pickableId as the FeatureTable's modelId so that it will be treated like a reality model or a map -\r\n    // specifically, it can be located and display a tooltip, but can't be selected.\r\n    const featureTable = this._pickableId ? new FeatureTable(1, this._pickableId) : undefined;\r\n    if (featureTable) {\r\n      this._localToWorldTransform.multiplyRange(range, range);\r\n      featureTable.insert(new Feature(this._pickableId));\r\n      graphic = this._viewport.target.renderSystem.createBatch(graphic, PackedFeatureTable.pack(featureTable), range);\r\n    }\r\n\r\n    return graphic;\r\n  }\r\n\r\n  private createGraphic(particles: Particle[], uniformTransparency: number | undefined): RenderGraphic | undefined {\r\n    const numParticles = particles.length;\r\n    if (numParticles <= 0)\r\n      return undefined;\r\n\r\n    // To keep scale values close to 1, compute mean size to use as size of quad.\r\n    const meanSize = new Vector2d();\r\n    let maxSize = 0;\r\n    for (const particle of particles) {\r\n      meanSize.x += particle.width;\r\n      meanSize.y += particle.height;\r\n      if (particle.width > maxSize)\r\n        maxSize = particle.width;\r\n      if (particle.height > maxSize)\r\n        maxSize = particle.height;\r\n    }\r\n    meanSize.x /= numParticles;\r\n    meanSize.y /= numParticles;\r\n\r\n    // Define InstancedGraphicParams for particles.\r\n    const rangeCenter = this._range.center;\r\n    const floatsPerTransform = 12;\r\n    const transforms = new Float32Array(floatsPerTransform * numParticles);\r\n    const bytesPerOverride = 8;\r\n    const symbologyOverrides = undefined === uniformTransparency ? new Uint8Array(bytesPerOverride * numParticles) : undefined;\r\n\r\n    const viewToWorld = this._viewport.view.getRotation().transpose();\r\n    let tfIndex = 0;\r\n    let ovrIndex = 0;\r\n    for (const particle of particles) {\r\n      const scaleX = particle.width / meanSize.x;\r\n      const scaleY = particle.height / meanSize.y;\r\n      if (this._isViewCoords) {\r\n        // Particles already face the camera in view coords - just apply the scale.\r\n        transforms[tfIndex + 0] = scaleX;\r\n        transforms[tfIndex + 5] = scaleY;\r\n        transforms[tfIndex + 10] = 1;\r\n      } else if (undefined !== particle.rotationMatrix) {\r\n        // Scale rotation matrix relative to size of quad.\r\n        transforms[tfIndex + 0] = particle.rotationMatrix.coffs[0] * scaleX;\r\n        transforms[tfIndex + 1] = particle.rotationMatrix.coffs[1] * scaleY;\r\n        transforms[tfIndex + 2] = particle.rotationMatrix.coffs[2];\r\n        transforms[tfIndex + 4] = particle.rotationMatrix.coffs[3] * scaleX;\r\n        transforms[tfIndex + 5] = particle.rotationMatrix.coffs[4] * scaleY;\r\n        transforms[tfIndex + 6] = particle.rotationMatrix.coffs[5];\r\n        transforms[tfIndex + 8] = particle.rotationMatrix.coffs[6] * scaleX;\r\n        transforms[tfIndex + 9] = particle.rotationMatrix.coffs[7] * scaleY;\r\n        transforms[tfIndex + 10] = particle.rotationMatrix.coffs[8];\r\n      } else {\r\n        // Rotate about origin by inverse view matrix so quads always face the camera and scale relative to size of quad.\r\n        transforms[tfIndex + 0] = viewToWorld.coffs[0] * scaleX;\r\n        transforms[tfIndex + 1] = viewToWorld.coffs[1] * scaleY;\r\n        transforms[tfIndex + 2] = viewToWorld.coffs[2];\r\n        transforms[tfIndex + 4] = viewToWorld.coffs[3] * scaleX;\r\n        transforms[tfIndex + 5] = viewToWorld.coffs[4] * scaleY;\r\n        transforms[tfIndex + 6] = viewToWorld.coffs[5];\r\n        transforms[tfIndex + 8] = viewToWorld.coffs[6] * scaleX;\r\n        transforms[tfIndex + 9] = viewToWorld.coffs[7] * scaleY;\r\n        transforms[tfIndex + 10] = viewToWorld.coffs[8];\r\n      }\r\n\r\n      // Translate relative to center of particles range.\r\n      transforms[tfIndex + 3] = particle.centroid.x - rangeCenter.x;\r\n      transforms[tfIndex + 7] = particle.centroid.y - rangeCenter.y;\r\n      transforms[tfIndex + 11] = particle.centroid.z - rangeCenter.z;\r\n\r\n      tfIndex += floatsPerTransform;\r\n\r\n      if (symbologyOverrides) {\r\n        // See FeatureOverrides.buildLookupTable() for layout.\r\n        symbologyOverrides[ovrIndex + 0] = 1 << 2; // OvrFlags.Alpha\r\n        symbologyOverrides[ovrIndex + 7] = 0xff - particle.transparency;\r\n\r\n        ovrIndex += bytesPerOverride;\r\n      }\r\n    }\r\n\r\n    // Produce instanced quads.\r\n    // Note: We do not need to allocate an array of featureIds. If we have a pickableId, all particles refer to the same Feature, with index 0.\r\n    // So we leave the vertex attribute disabled causing the shader to receive the default (0, 0, 0) which happens to correspond to our feature index.\r\n    const quad = createQuad(meanSize, this._texture, uniformTransparency ?? 0x7f);\r\n    const transformCenter = new Point3d(0, 0, 0);\r\n    const range = computeRange(this._range, rangeCenter, maxSize);\r\n    const instances = { count: numParticles, transforms, transformCenter, symbologyOverrides, range };\r\n    return this._viewport.target.renderSystem.createMesh(quad, instances);\r\n  }\r\n}\r\n\r\nfunction createQuad(size: XAndY, texture: RenderTexture, transparency: number): MeshParams {\r\n  const halfWidth = size.x / 2;\r\n  const halfHeight = size.y / 2;\r\n  const corners = [\r\n    new Point3d(-halfWidth, -halfHeight, 0), new Point3d(halfWidth, -halfHeight, 0),\r\n    new Point3d(-halfWidth, halfHeight, 0), new Point3d(halfWidth, halfHeight, 0),\r\n  ];\r\n\r\n  const range = new Range3d();\r\n  range.low = corners[0];\r\n  range.high = corners[3];\r\n\r\n  const points = new QPoint3dList(QParams3d.fromRange(range));\r\n  for (const corner of corners)\r\n    points.add(corner);\r\n\r\n  const colors = new ColorIndex();\r\n  colors.initUniform(ColorDef.white.withTransparency(transparency));\r\n\r\n  const quadArgs: MeshArgs = {\r\n    points,\r\n    vertIndices: [0, 1, 2, 2, 1, 3],\r\n    fillFlags: FillFlags.None,\r\n    isPlanar: true,\r\n    colors,\r\n    features: new FeatureIndex(),\r\n    textureMapping: {\r\n      texture,\r\n      uvParams: [new Point2d(0, 1), new Point2d(1, 1), new Point2d(0, 0), new Point2d(1, 0)],\r\n    },\r\n  };\r\n\r\n  return MeshParams.create(quadArgs);\r\n}\r\n\r\nfunction clampTransparency(transparency: number): number {\r\n  transparency = Math.min(255, transparency, Math.max(0, transparency));\r\n  transparency = Math.floor(transparency);\r\n  if (transparency < DisplayParams.minTransparency)\r\n    transparency = 0;\r\n\r\n  return transparency;\r\n}\r\n\r\nfunction computeRange(centroidRange: Range3d, center: Point3d, maxSize: number): Range3d {\r\n  const range2 = centroidRange.clone();\r\n  range2.low.subtractInPlace(center);\r\n  range2.high.subtractInPlace(center);\r\n  const halfSize = maxSize * 0.5;\r\n  range2.low.x -= halfSize;\r\n  range2.low.y -= halfSize;\r\n  range2.low.z -= halfSize;\r\n  range2.high.x += halfSize;\r\n  range2.high.y += halfSize;\r\n  range2.high.z += halfSize;\r\n  return range2;\r\n}\r\n"]}

package/lib/cjs/render/Pixel.d.ts

@@ -7,6 +7,7 @@ import { IModelConnection } from "../IModelConnection";
 /** Describes aspects of a pixel as read from a [[Viewport]].
  * @see [[Viewport.readPixels]].
  * @public
+ * @extensions
  */
 export declare namespace Pixel {
     /** Describes a single pixel within a [[Pixel.Buffer]]. */

package/lib/cjs/render/Pixel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pixel.d.ts","sourceRoot":"","sources":["../../../src/render/Pixel.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAa,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;GAGG;AACH,yBAAiB,KAAK,CAAC;IACrB,0DAA0D;IAC1D,MAAa,IAAI;QACf,2CAA2C;QAC3C,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClC,sHAAsH;QACtH,SAAgB,gBAAgB,EAAE,MAAM,CAAC;QACzC,oDAAoD;QACpD,SAAgB,IAAI,EAAE,YAAY,CAAC;QACnC,6DAA6D;QAC7D,SAAgB,SAAS,EAAE,SAAS,CAAC;QACrC,gBAAgB;QAChB,SAAgB,YAAY,CAAC,EAAE,kBAAkB,CAAC;QAClD,yEAAyE;QACzE,SAAgB,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAC1C,gBAAgB;QAChB,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChC,gBAAgB;QAChB,IAAW,YAAY,IAAI,OAAO,CAA4F;QAE9H,gBAAgB;oBACG,OAAO,CAAC,EAAE,OAAO,EAAE,gBAAgB,SAAO,EAAE,IAAI,eAAuB,EAAE,SAAS,YAAoB,EAAE,YAAY,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM;QAUxM,qDAAqD;QACrD,IAAW,SAAS,IAAI,UAAU,GAAG,SAAS,CAE7C;QAED,qEAAqE;QACrE,IAAW,aAAa,IAAI,UAAU,GAAG,SAAS,CAEjD;QAED,qDAAqD;QACrD,IAAW,aAAa,IAAI,aAAa,GAAG,SAAS,CAEpD;KACF;IAED,uEAAuE;IACvE,KAAY,YAAY;QACtB,qGAAqG;QACrG,OAAO,IAAA;QACP,8CAA8C;QAC9C,IAAI,IAAA;QACJ,qCAAqC;QACrC,OAAO,IAAA;QACP,yDAAyD;QACzD,MAAM,IAAA;QACN,uDAAuD;QACvD,IAAI,IAAA;QACJ,wEAAwE;QACxE,UAAU,IAAA;KACX;IAED,iFAAiF;IACjF,KAAY,SAAS;QACnB,0GAA0G;QAC1G,OAAO,IAAA;QACP,8CAA8C;QAC9C,IAAI,IAAA;QACJ,2CAA2C;QAC3C,MAAM,IAAA;QACN,+CAA+C;QAC/C,SAAS,IAAA;KACV;IAED;;;OAGG;IACH,KAAY,QAAQ;QAClB,IAAI,IAAI;QACR,iIAAiI;QACjI,OAAO,IAAS;QAChB,mJAAmJ;QACnJ,mBAAmB,IAAS;QAC5B,wCAAwC;QACxC,GAAG,IAAgC;KACpC;IAED;;;OAGG;IACH,UAAiB,MAAM;QACrB,gFAAgF;QAChF,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACtC;IAED;;OAEG;IACH,KAAY,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAC7D"}
+{"version":3,"file":"Pixel.d.ts","sourceRoot":"","sources":["../../../src/render/Pixel.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAa,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;GAIG;AACH,yBAAiB,KAAK,CAAC;IACrB,0DAA0D;IAC1D,MAAa,IAAI;QACf,2CAA2C;QAC3C,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClC,sHAAsH;QACtH,SAAgB,gBAAgB,EAAE,MAAM,CAAC;QACzC,oDAAoD;QACpD,SAAgB,IAAI,EAAE,YAAY,CAAC;QACnC,6DAA6D;QAC7D,SAAgB,SAAS,EAAE,SAAS,CAAC;QACrC,gBAAgB;QAChB,SAAgB,YAAY,CAAC,EAAE,kBAAkB,CAAC;QAClD,yEAAyE;QACzE,SAAgB,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAC1C,gBAAgB;QAChB,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChC,gBAAgB;QAChB,IAAW,YAAY,IAAI,OAAO,CAA4F;QAE9H,gBAAgB;oBACG,OAAO,CAAC,EAAE,OAAO,EAAE,gBAAgB,SAAO,EAAE,IAAI,eAAuB,EAAE,SAAS,YAAoB,EAAE,YAAY,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM;QAUxM,qDAAqD;QACrD,IAAW,SAAS,IAAI,UAAU,GAAG,SAAS,CAE7C;QAED,qEAAqE;QACrE,IAAW,aAAa,IAAI,UAAU,GAAG,SAAS,CAEjD;QAED,qDAAqD;QACrD,IAAW,aAAa,IAAI,aAAa,GAAG,SAAS,CAEpD;KACF;IAED,uEAAuE;IACvE,KAAY,YAAY;QACtB,qGAAqG;QACrG,OAAO,IAAA;QACP,8CAA8C;QAC9C,IAAI,IAAA;QACJ,qCAAqC;QACrC,OAAO,IAAA;QACP,yDAAyD;QACzD,MAAM,IAAA;QACN,uDAAuD;QACvD,IAAI,IAAA;QACJ,wEAAwE;QACxE,UAAU,IAAA;KACX;IAED,iFAAiF;IACjF,KAAY,SAAS;QACnB,0GAA0G;QAC1G,OAAO,IAAA;QACP,8CAA8C;QAC9C,IAAI,IAAA;QACJ,2CAA2C;QAC3C,MAAM,IAAA;QACN,+CAA+C;QAC/C,SAAS,IAAA;KACV;IAED;;;OAGG;IACH,KAAY,QAAQ;QAClB,IAAI,IAAI;QACR,iIAAiI;QACjI,OAAO,IAAS;QAChB,mJAAmJ;QACnJ,mBAAmB,IAAS;QAC5B,wCAAwC;QACxC,GAAG,IAAgC;KACpC;IAED;;;OAGG;IACH,UAAiB,MAAM;QACrB,gFAAgF;QAChF,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACtC;IAED;;OAEG;IACH,KAAY,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAC7D"}

package/lib/cjs/render/Pixel.js

@@ -12,6 +12,7 @@ const core_common_1 = require("@itwin/core-common");
 /** Describes aspects of a pixel as read from a [[Viewport]].
  * @see [[Viewport.readPixels]].
  * @public
+ * @extensions
  */
 var Pixel;
 (function (Pixel) {

package/lib/cjs/render/Pixel.js.map

@@ -1 +1 @@
-{"version":3,"file":"Pixel.js","sourceRoot":"","sources":["../../../src/render/Pixel.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAGH,oDAA2F;AAG3F;;;GAGG;AACH,IAAiB,KAAK,CAsGrB;AAtGD,WAAiB,KAAK;IACpB,0DAA0D;IAC1D,MAAa,IAAI;QAkBf,gBAAgB;QAChB,YAAmB,OAAiB,EAAE,gBAAgB,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,EAAE,YAAiC,EAAE,MAAyB,EAAE,MAAe;YACtM,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;YACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;YAC3B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;QAZD,gBAAgB;QAChB,IAAW,YAAY,KAAc,OAAO,SAAS,KAAK,IAAI,CAAC,YAAY,IAAI,uBAAS,CAAC,OAAO,KAAK,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAa9H,qDAAqD;QACrD,IAAW,SAAS;YAClB,OAAO,SAAS,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,CAAC;QAED,qEAAqE;QACrE,IAAW,aAAa;YACtB,OAAO,SAAS,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7E,CAAC;QAED,qDAAqD;QACrD,IAAW,aAAa;YACtB,OAAO,SAAS,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7E,CAAC;KACF;IA3CY,UAAI,OA2ChB,CAAA;IAED,uEAAuE;IACvE,IAAY,YAaX;IAbD,WAAY,YAAY;QACtB,qGAAqG;QACrG,qDAAO,CAAA;QACP,8CAA8C;QAC9C,+CAAI,CAAA;QACJ,qCAAqC;QACrC,qDAAO,CAAA;QACP,yDAAyD;QACzD,mDAAM,CAAA;QACN,uDAAuD;QACvD,+CAAI,CAAA;QACJ,wEAAwE;QACxE,2DAAU,CAAA;IACZ,CAAC,EAbW,YAAY,GAAZ,kBAAY,KAAZ,kBAAY,QAavB;IAED,iFAAiF;IACjF,IAAY,SASX;IATD,WAAY,SAAS;QACnB,0GAA0G;QAC1G,+CAAO,CAAA;QACP,8CAA8C;QAC9C,yCAAI,CAAA;QACJ,2CAA2C;QAC3C,6CAAM,CAAA;QACN,+CAA+C;QAC/C,mDAAS,CAAA;IACX,CAAC,EATW,SAAS,GAAT,eAAS,KAAT,eAAS,QASpB;IAED;;;OAGG;IACH,IAAY,QAQX;IARD,WAAY,QAAQ;QAClB,uCAAQ,CAAA;QACR,iIAAiI;QACjI,6CAAgB,CAAA;QAChB,mJAAmJ;QACnJ,qEAA4B,CAAA;QAC5B,wCAAwC;QACxC,qCAAmC,CAAA;IACrC,CAAC,EARW,QAAQ,GAAR,cAAQ,KAAR,cAAQ,QAQnB;AAeH,CAAC,EAtGgB,KAAK,GAAL,aAAK,KAAL,aAAK,QAsGrB","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { Id64String } from \"@itwin/core-bentley\";\r\nimport { BatchType, Feature, GeometryClass, PackedFeatureTable } from \"@itwin/core-common\";\r\nimport { IModelConnection } from \"../IModelConnection\";\r\n\r\n/** Describes aspects of a pixel as read from a [[Viewport]].\r\n * @see [[Viewport.readPixels]].\r\n * @public\r\n */\r\nexport namespace Pixel {\r\n  /** Describes a single pixel within a [[Pixel.Buffer]]. */\r\n  export class Data {\r\n    /** The feature that produced the pixel. */\r\n    public readonly feature?: Feature;\r\n    /** The pixel's depth in [[CoordSystem.Npc]] coordinates (0 to 1), or -1 if depth was not written or not requested. */\r\n    public readonly distanceFraction: number;\r\n    /** The type of geometry that produced the pixel. */\r\n    public readonly type: GeometryType;\r\n    /** The planarity of the geometry that produced the pixel. */\r\n    public readonly planarity: Planarity;\r\n    /** @internal */\r\n    public readonly featureTable?: PackedFeatureTable;\r\n    /** The iModel from which the geometry producing the pixel originated. */\r\n    public readonly iModel?: IModelConnection;\r\n    /** @internal */\r\n    public readonly tileId?: string;\r\n    /** @internal */\r\n    public get isClassifier(): boolean { return undefined !== this.featureTable && BatchType.Primary !== this.featureTable.type; }\r\n\r\n    /** @internal */\r\n    public constructor(feature?: Feature, distanceFraction = -1.0, type = GeometryType.Unknown, planarity = Planarity.Unknown, featureTable?: PackedFeatureTable, iModel?: IModelConnection, tileId?: string) {\r\n      this.feature = feature;\r\n      this.distanceFraction = distanceFraction;\r\n      this.type = type;\r\n      this.planarity = planarity;\r\n      this.featureTable = featureTable;\r\n      this.iModel = iModel;\r\n      this.tileId = tileId;\r\n    }\r\n\r\n    /** The Id of the element that produced the pixel. */\r\n    public get elementId(): Id64String | undefined {\r\n      return undefined !== this.feature ? this.feature.elementId : undefined;\r\n    }\r\n\r\n    /** The Id of the [SubCategory]($backend) that produced the pixel. */\r\n    public get subCategoryId(): Id64String | undefined {\r\n      return undefined !== this.feature ? this.feature.subCategoryId : undefined;\r\n    }\r\n\r\n    /** The class of geometry that produced the pixel. */\r\n    public get geometryClass(): GeometryClass | undefined {\r\n      return undefined !== this.feature ? this.feature.geometryClass : undefined;\r\n    }\r\n  }\r\n\r\n  /** Describes the type of geometry that produced the [[Pixel.Data]]. */\r\n  export enum GeometryType {\r\n    /** [[Pixel.Selector.GeometryAndDistance]] was not specified, or the type could not be determined. */\r\n    Unknown, // Geometry was not selected, or type could not be determined\r\n    /** No geometry was rendered to this pixel. */\r\n    None,\r\n    /** A surface produced this pixel. */\r\n    Surface,\r\n    /** A point primitive or polyline produced this pixel. */\r\n    Linear,\r\n    /** This pixel was produced by an edge of a surface. */\r\n    Edge,\r\n    /** This pixel was produced by a silhouette edge of a curved surface. */\r\n    Silhouette,\r\n  }\r\n\r\n  /** Describes the planarity of the foremost geometry which produced the pixel. */\r\n  export enum Planarity {\r\n    /** [[Pixel.Selector.GeometryAndDistance]] was not specified, or the planarity could not be determined. */\r\n    Unknown,\r\n    /** No geometry was rendered to this pixel. */\r\n    None,\r\n    /** Planar geometry produced this pixel. */\r\n    Planar,\r\n    /** Non-planar geometry produced this pixel. */\r\n    NonPlanar,\r\n  }\r\n\r\n  /**\r\n   * Bit-mask by which callers of [[Viewport.readPixels]] specify which aspects are of interest.\r\n   * Aspects not specified will be omitted from the returned data.\r\n   */\r\n  export enum Selector {\r\n    None = 0,\r\n    /** Select the [[Feature]] which produced each pixel, as well as the [[PackedFeatureTable]] from which the feature originated. */\r\n    Feature = 1 << 0, // eslint-disable-line @typescript-eslint/no-shadow\r\n    /** Select the type and planarity of geometry which produced each pixel as well as the fraction of its distance between the near and far planes. */\r\n    GeometryAndDistance = 1 << 2,\r\n    /** Select all aspects of each pixel. */\r\n    All = GeometryAndDistance | Feature,\r\n  }\r\n\r\n  /** A rectangular array of pixels as read from a [[Viewport]]'s frame buffer. Each pixel is represented as a [[Pixel.Data]] object.\r\n   * The contents of the pixel buffer will be specified using device pixels, not CSS pixels. See [[Viewport.devicePixelRatio]] and [[Viewport.cssPixelsToDevicePixels]].\r\n   * @see [[Viewport.readPixels]].\r\n   */\r\n  export interface Buffer {\r\n    /** Retrieve the data associated with the pixel at (x,y) in view coordinates. */\r\n    getPixel(x: number, y: number): Data;\r\n  }\r\n\r\n  /** A function which receives the results of a call to [[Viewport.readPixels]].\r\n   * @note The contents of the buffer become invalid once the Receiver function returns. Do not store a reference to it.\r\n   */\r\n  export type Receiver = (pixels: Buffer | undefined) => void;\r\n}\r\n"]}
+{"version":3,"file":"Pixel.js","sourceRoot":"","sources":["../../../src/render/Pixel.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAGH,oDAA2F;AAG3F;;;;GAIG;AACH,IAAiB,KAAK,CAsGrB;AAtGD,WAAiB,KAAK;IACpB,0DAA0D;IAC1D,MAAa,IAAI;QAkBf,gBAAgB;QAChB,YAAmB,OAAiB,EAAE,gBAAgB,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC,OAAO,EAAE,YAAiC,EAAE,MAAyB,EAAE,MAAe;YACtM,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;YACzC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;YAC3B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;QAZD,gBAAgB;QAChB,IAAW,YAAY,KAAc,OAAO,SAAS,KAAK,IAAI,CAAC,YAAY,IAAI,uBAAS,CAAC,OAAO,KAAK,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAa9H,qDAAqD;QACrD,IAAW,SAAS;YAClB,OAAO,SAAS,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,CAAC;QAED,qEAAqE;QACrE,IAAW,aAAa;YACtB,OAAO,SAAS,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7E,CAAC;QAED,qDAAqD;QACrD,IAAW,aAAa;YACtB,OAAO,SAAS,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7E,CAAC;KACF;IA3CY,UAAI,OA2ChB,CAAA;IAED,uEAAuE;IACvE,IAAY,YAaX;IAbD,WAAY,YAAY;QACtB,qGAAqG;QACrG,qDAAO,CAAA;QACP,8CAA8C;QAC9C,+CAAI,CAAA;QACJ,qCAAqC;QACrC,qDAAO,CAAA;QACP,yDAAyD;QACzD,mDAAM,CAAA;QACN,uDAAuD;QACvD,+CAAI,CAAA;QACJ,wEAAwE;QACxE,2DAAU,CAAA;IACZ,CAAC,EAbW,YAAY,GAAZ,kBAAY,KAAZ,kBAAY,QAavB;IAED,iFAAiF;IACjF,IAAY,SASX;IATD,WAAY,SAAS;QACnB,0GAA0G;QAC1G,+CAAO,CAAA;QACP,8CAA8C;QAC9C,yCAAI,CAAA;QACJ,2CAA2C;QAC3C,6CAAM,CAAA;QACN,+CAA+C;QAC/C,mDAAS,CAAA;IACX,CAAC,EATW,SAAS,GAAT,eAAS,KAAT,eAAS,QASpB;IAED;;;OAGG;IACH,IAAY,QAQX;IARD,WAAY,QAAQ;QAClB,uCAAQ,CAAA;QACR,iIAAiI;QACjI,6CAAgB,CAAA;QAChB,mJAAmJ;QACnJ,qEAA4B,CAAA;QAC5B,wCAAwC;QACxC,qCAAmC,CAAA;IACrC,CAAC,EARW,QAAQ,GAAR,cAAQ,KAAR,cAAQ,QAQnB;AAeH,CAAC,EAtGgB,KAAK,GAAL,aAAK,KAAL,aAAK,QAsGrB","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { Id64String } from \"@itwin/core-bentley\";\r\nimport { BatchType, Feature, GeometryClass, PackedFeatureTable } from \"@itwin/core-common\";\r\nimport { IModelConnection } from \"../IModelConnection\";\r\n\r\n/** Describes aspects of a pixel as read from a [[Viewport]].\r\n * @see [[Viewport.readPixels]].\r\n * @public\r\n * @extensions\r\n */\r\nexport namespace Pixel {\r\n  /** Describes a single pixel within a [[Pixel.Buffer]]. */\r\n  export class Data {\r\n    /** The feature that produced the pixel. */\r\n    public readonly feature?: Feature;\r\n    /** The pixel's depth in [[CoordSystem.Npc]] coordinates (0 to 1), or -1 if depth was not written or not requested. */\r\n    public readonly distanceFraction: number;\r\n    /** The type of geometry that produced the pixel. */\r\n    public readonly type: GeometryType;\r\n    /** The planarity of the geometry that produced the pixel. */\r\n    public readonly planarity: Planarity;\r\n    /** @internal */\r\n    public readonly featureTable?: PackedFeatureTable;\r\n    /** The iModel from which the geometry producing the pixel originated. */\r\n    public readonly iModel?: IModelConnection;\r\n    /** @internal */\r\n    public readonly tileId?: string;\r\n    /** @internal */\r\n    public get isClassifier(): boolean { return undefined !== this.featureTable && BatchType.Primary !== this.featureTable.type; }\r\n\r\n    /** @internal */\r\n    public constructor(feature?: Feature, distanceFraction = -1.0, type = GeometryType.Unknown, planarity = Planarity.Unknown, featureTable?: PackedFeatureTable, iModel?: IModelConnection, tileId?: string) {\r\n      this.feature = feature;\r\n      this.distanceFraction = distanceFraction;\r\n      this.type = type;\r\n      this.planarity = planarity;\r\n      this.featureTable = featureTable;\r\n      this.iModel = iModel;\r\n      this.tileId = tileId;\r\n    }\r\n\r\n    /** The Id of the element that produced the pixel. */\r\n    public get elementId(): Id64String | undefined {\r\n      return undefined !== this.feature ? this.feature.elementId : undefined;\r\n    }\r\n\r\n    /** The Id of the [SubCategory]($backend) that produced the pixel. */\r\n    public get subCategoryId(): Id64String | undefined {\r\n      return undefined !== this.feature ? this.feature.subCategoryId : undefined;\r\n    }\r\n\r\n    /** The class of geometry that produced the pixel. */\r\n    public get geometryClass(): GeometryClass | undefined {\r\n      return undefined !== this.feature ? this.feature.geometryClass : undefined;\r\n    }\r\n  }\r\n\r\n  /** Describes the type of geometry that produced the [[Pixel.Data]]. */\r\n  export enum GeometryType {\r\n    /** [[Pixel.Selector.GeometryAndDistance]] was not specified, or the type could not be determined. */\r\n    Unknown, // Geometry was not selected, or type could not be determined\r\n    /** No geometry was rendered to this pixel. */\r\n    None,\r\n    /** A surface produced this pixel. */\r\n    Surface,\r\n    /** A point primitive or polyline produced this pixel. */\r\n    Linear,\r\n    /** This pixel was produced by an edge of a surface. */\r\n    Edge,\r\n    /** This pixel was produced by a silhouette edge of a curved surface. */\r\n    Silhouette,\r\n  }\r\n\r\n  /** Describes the planarity of the foremost geometry which produced the pixel. */\r\n  export enum Planarity {\r\n    /** [[Pixel.Selector.GeometryAndDistance]] was not specified, or the planarity could not be determined. */\r\n    Unknown,\r\n    /** No geometry was rendered to this pixel. */\r\n    None,\r\n    /** Planar geometry produced this pixel. */\r\n    Planar,\r\n    /** Non-planar geometry produced this pixel. */\r\n    NonPlanar,\r\n  }\r\n\r\n  /**\r\n   * Bit-mask by which callers of [[Viewport.readPixels]] specify which aspects are of interest.\r\n   * Aspects not specified will be omitted from the returned data.\r\n   */\r\n  export enum Selector {\r\n    None = 0,\r\n    /** Select the [[Feature]] which produced each pixel, as well as the [[PackedFeatureTable]] from which the feature originated. */\r\n    Feature = 1 << 0, // eslint-disable-line @typescript-eslint/no-shadow\r\n    /** Select the type and planarity of geometry which produced each pixel as well as the fraction of its distance between the near and far planes. */\r\n    GeometryAndDistance = 1 << 2,\r\n    /** Select all aspects of each pixel. */\r\n    All = GeometryAndDistance | Feature,\r\n  }\r\n\r\n  /** A rectangular array of pixels as read from a [[Viewport]]'s frame buffer. Each pixel is represented as a [[Pixel.Data]] object.\r\n   * The contents of the pixel buffer will be specified using device pixels, not CSS pixels. See [[Viewport.devicePixelRatio]] and [[Viewport.cssPixelsToDevicePixels]].\r\n   * @see [[Viewport.readPixels]].\r\n   */\r\n  export interface Buffer {\r\n    /** Retrieve the data associated with the pixel at (x,y) in view coordinates. */\r\n    getPixel(x: number, y: number): Data;\r\n  }\r\n\r\n  /** A function which receives the results of a call to [[Viewport.readPixels]].\r\n   * @note The contents of the buffer become invalid once the Receiver function returns. Do not store a reference to it.\r\n   */\r\n  export type Receiver = (pixels: Buffer | undefined) => void;\r\n}\r\n"]}

package/lib/cjs/render/RenderClipVolume.d.ts

@@ -6,6 +6,7 @@ import { ClipVector } from "@itwin/core-geometry";
  * A RenderClipVolume is created from a [[ClipVector]] and takes ownership of that ClipVector, expecting that it will not be modified while the RenderClipVolume still references it.
  * @see [[RenderSystem.createClipVolume]] to create a clip volume.
  * @public
+ * @extensions
  */
 export declare abstract class RenderClipVolume {
     /** The ClipVector from which this volume was created. It must not be modified. */

package/lib/cjs/render/RenderClipVolume.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderClipVolume.d.ts","sourceRoot":"","sources":["../../../src/render/RenderClipVolume.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;GAIG;AACH,8BAAsB,gBAAgB;IACpC,kFAAkF;IAClF,SAAgB,UAAU,EAAE,UAAU,CAAC;IAEvC,SAAS,aAAa,UAAU,EAAE,UAAU;CAG7C"}
+{"version":3,"file":"RenderClipVolume.d.ts","sourceRoot":"","sources":["../../../src/render/RenderClipVolume.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;GAKG;AACH,8BAAsB,gBAAgB;IACpC,kFAAkF;IAClF,SAAgB,UAAU,EAAE,UAAU,CAAC;IAEvC,SAAS,aAAa,UAAU,EAAE,UAAU;CAG7C"}

package/lib/cjs/render/RenderClipVolume.js

@@ -12,6 +12,7 @@ exports.RenderClipVolume = void 0;
  * A RenderClipVolume is created from a [[ClipVector]] and takes ownership of that ClipVector, expecting that it will not be modified while the RenderClipVolume still references it.
  * @see [[RenderSystem.createClipVolume]] to create a clip volume.
  * @public
+ * @extensions
  */
 class RenderClipVolume {
     constructor(clipVector) {

package/lib/cjs/render/RenderClipVolume.js.map

@@ -1 +1 @@
-{"version":3,"file":"RenderClipVolume.js","sourceRoot":"","sources":["../../../src/render/RenderClipVolume.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAIH;;;;GAIG;AACH,MAAsB,gBAAgB;IAIpC,YAAsB,UAAsB;QAC1C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAPD,4CAOC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { ClipVector } from \"@itwin/core-geometry\";\r\n\r\n/** An opaque representation of a clip volume applied to geometry within a [[Viewport]].\r\n * A RenderClipVolume is created from a [[ClipVector]] and takes ownership of that ClipVector, expecting that it will not be modified while the RenderClipVolume still references it.\r\n * @see [[RenderSystem.createClipVolume]] to create a clip volume.\r\n * @public\r\n */\r\nexport abstract class RenderClipVolume {\r\n  /** The ClipVector from which this volume was created. It must not be modified. */\r\n  public readonly clipVector: ClipVector;\r\n\r\n  protected constructor(clipVector: ClipVector) {\r\n    this.clipVector = clipVector;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"RenderClipVolume.js","sourceRoot":"","sources":["../../../src/render/RenderClipVolume.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAIH;;;;;GAKG;AACH,MAAsB,gBAAgB;IAIpC,YAAsB,UAAsB;QAC1C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAPD,4CAOC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module Rendering\r\n */\r\n\r\nimport { ClipVector } from \"@itwin/core-geometry\";\r\n\r\n/** An opaque representation of a clip volume applied to geometry within a [[Viewport]].\r\n * A RenderClipVolume is created from a [[ClipVector]] and takes ownership of that ClipVector, expecting that it will not be modified while the RenderClipVolume still references it.\r\n * @see [[RenderSystem.createClipVolume]] to create a clip volume.\r\n * @public\r\n * @extensions\r\n */\r\nexport abstract class RenderClipVolume {\r\n  /** The ClipVector from which this volume was created. It must not be modified. */\r\n  public readonly clipVector: ClipVector;\r\n\r\n  protected constructor(clipVector: ClipVector) {\r\n    this.clipVector = clipVector;\r\n  }\r\n}\r\n"]}