@itwin/core-common 4.0.0-dev.52 → 4.0.0-dev.55

package/lib/esm/SolarShadows.js.map

@@ -1 +1 @@
-{"version":3,"file":"SolarShadows.js","sourceRoot":"","sources":["../../src/SolarShadows.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAatC,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;AAEhF;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAM9B,YAAoB,KAA+B;QACjD,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClD,IAAI,SAAS,KAAK,KAAK,CAAC,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,KAAK;YACnD,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;;YAE1B,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,CAAC;IAIM,MAAM,CAAC,QAAQ,CAAC,KAAgC;QACrD,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IAChE,CAAC;IAEM,MAAM;QACX,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC;QAC9C,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACvB,OAAO,SAAS,CAAC;QAEnB,MAAM,KAAK,GAA6B,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACpC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC;QAEjD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;YAC7B,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAEzB,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,MAAM,CAAC,GAAwB;QACpC,OAAO,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,YAAuC;QAClD,IAAI,CAAC,YAAY;YACf,OAAO,IAAI,CAAC;QAEd,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAClC,IAAI,YAAY,CAAC,KAAK;YACpB,KAAK,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC;QAEnC,IAAI,SAAS,KAAK,YAAY,CAAC,IAAI;YACjC,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;QAEjC,OAAO,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;;AAzCa,4BAAQ,GAAG,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC","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 DisplayStyles\r\n */\r\n\r\nimport { JsonUtils } from \"@itwin/core-bentley\";\r\nimport { ColorByName } from \"./ColorByName\";\r\nimport { ColorDef, ColorDefProps } from \"./ColorDef\";\r\nimport { RgbColor } from \"./RgbColor\";\r\n\r\n/** JSON representation of [[SolarShadowSettings]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SolarShadowSettingsProps {\r\n  /** Shadow color. Default: [[ColorByName.grey]]. */\r\n  color?: ColorDefProps;\r\n  /** @internal */\r\n  bias?: number;\r\n}\r\n\r\nconst defaultColor = RgbColor.fromColorDef(ColorDef.fromTbgr(ColorByName.grey));\r\n\r\n/** Settings controlling display of solar shadows for a [[DisplayStyle3dSettings]].\r\n * Solar shadows are imposed as a color scaling on geometry occluded from solar lighting.\r\n * @public\r\n */\r\nexport class SolarShadowSettings {\r\n  /** Shadow color. */\r\n  public readonly color: RgbColor;\r\n  /** @internal */\r\n  public readonly bias: number;\r\n\r\n  private constructor(props: SolarShadowSettingsProps) {\r\n    this.bias = JsonUtils.asDouble(props.bias, 0.001);\r\n    if (undefined === props.color || null === props.color)\r\n      this.color = defaultColor;\r\n    else\r\n      this.color = RgbColor.fromColorDef(ColorDef.fromJSON(props.color));\r\n  }\r\n\r\n  public static defaults = new SolarShadowSettings({});\r\n\r\n  public static fromJSON(props?: SolarShadowSettingsProps): SolarShadowSettings {\r\n    return props ? new SolarShadowSettings(props) : this.defaults;\r\n  }\r\n\r\n  public toJSON(): SolarShadowSettingsProps | undefined {\r\n    const defaults = SolarShadowSettings.defaults;\r\n    if (this.equals(defaults))\r\n      return undefined;\r\n\r\n    const props: SolarShadowSettingsProps = {};\r\n    if (!this.color.equals(defaults.color))\r\n      props.color = this.color.toColorDef().toJSON();\r\n\r\n    if (this.bias !== defaults.bias)\r\n      props.bias = this.bias;\r\n\r\n    return props;\r\n  }\r\n\r\n  public equals(rhs: SolarShadowSettings): boolean {\r\n    return this.bias === rhs.bias && this.color.equals(rhs.color);\r\n  }\r\n\r\n  /** Create a copy of these settings.\r\n   * @param changedProps Any property explicitly defined will be overridden in the copy.\r\n   * @returns A settings object equivalent to this one except for any properties explicitly overridden by `changedProps`.\r\n   */\r\n  public clone(changedProps?: SolarShadowSettingsProps): SolarShadowSettings {\r\n    if (!changedProps)\r\n      return this;\r\n\r\n    const props = this.toJSON() ?? {};\r\n    if (changedProps.color)\r\n      props.color = changedProps.color;\r\n\r\n    if (undefined !== changedProps.bias)\r\n      props.bias = changedProps.bias;\r\n\r\n    return SolarShadowSettings.fromJSON(props);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"SolarShadows.js","sourceRoot":"","sources":["../../src/SolarShadows.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAatC,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;AAEhF;;;GAGG;AACH,MAAa,mBAAmB;IAM9B,YAAoB,KAA+B;QACjD,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClD,IAAI,SAAS,KAAK,KAAK,CAAC,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,KAAK;YACnD,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;;YAE1B,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,CAAC;IAIM,MAAM,CAAC,QAAQ,CAAC,KAAgC;QACrD,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IAChE,CAAC;IAEM,MAAM;QACX,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC;QAC9C,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACvB,OAAO,SAAS,CAAC;QAEnB,MAAM,KAAK,GAA6B,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACpC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC;QAEjD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;YAC7B,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAEzB,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,MAAM,CAAC,GAAwB;QACpC,OAAO,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,YAAuC;QAClD,IAAI,CAAC,YAAY;YACf,OAAO,IAAI,CAAC;QAEd,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAClC,IAAI,YAAY,CAAC,KAAK;YACpB,KAAK,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC;QAEnC,IAAI,SAAS,KAAK,YAAY,CAAC,IAAI;YACjC,KAAK,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;QAEjC,OAAO,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;;AAzCa,4BAAQ,GAAG,IAAI,mBAAmB,CAAC,EAAE,CAAC,CAAC;SAd1C,mBAAmB","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 DisplayStyles\r\n */\r\n\r\nimport { JsonUtils } from \"@itwin/core-bentley\";\r\nimport { ColorByName } from \"./ColorByName\";\r\nimport { ColorDef, ColorDefProps } from \"./ColorDef\";\r\nimport { RgbColor } from \"./RgbColor\";\r\n\r\n/** JSON representation of [[SolarShadowSettings]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SolarShadowSettingsProps {\r\n  /** Shadow color. Default: [[ColorByName.grey]]. */\r\n  color?: ColorDefProps;\r\n  /** @internal */\r\n  bias?: number;\r\n}\r\n\r\nconst defaultColor = RgbColor.fromColorDef(ColorDef.fromTbgr(ColorByName.grey));\r\n\r\n/** Settings controlling display of solar shadows for a [[DisplayStyle3dSettings]].\r\n * Solar shadows are imposed as a color scaling on geometry occluded from solar lighting.\r\n * @public\r\n */\r\nexport class SolarShadowSettings {\r\n  /** Shadow color. */\r\n  public readonly color: RgbColor;\r\n  /** @internal */\r\n  public readonly bias: number;\r\n\r\n  private constructor(props: SolarShadowSettingsProps) {\r\n    this.bias = JsonUtils.asDouble(props.bias, 0.001);\r\n    if (undefined === props.color || null === props.color)\r\n      this.color = defaultColor;\r\n    else\r\n      this.color = RgbColor.fromColorDef(ColorDef.fromJSON(props.color));\r\n  }\r\n\r\n  public static defaults = new SolarShadowSettings({});\r\n\r\n  public static fromJSON(props?: SolarShadowSettingsProps): SolarShadowSettings {\r\n    return props ? new SolarShadowSettings(props) : this.defaults;\r\n  }\r\n\r\n  public toJSON(): SolarShadowSettingsProps | undefined {\r\n    const defaults = SolarShadowSettings.defaults;\r\n    if (this.equals(defaults))\r\n      return undefined;\r\n\r\n    const props: SolarShadowSettingsProps = {};\r\n    if (!this.color.equals(defaults.color))\r\n      props.color = this.color.toColorDef().toJSON();\r\n\r\n    if (this.bias !== defaults.bias)\r\n      props.bias = this.bias;\r\n\r\n    return props;\r\n  }\r\n\r\n  public equals(rhs: SolarShadowSettings): boolean {\r\n    return this.bias === rhs.bias && this.color.equals(rhs.color);\r\n  }\r\n\r\n  /** Create a copy of these settings.\r\n   * @param changedProps Any property explicitly defined will be overridden in the copy.\r\n   * @returns A settings object equivalent to this one except for any properties explicitly overridden by `changedProps`.\r\n   */\r\n  public clone(changedProps?: SolarShadowSettingsProps): SolarShadowSettings {\r\n    if (!changedProps)\r\n      return this;\r\n\r\n    const props = this.toJSON() ?? {};\r\n    if (changedProps.color)\r\n      props.color = changedProps.color;\r\n\r\n    if (undefined !== changedProps.bias)\r\n      props.bias = changedProps.bias;\r\n\r\n    return SolarShadowSettings.fromJSON(props);\r\n  }\r\n}\r\n"]}

package/lib/esm/SpatialClassification.d.ts

@@ -1,209 +1,209 @@
-/** @packageDocumentation
- * @module DisplayStyles
- */
-import { Id64String } from "@itwin/core-bentley";
-import { ModelMapLayerSettings } from "./MapLayerSettings";
-/** Describes how a [[SpatialClassifier]] affects the display of classified geometry - that is, geometry intersecting
- * the classifier.
- * @public
- * @extensions
- */
-export declare enum SpatialClassifierInsideDisplay {
-    /** The geometry is not displayed. */
-    Off = 0,
-    /** The geometry is displayed without alteration. */
-    On = 1,
-    /** The geometry is darkened. */
-    Dimmed = 2,
-    /** The geometry is tinted by the [Viewport.hilite]($frontend) color. */
-    Hilite = 3,
-    /** The geometry is tinted with the colors of the classifier elements. */
-    ElementColor = 4
-}
-/** Describes how a [[SpatialClassifier]] affects the display of unclassified geometry - that is, geometry not intersecting
- * the classifier.
- * @public
- * @extensions
- */
-export declare enum SpatialClassifierOutsideDisplay {
-    /** The geometry is not displayed. */
-    Off = 0,
-    /** The geometry is displayed without alteration. */
-    On = 1,
-    /** The geometry is darkened. */
-    Dimmed = 2
-}
-/** JSON representation of a [[SpatialClassifierFlags]].
- * @public
- * @extensions
- */
-export interface SpatialClassifierFlagsProps {
-    /** See [[SpatialClassifierFlags.inside]]. */
-    inside: SpatialClassifierInsideDisplay;
-    /** See [[SpatialClassifierFlags.outside]]. */
-    outside: SpatialClassifierOutsideDisplay;
-    /** See [[SpatialClassifierFlags.isVolumeClassifier]]. */
-    isVolumeClassifier?: boolean;
-}
-/** Flags affecting how a [[SpatialClassifier]] is applied.
- * @public
- */
-export declare class SpatialClassifierFlags {
-    /** How geometry intersecting the classifier should be displayed. */
-    readonly inside: SpatialClassifierInsideDisplay;
-    /** How geometry not intersecting the classifier should be displayed. */
-    readonly outside: SpatialClassifierOutsideDisplay;
-    /** True for volume classification; false for planar classification. */
-    readonly isVolumeClassifier: boolean;
-    /** Construct new flags. */
-    constructor(inside?: SpatialClassifierInsideDisplay, outside?: SpatialClassifierOutsideDisplay, isVolumeClassifier?: boolean);
-    /** Construct from JSON representation. */
-    static fromJSON(props: SpatialClassifierFlagsProps): SpatialClassifierFlags;
-    /** Convert to JSON representation. */
-    toJSON(): SpatialClassifierFlagsProps;
-    /** Create flags indentical to these ones except for any properties explicitly specified by `changedProps`. */
-    clone(changedProps?: Partial<SpatialClassifierFlagsProps>): SpatialClassifierFlags;
-    /** Return true if these flags are equivalent to `other`. */
-    equals(other: SpatialClassifierFlags): boolean;
-    /** Return true if these flags are equivalent to `props`. */
-    equalsProps(props: SpatialClassifierFlagsProps): boolean;
-}
-/** JSON representation of a [[SpatialClassifier]].
- * @public
- * @extensions
- */
-export interface SpatialClassifierProps {
-    /** See [[SpatialClassifier.modelId]]. */
-    modelId: Id64String;
-    /** See [[SpatialClassifier.expand]]. */
-    expand: number;
-    /** See [[SpatialClassifier.flags]]. */
-    flags: SpatialClassifierFlagsProps;
-    /** See [[SpatialClassifier.name]]. */
-    name: string;
-    /** Records whether this is the active classifier.
-     * See [[SpatialClassifier.active]].
-     */
-    isActive?: boolean;
-}
-/** Describes how to use the geometry of one [GeometricModel]($backend) to classify the contents of other models - most typically, reality models.
- * Applying a classifier divides the geometry of the classified model into two groups:
- *  - Classified (intersecting the classifier); and
- *  - Unclassified (not intersecting the classifier).
- * For example, a model containing the building footprints for a city block could be used to classify a reality mesh captured from photographs of the
- * real-world block. Then, buildings within the reality mesh can be selected individually, and present the properties of the classifier geometry (e.g.,
- * the address of the building). The appearance of the geometry can also be customized based using [[SpatialClassifierInsideDisplay]] and [[SpatialClassifierOutsideDisplay]].
- * Two types of classification are supported:
- *  - Planar classification, in which the geometry of the classifier model is projected onto a plane to classify geometry within a region extruded perpendicular
- * the plane (e.g., the building footprints example); and
- *  - Volume classification, in which closed, non-intersecting volumes within the classifier classify geometry that intersects (i.e. is contained within) those same volumes (e.g., imagine using boxes instead
- * of footprints to classify buildings, or floors of buildings).
- * @see this (interactive example)[https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=classifier-sample].
- * @see [[SpatialClassifiers]] to define a set of classifiers.
- * @see [[ContextRealityModel.classifiers]] to classify a context reality model.
- * @see [SpatialModelState.classifiers]($frontend) to classify a persistent reality model.
- * @public
- */
-export declare class SpatialClassifier {
-    /** The Id of the [GeometricModel]($backend) whose geometry is used to produce the classifier. */
-    readonly modelId: Id64String;
-    /** A distance in meters by which to expand the classifier geometry. For example, if line strings are used to represent streets,
-     * you might expand them to the average width of a street.
-     */
-    readonly expand: number;
-    /** Flags controlling how to apply the classifier. */
-    readonly flags: SpatialClassifierFlags;
-    /** A user-friendly name, useful for identifying individual classifiers within a [[SpatialClassifiers]]. */
-    readonly name: string;
-    /** Construct a new classifier. */
-    constructor(modelId: Id64String, name: string, flags?: SpatialClassifierFlags, expand?: number);
-    /** Construct from JSON representation. */
-    static fromJSON(props: SpatialClassifierProps): SpatialClassifier;
-    /** Convert to JSON representation.
-     * @note This method always sets the [[SpatialClassifierProps.isActive]] property to `false`.
-     */
-    toJSON(): SpatialClassifierProps;
-    /** Construct from Model Map Layer.
-     * @beta
-     */
-    static fromModelMapLayer(mapLayer: ModelMapLayerSettings): SpatialClassifier;
-    /** Create a classifier identical to this one except for any properties explicitly specified by `changedProps`. */
-    clone(changedProps?: Partial<SpatialClassifierProps>): SpatialClassifier;
-    /** Return true if this classifier is equivalent to `other`. */
-    equals(other: SpatialClassifier): boolean;
-    /** Return true if this classifier is equivalent to `props`. */
-    equalsProps(props: SpatialClassifierProps): boolean;
-}
-/** An object that can store the JSON representation of a list of [[SpatialClassifier]]s.
- * @see [[SpatialClassifiers]].
- * @public
- * @extensions
- */
-export interface SpatialClassifiersContainer {
-    /** The list of classifiers. */
-    classifiers?: SpatialClassifierProps[];
-}
-/** A set of [[SpatialClassifier]]s for a given reality model. At most one of the classifiers can be actively classifying the model at any given time.
- * The set of classifiers can be presented to the user, listed by name, so that the active classifier can be changed.
- * The set of classifiers is populated from its JSON representation and that representation is kept in sync as the set of classifiers is modified.
- * @see this (interactive example)[https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=classifier-sample].
- * @see [[SpatialClassifier]] for details on how spatial classification works.
- * @see [[ContextRealityModel.classifiers]] to define classifiers for a context reality model.
- * @see [SpatialModelState.classifiers]($frontend) to define classifiers for a persistent reality model.
- * @public
- */
-export declare class SpatialClassifiers implements Iterable<SpatialClassifier> {
-    private readonly _json;
-    private readonly _classifiers;
-    private _active?;
-    /** Construct a new set of classifiers from the JSON representation. The set will be initialized from `container.classifiers` and that JSON representation
-     * will be kept in sync with changes made to the set. The caller should not directly modify `container.classifiers` or its contents as that will cause the set to become out
-     * of sync with the JSON representation.
-     * The [[active]] classifier will be determined by the first [[SpatialClassifierProps]] whose `isActive` property is set to `true`, if any.
-     */
-    constructor(container: SpatialClassifiersContainer);
-    /** The classifier currently classifying the target reality model. The classifier passed to the setter must be one obtained from this set, or one equivalent to
-     * one contained in this set; in the latter case, the equivalent classifier contained in this set becomes active.
-     */
-    /** The classifier currently classifying the target reality model, if any.
-     * @see [[setActive]] to change the active classifier.
-     */
-    get active(): SpatialClassifier | undefined;
-    /** Change the [[active]] classifier. The input must be a classifier belonging to this set, or equivalent to one in the set.
-     * If no equivalent classifier exists in the set, the active classifier remains unchanged.
-     * @param The classifier to set as active, or `undefined` to clear the active classifier.
-     * @returns the active classifier.
-     */
-    setActive(active: SpatialClassifier | undefined): SpatialClassifier | undefined;
-    /** Obtain an iterator over the classifiers contained in this set. */
-    [Symbol.iterator](): Iterator<SpatialClassifier>;
-    /** The number of classifiers in this set. */
-    get size(): number;
-    /** Returns the first classifier that satisfies `criterion`, or `undefined` if no classifier satisfies it. */
-    find(criterion: (classifier: SpatialClassifier) => boolean): SpatialClassifier | undefined;
-    /** Find the first classifier that is equivalent to the supplied classifier, or `undefined` if no equivalent classifier exists in this set. */
-    findEquivalent(classifier: SpatialClassifier): SpatialClassifier | undefined;
-    /** Return true if the specified classifier or one equivalent to it exists in this set. */
-    has(classifier: SpatialClassifier): boolean;
-    /** Add a classifier to this set. If an equivalent classifier already exists, the supplied classifier is not added.
-     * @param classifier The classifier to add.
-     * @returns The equivalent pre-existing classifier, if one existed; or the supplied classifier, if it was added to the set.
-     */
-    add(classifier: SpatialClassifier): SpatialClassifier;
-    /** Replace an existing classifier with a different one.
-     * @param toReplace The classifier to be replaced.
-     * @param replacement The classifier to replace `toReplace`.
-     * @returns true if a classifier equivalent to `toReplace` existed in the set and was replaced by `replacement`.
-     * @note If `toReplace` was the [[active]] classifier, `replacement` will become active.
-     */
-    replace(toReplace: SpatialClassifier, replacement: SpatialClassifier): boolean;
-    /** Remove the first classifier equivalent to `classifier` from this set.
-     * @param classifier The classifier to remove.
-     * @returns The classifier that was actually removed, or `undefined` if none was removed.
-     */
-    delete(classifier: SpatialClassifier): SpatialClassifier | undefined;
-    /** Remove all classifiers from this set. */
-    clear(): void;
-    private get _array();
-}
+/** @packageDocumentation
+ * @module DisplayStyles
+ */
+import { Id64String } from "@itwin/core-bentley";
+import { ModelMapLayerSettings } from "./MapLayerSettings";
+/** Describes how a [[SpatialClassifier]] affects the display of classified geometry - that is, geometry intersecting
+ * the classifier.
+ * @public
+ * @extensions
+ */
+export declare enum SpatialClassifierInsideDisplay {
+    /** The geometry is not displayed. */
+    Off = 0,
+    /** The geometry is displayed without alteration. */
+    On = 1,
+    /** The geometry is darkened. */
+    Dimmed = 2,
+    /** The geometry is tinted by the [Viewport.hilite]($frontend) color. */
+    Hilite = 3,
+    /** The geometry is tinted with the colors of the classifier elements. */
+    ElementColor = 4
+}
+/** Describes how a [[SpatialClassifier]] affects the display of unclassified geometry - that is, geometry not intersecting
+ * the classifier.
+ * @public
+ * @extensions
+ */
+export declare enum SpatialClassifierOutsideDisplay {
+    /** The geometry is not displayed. */
+    Off = 0,
+    /** The geometry is displayed without alteration. */
+    On = 1,
+    /** The geometry is darkened. */
+    Dimmed = 2
+}
+/** JSON representation of a [[SpatialClassifierFlags]].
+ * @public
+ * @extensions
+ */
+export interface SpatialClassifierFlagsProps {
+    /** See [[SpatialClassifierFlags.inside]]. */
+    inside: SpatialClassifierInsideDisplay;
+    /** See [[SpatialClassifierFlags.outside]]. */
+    outside: SpatialClassifierOutsideDisplay;
+    /** See [[SpatialClassifierFlags.isVolumeClassifier]]. */
+    isVolumeClassifier?: boolean;
+}
+/** Flags affecting how a [[SpatialClassifier]] is applied.
+ * @public
+ */
+export declare class SpatialClassifierFlags {
+    /** How geometry intersecting the classifier should be displayed. */
+    readonly inside: SpatialClassifierInsideDisplay;
+    /** How geometry not intersecting the classifier should be displayed. */
+    readonly outside: SpatialClassifierOutsideDisplay;
+    /** True for volume classification; false for planar classification. */
+    readonly isVolumeClassifier: boolean;
+    /** Construct new flags. */
+    constructor(inside?: SpatialClassifierInsideDisplay, outside?: SpatialClassifierOutsideDisplay, isVolumeClassifier?: boolean);
+    /** Construct from JSON representation. */
+    static fromJSON(props: SpatialClassifierFlagsProps): SpatialClassifierFlags;
+    /** Convert to JSON representation. */
+    toJSON(): SpatialClassifierFlagsProps;
+    /** Create flags indentical to these ones except for any properties explicitly specified by `changedProps`. */
+    clone(changedProps?: Partial<SpatialClassifierFlagsProps>): SpatialClassifierFlags;
+    /** Return true if these flags are equivalent to `other`. */
+    equals(other: SpatialClassifierFlags): boolean;
+    /** Return true if these flags are equivalent to `props`. */
+    equalsProps(props: SpatialClassifierFlagsProps): boolean;
+}
+/** JSON representation of a [[SpatialClassifier]].
+ * @public
+ * @extensions
+ */
+export interface SpatialClassifierProps {
+    /** See [[SpatialClassifier.modelId]]. */
+    modelId: Id64String;
+    /** See [[SpatialClassifier.expand]]. */
+    expand: number;
+    /** See [[SpatialClassifier.flags]]. */
+    flags: SpatialClassifierFlagsProps;
+    /** See [[SpatialClassifier.name]]. */
+    name: string;
+    /** Records whether this is the active classifier.
+     * See [[SpatialClassifier.active]].
+     */
+    isActive?: boolean;
+}
+/** Describes how to use the geometry of one [GeometricModel]($backend) to classify the contents of other models - most typically, reality models.
+ * Applying a classifier divides the geometry of the classified model into two groups:
+ *  - Classified (intersecting the classifier); and
+ *  - Unclassified (not intersecting the classifier).
+ * For example, a model containing the building footprints for a city block could be used to classify a reality mesh captured from photographs of the
+ * real-world block. Then, buildings within the reality mesh can be selected individually, and present the properties of the classifier geometry (e.g.,
+ * the address of the building). The appearance of the geometry can also be customized based using [[SpatialClassifierInsideDisplay]] and [[SpatialClassifierOutsideDisplay]].
+ * Two types of classification are supported:
+ *  - Planar classification, in which the geometry of the classifier model is projected onto a plane to classify geometry within a region extruded perpendicular
+ * the plane (e.g., the building footprints example); and
+ *  - Volume classification, in which closed, non-intersecting volumes within the classifier classify geometry that intersects (i.e. is contained within) those same volumes (e.g., imagine using boxes instead
+ * of footprints to classify buildings, or floors of buildings).
+ * @see this (interactive example)[https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=classifier-sample].
+ * @see [[SpatialClassifiers]] to define a set of classifiers.
+ * @see [[ContextRealityModel.classifiers]] to classify a context reality model.
+ * @see [SpatialModelState.classifiers]($frontend) to classify a persistent reality model.
+ * @public
+ */
+export declare class SpatialClassifier {
+    /** The Id of the [GeometricModel]($backend) whose geometry is used to produce the classifier. */
+    readonly modelId: Id64String;
+    /** A distance in meters by which to expand the classifier geometry. For example, if line strings are used to represent streets,
+     * you might expand them to the average width of a street.
+     */
+    readonly expand: number;
+    /** Flags controlling how to apply the classifier. */
+    readonly flags: SpatialClassifierFlags;
+    /** A user-friendly name, useful for identifying individual classifiers within a [[SpatialClassifiers]]. */
+    readonly name: string;
+    /** Construct a new classifier. */
+    constructor(modelId: Id64String, name: string, flags?: SpatialClassifierFlags, expand?: number);
+    /** Construct from JSON representation. */
+    static fromJSON(props: SpatialClassifierProps): SpatialClassifier;
+    /** Convert to JSON representation.
+     * @note This method always sets the [[SpatialClassifierProps.isActive]] property to `false`.
+     */
+    toJSON(): SpatialClassifierProps;
+    /** Construct from Model Map Layer.
+     * @beta
+     */
+    static fromModelMapLayer(mapLayer: ModelMapLayerSettings): SpatialClassifier;
+    /** Create a classifier identical to this one except for any properties explicitly specified by `changedProps`. */
+    clone(changedProps?: Partial<SpatialClassifierProps>): SpatialClassifier;
+    /** Return true if this classifier is equivalent to `other`. */
+    equals(other: SpatialClassifier): boolean;
+    /** Return true if this classifier is equivalent to `props`. */
+    equalsProps(props: SpatialClassifierProps): boolean;
+}
+/** An object that can store the JSON representation of a list of [[SpatialClassifier]]s.
+ * @see [[SpatialClassifiers]].
+ * @public
+ * @extensions
+ */
+export interface SpatialClassifiersContainer {
+    /** The list of classifiers. */
+    classifiers?: SpatialClassifierProps[];
+}
+/** A set of [[SpatialClassifier]]s for a given reality model. At most one of the classifiers can be actively classifying the model at any given time.
+ * The set of classifiers can be presented to the user, listed by name, so that the active classifier can be changed.
+ * The set of classifiers is populated from its JSON representation and that representation is kept in sync as the set of classifiers is modified.
+ * @see this (interactive example)[https://www.itwinjs.org/sample-showcase/?group=Viewer+Features&sample=classifier-sample].
+ * @see [[SpatialClassifier]] for details on how spatial classification works.
+ * @see [[ContextRealityModel.classifiers]] to define classifiers for a context reality model.
+ * @see [SpatialModelState.classifiers]($frontend) to define classifiers for a persistent reality model.
+ * @public
+ */
+export declare class SpatialClassifiers implements Iterable<SpatialClassifier> {
+    private readonly _json;
+    private readonly _classifiers;
+    private _active?;
+    /** Construct a new set of classifiers from the JSON representation. The set will be initialized from `container.classifiers` and that JSON representation
+     * will be kept in sync with changes made to the set. The caller should not directly modify `container.classifiers` or its contents as that will cause the set to become out
+     * of sync with the JSON representation.
+     * The [[active]] classifier will be determined by the first [[SpatialClassifierProps]] whose `isActive` property is set to `true`, if any.
+     */
+    constructor(container: SpatialClassifiersContainer);
+    /** The classifier currently classifying the target reality model. The classifier passed to the setter must be one obtained from this set, or one equivalent to
+     * one contained in this set; in the latter case, the equivalent classifier contained in this set becomes active.
+     */
+    /** The classifier currently classifying the target reality model, if any.
+     * @see [[setActive]] to change the active classifier.
+     */
+    get active(): SpatialClassifier | undefined;
+    /** Change the [[active]] classifier. The input must be a classifier belonging to this set, or equivalent to one in the set.
+     * If no equivalent classifier exists in the set, the active classifier remains unchanged.
+     * @param The classifier to set as active, or `undefined` to clear the active classifier.
+     * @returns the active classifier.
+     */
+    setActive(active: SpatialClassifier | undefined): SpatialClassifier | undefined;
+    /** Obtain an iterator over the classifiers contained in this set. */
+    [Symbol.iterator](): Iterator<SpatialClassifier>;
+    /** The number of classifiers in this set. */
+    get size(): number;
+    /** Returns the first classifier that satisfies `criterion`, or `undefined` if no classifier satisfies it. */
+    find(criterion: (classifier: SpatialClassifier) => boolean): SpatialClassifier | undefined;
+    /** Find the first classifier that is equivalent to the supplied classifier, or `undefined` if no equivalent classifier exists in this set. */
+    findEquivalent(classifier: SpatialClassifier): SpatialClassifier | undefined;
+    /** Return true if the specified classifier or one equivalent to it exists in this set. */
+    has(classifier: SpatialClassifier): boolean;
+    /** Add a classifier to this set. If an equivalent classifier already exists, the supplied classifier is not added.
+     * @param classifier The classifier to add.
+     * @returns The equivalent pre-existing classifier, if one existed; or the supplied classifier, if it was added to the set.
+     */
+    add(classifier: SpatialClassifier): SpatialClassifier;
+    /** Replace an existing classifier with a different one.
+     * @param toReplace The classifier to be replaced.
+     * @param replacement The classifier to replace `toReplace`.
+     * @returns true if a classifier equivalent to `toReplace` existed in the set and was replaced by `replacement`.
+     * @note If `toReplace` was the [[active]] classifier, `replacement` will become active.
+     */
+    replace(toReplace: SpatialClassifier, replacement: SpatialClassifier): boolean;
+    /** Remove the first classifier equivalent to `classifier` from this set.
+     * @param classifier The classifier to remove.
+     * @returns The classifier that was actually removed, or `undefined` if none was removed.
+     */
+    delete(classifier: SpatialClassifier): SpatialClassifier | undefined;
+    /** Remove all classifiers from this set. */
+    clear(): void;
+    private get _array();
+}
 //# sourceMappingURL=SpatialClassification.d.ts.map