ViewerAPI

• webVis API Reference
• ViewerAPI

Interface ViewerAPI

The ViewerDrawingAPI provides basic functionalities to control the 2D Drawing Mode and the processed Output.

interface ViewerAPI {
    animateViewToViewmatrix(
        matrix:
            | Float32Array<ArrayBufferLike>
            | [
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
            ],
        transitionTime?: number,
    ): Promise<void>;
    cancelDrawingMode(): void;
    changeMagnifier(
        properties: ViewerMagnifierProperties,
    ): ViewerMagnifierProperties;
    changePolyline(polylineId: number, properties: PolylineProperties): void;
    changeSetting<T extends string>(
        viewerSetting: T,
        value: ViewerSettingType<T>,
    ): boolean;
    createCollectionFromGizmo(
        includeOverlappingNodes: boolean,
    ): Promise<number>;
    createGeometry(userGeoData: UserGeometryData): number;
    createPolyline(
        positions: number[],
        properties?: PolylineProperties,
    ): number;
    dehighlightEntity(highlightHandle?: number): void;
    enableNavigation(flag?: boolean): void;
    enableSnapping(useSnapping: boolean): void;
    enterColorCompareMode(): void;
    enterDrawingMode(): void;
    fitView(
        view?: Float32Array<ArrayBufferLike> | [number, number, number],
        up?: Float32Array<ArrayBufferLike> | [number, number, number],
        transitionTime?: number,
    ): Promise<void>;
    fitViewToAuxNode(nodeID: number, transitionTime?: number): Promise<void>;
    fitViewToDirection(
        direction?: ViewDirection,
        transitionTime?: number,
    ): Promise<void>;
    fitViewToNode(
        nodeID: number,
        view?: Float32Array<ArrayBufferLike> | [number, number, number],
        up?: Float32Array<ArrayBufferLike> | [number, number, number],
        transitionTime?: number,
    ): Promise<void>;
    fitViewToRectangle(
        x: number,
        y: number,
        width: number,
        height: number,
        transitionTime?: number,
    ): Promise<void>;
    fitViewToVolume(
        volume: BoxVolume,
        view?: Float32Array<ArrayBufferLike> | [number, number, number],
        up?: Float32Array<ArrayBufferLike> | [number, number, number],
        transitionTime?: number,
    ): Promise<void>;
    fitViewToVolumeFromDirection(
        volume: BoxVolume,
        direction?: ViewDirection,
        transitionTime?: number,
    ): Promise<void>;
    flipAuxToView(): void;
    forceRenderMode(renderMode: RenderMode): void;
    getActiveItem(): ActiveItemInfo;
    getAvailableGizmoTransformationModes(): number;
    getBoxGizmoProperties(): BoxGizmoProperties;
    getCameraPosition(): | Float32Array<ArrayBufferLike>
    | [number, number, number];
    getCameraProjectionType(): CameraProjectionType;
    getCenterOfRotation(): | Float32Array<ArrayBufferLike>
    | [number, number, number];
    getContext(): ContextAPI;
    getCurrentGizmoType(): GizmoType;
    getGizmoSize(): Float32Array<ArrayBufferLike> | [number, number, number];
    getGizmoTransform(): | Float32Array<ArrayBufferLike>
    | [
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
    ];
    getGizmoTransformationMode(): GizmoTransformationMode;
    getID(): string;
    getInteractionLevel(): ViewerInteractionLevel;
    getMagnifierProperties(): ViewerMagnifierProperties;
    getProjectionMatrix(): | Float32Array<ArrayBufferLike>
    | [
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
    ];
    getState(): ViewerState;
    getToCoordinateSystemMatrix(): | Float32Array<ArrayBufferLike>
    | [
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
    ];
    getViewMatrix(): [
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
    ];
    hideAllLineMarkers(): void;
    hideAllMarkers(): void;
    hideAllPointMarkers(): void;
    hideGizmo(): void;
    hidePointMarker(index?: number): void;
    highlightArc(
        pickedPt1: Float32Array<ArrayBufferLike> | [number, number, number],
        pickedPt3: Float32Array<ArrayBufferLike> | [number, number, number],
        center: Float32Array<ArrayBufferLike> | [number, number, number],
        axis: Float32Array<ArrayBufferLike> | [number, number, number],
        angle: number,
        measurementID: number,
    ): number;
    highlightBBox(
        center: Float32Array<ArrayBufferLike> | [number, number, number],
        size: Float32Array<ArrayBufferLike> | [number, number, number],
    ): number;
    highlightCircularArc(
        circularArcDescriptor: TopologyCircularArcDescriptor,
    ): number;
    highlightEntity(
        handle: TopologyHandle,
        highlightParameters?: ViewerHighlightParameters,
    ): Promise<number>;
    highlightLine(values: number[], scale: number, markerIndex: number): void;
    highlightPoint(
        position: Float32Array<ArrayBufferLike> | [number, number, number],
        markerIndex: number,
    ): void;
    isSnappingEnabled(): boolean;
    leaveColorCompareMode(): void;
    leaveDrawingMode(
        options?: ViewerDrawingProcessOptions,
    ): Promise<ViewerDrawingResult>;
    readSetting<T extends string>(viewerSetting: T): ViewerSettingType<T>;
    removeGeometry(id: number): void;
    removePolyline(polylineId: number): void;
    requestNodeIdsByRect(
        x: number,
        y: number,
        width: number,
        height: number,
        includeOverlappingNodes?: boolean,
    ): Promise<number[]>;
    requestScreenshot(
        width?: number,
        height?: number,
        mimeType?: "image/png" | "image/jpeg",
        resetCanvasSize?: boolean,
    ): Promise<string>;
    requestTopologyHandlesByRect(
        x: number,
        y: number,
        width: number,
        height: number,
    ): Promise<TopologyHandle[]>;
    reset(): void;
    resetSetting(viewerSetting: ViewerSettingStrings): void;
    restoreInitView(): void;
    setActiveItem(id: number, type: ActiveItemType): void;
    setCenterOfRotation(
        center?: Float32Array<ArrayBufferLike> | [number, number, number],
    ): Promise<void>;
    setCORGizmoVisible(flag: boolean): void;
    setGizmoTransformationMode(mode: GizmoTransformationMode): void;
    setInteractionLevel(level: ViewerInteractionLevel): void;
    setProjectionMatrix(
        matrix:
            | Float32Array<ArrayBufferLike>
            | [
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
            ],
    ): void;
    setView(
        position: Float32Array<ArrayBufferLike> | [number, number, number],
        target: Float32Array<ArrayBufferLike> | [number, number, number],
        upVector?: Float32Array<ArrayBufferLike> | [number, number, number],
        transitionTime?: number,
    ): Promise<void>;
    setViewMatrix(
        matrix:
            | Float32Array<ArrayBufferLike>
            | [
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
            ],
        transitionTime?: number,
    ): Promise<void>;
    showAxisMarker(
        values:
            | Float32Array<ArrayBufferLike>
            | [number, number, number, number, number, number],
        scale?: number,
        index?: number,
    ): void;
    showBoxGizmo(properties?: BoxGizmoProperties): void;
    showClippingBoxGizmo(clipRoomID: number): void;
    showPointMarker(
        position: Float32Array<ArrayBufferLike> | [number, number, number],
        index?: number,
    ): void;
    showSelectionBoxGizmo(
        size?: Float32Array<ArrayBufferLike> | [number, number, number],
        transform?:
            | Float32Array<ArrayBufferLike>
            | [
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
                number,
            ],
    ): void;
    showSelectionBoxGizmoFromVolume(volume?: BoxVolume): void;
    showSelectionTransformationGizmo(nodeIds: number[]): void;
    takeScreenshot(
        callback: (dataUrl: string) => void,
        mimeType?: string,
        width?: number,
        height?: number,
    ): void;
    updateGeometry(id: number, data: UserGeometryData): void;
}

Hierarchy (View Summary)

• ViewerDrawingAPI
• ViewerInteractionAPI
• ViewerGizmoAPI
• ViewerHighlightAPI
• ViewerPolylineAPI
• ViewerUserGeometryAPI
• ViewerStateAPI
• ViewerMagnifierAPI
  • ViewerAPI

Index

Methods

animateViewToViewmatrix cancelDrawingMode changeMagnifier changePolyline changeSetting createCollectionFromGizmo createGeometry createPolyline dehighlightEntity enableNavigation enableSnapping enterColorCompareMode enterDrawingMode fitView fitViewToAuxNode fitViewToDirection fitViewToNode fitViewToRectangle fitViewToVolume fitViewToVolumeFromDirection flipAuxToView forceRenderMode getActiveItem getAvailableGizmoTransformationModes getBoxGizmoProperties getCameraPosition getCameraProjectionType getCenterOfRotation getContext getCurrentGizmoType getGizmoSize getGizmoTransform getGizmoTransformationMode getID getInteractionLevel getMagnifierProperties getProjectionMatrix getState getToCoordinateSystemMatrix getViewMatrix hideAllLineMarkers hideAllMarkers hideAllPointMarkers hideGizmo hidePointMarker highlightArc highlightBBox highlightCircularArc highlightEntity highlightLine highlightPoint isSnappingEnabled leaveColorCompareMode leaveDrawingMode readSetting removeGeometry removePolyline requestNodeIdsByRect requestScreenshot requestTopologyHandlesByRect reset resetSetting restoreInitView setActiveItem setCenterOfRotation setCORGizmoVisible setGizmoTransformationMode setInteractionLevel setProjectionMatrix setView setViewMatrix showAxisMarker showBoxGizmo showClippingBoxGizmo showPointMarker showSelectionBoxGizmo showSelectionBoxGizmoFromVolume showSelectionTransformationGizmo takeScreenshot updateGeometry

Methods

animateViewToViewmatrix

• animateViewToViewmatrix(
      matrix:
          | Float32Array<ArrayBufferLike>
          | [
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
          ],
      transitionTime?: number,
  ): Promise<void>

• Animates to the given viewmatrix

  Parameters

  • matrix:
        | Float32Array<ArrayBufferLike>
        | [
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
        ]

    The new view matrix for the camera
  • OptionaltransitionTime: number

    Defines the transition time for the camera movement

  Returns Promise<void>

cancelDrawingMode

• cancelDrawingMode(): void

• Leaves the 2D Drawing Mode and discards all drawings.

  Returns void

  Inherited from ViewerDrawingAPI.cancelDrawingMode

changeMagnifier

• changeMagnifier(
      properties: ViewerMagnifierProperties,
  ): ViewerMagnifierProperties

• Changes the properties of the viewers magnifier.

  Parameters

  • properties: ViewerMagnifierProperties

    Object of Properties which should be changed.

  Returns ViewerMagnifierProperties

  An Object with the changed Properties.

  Inherited from ViewerMagnifierAPI.changeMagnifier

changePolyline

• changePolyline(polylineId: number, properties: PolylineProperties): void

• Changes the properties of the Polyline with the specified Id.

  Parameters

  • polylineId: number

    The Id of the Polyline which should be removed.
  • properties: PolylineProperties

    The properties which should be changed.

  Returns void

  Inherited from ViewerPolylineAPI.changePolyline

changeSetting

• changeSetting<T extends string>(
      viewerSetting: T,
      value: ViewerSettingType<T>,
  ): boolean

• Changes the viewer setting with the given name to the given value.

  Type Parameters

  • T extends string

  Parameters

  • viewerSetting: T

    Specifies a particular viewer setting which one would like to change.
  • value: ViewerSettingType<T>

    A new value for the specified setting.

  Returns boolean

  A boolean which indicates if the setting has changed

createCollectionFromGizmo

• createCollectionFromGizmo(includeOverlappingNodes: boolean): Promise<number>

• Parameters

  • includeOverlappingNodes: boolean

  Returns Promise<number>

  Inherited from ViewerGizmoAPI.createCollectionFromGizmo

createGeometry

• createGeometry(userGeoData: UserGeometryData): number

• Parameters

  • userGeoData: UserGeometryData

  Returns number

  Inherited from ViewerUserGeometryAPI.createGeometry

createPolyline

• createPolyline(positions: number[], properties?: PolylineProperties): number

• Creates a new Polyline with the specified positions and properties.

  Parameters

  • positions: number[]

    List of 3D positions which defines the Polyline.
  • Optionalproperties: PolylineProperties

    The properties of the Polyline.

  Returns number

  Inherited from ViewerPolylineAPI.createPolyline

dehighlightEntity

• dehighlightEntity(highlightHandle?: number): void

• Disable highlighting for the handle

  Parameters

  • OptionalhighlightHandle: number

    : number

  Returns void

  Inherited from ViewerHighlightAPI.dehighlightEntity

enableNavigation

• enableNavigation(flag?: boolean): void

• Toggles the state of the 3D navigation (on or off).

  Parameters

  • Optionalflag: boolean

  Returns void

enableSnapping

• enableSnapping(useSnapping: boolean): void

• Parameters

  • useSnapping: boolean

  Returns void

  Inherited from ViewerInteractionAPI.enableSnapping

enterColorCompareMode

• enterColorCompareMode(): void

• Enters the color compare mode which renders Nodes depending on the COMPARISON_GROUP-Property.

  Returns void

enterDrawingMode

• enterDrawingMode(): void

• Enters the 2D drawing Mode where you can draw on top of your 3D Model.

  Returns void

  Inherited from ViewerDrawingAPI.enterDrawingMode

fitView

• fitView(
      view?: Float32Array<ArrayBufferLike> | [number, number, number],
      up?: Float32Array<ArrayBufferLike> | [number, number, number],
      transitionTime?: number,
  ): Promise<void>

• Positions the camera such that the whole geometry is fitting into the view. The view and up parameter allow to define a viewing direction and roll for the resulting camera pose.

  Parameters

  • Optionalview: Float32Array<ArrayBufferLike> | [number, number, number]

    Defines the desired viewing direction
  • Optionalup: Float32Array<ArrayBufferLike> | [number, number, number]

    Defines the desired camera orientation in conjunction with the viewing direction
  • OptionaltransitionTime: number

    Defines the transition time for the camera movement

  Returns Promise<void>

fitViewToAuxNode

• fitViewToAuxNode(nodeID: number, transitionTime?: number): Promise<void>

• Positions the camera such that the aux node is fitting into the view.

  Parameters

  • nodeID: number

    The ID of the node on which one wants to fit the view
  • OptionaltransitionTime: number

    Defines the transition time for the camera movement

  Returns Promise<void>

fitViewToDirection

• fitViewToDirection(
      direction?: ViewDirection,
      transitionTime?: number,
  ): Promise<void>

• Positions the camera such that it looks from a specific direction.

  Parameters

  • Optionaldirection: ViewDirection

    The direction to fit.
  • OptionaltransitionTime: number

    Defines the transition time for the camera movement

  Returns Promise<void>

fitViewToNode

• fitViewToNode(
      nodeID: number,
      view?: Float32Array<ArrayBufferLike> | [number, number, number],
      up?: Float32Array<ArrayBufferLike> | [number, number, number],
      transitionTime?: number,
  ): Promise<void>

• Positions the camera such that the node’s bounding box is fitting into the view. The view and up parameter allow to define a viewing direction and roll for the resulting camera pose.

  Parameters

  • nodeID: number

    The ID of the node on which one wants to fit the view
  • Optionalview: Float32Array<ArrayBufferLike> | [number, number, number]

    The direction in which the camera will look on the node
  • Optionalup: Float32Array<ArrayBufferLike> | [number, number, number]

    The orientation in which the camera will look on the node
  • OptionaltransitionTime: number

    Defines the transition time for the camera movement

  Returns Promise<void>

fitViewToRectangle

• fitViewToRectangle(
      x: number,
      y: number,
      width: number,
      height: number,
      transitionTime?: number,
  ): Promise<void>

• Positions the camera such that the view is focused onto the given rectangle.

  Parameters

  • x: number

    Specifies the X-Coordinate of the 2D screen space Rectangle.
  • y: number

    Specifies the Y-Coordinate of the 2D screen space Rectangle.
  • width: number

    Specifies the width of the 2D screen space Rectangle.
  • height: number

    Specifies the height of the 2D screen space Rectangle.
  • OptionaltransitionTime: number

    Defines the transition time for the camera movement.

  Returns Promise<void>

fitViewToVolume

• fitViewToVolume(
      volume: BoxVolume,
      view?: Float32Array<ArrayBufferLike> | [number, number, number],
      up?: Float32Array<ArrayBufferLike> | [number, number, number],
      transitionTime?: number,
  ): Promise<void>

• Positions the camera such that the view is focused onto the given volume. The view and up parameter allow to define a viewing direction and roll for the resulting camera pose.

  Parameters

  • volume: BoxVolume

    A particular volume on which the view will be fitted
  • Optionalview: Float32Array<ArrayBufferLike> | [number, number, number]

    Specifies the direction in which the camera will look on the volume
  • Optionalup: Float32Array<ArrayBufferLike> | [number, number, number]

    Specifies the orientation in which the camera will look on the volume
  • OptionaltransitionTime: number

    Defines the transition time for the camera movement

  Returns Promise<void>

fitViewToVolumeFromDirection

• fitViewToVolumeFromDirection(
      volume: BoxVolume,
      direction?: ViewDirection,
      transitionTime?: number,
  ): Promise<void>

• Positions the camera such that it looks from the specified direction onto the specified volume.

  Parameters

  • volume: BoxVolume

    The volume on which the camera will be fitted
  • Optionaldirection: ViewDirection

    The direction to fit.
  • OptionaltransitionTime: number

    Defines the transition time for the camera movement

  Returns Promise<void>

flipAuxToView

• flipAuxToView(): void

• Flips the auxiliaries with respect to the current view

  Returns void

forceRenderMode

• forceRenderMode(renderMode: RenderMode): void

• Forces the viewer to render in the specified render mode regardless of any other render mode settings. If RenderMode.Unset is passed, the viewer will switch back to the default behaviour.

  Parameters

  • renderMode: RenderMode

    The render mode to force the viewer to render in.

  Returns void

getActiveItem

• getActiveItem(): ActiveItemInfo

• Returns ActiveItemInfo

  Inherited from ViewerGizmoAPI.getActiveItem

getAvailableGizmoTransformationModes

• getAvailableGizmoTransformationModes(): number

• Returns number

  Inherited from ViewerGizmoAPI.getAvailableGizmoTransformationModes

getBoxGizmoProperties

• getBoxGizmoProperties(): BoxGizmoProperties

• Returns the properties of the BoxGizmo

  Returns BoxGizmoProperties

  The properties of the BoxGizmo

  Inherited from ViewerGizmoAPI.getBoxGizmoProperties

getCameraPosition

• getCameraPosition(): Float32Array<ArrayBufferLike> | [number, number, number]

• Return the current Camera position

  Returns Float32Array<ArrayBufferLike> | [number, number, number]

  The current Camera position

getCameraProjectionType

• getCameraProjectionType(): CameraProjectionType

• Return the current Camera projection tyxpe

  Returns CameraProjectionType

  The current Camera projection tyxpe

getCenterOfRotation

• getCenterOfRotation(): Float32Array<ArrayBufferLike> | [number, number, number]

• Returns the center of rotation being the point around which the camera rotates around.

  Returns Float32Array<ArrayBufferLike> | [number, number, number]

getContext

• getContext(): ContextAPI

• Returns ContextAPI

getCurrentGizmoType

• getCurrentGizmoType(): GizmoType

• Returns GizmoType

  Inherited from ViewerGizmoAPI.getCurrentGizmoType

getGizmoSize

• getGizmoSize(): Float32Array<ArrayBufferLike> | [number, number, number]

• Returns Float32Array<ArrayBufferLike> | [number, number, number]

  Inherited from ViewerGizmoAPI.getGizmoSize

getGizmoTransform

• getGizmoTransform(): | Float32Array<ArrayBufferLike>
  | [
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
  ]

• Returns
      | Float32Array<ArrayBufferLike>
      | [
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
      ]

  Inherited from ViewerGizmoAPI.getGizmoTransform

getGizmoTransformationMode

• getGizmoTransformationMode(): GizmoTransformationMode

• Returns GizmoTransformationMode

  Inherited from ViewerGizmoAPI.getGizmoTransformationMode

getID

• getID(): string

• Returns string

getInteractionLevel

• getInteractionLevel(): ViewerInteractionLevel

• Returns the Viewer interaction level.

  Returns ViewerInteractionLevel

  The current interaction level.

  Inherited from ViewerInteractionAPI.getInteractionLevel

getMagnifierProperties

• getMagnifierProperties(): ViewerMagnifierProperties

• Returns the current properties of the magnifier.

  Returns ViewerMagnifierProperties

  The current properties of the magnifier.

  Inherited from ViewerMagnifierAPI.getMagnifierProperties

getProjectionMatrix

• getProjectionMatrix(): | Float32Array<ArrayBufferLike>
  | [
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
  ]

• Returns the current projection matrix.

  Returns
      | Float32Array<ArrayBufferLike>
      | [
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
      ]

  The current projection matrix

getState

• getState(): ViewerState

• Returns ViewerState

  Inherited from ViewerStateAPI.getState

getToCoordinateSystemMatrix

• getToCoordinateSystemMatrix(): | Float32Array<ArrayBufferLike>
  | [
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
  ]

• Returns
      | Float32Array<ArrayBufferLike>
      | [
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
          number,
      ]

  The toCoordinateSystem Matrix

  Deprecated

  use getCoordinateSystemMatrix instead

  Returns a 4x4 rotation matrix which is used to transform the internal default right-handed coordinate system with X and Y as front plane axis to the configured one.

getViewMatrix

• getViewMatrix(): [
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
  ]

• Returns the current view matrix.

  Returns [
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
      number,
  ]

  The current view matrix of the camera

hideAllLineMarkers

• hideAllLineMarkers(): void

• Returns void

  Inherited from ViewerGizmoAPI.hideAllLineMarkers

hideAllMarkers

• hideAllMarkers(): void

• Returns void

  Inherited from ViewerGizmoAPI.hideAllMarkers

hideAllPointMarkers

• hideAllPointMarkers(): void

• Returns void

  Inherited from ViewerGizmoAPI.hideAllPointMarkers

hideGizmo

• hideGizmo(): void

• Hides the currently visible Gizmo

  Returns void

  Inherited from ViewerGizmoAPI.hideGizmo

hidePointMarker

• hidePointMarker(index?: number): void

• Parameters

  • Optionalindex: number

  Returns void

  Inherited from ViewerGizmoAPI.hidePointMarker

highlightArc

• highlightArc(
      pickedPt1: Float32Array<ArrayBufferLike> | [number, number, number],
      pickedPt3: Float32Array<ArrayBufferLike> | [number, number, number],
      center: Float32Array<ArrayBufferLike> | [number, number, number],
      axis: Float32Array<ArrayBufferLike> | [number, number, number],
      angle: number,
      measurementID: number,
  ): number

• Parameters

  • pickedPt1: Float32Array<ArrayBufferLike> | [number, number, number]
  • pickedPt3: Float32Array<ArrayBufferLike> | [number, number, number]
  • center: Float32Array<ArrayBufferLike> | [number, number, number]
  • axis: Float32Array<ArrayBufferLike> | [number, number, number]
  • angle: number
  • measurementID: number

  Returns number

  Inherited from ViewerHighlightAPI.highlightArc

highlightBBox

• highlightBBox(
      center: Float32Array<ArrayBufferLike> | [number, number, number],
      size: Float32Array<ArrayBufferLike> | [number, number, number],
  ): number

• Parameters

  • center: Float32Array<ArrayBufferLike> | [number, number, number]
  • size: Float32Array<ArrayBufferLike> | [number, number, number]

  Returns number

  Inherited from ViewerHighlightAPI.highlightBBox

highlightCircularArc

• highlightCircularArc(
      circularArcDescriptor: TopologyCircularArcDescriptor,
  ): number

• Parameters

  • circularArcDescriptor: TopologyCircularArcDescriptor

  Returns number

  Inherited from ViewerHighlightAPI.highlightCircularArc

highlightEntity

• highlightEntity(
      handle: TopologyHandle,
      highlightParameters?: ViewerHighlightParameters,
  ): Promise<number>

• Enable highlighting of the entity , which matches the attributes informed in the viewerDataSelector

  Parameters

  • handle: TopologyHandle

    : IViewerHighlightSelector
  • OptionalhighlightParameters: ViewerHighlightParameters

  Returns Promise<number>

  the highlightHandle, which it reqed to remove the highlighting

  Inherited from ViewerHighlightAPI.highlightEntity

highlightLine

• highlightLine(values: number[], scale: number, markerIndex: number): void

• Parameters

  • values: number[]
  • scale: number
  • markerIndex: number

  Returns void

  Inherited from ViewerHighlightAPI.highlightLine

highlightPoint

• highlightPoint(
      position: Float32Array<ArrayBufferLike> | [number, number, number],
      markerIndex: number,
  ): void

• Parameters

  • position: Float32Array<ArrayBufferLike> | [number, number, number]
  • markerIndex: number

  Returns void

  Inherited from ViewerHighlightAPI.highlightPoint

isSnappingEnabled

• isSnappingEnabled(): boolean

• Returns boolean

  Inherited from ViewerInteractionAPI.isSnappingEnabled

leaveColorCompareMode

• leaveColorCompareMode(): void

• Leave the color compare render mode.

  Returns void

leaveDrawingMode

• leaveDrawingMode(
      options?: ViewerDrawingProcessOptions,
  ): Promise<ViewerDrawingResult>

• Leaves the 2D Drawing Mode and returns the processed 2D drawing data which can be used to create a Drawing with the help of the DrawingAPI.

  Parameters

  • Optionaloptions: ViewerDrawingProcessOptions

    Options to configure the result of the processing.

  Returns Promise<ViewerDrawingResult>

  The processed 2D drawing data.

  Inherited from ViewerDrawingAPI.leaveDrawingMode

readSetting

• readSetting<T extends string>(viewerSetting: T): ViewerSettingType<T>

• Returns the value of a viewer setting.

  Type Parameters

  • T extends string

  Parameters

  • viewerSetting: T

    The name of a particular setting whose value one wants to read

  Returns ViewerSettingType<T>

  The value of the specified setting

removeGeometry

• removeGeometry(id: number): void

• Parameters

  • id: number

  Returns void

  Inherited from ViewerUserGeometryAPI.removeGeometry

removePolyline

• removePolyline(polylineId: number): void

• Removes the Polyline with the specified Id.

  Parameters

  • polylineId: number

    The Id of the Polyline which should be removed.

  Returns void

  Inherited from ViewerPolylineAPI.removePolyline

requestNodeIdsByRect

• requestNodeIdsByRect(
      x: number,
      y: number,
      width: number,
      height: number,
      includeOverlappingNodes?: boolean,
  ): Promise<number[]>

• Returns a List of all NodeIds which are included or overlapped by the specified 2D screen space Rectangle.

  Parameters

  • x: number

    Specifies the X-Coordinate of the 2D screen space Rectangle.
  • y: number

    Specifies the Y-Coordinate of the 2D screen space Rectangle.
  • width: number

    Specifies the width of the 2D screen space Rectangle.
  • height: number

    Specifies the height of the 2D screen space Rectangle.
  • OptionalincludeOverlappingNodes: boolean

    Specifies that the result should include Nodes which overlap the specified 2D screen space Rectangle as well.

  Returns Promise<number[]>

  List of all NodeIds which are included or overlapped by the specified 2D screen space Rectangle.

requestScreenshot

• requestScreenshot(
      width?: number,
      height?: number,
      mimeType?: "image/png" | "image/jpeg",
      resetCanvasSize?: boolean,
  ): Promise<string>

• Requests a screenshot from the current view.

  Parameters

  • Optionalwidth: number

    The width of the requested screenshot. If not specified it uses the width of the current view.
  • Optionalheight: number

    The height of the requested screenshot. If not specified it uses the height of the current view.
  • OptionalmimeType: "image/png" | "image/jpeg"

    A string indicating the image format. The default type is image/png.
  • OptionalresetCanvasSize: boolean

  Returns Promise<string>

  • A string containing the requested screenshot as dataUrl.

requestTopologyHandlesByRect

• requestTopologyHandlesByRect(
      x: number,
      y: number,
      width: number,
      height: number,
  ): Promise<TopologyHandle[]>

• Returns a List of all TopologyHandles which ared included & overlapped by the specified 2D screen space Rectangle.

  Parameters

  • x: number

    Specifies the X-Coordinate of the 2D screen space Rectangle.
  • y: number

    Specifies the Y-Coordinate of the 2D screen space Rectangle.
  • width: number

    Specifies the width of the 2D screen space Rectangle.
  • height: number

    Specifies the height of the 2D screen space Rectangle.

  Returns Promise<TopologyHandle[]>

  List of all TopologyHandles which are included & overlapped by the specified 2D screen space Rectangle.

reset

• reset(): void

• Returns void

  Deprecated

  Will be removed in a future version because it is not needed anymore to switch between render setups.

  The viewer is destroyed and reinitialized with renderSetup selection

resetSetting

• resetSetting(viewerSetting: ViewerSettingStrings): void

• Resets the value of a viewer setting.

  Parameters

  • viewerSetting: ViewerSettingStrings

    The name of the viewer setting that should be reset.

  Returns void

restoreInitView

• restoreInitView(): void

• Sets the camera to the initial position

  Returns void

setActiveItem

• setActiveItem(id: number, type: ActiveItemType): void

• Parameters

  • id: number
  • type: ActiveItemType

  Returns void

  Inherited from ViewerGizmoAPI.setActiveItem

setCenterOfRotation

• setCenterOfRotation(
      center?: Float32Array<ArrayBufferLike> | [number, number, number],
  ): Promise<void>

• Sets the center of rotation being the point around which the inspection camera rotates. If no center parameter is supplied the center of rotation is set to the center of all currently loaded models.

  Parameters

  • Optionalcenter: Float32Array<ArrayBufferLike> | [number, number, number]

    The center of rotation

  Returns Promise<void>

setCORGizmoVisible

• setCORGizmoVisible(flag: boolean): void

• Parameters

  • flag: boolean

  Returns void

  Inherited from ViewerGizmoAPI.setCORGizmoVisible

setGizmoTransformationMode

• setGizmoTransformationMode(mode: GizmoTransformationMode): void

• Parameters

  • mode: GizmoTransformationMode

  Returns void

  Inherited from ViewerGizmoAPI.setGizmoTransformationMode

setInteractionLevel

• setInteractionLevel(level: ViewerInteractionLevel): void

• Sets the Viewer interaction level.

  Parameters

  • level: ViewerInteractionLevel

    Specifies the interaction level.

  Returns void

  Inherited from ViewerInteractionAPI.setInteractionLevel

setProjectionMatrix

• setProjectionMatrix(
      matrix:
          | Float32Array<ArrayBufferLike>
          | [
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
          ],
  ): void

• Sets the current projection matrix.

  Parameters

  • matrix:
        | Float32Array<ArrayBufferLike>
        | [
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
        ]

    The new projection matrix

  Returns void

setView

• setView(
      position: Float32Array<ArrayBufferLike> | [number, number, number],
      target: Float32Array<ArrayBufferLike> | [number, number, number],
      upVector?: Float32Array<ArrayBufferLike> | [number, number, number],
      transitionTime?: number,
  ): Promise<void>

• Sets the camera position, its target and the up-vector. If the up-vector is not defined, the previous up-vector is kept.

  Parameters

  • position: Float32Array<ArrayBufferLike> | [number, number, number]

    Specifies the new position or center of the camera
  • target: Float32Array<ArrayBufferLike> | [number, number, number]

    Specifies the point on which the camera will look
  • OptionalupVector: Float32Array<ArrayBufferLike> | [number, number, number]

    Specifies the new orientation of the camera
  • OptionaltransitionTime: number

    Defines the transition time for the camera movement

  Returns Promise<void>

setViewMatrix

• setViewMatrix(
      matrix:
          | Float32Array<ArrayBufferLike>
          | [
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
          ],
      transitionTime?: number,
  ): Promise<void>

• Sets the camera view matrix.

  Parameters

  • matrix:
        | Float32Array<ArrayBufferLike>
        | [
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
        ]

    The new view matrix for the camera
  • OptionaltransitionTime: number

    Defines the transition time for the camera movement

  Returns Promise<void>

showAxisMarker

• showAxisMarker(
      values:
          | Float32Array<ArrayBufferLike>
          | [number, number, number, number, number, number],
      scale?: number,
      index?: number,
  ): void

• Parameters

  • values: Float32Array<ArrayBufferLike> | [number, number, number, number, number, number]
  • Optionalscale: number
  • Optionalindex: number

  Returns void

  Inherited from ViewerGizmoAPI.showAxisMarker

showBoxGizmo

• showBoxGizmo(properties?: BoxGizmoProperties): void

• Shows the BoxGizmo based on the specified properties. If the BoxGizmo is already visible the specified properties will be updated.

  Parameters

  • Optionalproperties: BoxGizmoProperties

    The properties of the BoxGizmo.

  Returns void

  Inherited from ViewerGizmoAPI.showBoxGizmo

showClippingBoxGizmo

• showClippingBoxGizmo(clipRoomID: number): void

• Parameters

  • clipRoomID: number

  Returns void

  Inherited from ViewerGizmoAPI.showClippingBoxGizmo

showPointMarker

• showPointMarker(
      position: Float32Array<ArrayBufferLike> | [number, number, number],
      index?: number,
  ): void

• Parameters

  • position: Float32Array<ArrayBufferLike> | [number, number, number]
  • Optionalindex: number

  Returns void

  Inherited from ViewerGizmoAPI.showPointMarker

showSelectionBoxGizmo

• showSelectionBoxGizmo(
      size?: Float32Array<ArrayBufferLike> | [number, number, number],
      transform?:
          | Float32Array<ArrayBufferLike>
          | [
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
              number,
          ],
  ): void

• Parameters

  • Optionalsize: Float32Array<ArrayBufferLike> | [number, number, number]
  • Optionaltransform:
        | Float32Array<ArrayBufferLike>
        | [
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
            number,
        ]

  Returns void

  Inherited from ViewerGizmoAPI.showSelectionBoxGizmo

showSelectionBoxGizmoFromVolume

• showSelectionBoxGizmoFromVolume(volume?: BoxVolume): void

• Parameters

  • Optionalvolume: BoxVolume

  Returns void

  Inherited from ViewerGizmoAPI.showSelectionBoxGizmoFromVolume

showSelectionTransformationGizmo

• showSelectionTransformationGizmo(nodeIds: number[]): void

• Parameters

  • nodeIds: number[]

  Returns void

  Inherited from ViewerGizmoAPI.showSelectionTransformationGizmo

takeScreenshot

• takeScreenshot(
      callback: (dataUrl: string) => void,
      mimeType?: string,
      width?: number,
      height?: number,
  ): void

• Takes a screenshot from the current view.

  Parameters

  • callback: (dataUrl: string) => void

    A callback containing the result which is executed after all Rendering operations are finished.
  • OptionalmimeType: string

    A string indicating the image format. The default type is image/png.
  • Optionalwidth: number

    The width of the requested screenshot. If not specified it uses the width of the current view.
  • Optionalheight: number

    The height of the requested screenshot. If not specified it uses the height of the current view.

  Returns void

  Deprecated

  takeScreenshot is deprecated, please use requestScreenshot instead

updateGeometry

• updateGeometry(id: number, data: UserGeometryData): void

• Parameters

  • id: number
  • data: UserGeometryData

  Returns void

  Inherited from ViewerUserGeometryAPI.updateGeometry

---

Did you find this page useful? Please give it a rating:

★ ★ ★ ★ ★

Thank you for rating this page!

Any issues or feedback?

What kind of problem would you like to report?

• This page needs code samples
• Code samples do not work
• Information is missing
  Please tell us more about what's wrong:
• Information is incorrect
  Please tell us more about what's wrong:
• Information is unclear or confusing
  Please tell us more about what's wrong:
• The page is rendered incorrectly (styling/CSS)
• Give Feedback

Please tell us more about what's wrong: Name E-Mail Problem (required)