@itwin/core-common 3.5.0-dev.63 → 3.5.0-dev.66

package/lib/esm/ViewDetails.js

@@ -1,154 +1,162 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Views
- */
-import { BeEvent, Id64, JsonUtils } from "@itwin/core-bentley";
-import { ClipVector, Geometry } from "@itwin/core-geometry";
-import { ModelClipGroups } from "./ModelClipGroup";
-/** Describes the orientation of the grid displayed within a [Viewport]($frontend).
- * @public
- * @extensions
- */
-export var GridOrientationType;
-(function (GridOrientationType) {
-    /** Oriented with the view. */
-    GridOrientationType[GridOrientationType["View"] = 0] = "View";
-    /** Top */
-    GridOrientationType[GridOrientationType["WorldXY"] = 1] = "WorldXY";
-    /** Right */
-    GridOrientationType[GridOrientationType["WorldYZ"] = 2] = "WorldYZ";
-    /** Front */
-    GridOrientationType[GridOrientationType["WorldXZ"] = 3] = "WorldXZ";
-    /** Oriented by the auxiliary coordinate system. */
-    GridOrientationType[GridOrientationType["AuxCoord"] = 4] = "AuxCoord";
-})(GridOrientationType || (GridOrientationType = {}));
-/** Encapsulates access to optional view details stored in JSON properties.
- * @see [[ViewDetailsProps]] for the JSON representation.
- * @see [ViewDefinition.details]($backend) and [ViewState.details]($frontend).
- * @public
- */
-export class ViewDetails {
-    /** @internal */
-    constructor(jsonProperties) {
-        /** Event raised just before assignment to the [[clipVector]] property. */
-        this.onClipVectorChanged = new BeEvent();
-        if (!jsonProperties.viewDetails)
-            jsonProperties.viewDetails = {};
-        this._json = jsonProperties.viewDetails;
-    }
-    /** The Id of the auxiliary coordinate system for the view. */
-    get auxiliaryCoordinateSystemId() {
-        return Id64.fromJSON(this._json.acs);
-    }
-    set auxiliaryCoordinateSystemId(id) {
-        this._json.acs = Id64.isValidId64(id) ? id : undefined;
-    }
-    /** The aspect ratio skew (x/y, usually 1.0) used to exaggerate the y axis of the view. */
-    get aspectRatioSkew() {
-        const maxSkew = ViewDetails.maxSkew;
-        const skew = JsonUtils.asDouble(this._json.aspectSkew, 1.0);
-        return Geometry.clamp(skew, 1 / maxSkew, maxSkew);
-    }
-    set aspectRatioSkew(skew) {
-        this._json.aspectSkew = 1.0 !== skew ? skew : undefined;
-    }
-    /** The orientation of the view's grid. */
-    get gridOrientation() {
-        return JsonUtils.asInt(this._json.gridOrient, GridOrientationType.WorldXY);
-    }
-    set gridOrientation(orientation) {
-        this._json.gridOrient = GridOrientationType.WorldXY === orientation ? undefined : orientation;
-    }
-    /** The number of grids per ref for the view. */
-    get gridsPerRef() {
-        return JsonUtils.asInt(this._json.gridPerRef, 10);
-    }
-    set gridsPerRef(gridsPerRef) {
-        this._json.gridPerRef = 10 === gridsPerRef ? undefined : gridsPerRef;
-    }
-    /** The grid spacing for the view. */
-    get gridSpacing() {
-        const x = JsonUtils.asDouble(this._json.gridSpaceX, 1.0);
-        const y = JsonUtils.asDouble(this._json.gridSpaceY, x);
-        return { x, y };
-    }
-    set gridSpacing(spacing) {
-        this._json.gridSpaceX = 1.0 !== spacing.x ? spacing.x : undefined;
-        this._json.gridSpaceY = spacing.x !== spacing.y ? spacing.y : undefined;
-    }
-    /** Clipping volume for the view.
-     * @note Do *not* modify the returned ClipVector. If you wish to change the ClipVector, clone the returned ClipVector, modify it as desired, and pass the clone back to the setter.
-     */
-    get clipVector() {
-        if (undefined === this._clipVector) {
-            const clip = this._json.clip;
-            this._clipVector = (undefined !== clip ? ClipVector.fromJSON(clip) : ClipVector.createEmpty());
-        }
-        return this._clipVector.isValid ? this._clipVector : undefined;
-    }
-    set clipVector(clip) {
-        if (!clip)
-            clip = ClipVector.createEmpty();
-        this.onClipVectorChanged.raiseEvent(clip.isValid ? clip : undefined);
-        this._clipVector = clip;
-        if (clip.isValid)
-            this._json.clip = clip.toJSON();
-        else
-            delete this._json.clip;
-    }
-    /** Returns the internal JSON representation. This is *not* a copy.
-     * @internal
-     */
-    getJSON() {
-        return this._json;
-    }
-}
-/** Maximum aspect ratio skew. Apps can override this by changing its value. */
-ViewDetails.maxSkew = 25;
-/** Encapsulates access to optional 3d view details stored in JSON properties.
- * @see [[ViewDetails3dProps]] for the JSON representation.
- * @public
- */
-export class ViewDetails3d extends ViewDetails {
-    /** @internal */
-    constructor(jsonProperties) {
-        super(jsonProperties);
-        /** Event raised when just before assignment to the [[modelClipGroups]] property. */
-        this.onModelClipGroupsChanged = new BeEvent();
-    }
-    get _json3d() {
-        return this._json;
-    }
-    /** Controls whether viewing tools are allowed to operate on the view in 3 dimensions. */
-    get allow3dManipulations() {
-        return !JsonUtils.asBool(this._json3d.disable3dManipulations, false);
-    }
-    set allow3dManipulations(allow) {
-        this._json3d.disable3dManipulations = allow ? undefined : true;
-    }
-    /** Groups of models associated with [ClipVector]($core-geometry)s by which those models should be clipped.
-     * If the view and the model both have a clip vector defined, geometry in the model will be clipped by the intersection of the two clip vectors.
-     * [[ViewFlags.clipVolume]] has no effect on model clips, only the view clip - model clips are always applied.
-     * @note Do **not** modify the returned object directly. Instead, clone it, modify the clone, and pass the clone to the property setter.
-     */
-    get modelClipGroups() {
-        if (!this._modelClipGroups)
-            this._modelClipGroups = ModelClipGroups.fromJSON(this._json3d.modelClipGroups);
-        return this._modelClipGroups;
-    }
-    set modelClipGroups(groups) {
-        this.onModelClipGroupsChanged.raiseEvent(groups);
-        this._modelClipGroups = groups;
-        this._json3d.modelClipGroups = groups.toJSON();
-    }
-    /** Returns the internal JSON representation. This is *not* a copy.
-     * @internal
-     */
-    getJSON() {
-        return this._json3d;
-    }
-}
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Views
+ */
+import { assert, BeEvent, Id64, JsonUtils } from "@itwin/core-bentley";
+import { ClipVector, Geometry } from "@itwin/core-geometry";
+import { ModelClipGroups } from "./ModelClipGroup";
+/** Describes the orientation of the grid displayed within a [Viewport]($frontend).
+ * @public
+ * @extensions
+ */
+export var GridOrientationType;
+(function (GridOrientationType) {
+    /** Oriented with the view. */
+    GridOrientationType[GridOrientationType["View"] = 0] = "View";
+    /** Top */
+    GridOrientationType[GridOrientationType["WorldXY"] = 1] = "WorldXY";
+    /** Right */
+    GridOrientationType[GridOrientationType["WorldYZ"] = 2] = "WorldYZ";
+    /** Front */
+    GridOrientationType[GridOrientationType["WorldXZ"] = 3] = "WorldXZ";
+    /** Oriented by the auxiliary coordinate system. */
+    GridOrientationType[GridOrientationType["AuxCoord"] = 4] = "AuxCoord";
+})(GridOrientationType || (GridOrientationType = {}));
+/** Encapsulates access to optional view details stored in JSON properties.
+ * @see [[ViewDetailsProps]] for the JSON representation.
+ * @see [ViewDefinition.details]($backend) and [ViewState.details]($frontend).
+ * @public
+ */
+export class ViewDetails {
+    /** @internal */
+    constructor(jsonProperties) {
+        /** Event raised just before assignment to the [[clipVector]] property. */
+        this.onClipVectorChanged = new BeEvent();
+        if (!jsonProperties.viewDetails)
+            jsonProperties.viewDetails = {};
+        this._json = jsonProperties.viewDetails;
+    }
+    /** The Id of the auxiliary coordinate system for the view. */
+    get auxiliaryCoordinateSystemId() {
+        return Id64.fromJSON(this._json.acs);
+    }
+    set auxiliaryCoordinateSystemId(id) {
+        this._json.acs = Id64.isValidId64(id) ? id : undefined;
+    }
+    /** The aspect ratio skew (x/y, usually 1.0) used to exaggerate the y axis of the view. */
+    get aspectRatioSkew() {
+        const maxSkew = ViewDetails.maxSkew;
+        const skew = JsonUtils.asDouble(this._json.aspectSkew, 1.0);
+        return Geometry.clamp(skew, 1 / maxSkew, maxSkew);
+    }
+    set aspectRatioSkew(skew) {
+        this._json.aspectSkew = 1.0 !== skew ? skew : undefined;
+    }
+    /** The orientation of the view's grid. */
+    get gridOrientation() {
+        return JsonUtils.asInt(this._json.gridOrient, GridOrientationType.WorldXY);
+    }
+    set gridOrientation(orientation) {
+        this._json.gridOrient = GridOrientationType.WorldXY === orientation ? undefined : orientation;
+    }
+    /** The number of grids per ref for the view. */
+    get gridsPerRef() {
+        return JsonUtils.asInt(this._json.gridPerRef, 10);
+    }
+    set gridsPerRef(gridsPerRef) {
+        this._json.gridPerRef = 10 === gridsPerRef ? undefined : gridsPerRef;
+    }
+    /** The grid spacing for the view. */
+    get gridSpacing() {
+        const x = JsonUtils.asDouble(this._json.gridSpaceX, 1.0);
+        const y = JsonUtils.asDouble(this._json.gridSpaceY, x);
+        return { x, y };
+    }
+    set gridSpacing(spacing) {
+        this._json.gridSpaceX = 1.0 !== spacing.x ? spacing.x : undefined;
+        this._json.gridSpaceY = spacing.x !== spacing.y ? spacing.y : undefined;
+    }
+    /** Clipping volume for the view.
+     * @note Do *not* modify the returned ClipVector. If you wish to change the ClipVector, clone the returned ClipVector, modify it as desired, and pass the clone back to the setter.
+     */
+    get clipVector() {
+        if (undefined === this._clipVector) {
+            const clip = this._json.clip;
+            this._clipVector = (undefined !== clip ? ClipVector.fromJSON(clip) : ClipVector.createEmpty());
+        }
+        return this._clipVector.isValid ? this._clipVector : undefined;
+    }
+    set clipVector(clip) {
+        const curClip = this.clipVector;
+        if (curClip === clip)
+            return;
+        if (!curClip) {
+            assert(undefined !== clip);
+            // An empty clip is equivalent to no clip.
+            if (!clip.isValid)
+                return;
+        }
+        clip = clip !== null && clip !== void 0 ? clip : ClipVector.createEmpty();
+        this.onClipVectorChanged.raiseEvent(clip.isValid ? clip : undefined);
+        this._clipVector = clip;
+        if (clip.isValid)
+            this._json.clip = clip.toJSON();
+        else
+            delete this._json.clip;
+    }
+    /** Returns the internal JSON representation. This is *not* a copy.
+     * @internal
+     */
+    getJSON() {
+        return this._json;
+    }
+}
+/** Maximum aspect ratio skew. Apps can override this by changing its value. */
+ViewDetails.maxSkew = 25;
+/** Encapsulates access to optional 3d view details stored in JSON properties.
+ * @see [[ViewDetails3dProps]] for the JSON representation.
+ * @public
+ */
+export class ViewDetails3d extends ViewDetails {
+    /** @internal */
+    constructor(jsonProperties) {
+        super(jsonProperties);
+        /** Event raised when just before assignment to the [[modelClipGroups]] property. */
+        this.onModelClipGroupsChanged = new BeEvent();
+    }
+    get _json3d() {
+        return this._json;
+    }
+    /** Controls whether viewing tools are allowed to operate on the view in 3 dimensions. */
+    get allow3dManipulations() {
+        return !JsonUtils.asBool(this._json3d.disable3dManipulations, false);
+    }
+    set allow3dManipulations(allow) {
+        this._json3d.disable3dManipulations = allow ? undefined : true;
+    }
+    /** Groups of models associated with [ClipVector]($core-geometry)s by which those models should be clipped.
+     * If the view and the model both have a clip vector defined, geometry in the model will be clipped by the intersection of the two clip vectors.
+     * [[ViewFlags.clipVolume]] has no effect on model clips, only the view clip - model clips are always applied.
+     * @note Do **not** modify the returned object directly. Instead, clone it, modify the clone, and pass the clone to the property setter.
+     */
+    get modelClipGroups() {
+        if (!this._modelClipGroups)
+            this._modelClipGroups = ModelClipGroups.fromJSON(this._json3d.modelClipGroups);
+        return this._modelClipGroups;
+    }
+    set modelClipGroups(groups) {
+        this.onModelClipGroupsChanged.raiseEvent(groups);
+        this._modelClipGroups = groups;
+        this._json3d.modelClipGroups = groups.toJSON();
+    }
+    /** Returns the internal JSON representation. This is *not* a copy.
+     * @internal
+     */
+    getJSON() {
+        return this._json3d;
+    }
+}
 //# sourceMappingURL=ViewDetails.js.map

package/lib/esm/ViewDetails.js.map

@@ -1 +1 @@
-{"version":3,"file":"ViewDetails.js","sourceRoot":"","sources":["../../src/ViewDetails.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 Views\r\n */\r\n\r\nimport { BeEvent, Id64, Id64String, JsonUtils } from \"@itwin/core-bentley\";\r\nimport { ClipVector, ClipVectorProps, Geometry, XAndY } from \"@itwin/core-geometry\";\r\nimport { ModelClipGroupProps, ModelClipGroups } from \"./ModelClipGroup\";\r\n\r\n/** Properties of a [[ViewDefinitionProps]] stored as JSON.\r\n * @see [[ViewDefinitionProps.jsonProperties]].\r\n * @see [[ViewDetails3dProps]] for additional properties specific to 3d views.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ViewDetailsProps {\r\n  /** Id of the aux coord system. Default: invalid. */\r\n  acs?: Id64String;\r\n  /** Aspect ratio skew (x/y) used to exaggerate the y axis of the view. Default: 1.0. */\r\n  aspectSkew?: number;\r\n  /** Grid orientation. Default: WorldXY. */\r\n  gridOrient?: GridOrientationType;\r\n  /** Default: 10. */\r\n  gridPerRef?: number;\r\n  /** Default: 1.0. */\r\n  gridSpaceX?: number;\r\n  /** Default: same as gridSpaceX. */\r\n  gridSpaceY?: number;\r\n  /** Describes the [ClipVector]($core-geometry) applied to the view. */\r\n  clip?: ClipVectorProps;\r\n}\r\n\r\n/** Describes the orientation of the grid displayed within a [Viewport]($frontend).\r\n * @public\r\n * @extensions\r\n */\r\nexport enum GridOrientationType {\r\n  /** Oriented with the view. */\r\n  View = 0,\r\n  /** Top */\r\n  WorldXY = 1,\r\n  /** Right */\r\n  WorldYZ = 2,\r\n  /** Front */\r\n  WorldXZ = 3,\r\n  /** Oriented by the auxiliary coordinate system. */\r\n  AuxCoord = 4,\r\n}\r\n\r\n/** Properties of a [[ViewDefinition3dProps]] stored as JSON.\r\n * @see [[ViewDefinition3dProps.jsonProperties]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ViewDetails3dProps extends ViewDetailsProps {\r\n  /** Whether viewing tools are prohibited from operating in 3 dimensions on this view. Default: false. */\r\n  disable3dManipulations?: boolean;\r\n  /** Defines how to clip groups of models. */\r\n  modelClipGroups?: ModelClipGroupProps[];\r\n}\r\n\r\n/** Encapsulates access to optional view details stored in JSON properties.\r\n * @see [[ViewDetailsProps]] for the JSON representation.\r\n * @see [ViewDefinition.details]($backend) and [ViewState.details]($frontend).\r\n * @public\r\n */\r\nexport class ViewDetails {\r\n  /** @internal */\r\n  protected readonly _json: ViewDetailsProps;\r\n  private _clipVector?: ClipVector;\r\n\r\n  /** Event raised just before assignment to the [[clipVector]] property. */\r\n  public readonly onClipVectorChanged = new BeEvent<(newClip: ClipVector | undefined) => void>();\r\n\r\n  /** @internal */\r\n  public constructor(jsonProperties: { viewDetails?: ViewDetailsProps }) {\r\n    if (!jsonProperties.viewDetails)\r\n      jsonProperties.viewDetails = {};\r\n\r\n    this._json = jsonProperties.viewDetails;\r\n  }\r\n\r\n  /** The Id of the auxiliary coordinate system for the view. */\r\n  public get auxiliaryCoordinateSystemId(): Id64String {\r\n    return Id64.fromJSON(this._json.acs);\r\n  }\r\n  public set auxiliaryCoordinateSystemId(id: Id64String) {\r\n    this._json.acs = Id64.isValidId64(id) ? id : undefined;\r\n  }\r\n\r\n  /** Maximum aspect ratio skew. Apps can override this by changing its value. */\r\n  public static maxSkew = 25;\r\n\r\n  /** The aspect ratio skew (x/y, usually 1.0) used to exaggerate the y axis of the view. */\r\n  public get aspectRatioSkew(): number {\r\n    const maxSkew = ViewDetails.maxSkew;\r\n    const skew = JsonUtils.asDouble(this._json.aspectSkew, 1.0);\r\n    return Geometry.clamp(skew, 1 / maxSkew, maxSkew);\r\n  }\r\n  public set aspectRatioSkew(skew: number) {\r\n    this._json.aspectSkew = 1.0 !== skew ? skew : undefined;\r\n  }\r\n\r\n  /** The orientation of the view's grid. */\r\n  public get gridOrientation(): GridOrientationType {\r\n    return JsonUtils.asInt(this._json.gridOrient, GridOrientationType.WorldXY);\r\n  }\r\n  public set gridOrientation(orientation: GridOrientationType) {\r\n    this._json.gridOrient = GridOrientationType.WorldXY === orientation ? undefined : orientation;\r\n  }\r\n\r\n  /** The number of grids per ref for the view. */\r\n  public get gridsPerRef(): number {\r\n    return JsonUtils.asInt(this._json.gridPerRef, 10);\r\n  }\r\n  public set gridsPerRef(gridsPerRef: number) {\r\n    this._json.gridPerRef = 10 === gridsPerRef ? undefined : gridsPerRef;\r\n  }\r\n\r\n  /** The grid spacing for the view. */\r\n  public get gridSpacing(): XAndY {\r\n    const x = JsonUtils.asDouble(this._json.gridSpaceX, 1.0);\r\n    const y = JsonUtils.asDouble(this._json.gridSpaceY, x);\r\n    return { x, y };\r\n  }\r\n  public set gridSpacing(spacing: XAndY) {\r\n    this._json.gridSpaceX = 1.0 !== spacing.x ? spacing.x : undefined;\r\n    this._json.gridSpaceY = spacing.x !== spacing.y ? spacing.y : undefined;\r\n  }\r\n\r\n  /** Clipping volume for the view.\r\n   * @note Do *not* modify the returned ClipVector. If you wish to change the ClipVector, clone the returned ClipVector, modify it as desired, and pass the clone back to the setter.\r\n   */\r\n  public get clipVector(): ClipVector | undefined {\r\n    if (undefined === this._clipVector) {\r\n      const clip = this._json.clip;\r\n      this._clipVector = (undefined !== clip ? ClipVector.fromJSON(clip) : ClipVector.createEmpty());\r\n    }\r\n\r\n    return this._clipVector.isValid ? this._clipVector : undefined;\r\n  }\r\n  public set clipVector(clip: ClipVector | undefined) {\r\n    if (!clip)\r\n      clip = ClipVector.createEmpty();\r\n\r\n    this.onClipVectorChanged.raiseEvent(clip.isValid ? clip : undefined);\r\n    this._clipVector = clip;\r\n    if (clip.isValid)\r\n      this._json.clip = clip.toJSON();\r\n    else\r\n      delete this._json.clip;\r\n  }\r\n\r\n  /** Returns the internal JSON representation. This is *not* a copy.\r\n   * @internal\r\n   */\r\n  public getJSON(): Readonly<ViewDetailsProps> {\r\n    return this._json;\r\n  }\r\n}\r\n\r\n/** Encapsulates access to optional 3d view details stored in JSON properties.\r\n * @see [[ViewDetails3dProps]] for the JSON representation.\r\n * @public\r\n */\r\nexport class ViewDetails3d extends ViewDetails {\r\n  private _modelClipGroups?: ModelClipGroups;\r\n\r\n  private get _json3d(): ViewDetails3dProps {\r\n    return this._json as ViewDetails3dProps;\r\n  }\r\n\r\n  /** Event raised when just before assignment to the [[modelClipGroups]] property. */\r\n  public readonly onModelClipGroupsChanged = new BeEvent<(newGroups: ModelClipGroups) => void>();\r\n\r\n  /** @internal */\r\n  public constructor(jsonProperties: { viewDetails?: ViewDetails3dProps }) {\r\n    super(jsonProperties);\r\n  }\r\n\r\n  /** Controls whether viewing tools are allowed to operate on the view in 3 dimensions. */\r\n  public get allow3dManipulations(): boolean {\r\n    return !JsonUtils.asBool(this._json3d.disable3dManipulations, false);\r\n  }\r\n  public set allow3dManipulations(allow: boolean) {\r\n    this._json3d.disable3dManipulations = allow ? undefined : true;\r\n  }\r\n\r\n  /** Groups of models associated with [ClipVector]($core-geometry)s by which those models should be clipped.\r\n   * If the view and the model both have a clip vector defined, geometry in the model will be clipped by the intersection of the two clip vectors.\r\n   * [[ViewFlags.clipVolume]] has no effect on model clips, only the view clip - model clips are always applied.\r\n   * @note Do **not** modify the returned object directly. Instead, clone it, modify the clone, and pass the clone to the property setter.\r\n   */\r\n  public get modelClipGroups(): ModelClipGroups {\r\n    if (!this._modelClipGroups)\r\n      this._modelClipGroups = ModelClipGroups.fromJSON(this._json3d.modelClipGroups);\r\n\r\n    return this._modelClipGroups;\r\n  }\r\n  public set modelClipGroups(groups: ModelClipGroups) {\r\n    this.onModelClipGroupsChanged.raiseEvent(groups);\r\n    this._modelClipGroups = groups;\r\n    this._json3d.modelClipGroups = groups.toJSON();\r\n  }\r\n\r\n  /** Returns the internal JSON representation. This is *not* a copy.\r\n   * @internal\r\n   */\r\n  public override getJSON(): Readonly<ViewDetails3dProps> {\r\n    return this._json3d;\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ViewDetails.js","sourceRoot":"","sources":["../../src/ViewDetails.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Views\n */\n\nimport { assert, BeEvent, Id64, Id64String, JsonUtils } from \"@itwin/core-bentley\";\nimport { ClipVector, ClipVectorProps, Geometry, XAndY } from \"@itwin/core-geometry\";\nimport { ModelClipGroupProps, ModelClipGroups } from \"./ModelClipGroup\";\n\n/** Properties of a [[ViewDefinitionProps]] stored as JSON.\n * @see [[ViewDefinitionProps.jsonProperties]].\n * @see [[ViewDetails3dProps]] for additional properties specific to 3d views.\n * @public\n * @extensions\n */\nexport interface ViewDetailsProps {\n  /** Id of the aux coord system. Default: invalid. */\n  acs?: Id64String;\n  /** Aspect ratio skew (x/y) used to exaggerate the y axis of the view. Default: 1.0. */\n  aspectSkew?: number;\n  /** Grid orientation. Default: WorldXY. */\n  gridOrient?: GridOrientationType;\n  /** Default: 10. */\n  gridPerRef?: number;\n  /** Default: 1.0. */\n  gridSpaceX?: number;\n  /** Default: same as gridSpaceX. */\n  gridSpaceY?: number;\n  /** Describes the [ClipVector]($core-geometry) applied to the view. */\n  clip?: ClipVectorProps;\n}\n\n/** Describes the orientation of the grid displayed within a [Viewport]($frontend).\n * @public\n * @extensions\n */\nexport enum GridOrientationType {\n  /** Oriented with the view. */\n  View = 0,\n  /** Top */\n  WorldXY = 1,\n  /** Right */\n  WorldYZ = 2,\n  /** Front */\n  WorldXZ = 3,\n  /** Oriented by the auxiliary coordinate system. */\n  AuxCoord = 4,\n}\n\n/** Properties of a [[ViewDefinition3dProps]] stored as JSON.\n * @see [[ViewDefinition3dProps.jsonProperties]].\n * @public\n * @extensions\n */\nexport interface ViewDetails3dProps extends ViewDetailsProps {\n  /** Whether viewing tools are prohibited from operating in 3 dimensions on this view. Default: false. */\n  disable3dManipulations?: boolean;\n  /** Defines how to clip groups of models. */\n  modelClipGroups?: ModelClipGroupProps[];\n}\n\n/** Encapsulates access to optional view details stored in JSON properties.\n * @see [[ViewDetailsProps]] for the JSON representation.\n * @see [ViewDefinition.details]($backend) and [ViewState.details]($frontend).\n * @public\n */\nexport class ViewDetails {\n  /** @internal */\n  protected readonly _json: ViewDetailsProps;\n  private _clipVector?: ClipVector;\n\n  /** Event raised just before assignment to the [[clipVector]] property. */\n  public readonly onClipVectorChanged = new BeEvent<(newClip: ClipVector | undefined) => void>();\n\n  /** @internal */\n  public constructor(jsonProperties: { viewDetails?: ViewDetailsProps }) {\n    if (!jsonProperties.viewDetails)\n      jsonProperties.viewDetails = {};\n\n    this._json = jsonProperties.viewDetails;\n  }\n\n  /** The Id of the auxiliary coordinate system for the view. */\n  public get auxiliaryCoordinateSystemId(): Id64String {\n    return Id64.fromJSON(this._json.acs);\n  }\n  public set auxiliaryCoordinateSystemId(id: Id64String) {\n    this._json.acs = Id64.isValidId64(id) ? id : undefined;\n  }\n\n  /** Maximum aspect ratio skew. Apps can override this by changing its value. */\n  public static maxSkew = 25;\n\n  /** The aspect ratio skew (x/y, usually 1.0) used to exaggerate the y axis of the view. */\n  public get aspectRatioSkew(): number {\n    const maxSkew = ViewDetails.maxSkew;\n    const skew = JsonUtils.asDouble(this._json.aspectSkew, 1.0);\n    return Geometry.clamp(skew, 1 / maxSkew, maxSkew);\n  }\n  public set aspectRatioSkew(skew: number) {\n    this._json.aspectSkew = 1.0 !== skew ? skew : undefined;\n  }\n\n  /** The orientation of the view's grid. */\n  public get gridOrientation(): GridOrientationType {\n    return JsonUtils.asInt(this._json.gridOrient, GridOrientationType.WorldXY);\n  }\n  public set gridOrientation(orientation: GridOrientationType) {\n    this._json.gridOrient = GridOrientationType.WorldXY === orientation ? undefined : orientation;\n  }\n\n  /** The number of grids per ref for the view. */\n  public get gridsPerRef(): number {\n    return JsonUtils.asInt(this._json.gridPerRef, 10);\n  }\n  public set gridsPerRef(gridsPerRef: number) {\n    this._json.gridPerRef = 10 === gridsPerRef ? undefined : gridsPerRef;\n  }\n\n  /** The grid spacing for the view. */\n  public get gridSpacing(): XAndY {\n    const x = JsonUtils.asDouble(this._json.gridSpaceX, 1.0);\n    const y = JsonUtils.asDouble(this._json.gridSpaceY, x);\n    return { x, y };\n  }\n  public set gridSpacing(spacing: XAndY) {\n    this._json.gridSpaceX = 1.0 !== spacing.x ? spacing.x : undefined;\n    this._json.gridSpaceY = spacing.x !== spacing.y ? spacing.y : undefined;\n  }\n\n  /** Clipping volume for the view.\n   * @note Do *not* modify the returned ClipVector. If you wish to change the ClipVector, clone the returned ClipVector, modify it as desired, and pass the clone back to the setter.\n   */\n  public get clipVector(): ClipVector | undefined {\n    if (undefined === this._clipVector) {\n      const clip = this._json.clip;\n      this._clipVector = (undefined !== clip ? ClipVector.fromJSON(clip) : ClipVector.createEmpty());\n    }\n\n    return this._clipVector.isValid ? this._clipVector : undefined;\n  }\n  public set clipVector(clip: ClipVector | undefined) {\n    const curClip = this.clipVector;\n    if (curClip === clip)\n      return;\n\n    if (!curClip) {\n      assert(undefined !== clip);\n\n      // An empty clip is equivalent to no clip.\n      if (!clip.isValid)\n        return;\n    }\n\n    clip = clip ?? ClipVector.createEmpty();\n\n    this.onClipVectorChanged.raiseEvent(clip.isValid ? clip : undefined);\n\n    this._clipVector = clip;\n    if (clip.isValid)\n      this._json.clip = clip.toJSON();\n    else\n      delete this._json.clip;\n  }\n\n  /** Returns the internal JSON representation. This is *not* a copy.\n   * @internal\n   */\n  public getJSON(): Readonly<ViewDetailsProps> {\n    return this._json;\n  }\n}\n\n/** Encapsulates access to optional 3d view details stored in JSON properties.\n * @see [[ViewDetails3dProps]] for the JSON representation.\n * @public\n */\nexport class ViewDetails3d extends ViewDetails {\n  private _modelClipGroups?: ModelClipGroups;\n\n  private get _json3d(): ViewDetails3dProps {\n    return this._json as ViewDetails3dProps;\n  }\n\n  /** Event raised when just before assignment to the [[modelClipGroups]] property. */\n  public readonly onModelClipGroupsChanged = new BeEvent<(newGroups: ModelClipGroups) => void>();\n\n  /** @internal */\n  public constructor(jsonProperties: { viewDetails?: ViewDetails3dProps }) {\n    super(jsonProperties);\n  }\n\n  /** Controls whether viewing tools are allowed to operate on the view in 3 dimensions. */\n  public get allow3dManipulations(): boolean {\n    return !JsonUtils.asBool(this._json3d.disable3dManipulations, false);\n  }\n  public set allow3dManipulations(allow: boolean) {\n    this._json3d.disable3dManipulations = allow ? undefined : true;\n  }\n\n  /** Groups of models associated with [ClipVector]($core-geometry)s by which those models should be clipped.\n   * If the view and the model both have a clip vector defined, geometry in the model will be clipped by the intersection of the two clip vectors.\n   * [[ViewFlags.clipVolume]] has no effect on model clips, only the view clip - model clips are always applied.\n   * @note Do **not** modify the returned object directly. Instead, clone it, modify the clone, and pass the clone to the property setter.\n   */\n  public get modelClipGroups(): ModelClipGroups {\n    if (!this._modelClipGroups)\n      this._modelClipGroups = ModelClipGroups.fromJSON(this._json3d.modelClipGroups);\n\n    return this._modelClipGroups;\n  }\n  public set modelClipGroups(groups: ModelClipGroups) {\n    this.onModelClipGroupsChanged.raiseEvent(groups);\n    this._modelClipGroups = groups;\n    this._json3d.modelClipGroups = groups.toJSON();\n  }\n\n  /** Returns the internal JSON representation. This is *not* a copy.\n   * @internal\n   */\n  public override getJSON(): Readonly<ViewDetails3dProps> {\n    return this._json3d;\n  }\n}\n"]}