DrawingViewState Class
A view of a DrawingModel
extensions
Extends
Methods
| Name | Description | |
|---|---|---|
| constructor(props: ViewDefinition2dProps, iModel: IModelConnection, categories: CategorySelectorState, displayStyle: DisplayStyle2dState, extents: Range3d, sectionDrawing?: SectionDrawingViewProps): DrawingViewState | ||
| getViewedExtents(): Range3d | Get the extents of this view in CoordSystem.World coordinates. | |
| toProps(): ViewStateProps | Serialize this ViewState as a set of properties that can be used to recreate it via ViewState.createFromProps. | |
| createFromProps(props: ViewStateProps, iModel: IModelConnection): DrawingViewState Static | Create a new ViewState object from a set of properties. |
Inherited methods
| Name | Inherited from | Description |
|---|---|---|
| _updateMaxGlobalScopeFactor(): void Protected | ViewState2d | |
| adjustAspectRatio(aspect: number): void | ViewState2d | Adjust the aspect ratio of this ViewState so it matches the supplied value. |
| allow3dManipulations(): boolean | ViewState2d | Returns true if ViewTools are allowed to operate in three dimensions on this view. |
| calculateFocusCorners(): Point3d[] | ViewState2d | |
| calculateFrustum(result?: Frustum): undefined | Frustum | ViewState2d | Calculate the world coordinate Frustum from the parameters of this ViewState. |
| clone(iModel?: IModelConnection): DrawingViewState | ViewState2d | Make an independent copy of this EntityState |
| computeDisplayTransform(args: ComputeDisplayTransformArgs): undefined | Transform | ViewState2d | Compute the transform applied to a model or element at display time, if any. |
| computeFitRange(): Range3d | ViewState2d | Compute a range in CoordSystem.World coordinates that tightly encloses the contents of this view. |
| createAuxCoordSystem(acsName: string): AuxCoordSystemState | ViewState2d | |
| equals(other: DrawingViewState): boolean | ViewState2d | Determine whether this ViewState exactly matches another. |
| forEachModel(func: (model: GeometricModelState) => void): void | ViewState2d | Execute a function on each viewed model |
| getAspectRatio(): number | ViewState2d | Get the aspect ratio (width/height) of this view |
| getAspectRatioSkew(): number | ViewState2d | Get the aspect ratio skew (x/y, usually 1.0) that is used to exaggerate the y axis of the view. |
| getAuxiliaryCoordinateSystemId(): string | ViewState2d | Get the Id of the auxiliary coordinate system for this ViewState |
| getCenter(result?: Point3d): Point3d | ViewState2d | Get the point at the geometric center of the view. |
| getGlobeRotation(): undefined | Matrix3d | ViewState2d | If the view is not of the project as determined by ViewState2d.getIsViewingProject then return |
| getGridOrientation(): GridOrientationType | ViewState2d | Get the grid settings for this view |
| getGridSettings(vp: Viewport, origin: Point3d, rMatrix: Matrix3d, orientation: GridOrientationType): void | ViewState2d | Populate the given origin and rotation with information from the grid settings from the grid orientation. |
| getGridSpacing(): Readonly<WritableXAndY> | ViewState2d | |
| getGridsPerRef(): number | ViewState2d | |
| getIsViewingProject(): boolean | ViewState2d | Return true if the view is looking at the current iModel project extents or |
| getModelAppearanceOverride(id: string): undefined | FeatureAppearance | ViewState2d | Query the symbology overrides applied to a model when rendered using this ViewState. |
| getRotation(): Matrix3d | ViewState2d | Get the 3x3 ortho-normal Matrix3d for this view. |
| getSubCategoryOverride(id: string): undefined | SubCategoryOverride | ViewState2d | Query the symbology overrides applied to geometry belonging to a specific subcategory when rendered using this ViewState. |
| getTargetPoint(result?: Point3d): Point3d | ViewState2d | Get the target point of the view. |
| getUpVector(point: Point3d): Vector3d | ViewState2d | |
| getViewClip(): undefined | ClipVector | ViewState2d | Get the clipping volume for this view, if defined |
| getViewedModel(): undefined | GeometricModel2dState | ViewState2d | Return the model for this 2d view. |
| getXVector(result?: Vector3d): Vector3d | ViewState2d | Get the unit vector that points in the view X (left-to-right) direction. |
| getYVector(result?: Vector3d): Vector3d | ViewState2d | Get the unit vector that points in the view Y (bottom-to-top) direction. |
| getZVector(result?: Vector3d): Vector3d | ViewState2d | Get the unit vector that points in the view Z (front-to-back) direction. |
| hasSameCoordinates(other: ViewState): boolean | ViewState2d | Determine whether this ViewState has the same coordinate system as another one. |
| is2d(): this is ViewState2d | ViewState2d | Returns true if this ViewState is-a ViewState2d |
| isSheetView(): this is SheetViewState | ViewState2d | Returns true if this ViewState is-a SheetViewState |
| load(): Promise<void> | ViewState2d | Asynchronously load any required data for this ViewState from the backend. |
| lookAtViewAlignedVolume(volume: Range3d, aspect?: number, options?: MarginOptions & OnViewExtentsError): void | ViewState2d | Look at a volume of space defined by a range in view local coordinates, keeping its current rotation. |
| lookAtVolume(volume: Readonly<WritableLowAndHighXYZ> | Readonly<WritableLowAndHighXY>, aspect?: number, options?: MarginOptions & OnViewExtentsError): void | ViewState2d | Change the volume that this view displays, keeping its current rotation. |
| resetExtentLimits(): void | ViewState2d | Resets the largest and smallest values allowed for the extents of this ViewState to their default values. |
| savePose(): ViewPose2d | ViewState2d | Capture a copy of the viewed area. |
| setAspectRatioSkew(val: number): void | ViewState2d | Set the aspect ratio skew (x/y) for this view. |
| setAuxiliaryCoordinateSystem(acs?: AuxCoordSystemState): void | ViewState2d | Set or clear the AuxiliaryCoordinateSystem for this view. |
| setCategorySelector(categories: CategorySelectorState): void | ViewState2d | Set the CategorySelector for this view. |
| setCenter(center: Point3d): void | ViewState2d | set the center of this view to a new position. |
| setDisplayStyle(style: DisplayStyleState): void | ViewState2d | |
| setExtents(delta: Readonly<WritableXAndY>): void | ViewState2d | Set the extents of this view in CoordSystem.World coordinates. |
| setGridSettings(orientation: GridOrientationType, spacing: Point2d, gridsPerRef: number): void | ViewState2d | Set the grid settings for this view |
| setOrigin(origin: Readonly<WritableXAndY>): void | ViewState2d | Set the origin of this view in CoordSystem.World coordinates. |
| setRotation(rot: Matrix3d): void | ViewState2d | Change the rotation of the view. |
| setRotationAboutPoint(rotation: Matrix3d, point?: Point3d): void | ViewState2d | Set the rotation of this ViewState to the supplied rotation, by rotating it about a point. |
| setStandardGlobalRotation(id: StandardViewId): void | ViewState2d | Orient this view to one of the StandardView rotations, if the the view is not viewing the project then the |
| setStandardRotation(id: StandardViewId): void | ViewState2d | Orient this view to one of the StandardView rotations. |
| setViewClip(clip?: ClipVector): void | ViewState2d | Set or clear the clipping volume for this view. |
| setupFromFrustum(inFrustum: Frustum, opts?: OnViewExtentsError): ViewStatus | ViewState2d | Initialize the origin, extents, and rotation from an existing Frustum |
| toJSON(): ViewDefinition2dProps | ViewState2d | Convert to JSON representation. |
| viewsCategory(id: string): boolean | ViewState2d | Determine whether the specified Category is displayed in this view |
| viewsModel(modelId: string): boolean | ViewState2d | Returns true if this view displays the contents of a ViewState2d.Model specified by Id. |
Properties
| Name | Type | Description | |
|---|---|---|---|
| attachment Accessor ReadOnly | undefined | Object | Strictly for testing. | |
| attachmentInfo Accessor ReadOnly | Object | Strictly for testing. | |
| defaultExtentLimits Accessor ReadOnly | ExtentLimits | ||
| sectionDrawingInfo Accessor ReadOnly | Strictly for testing. | ||
| sectionDrawingProps Accessor ReadOnly | undefined | SectionDrawingViewProps | Strictly for testing. |
Inherited properties
| Name | Type | Inherited from | Description |
|---|---|---|---|
| _baseModelId Protected | string | ViewState2d | |
| analysisStyle Accessor ReadOnly | undefined | AnalysisStyle | ViewState2d | See DisplayStyleSettings.analysisStyle. |
| angle Readonly | Angle | ViewState2d | |
| auxiliaryCoordinateSystem Accessor ReadOnly | AuxCoordSystemState | ViewState2d | get the auxiliary coordinate system state object for this ViewState. |
| backgroundColor Accessor ReadOnly | ColorDef | ViewState2d | Get this view's background color. |
| baseModelId Accessor ReadOnly | string | ViewState2d | |
| categorySelector Accessor | CategorySelectorState | ViewState2d | Selects the categories that are display by this ViewState. |
| classFullName Accessor StaticReadOnly | string | ViewState2d | Get full BIS class name of this Entity in the form "SchemaName:ClassName". |
| classFullName Readonly | string | ViewState2d | The full class name in the form "schema:class". |
| className Accessor ReadOnly | string | ViewState2d | The name of the BIS class associated with this class. |
| code Readonly | Code | ViewState2d | The Code for this element |
| delta Readonly | Point2d | ViewState2d | |
| description | undefined | string | ViewState2d | |
| details Accessor ReadOnly | ViewDetails | ViewState2d | Provides access to optional detail settings for this view. |
| displayStyle Accessor | DisplayStyleState | ViewState2d | The style that controls how the contents of the view are displayed. |
| extentLimits Accessor | ExtentLimits | ViewState2d | Get or set the largest and smallest values allowed for the extents for this ViewState The default limits vary based on the type of view: - Spatial view extents cannot exceed the diameter of the earth. - Drawing view extents cannot exceed twice the longest axis of the drawing model's range. - Sheet view extents cannot exceed ten times the paper size of the sheet. Explicitly setting the extent limits overrides the default limits. |
| federationGuid Readonly | undefined | string | ViewState2d | A FederationGuid assigned to this element by some other federated database |
| globalScopeFactor Accessor ReadOnly | number | ViewState2d | A value that represents the global scope of the view -- a value greater than one indicates that the scope of this view is global (viewing most of Earth). |
| id Readonly | string | ViewState2d | The Id of this Entity. |
| iModel Readonly | IModelConnection | ViewState2d | The iModel from which this Entity was loaded |
| isAttachedToViewport Accessor ReadOnly | boolean | ViewState2d | Returns whether this view is currently being displayed by a Viewport. |
| isPrivate | undefined | boolean | ViewState2d | |
| jsonProperties Readonly | { T } | ViewState2d | Optional json properties of this Entity. |
| model Readonly | string | ViewState2d | The ModelId of the Model containing this element |
| modelDisplayTransformProvider Accessor | undefined | ModelDisplayTransformProvider | ViewState2d | An object that can provide per-model transforms to be applied at display time. |
| name Accessor ReadOnly | string | ViewState2d | Get the name of the ViewDefinition from which this ViewState originated. |
| onDisplayStyleChanged Readonly | BeEvent<(newStyle: DisplayStyleState) => void> | ViewState2d | An event raised just before assignment to the ViewState2d.displayStyle property, only if the view is attached to a Viewport. |
| onModelDisplayTransformProviderChanged Readonly | BeEvent<(newProvider: undefined | ModelDisplayTransformProvider) => void> | ViewState2d | Event raised just before assignment to the ViewState2d.modelDisplayTransformProvider property, only if the view is attached to a Viewport. |
| onViewedCategoriesChanged Readonly | BeEvent<() => void> | ViewState2d | An event raised when the set of categories viewed by this view changes, only if the view is attached to a Viewport. |
| origin Readonly | Point2d | ViewState2d | |
| parent Readonly | undefined | RelatedElement | ViewState2d | The parent Element of this, or undefined if no parent. |
| scheduleScript Accessor ReadOnly | undefined | Script | ViewState2d | The RenderSchedule.Script that animates the contents of the view, if any. |
| schemaName Accessor StaticReadOnly | string | ViewState2d | The name of the BIS schema for this class. |
| userLabel Readonly | undefined | string | ViewState2d | A user-assigned label for this element. |
| viewFlags Accessor | ViewFlags | ViewState2d | Flags controlling various aspects of this view's DisplayStyleState. |
Defined in
Last Updated: 30 November, 2023