ContextAPI¶

Interface ContextAPI

The ContextAPI combines all functionality which can be applied on the WebvisContext.

interface ContextAPI {
    add(options: AddNodeOptions): number;
    add(
        dataURI: string,
        parentID?: number,
        usage?: UsageString,
        label?: string,
        contentType?: string,
        initialProperties?: InitialNodeProperties,
        cacheStrategy?: CacheStrategy,
    ): number;
    addCustomNode(
        customNodeType: string,
        data: any,
        dataType?: AttachmentType,
    ): number;
    addToCollection(
        collectionID: number,
        nodeID: number,
        recursive?: boolean,
    ): void;
    addTopologyToSelection(
        handle: TopologyHandle | TopologyHandle[],
    ): Promise<void>;
    addToSelection(
        nodeID: number | number[],
        silent?: boolean,
    ): Promise<ChangeSelectionResult>;
    anchorXR(xrAnchorOptions?: XRAnchorOptions): void;
    changeAnnotation(
        annotationId: number,
        properties: AnnotationProperties,
    ): AnnotationProperties;
    changeAnnotation(
        annotationID: number,
        label?: string,
        visible?: boolean,
        anchorPosition?: number[] | Float32Array<ArrayBufferLike>,
        labelPosition?: number[] | Float32Array<ArrayBufferLike>,
        active?: boolean,
        transform?: number[] | Float32Array<ArrayBufferLike>,
    ): void;
    changeClippingRoom(properties?: ClipRoomProperties): ClipRoomProperties;
    changeClippingRoom(
        name?: string,
        size?: number[] | Float32Array<ArrayBufferLike>,
        transformation?: number[] | Float32Array<ArrayBufferLike>,
        disabled?: boolean,
        invisible?: boolean,
    ): ClipRoomProperties;
    changeClipPlane(
        clipPlaneId: number,
        properties: ClipPlaneProperties,
    ): ClipPlaneProperties;
    changeClipPlane(
        clipPlaneID: number,
        normal?: number[] | Float32Array<ArrayBufferLike>,
        point?: number[] | Float32Array<ArrayBufferLike>,
        name?: string,
        thickness?: number,
        tangent?: number[] | Float32Array<ArrayBufferLike>,
        disabled?: boolean,
        invisible?: boolean,
        exclusive?: boolean,
    ): void;
    changeDrawing(
        drawingId: number,
        properties: DrawingProperties,
    ): DrawingProperties;
    changeDrawingPlane(
        drawingPlaneId: number,
        properties: DrawingPlaneProperties,
    ): DrawingPlaneProperties;
    changeMaterial(
        materialId: number,
        properties: MaterialProperties,
    ): MaterialProperties;
    changeMeasurement(
        measurementID: number,
        properties: MeasurementProperties,
    ): MeasurementProperties;
    changeSetting<T extends string>(
        setting: T,
        value: ContextSettingType<T>,
    ): boolean;
    changeSnapshot(
        snapshotID: number,
        properties: SnapshotProperties,
    ): SnapshotProperties;
    changeSnapshot(
        snapshotID: number,
        name?: string,
        screenshotURL?: string,
        order?: number,
    ): SnapshotProperties;
    clear(): Promise<void>;
    clearSelection(silent?: boolean): Promise<ChangeSelectionResult>;
    clearTopologySelection(): Promise<void>;
    clipOtherParts(target: number | number[]): void;
    cloneIntoNewSpace(): Promise<void>;
    collectRuntimeNodesOfType(nodeType: NodeType, subType?: string): number[];
    connectToSession(
        sessionID?: string,
        name?: string,
    ): Promise<SessionStateData>;
    connectXR(xrConfiguration?: XRConfiguration): Promise<void>;
    createAnimationFrames(name: string, frames: AnimationFrame[]): void;
    createAnnotation(properties?: AnnotationProperties): number;
    createAnnotation(
        nodeID: number,
        label: string,
        visible?: boolean,
        anchorPosition?: number[] | Float32Array<ArrayBufferLike>,
        labelOffset?: number[] | Float32Array<ArrayBufferLike>,
    ): number;
    createAttachment(dataType: AttachmentType): number;
    createBoxVolume(
        min?: [number, number, number],
        max?: [number, number, number],
    ): BoxVolume;
    createCapping(clipPlaneId: number): Promise<void>;
    createCircularArcDescriptor(
        point0: [number, number, number],
        point1: [number, number, number],
        point2: [number, number, number],
    ): { descriptor: TopologyCircularArcDescriptor; type: CIRCULAR_ARC };
    createClippingRoom(properties?: ClipRoomProperties): void;
    createClippingRoom(
        name?: string,
        size?: number[] | Float32Array<ArrayBufferLike>,
        transformation?: number[] | Float32Array<ArrayBufferLike>,
        disabled?: boolean,
        invisible?: boolean,
    ): void;
    createClipPlane(properties?: ClipPlaneProperties): number;
    createClipPlane(
        normal?: number[] | Float32Array<ArrayBufferLike>,
        point?: number[] | Float32Array<ArrayBufferLike>,
        name?: string,
        thickness?: number,
        tangent?: number[] | Float32Array<ArrayBufferLike>,
        disabled?: boolean,
        invisible?: boolean,
        exclusive?: boolean,
    ): number;
    createCollection(nodeIDlist?: number[]): number;
    createCollection(): number;
    createDrawing(
        data: ViewerDrawingResult,
        properties?: DrawingProperties,
    ): number;
    createDrawingPlane(properties?: DrawingPlaneProperties): number;
    createExplosion(centerNodeID?: number): void;
    createMaterial(properties?: MaterialProperties): number;
    createMeasurement<T extends keyof MeasurementTypeToTargetMap>(
        type: T,
        targets: MeasurementTypeToTargetMap[T],
        properties?: MeasurementProperties,
    ): number;
    createNodePathHandles(targets: number[]): Promise<NodePathHandle[]>;
    createPointDescriptor(
        point: [number, number, number],
    ): { descriptor: TopologyPointDescriptor; type: POINT };
    createSnapshot(
        name?: string,
        options?: SnapshotCreationOptions,
    ): Promise<number>;
    createViewer(
        viewerID?: string,
        canvas?: HTMLCanvasElement,
        settings?: {
            aaSetting?: any;
            backgroundColor?: any;
            cappingEffectEdgeColor?: any;
            cappingEffectEnabled?: any;
            cappingEffectInnerColor?: any;
            colorComparisonFirstColor?: any;
            colorComparisonMatchingColor?: any;
            colorComparisonSecondColor?: any;
            colorizeEffect?: any;
            coordSys?: any;
            defaultFieldOfView?: any;
            disableSpecularHighlights?: any;
            doubleClickAnimationVolumeScale?: any;
            doubleClickTimeWindow?: any;
            drawingArrowheadEnd?: any;
            drawingArrowheadStart?: any;
            drawingColor?: any;
            drawingMode?: any;
            drawingSize?: any;
            dynamicAuxContrastEnabled?: any;
            dynamicClippingDistance?: any;
            dynamicClippingEnabled?: any;
            dynamicCOREnabled?: any;
            expandOnViewerSelection?: any;
            faceHighlightColor?: any;
            faceSelectionColor?: any;
            fitViewFactor?: any;
            flyNavigationSpeed?: any;
            flyToOnDoubleClick?: any;
            focusOnDoubleClick?: any;
            frustumCulling?: any;
            ghostedSceneOpacity?: any;
            gizmoScalingFactor?: any;
            gizmosEnabled?: any;
            gpuMemoryReleaseFactor?: any;
            hoverColor?: any;
            initialFit?: any;
            initialFitDirection?: any;
            initView?: any;
            lightingEnvironment?: any;
            lineHighlightColor?: any;
            lineSelectionColor?: any;
            maxDynamicClipDistance?: any;
            maxGPUMemory?: any;
            maxSRCCPUMemory?: any;
            mouseInvertZoomingDirection?: any;
            navigationMode?: any;
            navigationSampling?: any;
            navigationSpeedFactor?: any;
            navigationSpeedThrottleFactor?: any;
            outlineColor?: any;
            outlineColorOccluded?: any;
            outlineInnerRadius?: any;
            outlineOuterRadius?: any;
            preSelectionColor?: any;
            projectionType?: any;
            renderAuxOnTop?: any;
            renderMode?: any;
            renderSetup?: any;
            sceneOpacity?: any;
            screenSpaceCoverageCalculationMethod?: any;
            selectionColor?: any;
            showAuxOnNavigation?: any;
            silhouetteEffect?: any;
            silhouetteEffectColor?: any;
            silhouetteEffectExclusiveEnabled?: any;
            smallFeatureCulling?: any;
            smallFeaturePixelThreshold?: any;
            soc?: any;
            spacemouseMultiplier?: any;
            ssaoEnabled?: any;
            taaEnabled?: any;
            topoGeometryColor?: any;
            topoGeometrySecondaryColor?: any;
            topoPointsEnabled?: any;
            transparencyMode?: any;
            turntableLowerVerticalLimit?: any;
            turntableUpperVerticalLimit?: any;
            turntableVerticalLimitsEnabled?: any;
            useDevicePixelRatio?: any;
            vertexColorsEnabled?: any;
            viewPerspective?: any;
            webglPreserveDrawingbuffer?: any;
        },
    ): ViewerAPI;
    deleteMemberProfileEntry(key: string): Promise<void>;
    disableCapping(clipPlaneId: number): Promise<void>;
    disconnectFromSession(): void;
    disconnectXR(): Promise<void>;
    enableCapping(clipPlaneId: number): Promise<void>;
    endExplosion(): void;
    enterXRInitMode(xrInitOptions?: XRInitOptions): Promise<void>;
    exportXRInitTemplate(): Promise<string>;
    fetchAttachmentData(attachmentID: number): Promise<Serializable>;
    getAnnotationData(annotationId: number): AnnotationData;
    getAnnotations(): number[];
    getAttachmentData(attachmentID: number): Serializable;
    getAttachmentDataURI(attachmentID: number): string;
    getClipPlanes(): number[];
    getClipRoom(): number;
    getCollection(collectionID: number): ICollection;
    getCollectionElements(collectionID: number): Promise<number[]>;
    getCollectionNodeCount(collectionID: number): Promise<number>;
    getCoordinateSystemForwardVector(): | Float32Array<ArrayBufferLike>
    | [number, number, number];
    getCoordinateSystemMatrix(): | Float32Array<ArrayBufferLike>
    | [
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
    ];
    getCoordinateSystemRightVector(): | Float32Array<ArrayBufferLike>
    | [number, number, number];
    getCoordinateSystemUpVector(): | Float32Array<ArrayBufferLike>
    | [number, number, number];
    getDrawingPlaneData(drawingPlaneId: number): DrawingPlaneProperties;
    getDrawingPlanes(): number[];
    getDrawings(): number[];
    getEnabledAuxNodes(nodeID: number): Promise<number[]>;
    getEnabledLayerFilters(): string[];
    getInteractionMode(): InteractionMode;
    getMaterialData(materialId: number): MaterialProperties;
    getMaterials(): number[];
    getMeasurements(): number[];
    getMemberName(): string;
    getMembers(): number[];
    getMetadata(nodeID: number): Promise<{ [key: string]: string }>;
    getName(): string;
    getProperties<T extends string>(
        nodeID: number,
        properties: T[],
    ): Promise<PropertyType<T>[]>;
    getProperty<T extends string>(
        nodeID: number,
        property: T,
    ): Promise<PropertyType<T>>;
    getRegisteredLayerFilters(): { [key: string]: boolean };
    getRootNodeId(
        target: number | TopologyHandle,
        includeTarget?: boolean,
    ): number;
    getSelectedLeafNodes(): number[];
    getSelectedNodes(): number[];
    getSelectedTopologyHandles(): TopologyHandle[];
    getSelection(): Promise<number[]>;
    getSessionMemberID(): number;
    getSessionMembers(): Promise<SessionMemberData[]>;
    getSessionStateData(): SessionStateData;
    getShapeHandle(handle: TopologyHandle): TopologyHandle;
    getSnapshotData(
        snapshotID: number,
    ): { attachmentID: number; name: string; order: number };
    getSnapshots(): number[];
    getStatistics(
        nodeType?: NodeType,
        nodeID?: number,
        recursive?: boolean,
    ): Promise<any>;
    getTopologyType(handle: TopologyHandle): TopologyType;
    getViewer(id?: string): ViewerAPI;
    getViewers(): ViewerAPI[];
    getXRCapabilities(): XRCapability[];
    getXRMembers(): number[];
    getXRPlaybackProperties(): XRPlaybackProperties;
    getXRPlaybackState(): XRPlaybackState;
    getXRState(): XRState;
    hideXRBackgroundFeed(): Promise<void>;
    importConfig(
        config: {
            aaSetting?: any;
            additionalCookies?: any;
            additionalRequestHeaders?: any;
            additionalWSQueryParameters?: any;
            applicationIdentifier?: any;
            auxModeRecursiveSearch?: any;
            auxModeUncolorFacesOnLeave?: any;
            backgroundColor?: any;
            batchedQueries?: any;
            boosterURL?: any;
            cappingEffectEdgeColor?: any;
            cappingEffectEnabled?: any;
            cappingEffectInnerColor?: any;
            cappingGeometryColor?: any;
            colorComparisonFirstColor?: any;
            colorComparisonMatchingColor?: any;
            colorComparisonSecondColor?: any;
            colorizeEffect?: any;
            contextMenuFunction?: any;
            coordSys?: any;
            defaultFieldOfView?: any;
            defaultQueryLinkDepth?: any;
            disableDefaultInteraction?: any;
            disableSpecularHighlights?: any;
            doubleClickAnimationVolumeScale?: any;
            doubleClickTimeWindow?: any;
            drawingArrowheadEnd?: any;
            drawingArrowheadStart?: any;
            drawingColor?: any;
            drawingMode?: any;
            drawingSize?: any;
            dynamicAuxContrastEnabled?: any;
            dynamicClippingDistance?: any;
            dynamicClippingEnabled?: any;
            dynamicCOREnabled?: any;
            expandOnViewerSelection?: any;
            faceHighlightColor?: any;
            faceSelectionColor?: any;
            fitViewFactor?: any;
            flyNavigationSpeed?: any;
            flyToOnDoubleClick?: any;
            focusOnDoubleClick?: any;
            frontPlaneAxis?: any;
            frustumCulling?: any;
            ghostedSceneOpacity?: any;
            gizmoScalingFactor?: any;
            gizmosEnabled?: any;
            gpuMemoryReleaseFactor?: any;
            hoverColor?: any;
            hubURL?: any;
            initialFit?: any;
            initialFitDirection?: any;
            initialStateActivation?: any;
            initView?: any;
            lightingEnvironment?: any;
            lineHighlightColor?: any;
            lineSelectionColor?: any;
            loadRemoteConfigFile?: any;
            logLevel?: any;
            maxActiveSceneVolumeDiameter?: any;
            maxConcurrentDownloads?: any;
            maxDynamicClipDistance?: any;
            maxGPUMemory?: any;
            maxSRCCPUMemory?: any;
            measurementAngularTolerance?: any;
            measurementMaterialDensities?: any;
            mouseInvertZoomingDirection?: any;
            navigationMode?: any;
            navigationSampling?: any;
            navigationSpeedFactor?: any;
            navigationSpeedThrottleFactor?: any;
            notificationLogLevels?: any;
            outlineColor?: any;
            outlineColorOccluded?: any;
            outlineInnerRadius?: any;
            outlineOuterRadius?: any;
            parentSelectEnabled?: any;
            preferXHRWithCredentials?: any;
            preSelectionColor?: any;
            projectionType?: any;
            renderAuxOnTop?: any;
            renderMode?: any;
            renderSetup?: any;
            sceneOpacity?: any;
            screenSpaceCoverageCalculationMethod?: any;
            selectionColor?: any;
            sessionDeviceTags?: any;
            sessionForwardUrl?: any;
            sessionInteractions?: any;
            sessionMemberName?: any;
            showAuxOnNavigation?: any;
            silhouetteEffect?: any;
            silhouetteEffectColor?: any;
            silhouetteEffectExclusiveEnabled?: any;
            skipSslVerify?: any;
            smallFeatureCulling?: any;
            smallFeaturePixelThreshold?: any;
            snapshotContentSelection?: any;
            soc?: any;
            spacemouseMultiplier?: any;
            ssaoEnabled?: any;
            taaEnabled?: any;
            topoGeometryColor?: any;
            topoGeometrySecondaryColor?: any;
            topoPointsEnabled?: any;
            transparencyMode?: any;
            turntableLowerVerticalLimit?: any;
            turntableUpperVerticalLimit?: any;
            turntableVerticalLimitsEnabled?: any;
            uriMap?: any;
            usageGroup?: any;
            useDevicePixelRatio?: any;
            vertexColorsEnabled?: any;
            viewPerspective?: any;
            webglPreserveDrawingbuffer?: any;
            xrEnableDebugImages?: any;
            xrFusionMode?: any;
            xrImageCompressionQuality?: any;
            xrImageResolutionProfile?: any;
            xrModelTrackerQualityThreshold?: any;
            xrModelTrackerSmoothingFactor?: any;
        },
    ): void;
    importSession(data: any, format?: "xscn"): Promise<any>;
    importXRInitTemplate(template: string): Promise<void>;
    invertEnabledStates(): void;
    invertSelection(silent?: boolean): Promise<ChangeSelectionResult>;
    isColorComparisonActive(): boolean;
    isNodeDeletable(nodeID: number): boolean;
    isNodePartOfEnabledLayers(nodeID: number): Promise<boolean>;
    isNodePartOfEnabledVariant(nodeId: number): Promise<boolean>;
    isNodeType(nodeID: number, nodeType: NodeType): boolean;
    isOfflineStorageAvailable(): Promise<boolean>;
    isSelected(nodeID: number): Promise<boolean>;
    isTopologySelected(handle: TopologyHandle): boolean;
    mapInternalToOriginalTopologyHandles(
        handles: TopologyHandle[],
    ): Promise<OriginalTopologyHandle[]>;
    mapOriginalToInternalTopologyHandles(
        nodeID: number,
        handles: OriginalTopologyHandle[],
    ): Promise<TopologyHandle[]>;
    measureBetween(
        target0: MeasurementTarget,
        target1: MeasurementTarget,
    ): Promise<BetweenMeasurementResult>;
    measureNormal(
        topology: { class: TOPOLOGY; value: TopologyHandle },
        point: { class: POINT; value: [number, number, number] },
    ): Promise<NormalMeasurementResult>;
    measurePointsByDistance(
        searchCurve: {
            class: CURVE;
            value: [[number, number, number], [number, number, number]][];
        },
        distanceCurves: { class: TOPOLOGY; value: TopologyHandle }[],
        distance: number,
    ): Promise<DistanceConstraintMatch[]>;
    measureTangent(
        topology: { class: TOPOLOGY; value: TopologyHandle },
        point: { class: POINT; value: [number, number, number] },
    ): Promise<TangentMeasurementResult>;
    measureThickness(
        topology: { class: TOPOLOGY; value: TopologyHandle },
        point: { class: POINT; value: [number, number, number] },
    ): Promise<ThicknessMeasurementResult>;
    openSpace(spaceHandle?: string): Promise<void>;
    performExplosion(explosionFactor: number): void;
    processInteractionInput(interactionData: InteractionData): void;
    promoteSessionMember(memberID: number): void;
    query(query: string | Query, nodeID?: number): Promise<QueryResult>;
    readSetting<T extends string>(setting: T): ContextSettingType<T>;
    registerCustomProperty(
        name: string,
        defaultValue: any,
        recursive?: boolean,
    ): void;
    registerFrameListener(listener: FrameListener): void;
    registerListener<T extends WebVisEvent = WebVisEvent>(
        eventTypes: EventType[],
        listener: IEventListener<T>,
        nodeID?: number,
        observeSubTree?: boolean,
    ): number;
    remove(nodeID?: number | number[], safe?: boolean): Promise<RemoveState>;
    removeAnimationFrames(name: string): void;
    removeAnnotation(annotationId: number, safe?: boolean): RemoveState;
    removeAttachment(attachmentID: number, safe?: boolean): RemoveState;
    removeCapping(clipPlaneId: number): Promise<void>;
    removeClippingRoom(safe?: boolean): RemoveState;
    removeClipPlane(clipPlaneId: number, safe?: boolean): RemoveState;
    removeCollection(collectionID: number): void;
    removeDrawing(drawingId: number, safe?: boolean): RemoveState;
    removeDrawingPlane(drawingPlaneId: number, safe?: boolean): RemoveState;
    removeFromCollection(
        collectionID: number,
        nodeID: number,
        recursive?: boolean,
    ): void;
    removeFromSelection(
        nodeID: number | number[],
        silent?: boolean,
    ): Promise<ChangeSelectionResult>;
    removeMaterial(materialId: number, safe?: boolean): RemoveState;
    removeMeasurement(measurementID: number, safe?: boolean): RemoveState;
    removeSessionMember(memberID: number): void;
    removeSnapshot(snapshotID: number): void;
    removeTopologyFromSelection(
        handle: TopologyHandle | TopologyHandle[],
    ): Promise<void>;
    removeViewer(viewer: ViewerAPI): void;
    requestActiveSceneVolume(): Promise<BoxVolume>;
    requestAnnotationData(annotationId: number): Promise<AnnotationProperties>;
    requestAuxRootNodeIds(scopeNodeId?: number): Promise<number[]>;
    requestBoxDescriptor(
        nodeIds: number[],
    ): Promise<{ descriptor: TopologyBoxDescriptor; type: BOX }>;
    requestClipPlaneData(clipPlaneId: number): Promise<ClipPlaneProperties>;
    requestClipRoomData(): Promise<ClipRoomProperties>;
    requestDrawingData(drawingId: number): Promise<DrawingData>;
    requestFullSceneVolume(): Promise<BoxVolume>;
    requestHubVersion(): Promise<string>;
    requestL3DInformation(targetNodeId: number): Promise<any>;
    requestMeasurementData(
        measurementID: number,
    ): Promise<MeasurementProperties>;
    requestMemberActions(memberId: number): Promise<MemberAction[]>;
    requestMemberProperties(id: number): Promise<MemberProperties>;
    requestNeighboringEdges(handle: TopologyHandle): Promise<TopologyHandle[]>;
    requestNeighboringFaces(handle: TopologyHandle): Promise<TopologyHandle[]>;
    requestNodeIdsByBoxVolume(
        boxVolume: BoxVolume,
        includeOverlappingNodes?: boolean,
        includeDisabledNodes?: boolean,
        forceExpand?: boolean,
        scopeNodeId?: number,
    ): Promise<number[]>;
    requestNodePathHandleMap(
        paths: string[],
        scope?: number,
    ): Promise<NodePathHandleMap>;
    requestNodePathStrings(
        handles: NodePathHandle[],
        scope?: number,
        typePriorities?: NodePathFragmentType[],
    ): Promise<string[]>;
    requestRootNodeIds(
        scopeNodeId?: number,
        recursive?: boolean,
    ): Promise<number[]>;
    requestServiceStates(): Promise<Map<ServiceType, ServiceState>>;
    requestSnapshotData(snapshotID: number): Promise<SnapshotProperties>;
    requestSpaceHandle(role?: MemberRole): Promise<string>;
    requestSupportedContentTypes(): Promise<ContentType[]>;
    requestSupportedRenderSetups(): Promise<{ name: string; value: string }[]>;
    requestTopologyDescriptor(
        handle: TopologyHandle,
    ): Promise<TopologyDescriptor>;
    requestVariants(nodeId: number): Promise<VariantProperties[]>;
    requestXRDeviceScreenshot(): Promise<string>;
    requestXRScanshot(): Promise<XRScanshot>;
    resetInteractionMode(keepColorCompareActive?: boolean): void;
    resetProperties(
        nodeID: number,
        properties: string[],
        recursive?: boolean,
    ): Promise<void>;
    resetProperty(
        nodeID: number,
        property: string,
        recursive?: boolean,
    ): Promise<void>;
    resetSetting(setting: ViewerSettingStrings | SettingStrings): void;
    resetUserSettings(): void;
    restoreSession(handle: string): Promise<void>;
    restoreSnapshot(
        snapshotID: number,
        options?: SnapshotRestoreOptions,
    ): Promise<void>;
    searchByVolume(
        selectionBox: BoxVolume,
        includeOverlappingNodes: boolean,
        rootNodeID?: number,
    ): Promise<number>;
    seekXRPlayback(frameIndex: number): Promise<void>;
    selectCollection(
        collectionID: number,
        silent?: boolean,
    ): Promise<ChangeSelectionResult>;
    setAttachmentData(attachmentID: number, data: Serializable): void;
    setAttachmentDataURI(attachmentID: number, dataURI: string): void;
    setInteractionMode(
        mode: string | string[],
        keepColorCompareActive?: boolean,
    ): void;
    setInteractionMode(
        mode: InteractionMode,
        keepColorCompareActive?: boolean,
    ): void;
    setLayerFilterEnabled(
        name: string,
        enabled: boolean,
    ): SetLayerFilterEnabledResult;
    setMemberName(name: string): void;
    setMemberProfileEntry(key: string, value: Serializable): Promise<void>;
    setParent(nodeID: number, newParentID: number): void;
    setProperty<T extends string>(
        nodeID: number | number[],
        property: T,
        value: PropertyType<T>,
        silent?: boolean,
    ): Promise<void>;
    setSelection(
        nodeID: number | number[],
        silent?: boolean,
    ): Promise<ChangeSelectionResult>;
    setTopologyProperty<T extends keyof TopologyPropertyTypeMap>(
        handle: TopologyHandle | TopologyHandle[],
        property: T,
        value: TopologyPropertyTypeMap[T],
    ): Promise<PromiseSettledResult<void>[]>;
    setTopologySelection(
        handle: TopologyHandle | TopologyHandle[],
    ): Promise<void>;
    setVariantEnabled(variant: number, enabled: boolean): Promise<void>;
    setXRPlaybackBoomerang(boomerang: boolean): Promise<void>;
    setXRPlaybackFrameRange(
        startFrame: number,
        endFrame: number,
    ): Promise<number>;
    setXRPlaybackSource(url: string): Promise<number>;
    setXRPlaybackSpeed(speed: number): void;
    showXRBackgroundFeed(): Promise<void>;
    shutdownSession(): Promise<void>;
    startXRPlayback(): void;
    startXRSpectate(sessionMemberId: number): Promise<void>;
    stopXRPlayback(): void;
    stopXRSpectate(): void;
    storeSession(): Promise<string>;
    transferSession(
        progressCallback: StoreSessionProgressCallback,
    ): Promise<string>;
    transferSession(): Promise<string>;
    unanchorXR(): void;
    unregisterFrameListener(listener: FrameListener): void;
    unregisterListener(listenerID: number): void;
    useMemberAction<A extends MemberAction>(
        memberId: number,
        action: A,
        options?: MemberActionsToOptionsMap[A],
    ): Promise<void>;
    waitFor(state: ContextState): Promise<void>;
}

Index

Methods

add addCustomNode addToCollection addTopologyToSelection addToSelection anchorXR changeAnnotation changeClippingRoom changeClipPlane changeDrawing changeDrawingPlane changeMaterial changeMeasurement changeSetting changeSnapshot clear clearSelection clearTopologySelection clipOtherParts cloneIntoNewSpace collectRuntimeNodesOfType connectToSession connectXR createAnimationFrames createAnnotation createAttachment createBoxVolume createCapping createCircularArcDescriptor createClippingRoom createClipPlane createCollection createDrawing createDrawingPlane createExplosion createMaterial createMeasurement createNodePathHandles createPointDescriptor createSnapshot createViewer deleteMemberProfileEntry disableCapping disconnectFromSession disconnectXR enableCapping endExplosion enterXRInitMode exportXRInitTemplate fetchAttachmentData getAnnotationData getAnnotations getAttachmentData getAttachmentDataURI getClipPlanes getClipRoom getCollection getCollectionElements getCollectionNodeCount getCoordinateSystemForwardVector getCoordinateSystemMatrix getCoordinateSystemRightVector getCoordinateSystemUpVector getDrawingPlaneData getDrawingPlanes getDrawings getEnabledAuxNodes getEnabledLayerFilters getInteractionMode getMaterialData getMaterials getMeasurements getMemberName getMembers getMetadata getName getProperties getProperty getRegisteredLayerFilters getRootNodeId getSelectedLeafNodes getSelectedNodes getSelectedTopologyHandles getSelection getSessionMemberID getSessionMembers getSessionStateData getShapeHandle getSnapshotData getSnapshots getStatistics getTopologyType getViewer getViewers getXRCapabilities getXRMembers getXRPlaybackProperties getXRPlaybackState getXRState hideXRBackgroundFeed importConfig importSession importXRInitTemplate invertEnabledStates invertSelection isColorComparisonActive isNodeDeletable isNodePartOfEnabledLayers isNodePartOfEnabledVariant isNodeType isOfflineStorageAvailable isSelected isTopologySelected mapInternalToOriginalTopologyHandles mapOriginalToInternalTopologyHandles measureBetween measureNormal measurePointsByDistance measureTangent measureThickness openSpace performExplosion processInteractionInput promoteSessionMember query readSetting registerCustomProperty registerFrameListener registerListener remove removeAnimationFrames removeAnnotation removeAttachment removeCapping removeClippingRoom removeClipPlane removeCollection removeDrawing removeDrawingPlane removeFromCollection removeFromSelection removeMaterial removeMeasurement removeSessionMember removeSnapshot removeTopologyFromSelection removeViewer requestActiveSceneVolume requestAnnotationData requestAuxRootNodeIds requestBoxDescriptor requestClipPlaneData requestClipRoomData requestDrawingData requestFullSceneVolume requestHubVersion requestL3DInformation requestMeasurementData requestMemberActions requestMemberProperties requestNeighboringEdges requestNeighboringFaces requestNodeIdsByBoxVolume requestNodePathHandleMap requestNodePathStrings requestRootNodeIds requestServiceStates requestSnapshotData requestSpaceHandle requestSupportedContentTypes requestSupportedRenderSetups requestTopologyDescriptor requestVariants requestXRDeviceScreenshot requestXRScanshot resetInteractionMode resetProperties resetProperty resetSetting resetUserSettings restoreSession restoreSnapshot searchByVolume seekXRPlayback selectCollection setAttachmentData setAttachmentDataURI setInteractionMode setLayerFilterEnabled setMemberName setMemberProfileEntry setParent setProperty setSelection setTopologyProperty setTopologySelection setVariantEnabled setXRPlaybackBoomerang setXRPlaybackFrameRange setXRPlaybackSource setXRPlaybackSpeed showXRBackgroundFeed shutdownSession startXRPlayback startXRSpectate stopXRPlayback stopXRSpectate storeSession transferSession unanchorXR unregisterFrameListener unregisterListener useMemberAction waitFor

Methods

add

add(options: AddNodeOptions): number
Adds a new node to the instance graph.
Parameters
- options: AddNodeOptions
  Specifies the options for the new Node.
Returns number
The ID of the added node

Inherited from InstanceGraphAPI.add
add(
    dataURI: string,
    parentID?: number,
    usage?: UsageString,
    label?: string,
    contentType?: string,
    initialProperties?: InitialNodeProperties,
    cacheStrategy?: CacheStrategy,
): number
Parameters
- dataURI: string
  Specifies the URI to the data resource.
- OptionalparentID: number
  Specifies the parent Node ID of the added Node.
- Optionalusage: UsageString
  The usage parameter allows to define how the resource should be inserted in the InstanceGraph.
- Optionallabel: string
  Specifies a custom label for the added Node.
- OptionalcontentType: string
  Specifies the MimeType of the data resource.
- OptionalinitialProperties: InitialNodeProperties
  Specifies initialProperties of the added Node.
- OptionalcacheStrategy: CacheStrategy
  Specifies the strategy which is used when a data cache is requested from the Hub.
Returns number
The ID of added node

Deprecated
This function will no longer be available in future webvis releases. Please use the add function with AddNodeOptions instead.

Adds a new Node to the InstanceGraph.

Triggers a NodeAddedEvent. In case of an error, a NodeErrorEvent is triggered.

Inherited from InstanceGraphAPI.add

addCustomNode

addCustomNode(
    customNodeType: string,
    data: any,
    dataType?: AttachmentType,
): number
Creates a custom node along with custom data which is stored in an attachment.

The attached data can be accessed via the Property.ATTACHMENT property of the node.

Triggers a NodeAddedEvent. In case of an error, a NodeErrorEvent is triggered.
Parameters
- customNodeType: string
  Specifies the custom node type.
- data: any
  Specifies the data of the custom node.
- OptionaldataType: AttachmentType
  Specifies the type of the data. Default: "json".
Returns number
The ID of the newly created custom node.

See
AttachmentAPI

Inherited from InstanceGraphAPI.addCustomNode

addToCollection

addToCollection(collectionID: number, nodeID: number, recursive?: boolean): void
Parameters
- collectionID: number
  Specifies to which collection the node should be added
- nodeID: number
  Specifies which node should be added to the collection
- Optionalrecursive: boolean
  Specifies if the children of the node should also be added to the collection
Returns void
Deprecated
addToCollection is deprecated and will be removed in future versions.

Adds the node given by nodeID to the collection with id collectionID. If recursive is true, the descendants of the node are also added. Returns the number of nodes in the collection.

Inherited from CollectionAPI.addToCollection

addTopologyToSelection

addTopologyToSelection(handle: TopologyHandle | TopologyHandle[]): Promise<void>
Adds one or more topological entities to the current selection.
Parameters
- handle: TopologyHandle | TopologyHandle[]
  The topological entity or array of topological entities which should be added to the current selection.
Returns Promise<void>
A promise which resolves when the operation is completed.
See
Inherited from TopologyAPI.addTopologyToSelection

addToSelection

addToSelection(
nodeID: number | number[],
silent?: boolean,
): Promise<ChangeSelectionResult>
Adds the specified nodes to the current selection.

Triggers a SelectionChangedEvent if silent is set to false.
Parameters
- nodeID: number | number[]
  The ID or array of IDs of the nodes to add to the selection.
- Optionalsilent: boolean
  If set to true, no event will be emitted. Default: false
Returns Promise<ChangeSelectionResult>
The result of the selection change.

Inherited from SelectionAPI.addToSelection

anchorXR

anchorXR(xrAnchorOptions?: XRAnchorOptions): void
Experimental
Anchors the model at the current 3D pose. Visually, this will have the effect that the model will stay at the current position and orientation in the real world.

Please note, that in a model-based tracking scenario, the model will get anchored automatically when the alignment of the model with the real world object is high enough that tracking can be performed (model is snapped).

This will trigger a XRStateChangedEvent with XRState.anchored set to true.

The optional parameter XRAnchorOptions, in conjunction with XRAnchorOptions.anchorToSurface, can be used to anchor the model on a detected surface. By default, this is set to false, and the model is anchored at the current 3D pose of the device, as described above.

However, if set to true, and if the device running webvis supports XR and ray casting, a mathematical ray will be cast from the device into the real world. If this ray intersects with a detected surface, the scene will be transformed and anchored to this surface at the intersection point, with the Y axis alined orthogonally to the surface. On occasion, the model may need to be offset, so it does not appear to be imbedded in the surface it is anchored to. In order to achieve this, an optional parameter can be set in the XRAnchorOptions, by updating the XRAnchorOptions.xrAnchorOffsetTransform matrix.
Parameters
- OptionalxrAnchorOptions: XRAnchorOptions
  An optional object that contains the anchorToSurface property.
Returns void
Inherited from RealityAPI.anchorXR

changeAnnotation

changeAnnotation(
annotationId: number,
properties: AnnotationProperties,
): AnnotationProperties
Changes one or more properties of an Annotation with the specified ID and triggers an AnnotationChangedEvent.
Parameters
- annotationId: number
  The ID of the Annotation you want to change.
- properties: AnnotationProperties
  The properties of the Annotation you want change.
Returns AnnotationProperties
An Object with the changed Properties.

Inherited from AnnotationAPI.changeAnnotation
changeAnnotation(
    annotationID: number,
    label?: string,
    visible?: boolean,
    anchorPosition?: number[] | Float32Array<ArrayBufferLike>,
    labelPosition?: number[] | Float32Array<ArrayBufferLike>,
    active?: boolean,
    transform?: number[] | Float32Array<ArrayBufferLike>,
): void
Parameters
- annotationID: number
  The ID of the Annotation.
- Optionallabel: string
  The text of the Annotation.
- Optionalvisible: boolean
  Indicates if the Annotation should be visible or hidden.
- OptionalanchorPosition: number[] | Float32Array<ArrayBufferLike>
  Anchor position in world space coordinates.
- OptionallabelPosition: number[] | Float32Array<ArrayBufferLike>
  The position of the label.
- Optionalactive: boolean
  DEPRECATED
- Optionaltransform: number[] | Float32Array<ArrayBufferLike>
  The transformation of the Annotation.
Returns void
Deprecated
Changes an annotation. Should use a properties object AnnotationProperties as an argument rather than passing individual values.

Inherited from AnnotationAPI.changeAnnotation

changeClippingRoom

changeClippingRoom(properties?: ClipRoomProperties): ClipRoomProperties
Changes one or more properties of an existing clip room.

Allows modifying various aspects of the clip room such as size, position, orientation (via transform matrix), visibility, and enabled state. Only the properties specified in the properties object will be changed.

Since WebVis only supports a single clip room at a time, there's no need to specify a clip room ID. If no clip room exists when this method is called, it will create one.

Triggers a ClippingRoomChangedEvent when properties are modified.

Example usage:
```
// Get the webvis context
const context = webvis.getContext();

// Change the size and position of a clip room
const updatedProps = context.changeClippingRoom({
  size: [20, 15, 10],          // Resize the clip room
  transform: [                 // Move to new position with rotation
    1, 0, 0, 0,
    0, 1, 0, 0,
    0, 0, 1, 0,
    5, 2, 3, 1                 // Translation component
  ],
  invisible: true              // Hide the visual representation
});

// Disable the clip room temporarily without removing it
context.changeClippingRoom({
  enabled: false
});
```
Parameters
- Optionalproperties: ClipRoomProperties
  Properties to change on the clip room
Returns ClipRoomProperties
An object containing only the properties that were actually changed

Inherited from ClipPlaneAPI.changeClippingRoom
changeClippingRoom(
    name?: string,
    size?: number[] | Float32Array<ArrayBufferLike>,
    transformation?: number[] | Float32Array<ArrayBufferLike>,
    disabled?: boolean,
    invisible?: boolean,
): ClipRoomProperties
Parameters
- Optionalname: string
  The name of the clip room.
- Optionalsize: number[] | Float32Array<ArrayBufferLike>
  The size of the clip room.
- Optionaltransformation: number[] | Float32Array<ArrayBufferLike>
  The transformation of the clip room.
- Optionaldisabled: boolean
  The disabled state of the clip room.
- Optionalinvisible: boolean
  The invisible state of the clip room.
Returns ClipRoomProperties
An object with the changed properties.

Deprecated
Calling changeClippingRoom with single parameters is deprecated, please use ClipRoomProperties instead.

Changes one or more properties of the clip room.

Inherited from ClipPlaneAPI.changeClippingRoom

changeClipPlane

changeClipPlane(
clipPlaneId: number,
properties: ClipPlaneProperties,
): ClipPlaneProperties
Changes one or more properties of an existing clip plane .

Allows modifying various aspects of a clip plane such as orientation, position, visibility, and selection of which nodes are affected. Only the properties specified in the properties object will be changed.

Triggers a ClipPlaneChangedEvent when properties are modified.

Example usage:
```
// Get the webvis context
const context = webvis.getContext();

// Change the position and orientation of a clip plane
const updatedProps = context.changeClipPlane(clipPlaneId, {
  normal: [0, 1, 0],     // Update to Y-axis normal
  position: [0, 0, 5],   // Move to new position
  invisible: true        // Hide the visual plane representation
});

// Exclude certain components from being clipped
context.changeClipPlane(clipPlaneId, {
  excludedNodes: [1234, 5678]  // These nodes won't be affected by the clip plane
});
```
Parameters
- clipPlaneId: number
  The ID of the clip plane to modify
- properties: ClipPlaneProperties
  Properties to change on the clip plane
Returns ClipPlaneProperties
An object containing only the properties that were actually changed

Inherited from ClipPlaneAPI.changeClipPlane
changeClipPlane(
    clipPlaneID: number,
    normal?: number[] | Float32Array<ArrayBufferLike>,
    point?: number[] | Float32Array<ArrayBufferLike>,
    name?: string,
    thickness?: number,
    tangent?: number[] | Float32Array<ArrayBufferLike>,
    disabled?: boolean,
    invisible?: boolean,
    exclusive?: boolean,
): void
Parameters
- clipPlaneID: number
  The ID of the clip plane to modify
- Optionalnormal: number[] | Float32Array<ArrayBufferLike>
  The new normal vector for the clip plane
- Optionalpoint: number[] | Float32Array<ArrayBufferLike>
  A point in space that lies on the clip plane
- Optionalname: string
  The display name for the clip plane
- Optionalthickness: number
  The visual thickness of the clip plane
- Optionaltangent: number[] | Float32Array<ArrayBufferLike>
  The tangent vector for the clip plane
- Optionaldisabled: boolean
  Whether the clip plane is enabled (false) or disabled (true)
- Optionalinvisible: boolean
  Whether the clip plane's visual representation is hidden
- Optionalexclusive: boolean
  Whether the clip plane only affects nodes with the exclusiveClipplanes property
Returns void
Deprecated
Calling changeClipPlane with single parameters is deprecated, please use the version with ClipPlaneProperties instead.

Changes properties of an existing clip plane using individual parameters.

Triggers a ClipPlaneChangedEvent when properties are modified.

Inherited from ClipPlaneAPI.changeClipPlane

changeDrawing

changeDrawing(
drawingId: number,
properties: DrawingProperties,
): DrawingProperties
Changes one or more properties of a Drawing with the specified id.
Parameters
- drawingId: number
  The id of the Drawing.
- properties: DrawingProperties
  The properties of the Drawing.
Returns DrawingProperties
An object with the changed properties.

Inherited from DrawingAPI.changeDrawing

changeDrawingPlane

changeDrawingPlane(
drawingPlaneId: number,
properties: DrawingPlaneProperties,
): DrawingPlaneProperties
Experimental
Changes one or more properties of a DrawingPlane with the specified ID.
Parameters
- drawingPlaneId: number
  The ID of the DrawingPlane you want to change.
- properties: DrawingPlaneProperties
  The properties of the DrawingPlane you want change.
Returns DrawingPlaneProperties
An Object with the changed Properties.

Inherited from DrawingPlaneAPI.changeDrawingPlane

changeMaterial

changeMaterial(
materialId: number,
properties: MaterialProperties,
): MaterialProperties
Experimental
Experimental. May be changed in the future without notice.

Changes one or more properties of a material with the specified ID and triggers a MaterialChangedEvent.
Parameters
- materialId: number
  The ID of the material you want to change.
- properties: MaterialProperties
  The properties of the material you want change.
Returns MaterialProperties
An object with the changed properties.

Inherited from MaterialAPI.changeMaterial

changeMeasurement

changeMeasurement(
measurementID: number,
properties: MeasurementProperties,
): MeasurementProperties
Changes one or more properties of the measurement entity with the specified ID.

Triggers a MeasurementChangedEvent when the measurement entity has been changed.
Parameters
- measurementID: number
  The ID of the measurement entity that should be changed.
- properties: MeasurementProperties
  The properties that should be changed.
Returns MeasurementProperties
An object with the changed properties.

See
createMeasurement

Inherited from MeasurementAPI.changeMeasurement

changeSetting

changeSetting<T extends string>(
setting: T,
value: ContextSettingType<T>,
): boolean
Changes the setting to the given value.
Type Parameters
- T extends string
Parameters
- setting: T
  A name that specifies a particular setting
- value: ContextSettingType<T>
  The new value for the setting
Returns boolean
A boolean which indicates if the setting has changed

Inherited from SettingsAPI.changeSetting

changeSnapshot

changeSnapshot(
snapshotID: number,
properties: SnapshotProperties,
): SnapshotProperties
Changes one or more properties of a snapshot with the specified ID.

Triggers a SnapshotChangedEvent.
Parameters
- snapshotID: number
  The ID of the snapshot to change.
- properties: SnapshotProperties
  The properties of the snapshot to change.
Returns SnapshotProperties
An object with the changed properties.

Inherited from SessionStorageAPI.changeSnapshot
changeSnapshot(
    snapshotID: number,
    name?: string,
    screenshotURL?: string,
    order?: number,
): SnapshotProperties
Changes the textual description of the snapshot with the specified ID to the value of text.

Triggers a SnapshotChangedEvent.
Parameters
- snapshotID: number
  The ID of the snapshot to change.
- Optionalname: string
  The new name of the snapshot.
- OptionalscreenshotURL: string
  The new screenshot URL of the snapshot.
- Optionalorder: number
  The order inside the list of snapshots.
Returns SnapshotProperties
Deprecated
Calling changeSnapshot with single parameters is deprecated, please use SnapshotProperties instead.

Inherited from SessionStorageAPI.changeSnapshot

clear

clear(): Promise<void>
Clears the whole Context by removing all Nodes, Snapshots, ClipPlanes, Drawings, Measurements, etc.

Returns Promise<void>

clearSelection

clearSelection(silent?: boolean): Promise<ChangeSelectionResult>
Clears the current selection.

Triggers a SelectionChangedEvent if silent is set to false.
Parameters
- Optionalsilent: boolean
  If set to true, no event will be emitted. Default: false
Returns Promise<ChangeSelectionResult>
The result of the selection change.

Inherited from SelectionAPI.clearSelection

clearTopologySelection

clearTopologySelection(): Promise<void>
Clears the current topological entity selection.

Returns Promise<void>
A promise which resolves when the operation is completed.
See
Inherited from TopologyAPI.clearTopologySelection

clipOtherParts

clipOtherParts(target: number | number[]): void
Creates a clip room that encompasses the selected node(s).

This method automatically calculates a bounding box around the specified target node(s) and creates a clip room with the exact dimensions of that box. It's an easy way to isolate specific components for closer examination by clipping away all surrounding geometry.

The created clip room replaces any existing clip room .

Example usage:
```
// Get the webvis context
const context = webvis.getContext();

// Create a clip room around a single component
context.clipOtherParts(4567);

// Create a clip room around multiple components
context.clipOtherParts([1234, 5678, 9012]);

// Create a clip room around the currently selected components
const selectedNodes = context.getSelectedNodes();
if (selectedNodes.length > 0) {
  context.clipOtherParts(selectedNodes);
}
```
Parameters
- target: number | number[]
  ID or array of IDs of the nodes to create a clip room around
Returns void
Inherited from ClipPlaneAPI.clipOtherParts

cloneIntoNewSpace

cloneIntoNewSpace(): Promise<void>
Experimental
Opens a new 3D space by cloning the current space.

Returns Promise<void>
A promise that resolves when the new space has been opened.

Inherited from SpaceAPI.cloneIntoNewSpace

collectRuntimeNodesOfType

collectRuntimeNodesOfType(nodeType: NodeType, subType?: string): number[]
Returns a list of all existing runtime node IDs of a specified type.
Parameters
- nodeType: NodeType
  The node type to collect.
- OptionalsubType: string
  The sub type to collect. Only used for custom nodes. See Property.SUBTYPE.
Returns number[]
A list of runtime node IDs of the specified type.

Inherited from InstanceGraphAPI.collectRuntimeNodesOfType

connectToSession

connectToSession(sessionID?: string, name?: string): Promise<SessionStateData>
Parameters
- OptionalsessionID: string
  The ID of the Session.
- Optionalname: string
  The ID of the Session.
Returns Promise<SessionStateData>
Deprecated
The whole SessionAPI is under consolidation and will be replaced in a future release.

Connects to a Session. If the ID does not exist, a new Session will be created.

Inherited from SessionAPI.connectToSession

connectXR

connectXR(xrConfiguration?: XRConfiguration): Promise<void>
Experimental
Connect to the XR system with the given XRConfiguration. The configuration determines what parts of the API are desired to be used.

By default, XR will be connected with the following configuration:
```
const defaultXRConfiguration = {
     imageSourceConfig:
     {
         type: XRImageSource.DEVICE
     }
}
```
If unspecified, modelTrackingEnabled and autoShowBackgroundFeed will be inferred as true and deviceScreenshotsEnabled as false automatically.

Note: If a change of configuration is required after being initialized, the user has to disconnectXR and connect with the new configuration.
Parameters
- OptionalxrConfiguration: XRConfiguration
  The configuration for the XR system
Returns Promise<void>
Returns a Promise which resolved when the operation was successful or rejects in an error case

Inherited from RealityAPI.connectXR

createAnimationFrames

createAnimationFrames(name: string, frames: AnimationFrame[]): void
Creates a new keyframe-based animation sequence.
Parameters
- name: string
  The name of the animation sequence.
- frames: AnimationFrame[]
  The keyframes of the animation sequence.
Returns void
Inherited from AnimationAPI.createAnimationFrames

createAnnotation

createAnnotation(properties?: AnnotationProperties): number
Creates a new Annotation and triggers an AnnotationCreatedEvent.
Parameters
- Optionalproperties: AnnotationProperties
  Initial properties of the created Annotation.
Returns number
The ID of the newly created Annotation.

Inherited from AnnotationAPI.createAnnotation
createAnnotation(
    nodeID: number,
    label: string,
    visible?: boolean,
    anchorPosition?: number[] | Float32Array<ArrayBufferLike>,
    labelOffset?: number[] | Float32Array<ArrayBufferLike>,
): number
Parameters
- nodeID: number
  The ID of the node that the Annotation belongs to.
- label: string
  The text of the Annotation.
- Optionalvisible: boolean
  Indicates if the Annotation should be visible or hidden.
- OptionalanchorPosition: number[] | Float32Array<ArrayBufferLike>
  Anchor position in world space coordinates.
- OptionallabelOffset: number[] | Float32Array<ArrayBufferLike>
  The offset between anchorPosition and where the label should be displayed.
Returns number
The ID of the new annotation.

Deprecated
Creates a new annotation. Should use a properties object AnnotationProperties as an argument rather than passing individual values.

Inherited from AnnotationAPI.createAnnotation

createAttachment

createAttachment(dataType: AttachmentType): number
Creates a new attachment.

Triggers an AttachmentCreatedEvent.
Parameters
- dataType: AttachmentType
  Specifies the attachment data type.
Returns number
The ID of the created attachment.

Inherited from AttachmentAPI.createAttachment

createBoxVolume

createBoxVolume(
min?: [number, number, number],
max?: [number, number, number],
): BoxVolume
Creates a new BoxVolume object.
Parameters
- Optionalmin: [number, number, number]
- Optionalmax: [number, number, number]
Returns BoxVolume
A new Box Volume

Inherited from UtilityAPI.createBoxVolume

createCapping

createCapping(clipPlaneId: number): Promise<void>
Experimental
Generates capping geometry for the surface that is cut by a clip plane.

This method creates visible geometry at the intersection of the clip plane and the model, allowing you to see and interact with the cut surface. The generated capping geometry supports measurements and all other operations that can be performed on regular geometry.

Once generated, capping geometry can be enabled, disabled, or removed using the corresponding methods.

Example usage:
```
// Get the webvis context
const context = webvis.getContext();

// Create a clip plane
const clipPlaneId = context.createClipPlane({
  normal: [0, 0, 1],
  position: [0, 0, 0]
});

// Generate capping geometry for the cut surface
await context.createCapping(clipPlaneId);

// Later, disable the capping when not needed
await context.disableCapping(clipPlaneId);
```
Parameters
- clipPlaneId: number
  The ID of the clip plane to create capping geometry for
Returns Promise<void>
Promise that resolves when the capping geometry has been created

Inherited from ClipPlaneAPI.createCapping

createCircularArcDescriptor

createCircularArcDescriptor(
    point0: [number, number, number],
    point1: [number, number, number],
    point2: [number, number, number],
): { descriptor: TopologyCircularArcDescriptor; type: CIRCULAR_ARC }
Creates a circular arc descriptor based on three points.
Parameters
- point0: [number, number, number]
  The first point.
- point1: [number, number, number]
  The second point.
- point2: [number, number, number]
  The third point.
Returns { descriptor: TopologyCircularArcDescriptor; type: CIRCULAR_ARC }
A circular arc descriptor.
- descriptor: TopologyCircularArcDescriptor
  The attributes of the topological entity.
- type: CIRCULAR_ARC
  The subtype of the topological entity.
Inherited from TopologyAPI.createCircularArcDescriptor

createClippingRoom

createClippingRoom(properties?: ClipRoomProperties): void

Creates a new clip room.

A clip room consists of six orthogonal planes forming a box that clips any geometry outside of it. This is useful for examining internal structures of complex models or focusing on specific regions of interest.

Clip rooms can be positioned and sized using the properties object, and can be made invisible (for clipping without showing the room boundaries) or disabled temporarily without removing them.

Triggers a ClippingRoomCreatedEvent when the clip room is created.

Example usage:

// Get the webvis context
const context = webvis.getContext();

// Create a basic clip room at the origin
context.createClippingRoom({
  size: [10, 10, 10],        // Size along X, Y, and Z axes
  name: "Engine Section"
});

// Create a positioned and rotated clip room
context.createClippingRoom({
  size: [5, 5, 5],
  // Matrix including rotation and translation
  transform: [
    0.866, 0.5, 0, 0,      // First row (rotation + scale)
    -0.5, 0.866, 0, 0,     // Second row (rotation + scale)
    0, 0, 1, 0,            // Third row (rotation + scale)
    10, 5, 3, 1            // Fourth row (translation + w)
  ]
});

Parameters

Optionalproperties: ClipRoomProperties
Initial properties of the created clip room. Default: {}

Returns void

createClippingRoom(
    name?: string,
    size?: number[] | Float32Array<ArrayBufferLike>,
    transformation?: number[] | Float32Array<ArrayBufferLike>,
    disabled?: boolean,
    invisible?: boolean,
): void
Parameters
- Optionalname: string
  The name of the clip room.
- Optionalsize: number[] | Float32Array<ArrayBufferLike>
  The size of the clip room.
- Optionaltransformation: number[] | Float32Array<ArrayBufferLike>
  The transformation of the clip room.
- Optionaldisabled: boolean
  The disabled state of the clip room.
- Optionalinvisible: boolean
  The invisible state of the clip room.
Returns void
Deprecated
Calling createClippingRoom with single parameters is deprecated, please use ClipRoomProperties instead.

Creates a new clip room.

Inherited from ClipPlaneAPI.createClippingRoom

createClipPlane

createClipPlane(properties?: ClipPlaneProperties): number
Creates a new clip plane.

Clip planes create a visual cut through 3D models, allowing examination of internal structures by hiding geometry on one side of the plane. The orientation and position of the plane are defined by its normal vector and a point on the plane.

A clip plane can be configured to exclude specific nodes from clipping or to clip only specific nodes, using the excludedNodes and clippedNodes properties respectively.

Triggers a ClipPlaneCreatedEvent when the clip plane is created.

Example usage:
```
// Get the webvis context
const context = webvis.getContext();

// Create a clip plane aligned with the XY plane
const clipPlaneId = context.createClipPlane({
  normal: [0, 0, 1],     // Z-axis normal
  position: [0.04, -0.03, -0.15],   // Passing through a specific point
  name: "Section View"
});

// Create a clip plane with excluded nodes
const clipPlaneId = context.createClipPlane({
  normal: [1, 0, 0],
  excludedNodes: [1234, 5678],  // These nodes won't be clipped
  invisible: true               // Hide the visual representation of the plane
});
```
Parameters
- Optionalproperties: ClipPlaneProperties
  Initial properties of the created clip plane. Default: {}
Returns number
The ID of the newly created clip plane.

Inherited from ClipPlaneAPI.createClipPlane
createClipPlane(
    normal?: number[] | Float32Array<ArrayBufferLike>,
    point?: number[] | Float32Array<ArrayBufferLike>,
    name?: string,
    thickness?: number,
    tangent?: number[] | Float32Array<ArrayBufferLike>,
    disabled?: boolean,
    invisible?: boolean,
    exclusive?: boolean,
): number
Parameters
- Optionalnormal: number[] | Float32Array<ArrayBufferLike>
  The normal of the clip plane
- Optionalpoint: number[] | Float32Array<ArrayBufferLike>
  An arbitrary point in space which lies on the clip plane
- Optionalname: string
  The name of the clip plane
- Optionalthickness: number
  The thickness of the clip plane
- Optionaltangent: number[] | Float32Array<ArrayBufferLike>
  The tangent of the clip plane
- Optionaldisabled: boolean
  The state of the clip plane
- Optionalinvisible: boolean
  Invisible on the UI
- Optionalexclusive: boolean
  Set the exclusive flag to clip geometry when using exclusiveClipplanes property
Returns number
The ID of the newly created clip plane

Deprecated
Calling createClipPlane with single parameters is deprecated, please use ClipPlaneProperties instead.

Creates a clip plane defined by the plane's normal, positioned at an optional point (otherwise at the world space origin) and an optional name.

Inherited from ClipPlaneAPI.createClipPlane

createCollection

createCollection(nodeIDlist?: number[]): number
Parameters
- OptionalnodeIDlist: number[]
  An array of node id's from which a new node collection should be created.
Returns number
The id of the newly created node collection.

Deprecated
createCollection is deprecated and will be removed in future versions. Please use a simple array of node IDs instead.

Returns the id of a new collection containing the nodes from the given list.

Inherited from CollectionAPI.createCollection
createCollection(): number
Returns number
The id of the newly created collection.

Deprecated
createCollection is deprecated and will be removed in future versions. Please use a simple array of node IDs instead.

Creates a new, empty collection and returns its id.

Inherited from CollectionAPI.createCollection

createDrawing

createDrawing(data: ViewerDrawingResult, properties?: DrawingProperties): number
Creates a new Drawing from the Output of the ViewerDrawingAPI.
Parameters
- data: ViewerDrawingResult
  The data generated with the help of the ViewerDrawingAPI.
- Optionalproperties: DrawingProperties
  Initial properties of the created Drawing.
Returns number
The id of the newly created Drawing.

Inherited from DrawingAPI.createDrawing

createDrawingPlane

createDrawingPlane(properties?: DrawingPlaneProperties): number
Experimental
Creates a new DrawingPlane with the specified properties.
Parameters
- Optionalproperties: DrawingPlaneProperties
  Initial properties of the created Drawing.
Returns number
The ID of the newly created Drawing.

Inherited from DrawingPlaneAPI.createDrawingPlane

createExplosion

createExplosion(centerNodeID?: number): void
Creates an Explosion (around a given point).
Parameters
- OptionalcenterNodeID: number
  The nodeID of the node around which center the explosion is created.
Returns void
Inherited from ExplosionAPI.createExplosion

createMaterial

createMaterial(properties?: MaterialProperties): number
Experimental
Experimental. May be changed in the future without notice.

Creates a new material and triggers a MaterialCreatedEvent.
Parameters
- Optionalproperties: MaterialProperties
  Initial properties of the created material.
Returns number
The ID of the newly created material.

Inherited from MaterialAPI.createMaterial

createMeasurement

createMeasurement<T extends keyof MeasurementTypeToTargetMap>(
    type: T,
    targets: MeasurementTypeToTargetMap[T],
    properties?: MeasurementProperties,
): number
Performs a measurement and creates a corresponding measurement entity in the webvis context. The different kinds of measurements that this function can perform are defined in the MeasurementType enum. Depending on the measurement type, different targets are required.

Triggers a MeasurementCreatedEvent when the measurement entity has been created, followed by a MeasurementChangedEvent when processing is complete and the result is available.
Type Parameters
- T extends keyof MeasurementTypeToTargetMap
  The MeasurementType.
Parameters
- type: T
  The type of the measurement, given as a MeasurementType.
- targets: MeasurementTypeToTargetMap[T]
  The MeasurementTargets, as defined by the MeasurementType.
- Optionalproperties: MeasurementProperties
  Additional properties of the measurement entity. These include the enabled state and positioning information.
Returns number
The ID of the created measurement.
See
- changeMeasurement
- requestMeasurementData
Inherited from MeasurementAPI.createMeasurement

createNodePathHandles

createNodePathHandles(targets: number[]): Promise<NodePathHandle[]>
createNodePathHandles Creates and returns handles for the target node ids or topology selectors.
Parameters
- targets: number[]
  {Array} Array of target node ids to create the handles for
Returns Promise<NodePathHandle[]>
The array of handles

Inherited from NodePathAPI.createNodePathHandles

createPointDescriptor

createPointDescriptor(
point: [number, number, number],
): { descriptor: TopologyPointDescriptor; type: POINT }
Creates a point descriptor for the specified point.
Parameters
- point: [number, number, number]
  The point.
Returns { descriptor: TopologyPointDescriptor; type: POINT }
A point descriptor.
- descriptor: TopologyPointDescriptor
  The attributes of the topological entity.
- type: POINT
  The subtype of the topological entity.
Inherited from TopologyAPI.createPointDescriptor

createSnapshot

createSnapshot(
name?: string,
options?: SnapshotCreationOptions,
): Promise<number>
Creates a snapshot of the current session state.

Triggers a SnapshotCreationStartedEvent and, if successful, a SnapshotCreatedEvent.
Parameters
- Optionalname: string
  The name of the snapshot.
- Optionaloptions: SnapshotCreationOptions
  Options used for the snapshot creation.
Returns Promise<number>
The ID of the created snapshot.

Inherited from SessionStorageAPI.createSnapshot

createViewer

createViewer(
    viewerID?: string,
    canvas?: HTMLCanvasElement,
    settings?: {
        aaSetting?: any;
        backgroundColor?: any;
        cappingEffectEdgeColor?: any;
        cappingEffectEnabled?: any;
        cappingEffectInnerColor?: any;
        colorComparisonFirstColor?: any;
        colorComparisonMatchingColor?: any;
        colorComparisonSecondColor?: any;
        colorizeEffect?: any;
        coordSys?: any;
        defaultFieldOfView?: any;
        disableSpecularHighlights?: any;
        doubleClickAnimationVolumeScale?: any;
        doubleClickTimeWindow?: any;
        drawingArrowheadEnd?: any;
        drawingArrowheadStart?: any;
        drawingColor?: any;
        drawingMode?: any;
        drawingSize?: any;
        dynamicAuxContrastEnabled?: any;
        dynamicClippingDistance?: any;
        dynamicClippingEnabled?: any;
        dynamicCOREnabled?: any;
        expandOnViewerSelection?: any;
        faceHighlightColor?: any;
        faceSelectionColor?: any;
        fitViewFactor?: any;
        flyNavigationSpeed?: any;
        flyToOnDoubleClick?: any;
        focusOnDoubleClick?: any;
        frustumCulling?: any;
        ghostedSceneOpacity?: any;
        gizmoScalingFactor?: any;
        gizmosEnabled?: any;
        gpuMemoryReleaseFactor?: any;
        hoverColor?: any;
        initialFit?: any;
        initialFitDirection?: any;
        initView?: any;
        lightingEnvironment?: any;
        lineHighlightColor?: any;
        lineSelectionColor?: any;
        maxDynamicClipDistance?: any;
        maxGPUMemory?: any;
        maxSRCCPUMemory?: any;
        mouseInvertZoomingDirection?: any;
        navigationMode?: any;
        navigationSampling?: any;
        navigationSpeedFactor?: any;
        navigationSpeedThrottleFactor?: any;
        outlineColor?: any;
        outlineColorOccluded?: any;
        outlineInnerRadius?: any;
        outlineOuterRadius?: any;
        preSelectionColor?: any;
        projectionType?: any;
        renderAuxOnTop?: any;
        renderMode?: any;
        renderSetup?: any;
        sceneOpacity?: any;
        screenSpaceCoverageCalculationMethod?: any;
        selectionColor?: any;
        showAuxOnNavigation?: any;
        silhouetteEffect?: any;
        silhouetteEffectColor?: any;
        silhouetteEffectExclusiveEnabled?: any;
        smallFeatureCulling?: any;
        smallFeaturePixelThreshold?: any;
        soc?: any;
        spacemouseMultiplier?: any;
        ssaoEnabled?: any;
        taaEnabled?: any;
        topoGeometryColor?: any;
        topoGeometrySecondaryColor?: any;
        topoPointsEnabled?: any;
        transparencyMode?: any;
        turntableLowerVerticalLimit?: any;
        turntableUpperVerticalLimit?: any;
        turntableVerticalLimitsEnabled?: any;
        useDevicePixelRatio?: any;
        vertexColorsEnabled?: any;
        viewPerspective?: any;
        webglPreserveDrawingbuffer?: any;
    },
): ViewerAPI
Creates a viewer element.
Parameters
- OptionalviewerID: string
  The id of the viewer.
- Optionalcanvas: HTMLCanvasElement
  The canvas which is attached to the viewer.
- Optionalsettings: {
      aaSetting?: any;
      backgroundColor?: any;
      cappingEffectEdgeColor?: any;
      cappingEffectEnabled?: any;
      cappingEffectInnerColor?: any;
      colorComparisonFirstColor?: any;
      colorComparisonMatchingColor?: any;
      colorComparisonSecondColor?: any;
      colorizeEffect?: any;
      coordSys?: any;
      defaultFieldOfView?: any;
      disableSpecularHighlights?: any;
      doubleClickAnimationVolumeScale?: any;
      doubleClickTimeWindow?: any;
      drawingArrowheadEnd?: any;
      drawingArrowheadStart?: any;
      drawingColor?: any;
      drawingMode?: any;
      drawingSize?: any;
      dynamicAuxContrastEnabled?: any;
      dynamicClippingDistance?: any;
      dynamicClippingEnabled?: any;
      dynamicCOREnabled?: any;
      expandOnViewerSelection?: any;
      faceHighlightColor?: any;
      faceSelectionColor?: any;
      fitViewFactor?: any;
      flyNavigationSpeed?: any;
      flyToOnDoubleClick?: any;
      focusOnDoubleClick?: any;
      frustumCulling?: any;
      ghostedSceneOpacity?: any;
      gizmoScalingFactor?: any;
      gizmosEnabled?: any;
      gpuMemoryReleaseFactor?: any;
      hoverColor?: any;
      initialFit?: any;
      initialFitDirection?: any;
      initView?: any;
      lightingEnvironment?: any;
      lineHighlightColor?: any;
      lineSelectionColor?: any;
      maxDynamicClipDistance?: any;
      maxGPUMemory?: any;
      maxSRCCPUMemory?: any;
      mouseInvertZoomingDirection?: any;
      navigationMode?: any;
      navigationSampling?: any;
      navigationSpeedFactor?: any;
      navigationSpeedThrottleFactor?: any;
      outlineColor?: any;
      outlineColorOccluded?: any;
      outlineInnerRadius?: any;
      outlineOuterRadius?: any;
      preSelectionColor?: any;
      projectionType?: any;
      renderAuxOnTop?: any;
      renderMode?: any;
      renderSetup?: any;
      sceneOpacity?: any;
      screenSpaceCoverageCalculationMethod?: any;
      selectionColor?: any;
      showAuxOnNavigation?: any;
      silhouetteEffect?: any;
      silhouetteEffectColor?: any;
      silhouetteEffectExclusiveEnabled?: any;
      smallFeatureCulling?: any;
      smallFeaturePixelThreshold?: any;
      soc?: any;
      spacemouseMultiplier?: any;
      ssaoEnabled?: any;
      taaEnabled?: any;
      topoGeometryColor?: any;
      topoGeometrySecondaryColor?: any;
      topoPointsEnabled?: any;
      transparencyMode?: any;
      turntableLowerVerticalLimit?: any;
      turntableUpperVerticalLimit?: any;
      turntableVerticalLimitsEnabled?: any;
      useDevicePixelRatio?: any;
      vertexColorsEnabled?: any;
      viewPerspective?: any;
      webglPreserveDrawingbuffer?: any;
  }
  ViewerSettings
Returns ViewerAPI

deleteMemberProfileEntry

deleteMemberProfileEntry(key: string): Promise<void>
Experimental
Deletes a profile entry of the local member.
Parameters
- key: string
  The key of the profile entry to delete.
Returns Promise<void>
A promise that resolves when the profile entry has been deleted.

Inherited from MemberAPI.deleteMemberProfileEntry

disableCapping

disableCapping(clipPlaneId: number): Promise<void>
Experimental
Disables the generated capping geometry for a clip plane.

This method temporarily hides the capping geometry without removing it from the scene. The capping geometry can be made visible again using enableCapping. This is useful when you need to switch between seeing the cut surface and seeing through to the interior of the model.

Example usage:
```
// Get the webvis context
const context = webvis.getContext();

// Create a clip plane and generate capping geometry
const clipPlaneId = context.createClipPlane({
  normal: [0, 0, 1],
  position: [0, 0, 0]
});

await context.createCapping(clipPlaneId);

// Hide the capping geometry temporarily
await context.disableCapping(clipPlaneId);

// Show it again later
await context.enableCapping(clipPlaneId);
```
Parameters
- clipPlaneId: number
  The ID of the clip plane whose capping geometry should be disabled
Returns Promise<void>
Promise that resolves when the capping geometry has been disabled

Inherited from ClipPlaneAPI.disableCapping

disconnectFromSession

disconnectFromSession(): void
Returns void
Deprecated
The whole SessionAPI is under consolidation and will be replaced in a future release.

Disconnects from a Session.

Inherited from SessionAPI.disconnectFromSession

disconnectXR

disconnectXR(): Promise<void>
Experimental
Disconnect from the XR system.

This method should be called when the AR functionalities are no longer needed.

Returns Promise<void>
Returns a Promise which resolved when the operation was successful or rejects in an error case

Inherited from RealityAPI.disconnectXR

enableCapping

enableCapping(clipPlaneId: number): Promise<void>
Experimental
Enables the generated capping geometry for a clip plane.

After capping geometry has been created for a clip plane, this method makes it visible . The capping geometry represents the intersection between the clip plane and the model, allowing visualization and interaction with the cut surface.

Example usage:
```
// Get the webvis context
const context = webvis.getContext();

// Create a clip plane and generate capping geometry
const clipPlaneId = context.createClipPlane({
  normal: [0, 0, 1],
  position: [0, 0, 0]
});

await context.createCapping(clipPlaneId);

// Later disable capping and then re-enable it
await context.disableCapping(clipPlaneId);
// ...
await context.enableCapping(clipPlaneId);
```
Parameters
- clipPlaneId: number
  The ID of the clip plane whose capping geometry should be enabled
Returns Promise<void>
Promise that resolves when the capping geometry has been enabled

Inherited from ClipPlaneAPI.enableCapping

endExplosion

endExplosion(): void
Restores the initial transformations of all exploded parts.

Returns void
Inherited from ExplosionAPI.endExplosion

enterXRInitMode

enterXRInitMode(xrInitOptions?: XRInitOptions): Promise<void>
Experimental
Enter the XR initialization mode. The initialization mode is used as an entry point for model-based tracking. It unanchors any previously anchored model and starts the model-based tracking process. In this mode, the user can align the model with the real object (snapping). When the model is snapped, the XRState.anchored value will be set to true which will trigger a XRStateChangedEvent. By that, the init mode gets exited and the model is anchored to the real object. The model now gets tracked and moves with the device.

Please note, that this method should only be called if the XR system has the XRCapability.SUPPORTS_MODEL_TRACKING capability.
Parameters
- OptionalxrInitOptions: XRInitOptions
  The options for the XR initialization mode
Returns Promise<void>
Returns a Promise which resolved when the operation was successful or rejects in an error case

Inherited from RealityAPI.enterXRInitMode

exportXRInitTemplate

exportXRInitTemplate(): Promise<string>
Experimental
Exports an initialization template for model-based tracking.

In a model-based tracking scenario, after a successful tracking session, the learned initialization data can be exported with this function and stored as a template for later.

This method is only available if the XR system has the XRCapability.SUPPORTS_MODEL_TRACKING capability.

The acquired data can be imported via importXRInitTemplate function.

Returns Promise<string>
Returns a Promise which contains the base64 encoded initialization template data when the operation was successful or rejects in an error case.

Inherited from RealityAPI.exportXRInitTemplate

fetchAttachmentData

fetchAttachmentData(attachmentID: number): Promise<Serializable>
Fetches and returns the attachment data of the specified attachment.
Parameters
- attachmentID: number
  Specifies the attachment object.
Returns Promise<Serializable>
The attached data.

Inherited from AttachmentAPI.fetchAttachmentData

getAnnotationData

getAnnotationData(annotationId: number): AnnotationData
Parameters
- annotationId: number
  The ID of the Annotation.
Returns AnnotationData
The content and properties of an annotation.

Deprecated
Inherited from AnnotationAPI.getAnnotationData

getAnnotations

getAnnotations(): number[]
Returns number[]
The IDs of all available Annotations.

Inherited from AnnotationAPI.getAnnotations

getAttachmentData

getAttachmentData(attachmentID: number): Serializable
Returns the attachment data.
Parameters
- attachmentID: number
  Specifies the attachment object.
Returns Serializable
The attached data

Deprecated
getAttachmentData is deprecated, please use fetchAttachmentData instead.

Inherited from AttachmentAPI.getAttachmentData

getAttachmentDataURI

getAttachmentDataURI(attachmentID: number): string
Returns the attachment data URI.
Parameters
- attachmentID: number
  Specifies the attachment object.
Returns string
The attachment data URI.

Inherited from AttachmentAPI.getAttachmentDataURI

getClipPlanes

getClipPlanes(): number[]

Returns the IDs of all clip planes.

This method provides a list of all clip plane IDs that can be used with other ClipPlaneAPI methods like changeClipPlane, removeClipPlane, or requestClipPlaneData.

Example usage:

// Get the webvis context
const context = webvis.getContext();

// Get all clip planes and print their properties
const clipPlaneIds = context.getClipPlanes();

clipPlaneIds.forEach(async (id) => {
  const properties = await context.requestClipPlaneData(id);
  console.log(`Clip plane ${id}: ${properties.name || 'unnamed'}`);
});

Returns number[]

An array of clip plane IDs. Empty array if no clip planes exist.

getClipRoom

getClipRoom(): number

Returns the ID of the current clip room.

Since WebVis only supports a single clip room at a time, this method returns a single ID value rather than an array. The ID can be used with other clip room methods like requestClipRoomData.

Example usage:

// Get the webvis context
const context = webvis.getContext();

// Get the current clip room ID and retrieve its properties
const clipRoomId = context.getClipRoom();

if (clipRoomId !== undefined) {
  const properties = await context.requestClipRoomData();
  console.log(`Clip room size: [${properties.size}]`);
} else {
  console.log("No clip room exists in the scene");
}

Returns number

The ID of the current clip room, or undefined if no clip room exists

getCollection

getCollection(collectionID: number): ICollection
Parameters
- collectionID: number
  Specifies which collection should be returned
Returns ICollection
The collection with the given id

Deprecated
getCollection is deprecated and will be removed in future versions.

Returns the collection with the given id.

Inherited from CollectionAPI.getCollection

getCollectionElements

getCollectionElements(collectionID: number): Promise<number[]>
Readonly
Parameters
- collectionID: number
  The id of the node collection
Returns Promise<number[]>
Array of node IDs representing the node collection

Deprecated
getCollectionElements is deprecated and will be removed in future versions.

Returns an array containing the ids of the nodes in the collection. Modifying the returned array results in undefined behavior.

Inherited from CollectionAPI.getCollectionElements

getCollectionNodeCount

getCollectionNodeCount(collectionID: number): Promise<number>
Parameters
- collectionID: number
  The id of the collection
Returns Promise<number>
Number of elements in a collection.

Deprecated
getCollectionNodeCount is deprecated and will be removed in future versions.

Returns the number of elements inside a collection.

Inherited from CollectionAPI.getCollectionNodeCount

getCoordinateSystemForwardVector

getCoordinateSystemForwardVector(): | Float32Array<ArrayBufferLike>
| [number, number, number]
Returns the forward vector of the current coordinate system.

Returns Float32Array<ArrayBufferLike> | [number, number, number]
The forward vector of the current coordinate system.

Inherited from CoordinateSystemAPI.getCoordinateSystemForwardVector

getCoordinateSystemMatrix

getCoordinateSystemMatrix(): | Float32Array<ArrayBufferLike>
| [
    number,
    number,
    number,
    number,
    number,
    number,
    number,
    number,
    number,
    number,
    number,
    number,
    number,
    number,
    number,
    number,
]
This function returns a 4x4 transformation matrix that transforms the default right-handed coordinate system, where the x-axis points right, the y-axis points up, and the z-axis points forward (towards the viewer), to a custom coordinate system defined by the front plane axis setting.

Returns
    | Float32Array<ArrayBufferLike>
    | [
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
        number,
    ]
The 4x4 coordinate system matrix

Inherited from CoordinateSystemAPI.getCoordinateSystemMatrix

getCoordinateSystemRightVector

getCoordinateSystemRightVector(): | Float32Array<ArrayBufferLike>
| [number, number, number]
Returns the right vector of the current coordinate system.

Returns Float32Array<ArrayBufferLike> | [number, number, number]
The right vector of the current coordinate system.

Inherited from CoordinateSystemAPI.getCoordinateSystemRightVector

getCoordinateSystemUpVector

getCoordinateSystemUpVector(): | Float32Array<ArrayBufferLike>
| [number, number, number]
Returns the up vector of the current coordinate system.

Returns Float32Array<ArrayBufferLike> | [number, number, number]
The up vector of the current coordinate system.

Inherited from CoordinateSystemAPI.getCoordinateSystemUpVector

getDrawingPlaneData

getDrawingPlaneData(drawingPlaneId: number): DrawingPlaneProperties
Experimental
Returns the DrawingPlane properties for the specified DrawingPlane ID.
Parameters
- drawingPlaneId: number
  The ID of the DrawingPlane you want to get the Data for.
Returns DrawingPlaneProperties
The requested DrawingPlane properties.

Inherited from DrawingPlaneAPI.getDrawingPlaneData

getDrawingPlanes

getDrawingPlanes(): number[]
Experimental
Returns all available DrawingPlane IDs.

Returns number[]
An Array of all available DrawingPlane IDs.

Inherited from DrawingPlaneAPI.getDrawingPlanes

getDrawings

getDrawings(): number[]
Returns all available Drawing ids.

Returns number[]
An Array of all available Drawing ids.

Inherited from DrawingAPI.getDrawings

getEnabledAuxNodes

getEnabledAuxNodes(nodeID: number): Promise<number[]>
Parameters
- nodeID: number
  Specifies the entry point of the subtree traversal. Default: 0
Returns Promise<number[]>
An Array of all enabled aux node IDs

Deprecated
This function will no longer be available in future webvis releases. Use the QueryAPI instead.

Traverses the subtree of a given node ID and collects all enabled aux nodes.

Inherited from InstanceGraphAPI.getEnabledAuxNodes

getEnabledLayerFilters

getEnabledLayerFilters(): string[]
Returns the currently defined list of enabled layer filters.

Returns string[]
An array of strings representing the names of the enabled layer filters.

Inherited from LayerFilterAPI.getEnabledLayerFilters

getInteractionMode

getInteractionMode(): InteractionMode
Returns the current Interaction mode.

Returns InteractionMode
The current Interaction mode.

Inherited from InteractionAPI.getInteractionMode

getMaterialData

getMaterialData(materialId: number): MaterialProperties
Experimental
Experimental. May be changed in the future without notice.

Returns the properties of the material entity with the specified ID.
Parameters
- materialId: number
  The ID of the material entity.
Returns MaterialProperties
The properties of the material entity.

Inherited from MaterialAPI.getMaterialData

getMaterials

getMaterials(): number[]
Experimental
Experimental. May be changed in the future without notice.

Returns the IDs of all material entities in the webvis context.

Returns number[]
The IDs of all available materials

Inherited from MaterialAPI.getMaterials

getMeasurements

getMeasurements(): number[]
Returns the IDs of all measurement entities in the webvis context.

Returns number[]
The IDs of all measurement entities.

See
createMeasurement

Inherited from MeasurementAPI.getMeasurements

getMemberName

getMemberName(): string
Experimental
Gets the name of the local member.

Returns string
The name of the local member, or undefined if not set.

Inherited from MemberAPI.getMemberName

getMembers

getMembers(): number[]
Experimental
Gets a list of all member IDs in the current space.

Returns number[]
An array of member IDs.

Inherited from MemberAPI.getMembers

getMetadata

getMetadata(nodeID: number): Promise<{ [key: string]: string }>
Returns a JSON object containing the metadata for the given node ID.
Parameters
- nodeID: number
  The ID of a node.
Returns Promise<{ [key: string]: string }>
A JSON object containing the requested metadata.

Inherited from InstanceGraphAPI.getMetadata

getName

getName(): string
Returns string
The name of the context.

getProperties

getProperties<T extends string>(
nodeID: number,
properties: T[],
): Promise<PropertyType<T>[]>
Returns the values of the specified properties of the given node.
Type Parameters
- T extends string
Parameters
- nodeID: number
  The ID of the node whose properties should be read.
- properties: T[]
  The names of the Properties whose values should be read.
Returns Promise<PropertyType<T>[]>
The retrieved values of the node's properties.

Inherited from InstanceGraphAPI.getProperties

getProperty

getProperty<T extends string>(
nodeID: number,
property: T,
): Promise<PropertyType<T>>
Returns the value of the specified property of the given node.
Type Parameters
- T extends string
Parameters
- nodeID: number
  The ID(s) of the node(s) whose property should be read.
- property: T
  The name of the Property whose value should be read.
Returns Promise<PropertyType<T>>
The retrieved value of the node property.

Inherited from InstanceGraphAPI.getProperty

getRegisteredLayerFilters

getRegisteredLayerFilters(): { [key: string]: boolean }
Returns the currently defined list of layer filters with their current state.

Returns { [key: string]: boolean }
Returns a map of the registered layer filters and their states.

Inherited from LayerFilterAPI.getRegisteredLayerFilters

getRootNodeId

getRootNodeId(target: number | TopologyHandle, includeTarget?: boolean): number
Returns the root node ID of the given node or topology element.
Parameters
- target: number | TopologyHandle
  Specifies the target node or topology element.
- OptionalincludeTarget: boolean
  Controls if the target node itself can be returned as root node. If set to false and a root node ID is passed in, it returns the next higher root node ID. Default: true
Returns number
The root node ID of the given node ID or topology handle.

Inherited from InstanceGraphAPI.getRootNodeId

getSelectedLeafNodes

getSelectedLeafNodes(): number[]
Returns a list of all selected leaf nodes.

Returns number[]
An array which contains the IDs of all leaf nodes in the current selection.

Inherited from SelectionAPI.getSelectedLeafNodes

getSelectedNodes

getSelectedNodes(): number[]
Returns a list of all selected nodes. When a whole subtree is selected, only the parent node will be included in the returned array. To get the selected leaf nodes of the subtree, use getSelectedLeafNodes instead.

Returns number[]
An array which contains the IDs of all nodes in the current selection.

Inherited from SelectionAPI.getSelectedNodes

getSelectedTopologyHandles

getSelectedTopologyHandles(): TopologyHandle[]
Returns all selected topological entities.

Returns TopologyHandle[]
All selected topological entities.
See
- isTopologySelected
- setTopologySelection
Inherited from TopologyAPI.getSelectedTopologyHandles

getSelection

getSelection(): Promise<number[]>
Returns a list of all selected nodes.

Returns Promise<number[]>
An array which contains the IDs of all nodes in the current selection.

Deprecated
getSelection is deprecated, please use getSelectedNodes instead.

Inherited from SelectionAPI.getSelection

getSessionMemberID

getSessionMemberID(): number
Returns number
The ID of the SessionMember.

Deprecated
The whole SessionAPI is under consolidation and will be replaced in a future release.

Inherited from SessionAPI.getSessionMemberID

getSessionMembers

getSessionMembers(): Promise<SessionMemberData[]>
Returns Promise<SessionMemberData[]>
The IDs of all SessionMembers.

Deprecated
The whole SessionAPI is under consolidation and will be replaced in a future release.

Inherited from SessionAPI.getSessionMembers

getSessionStateData

getSessionStateData(): SessionStateData
Returns SessionStateData
Information about the Session.

Deprecated
The whole SessionAPI is under consolidation and will be replaced in a future release.

Inherited from SessionAPI.getSessionStateData

getShapeHandle

getShapeHandle(handle: TopologyHandle): TopologyHandle
Returns a handle for the shape that contains the given topological entity.
Parameters
- handle: TopologyHandle
  The topology handle.
Returns TopologyHandle
A handle for the shape that contains the given topological entity.

Inherited from TopologyAPI.getShapeHandle

getSnapshotData

getSnapshotData(
snapshotID: number,
): { attachmentID: number; name: string; order: number }
Parameters
- snapshotID: number
  The ID of the snapshot to request data for.
Returns { attachmentID: number; name: string; order: number }
The data of the specified snapshot.

Deprecated
getSnapshotData is deprecated. Please use requestSnapshotData instead.

Inherited from SessionStorageAPI.getSnapshotData

getSnapshots

getSnapshots(): number[]
Returns the IDs of all available snapshots.

Returns number[]
An array of snapshot IDs.

Inherited from SessionStorageAPI.getSnapshots

getStatistics

getStatistics(
    nodeType?: NodeType,
    nodeID?: number,
    recursive?: boolean,
): Promise<any>
Traverses the subtree of a given node ID and collects all statistics (currently only available for AUX nodes).
Parameters
- OptionalnodeType: NodeType
  Specifies the target node type. Default: NodeType.ALL
- OptionalnodeID: number
  Specifies the node ID as the entry point of the subtree traversal. Default: 0
- Optionalrecursive: boolean
Returns Promise<any>
An object of type/count pairs.

Inherited from InstanceGraphAPI.getStatistics

getTopologyType

getTopologyType(handle: TopologyHandle): TopologyType
Returns the type of the given topological entity.
Parameters
- handle: TopologyHandle
  The topology handle.
Returns TopologyType
The type of the given topological entity.

Inherited from TopologyAPI.getTopologyType

getViewer

getViewer(id?: string): ViewerAPI
Parameters
- Optionalid: string
  The id of the viewer.
Returns ViewerAPI
The viewer element by the given id.

getViewers

getViewers(): ViewerAPI[]
Returns ViewerAPI[]
An array of all viewer elements.

getXRCapabilities

getXRCapabilities(): XRCapability[]
Experimental
Get the array of XRCapability. The array of capabilities determines what parts of the API can be used. The capabilities are mostly defined by the used device.

Returns XRCapability[]
Returns an Array<XRCapability> containing the XR system's capabilities.

Inherited from RealityAPI.getXRCapabilities

getXRMembers

getXRMembers(): number[]
Experimental
Returns an array of member IDs of those session members which are currently using an XR device and are currently publishing an XRImage stream.

The array will not contain the session member ID of the own session member. Will return an empty array, if
- the session is not connected.
- the session is connected, but no session member currently publishes an XRImage stream.
Returns number[]
The array of member IDs of those session members that are currently publishing an XRImage stream.

Inherited from RealityAPI.getXRMembers

getXRPlaybackProperties

getXRPlaybackProperties(): XRPlaybackProperties
Experimental
Get static information about the playback sequence.

Returns XRPlaybackProperties
The current XRPlaybackProperties

Inherited from RealityAPI.getXRPlaybackProperties

getXRPlaybackState

getXRPlaybackState(): XRPlaybackState
Experimental
Get real-time information about the current state of the playback.

Returns XRPlaybackState
The current XRPlaybackState

Inherited from RealityAPI.getXRPlaybackState

getXRState

getXRState(): XRState
Experimental
Get the runtime state of the XR system.

Returns XRState
Returns either the current XRState or undefined if the XR system is not connected.

Inherited from RealityAPI.getXRState

hideXRBackgroundFeed

hideXRBackgroundFeed(): Promise<void>
Experimental
Stops putting the image feed into the viewer's background. Also see showXRBackgroundFeed.

This will trigger a XRStateChangedEvent with XRState.backgroundFeedVisible set to false.

Returns Promise<void>
Returns a Promise which resolved when the operation was successful or rejects in an error case

Inherited from RealityAPI.hideXRBackgroundFeed

importConfig

importConfig(
    config: {
        aaSetting?: any;
        additionalCookies?: any;
        additionalRequestHeaders?: any;
        additionalWSQueryParameters?: any;
        applicationIdentifier?: any;
        auxModeRecursiveSearch?: any;
        auxModeUncolorFacesOnLeave?: any;
        backgroundColor?: any;
        batchedQueries?: any;
        boosterURL?: any;
        cappingEffectEdgeColor?: any;
        cappingEffectEnabled?: any;
        cappingEffectInnerColor?: any;
        cappingGeometryColor?: any;
        colorComparisonFirstColor?: any;
        colorComparisonMatchingColor?: any;
        colorComparisonSecondColor?: any;
        colorizeEffect?: any;
        contextMenuFunction?: any;
        coordSys?: any;
        defaultFieldOfView?: any;
        defaultQueryLinkDepth?: any;
        disableDefaultInteraction?: any;
        disableSpecularHighlights?: any;
        doubleClickAnimationVolumeScale?: any;
        doubleClickTimeWindow?: any;
        drawingArrowheadEnd?: any;
        drawingArrowheadStart?: any;
        drawingColor?: any;
        drawingMode?: any;
        drawingSize?: any;
        dynamicAuxContrastEnabled?: any;
        dynamicClippingDistance?: any;
        dynamicClippingEnabled?: any;
        dynamicCOREnabled?: any;
        expandOnViewerSelection?: any;
        faceHighlightColor?: any;
        faceSelectionColor?: any;
        fitViewFactor?: any;
        flyNavigationSpeed?: any;
        flyToOnDoubleClick?: any;
        focusOnDoubleClick?: any;
        frontPlaneAxis?: any;
        frustumCulling?: any;
        ghostedSceneOpacity?: any;
        gizmoScalingFactor?: any;
        gizmosEnabled?: any;
        gpuMemoryReleaseFactor?: any;
        hoverColor?: any;
        hubURL?: any;
        initialFit?: any;
        initialFitDirection?: any;
        initialStateActivation?: any;
        initView?: any;
        lightingEnvironment?: any;
        lineHighlightColor?: any;
        lineSelectionColor?: any;
        loadRemoteConfigFile?: any;
        logLevel?: any;
        maxActiveSceneVolumeDiameter?: any;
        maxConcurrentDownloads?: any;
        maxDynamicClipDistance?: any;
        maxGPUMemory?: any;
        maxSRCCPUMemory?: any;
        measurementAngularTolerance?: any;
        measurementMaterialDensities?: any;
        mouseInvertZoomingDirection?: any;
        navigationMode?: any;
        navigationSampling?: any;
        navigationSpeedFactor?: any;
        navigationSpeedThrottleFactor?: any;
        notificationLogLevels?: any;
        outlineColor?: any;
        outlineColorOccluded?: any;
        outlineInnerRadius?: any;
        outlineOuterRadius?: any;
        parentSelectEnabled?: any;
        preferXHRWithCredentials?: any;
        preSelectionColor?: any;
        projectionType?: any;
        renderAuxOnTop?: any;
        renderMode?: any;
        renderSetup?: any;
        sceneOpacity?: any;
        screenSpaceCoverageCalculationMethod?: any;
        selectionColor?: any;
        sessionDeviceTags?: any;
        sessionForwardUrl?: any;
        sessionInteractions?: any;
        sessionMemberName?: any;
        showAuxOnNavigation?: any;
        silhouetteEffect?: any;
        silhouetteEffectColor?: any;
        silhouetteEffectExclusiveEnabled?: any;
        skipSslVerify?: any;
        smallFeatureCulling?: any;
        smallFeaturePixelThreshold?: any;
        snapshotContentSelection?: any;
        soc?: any;
        spacemouseMultiplier?: any;
        ssaoEnabled?: any;
        taaEnabled?: any;
        topoGeometryColor?: any;
        topoGeometrySecondaryColor?: any;
        topoPointsEnabled?: any;
        transparencyMode?: any;
        turntableLowerVerticalLimit?: any;
        turntableUpperVerticalLimit?: any;
        turntableVerticalLimitsEnabled?: any;
        uriMap?: any;
        usageGroup?: any;
        useDevicePixelRatio?: any;
        vertexColorsEnabled?: any;
        viewPerspective?: any;
        webglPreserveDrawingbuffer?: any;
        xrEnableDebugImages?: any;
        xrFusionMode?: any;
        xrImageCompressionQuality?: any;
        xrImageResolutionProfile?: any;
        xrModelTrackerQualityThreshold?: any;
        xrModelTrackerSmoothingFactor?: any;
    },
): void
Applies the specified set of settings to the context.
Parameters
- config: {
      aaSetting?: any;
      additionalCookies?: any;
      additionalRequestHeaders?: any;
      additionalWSQueryParameters?: any;
      applicationIdentifier?: any;
      auxModeRecursiveSearch?: any;
      auxModeUncolorFacesOnLeave?: any;
      backgroundColor?: any;
      batchedQueries?: any;
      boosterURL?: any;
      cappingEffectEdgeColor?: any;
      cappingEffectEnabled?: any;
      cappingEffectInnerColor?: any;
      cappingGeometryColor?: any;
      colorComparisonFirstColor?: any;
      colorComparisonMatchingColor?: any;
      colorComparisonSecondColor?: any;
      colorizeEffect?: any;
      contextMenuFunction?: any;
      coordSys?: any;
      defaultFieldOfView?: any;
      defaultQueryLinkDepth?: any;
      disableDefaultInteraction?: any;
      disableSpecularHighlights?: any;
      doubleClickAnimationVolumeScale?: any;
      doubleClickTimeWindow?: any;
      drawingArrowheadEnd?: any;
      drawingArrowheadStart?: any;
      drawingColor?: any;
      drawingMode?: any;
      drawingSize?: any;
      dynamicAuxContrastEnabled?: any;
      dynamicClippingDistance?: any;
      dynamicClippingEnabled?: any;
      dynamicCOREnabled?: any;
      expandOnViewerSelection?: any;
      faceHighlightColor?: any;
      faceSelectionColor?: any;
      fitViewFactor?: any;
      flyNavigationSpeed?: any;
      flyToOnDoubleClick?: any;
      focusOnDoubleClick?: any;
      frontPlaneAxis?: any;
      frustumCulling?: any;
      ghostedSceneOpacity?: any;
      gizmoScalingFactor?: any;
      gizmosEnabled?: any;
      gpuMemoryReleaseFactor?: any;
      hoverColor?: any;
      hubURL?: any;
      initialFit?: any;
      initialFitDirection?: any;
      initialStateActivation?: any;
      initView?: any;
      lightingEnvironment?: any;
      lineHighlightColor?: any;
      lineSelectionColor?: any;
      loadRemoteConfigFile?: any;
      logLevel?: any;
      maxActiveSceneVolumeDiameter?: any;
      maxConcurrentDownloads?: any;
      maxDynamicClipDistance?: any;
      maxGPUMemory?: any;
      maxSRCCPUMemory?: any;
      measurementAngularTolerance?: any;
      measurementMaterialDensities?: any;
      mouseInvertZoomingDirection?: any;
      navigationMode?: any;
      navigationSampling?: any;
      navigationSpeedFactor?: any;
      navigationSpeedThrottleFactor?: any;
      notificationLogLevels?: any;
      outlineColor?: any;
      outlineColorOccluded?: any;
      outlineInnerRadius?: any;
      outlineOuterRadius?: any;
      parentSelectEnabled?: any;
      preferXHRWithCredentials?: any;
      preSelectionColor?: any;
      projectionType?: any;
      renderAuxOnTop?: any;
      renderMode?: any;
      renderSetup?: any;
      sceneOpacity?: any;
      screenSpaceCoverageCalculationMethod?: any;
      selectionColor?: any;
      sessionDeviceTags?: any;
      sessionForwardUrl?: any;
      sessionInteractions?: any;
      sessionMemberName?: any;
      showAuxOnNavigation?: any;
      silhouetteEffect?: any;
      silhouetteEffectColor?: any;
      silhouetteEffectExclusiveEnabled?: any;
      skipSslVerify?: any;
      smallFeatureCulling?: any;
      smallFeaturePixelThreshold?: any;
      snapshotContentSelection?: any;
      soc?: any;
      spacemouseMultiplier?: any;
      ssaoEnabled?: any;
      taaEnabled?: any;
      topoGeometryColor?: any;
      topoGeometrySecondaryColor?: any;
      topoPointsEnabled?: any;
      transparencyMode?: any;
      turntableLowerVerticalLimit?: any;
      turntableUpperVerticalLimit?: any;
      turntableVerticalLimitsEnabled?: any;
      uriMap?: any;
      usageGroup?: any;
      useDevicePixelRatio?: any;
      vertexColorsEnabled?: any;
      viewPerspective?: any;
      webglPreserveDrawingbuffer?: any;
      xrEnableDebugImages?: any;
      xrFusionMode?: any;
      xrImageCompressionQuality?: any;
      xrImageResolutionProfile?: any;
      xrModelTrackerQualityThreshold?: any;
      xrModelTrackerSmoothingFactor?: any;
  }
  Settings to import
Returns void
Inherited from SettingsAPI.importConfig

importSession

importSession(data: any, format?: "xscn"): Promise<any>
Imports a session from the given data string in the specified format.

Supported formats: xscn.
Parameters
- data: any
  The content of the session file.
- Optionalformat: "xscn"
  The format of the session file. Default: "xscn".
Returns Promise<any>
A Promise that resolves when the session is imported.

Inherited from SessionStorageAPI.importSession

importXRInitTemplate

importXRInitTemplate(template: string): Promise<void>
Experimental
Imports an initialization template for model-based tracking.

In a model-based tracking scenario, initialization templates are captured during the tracking process. This initialization data is linked to previously visited viewpoints along the traveled camera path. Once the tracking is lost the templates are used to quickly reinitialize from similar viewpoints without the user having to align the line model with the real object.

Once the initialization template data is imported, it will persist until enterXRInitMode with XRInitOptions.resetInitTemplate set to true is called.

This method is only available if the XR system has the XRCapability.SUPPORTS_MODEL_TRACKING capability.

The input data can be aquired via the exportXRInitTemplate method.
Parameters
- template: string
  The base64 encoded initialization template data
Returns Promise<void>
Returns a Promise which resolved when the operation was successful or rejects in an error case

Inherited from RealityAPI.importXRInitTemplate

invertEnabledStates

invertEnabledStates(): void
Inverts all enabled states.

Triggers a NodeChangedEvent.

Returns void
Inherited from InstanceGraphAPI.invertEnabledStates

invertSelection

invertSelection(silent?: boolean): Promise<ChangeSelectionResult>
Inverts the current selection.

Selected nodes will be unselected, and then all previously unselected leaf nodes will be selected. When all child nodes of a parent are selected, the selection moves up the hierarchy as usual.

For example, consider the following hierarchy:
```
Node 0
 |- Node 1
     |- Node 1.1
     |- Node 1.2
 |- Node 2
     |- Node 2.1
     |- Node 2.2
```
If the initial selection is only Node 2.1, calling invertSelection will result in the selection including Node 2.2, Node 1.1, Node 1.2, and therefore also Node 1. Node 0 and Node 2 will not become selected, even though they were not selected initially. If getSelectedNodes is called at this point, it will return [Node 1, Node 2.2].

Triggers a SelectionChangedEvent if silent is set to false.
Parameters
- Optionalsilent: boolean
  If set to true, no event will be emitted. Default: false
Returns Promise<ChangeSelectionResult>
The result of the selection change.

Inherited from SelectionAPI.invertSelection

isColorComparisonActive

isColorComparisonActive(): boolean
Checks if the color comparison mode is active.

Returns boolean
true if the color comparison mode is active, otherwise false.

Inherited from InteractionAPI.isColorComparisonActive

isNodeDeletable

isNodeDeletable(nodeID: number): boolean
Checks if a node is deletable.
Parameters
- nodeID: number
Returns boolean
true if the node is deletable.

Inherited from InstanceGraphAPI.isNodeDeletable

isNodePartOfEnabledLayers

isNodePartOfEnabledLayers(nodeID: number): Promise<boolean>
Returns true if the specified node ID is part of an enabled layer.
Parameters
- nodeID: number
  The node ID which should be checked.
Returns Promise<boolean>
Returns a promise that resolves to true if the node is part of an enabled layer, false otherwise.

Inherited from LayerFilterAPI.isNodePartOfEnabledLayers

isNodePartOfEnabledVariant

isNodePartOfEnabledVariant(nodeId: number): Promise<boolean>
Parameters
- nodeId: number
  The ID of the Node.
Returns Promise<boolean>
True, if the Node is Part of an enabled Variant. False otherwise.

Inherited from VariantsAPI.isNodePartOfEnabledVariant

isNodeType

isNodeType(nodeID: number, nodeType: NodeType): boolean
Checks if a node is a specific type.
Parameters
- nodeID: number
- nodeType: NodeType
Returns boolean
true if the node is of the specified type, otherwise false.

Inherited from InstanceGraphAPI.isNodeType

isOfflineStorageAvailable

isOfflineStorageAvailable(): Promise<boolean>
Returns Promise<boolean>
A Promise that always resolves to false, as offline storage is not used anymore.

Deprecated
isOfflineStorageAvailable is deprecated.

Checks if offline storage is currently available. This functionality is no longer relevant as offline storage is not supported anymore.

Inherited from SessionStorageAPI.isOfflineStorageAvailable

isSelected

isSelected(nodeID: number): Promise<boolean>
Checks if the specified node is part of the selection.
Parameters
- nodeID: number
  The ID of the node to check for selection status.
Returns Promise<boolean>
True if the given node is selected, otherwise false.

Inherited from SelectionAPI.isSelected

isTopologySelected

isTopologySelected(handle: TopologyHandle): boolean
Returns true if the specified topological entity is selected, false otherwise.
Parameters
- handle: TopologyHandle
  The topology handle.
Returns boolean
True if the specified topological entity is selected, false otherwise.
See
- getSelectedTopologyHandles
- setTopologySelection
Inherited from TopologyAPI.isTopologySelected

mapInternalToOriginalTopologyHandles

mapInternalToOriginalTopologyHandles(
handles: TopologyHandle[],
): Promise<OriginalTopologyHandle[]>
Maps the given webvis topology handles to the corresponding original topology handles.
Parameters
- handles: TopologyHandle[]
  The webvis topology handles to be mapped.
Returns Promise<OriginalTopologyHandle[]>
The corresponding original topology handles.

See
mapOriginalToInternalTopologyHandles

Inherited from TopologyAPI.mapInternalToOriginalTopologyHandles

mapOriginalToInternalTopologyHandles

mapOriginalToInternalTopologyHandles(
nodeID: number,
handles: OriginalTopologyHandle[],
): Promise<TopologyHandle[]>
Maps the given original topology handles to the corresponding webvis topology handles.
Parameters
- nodeID: number
  The node which represents the part that contains the topological entities.
- handles: OriginalTopologyHandle[]
  The original topology handles to be mapped.
Returns Promise<TopologyHandle[]>
The corresponding webvis topology handles.

See
mapInternalToOriginalTopologyHandles

Inherited from TopologyAPI.mapOriginalToInternalTopologyHandles

measureBetween

measureBetween(
target0: MeasurementTarget,
target1: MeasurementTarget,
): Promise<BetweenMeasurementResult>
Measures the distance and, if applicable, the angle between two measurement targets. The result also includes the corresponding closest points on the targets.

If the targets intersect, the result will contain a representation of the intersection. Note that the intersection is not available for measurements involving target classes TOPOLOGY or NODE, except for the cases plane-face and face-face.
Parameters
- target0: MeasurementTarget
  The first measurement target.
- target1: MeasurementTarget
  The second measurement target.
Returns Promise<BetweenMeasurementResult>
The result of the measurement.

Inherited from MeasurementAPI.measureBetween

measureNormal

measureNormal(
topology: { class: TOPOLOGY; value: TopologyHandle },
point: { class: POINT; value: [number, number, number] },
): Promise<NormalMeasurementResult>
Measures the normal of a face at a given point. The face is specified by a measurement target that points to a corresponding TopologyHandle. If the point does not lie on the face, the closest point on the face is used.
Parameters
- topology: { class: TOPOLOGY; value: TopologyHandle }
  The measurement target representing the face via a TopologyHandle.
- point: { class: POINT; value: [number, number, number] }
  The point at which the normal should be measured.
Returns Promise<NormalMeasurementResult>
The result of the normal measurement.

Inherited from MeasurementAPI.measureNormal

measurePointsByDistance

measurePointsByDistance(
    searchCurve: {
        class: CURVE;
        value: [[number, number, number], [number, number, number]][];
    },
    distanceCurves: { class: TOPOLOGY; value: TopologyHandle }[],
    distance: number,
): Promise<DistanceConstraintMatch[]>
Experimental
Attention: This function is experimental and may be changed or removed in future versions.

Returns points from a search space that have the specified distance to a set of measurement targets. The search space is defined by a measurement target. Currently only supports a search space that is defined by a curve and edges as distance targets.
Parameters
- searchCurve: { class: CURVE; value: [[number, number, number], [number, number, number]][] }
  The curve on which to search.
- distanceCurves: { class: TOPOLOGY; value: TopologyHandle }[]
  The targets from which the distance is measured.
- distance: number
  The distance.
Returns Promise<DistanceConstraintMatch[]>
An array of points that match the distance constraint.

Inherited from MeasurementAPI.measurePointsByDistance

measureTangent

measureTangent(
topology: { class: TOPOLOGY; value: TopologyHandle },
point: { class: POINT; value: [number, number, number] },
): Promise<TangentMeasurementResult>
Measures the tangent of an edge at a given point. The edge is specified by a measurement target that points to a corresponding TopologyHandle. If the point does not lie on the edge, the closest point on the edge is used.
Parameters
- topology: { class: TOPOLOGY; value: TopologyHandle }
  The measurement target representing the edge via a TopologyHandle.
- point: { class: POINT; value: [number, number, number] }
  The point at which the tangent should be measured.
Returns Promise<TangentMeasurementResult>
The result of the tangent measurement.

Inherited from MeasurementAPI.measureTangent

measureThickness

measureThickness(
topology: { class: TOPOLOGY; value: TopologyHandle },
point: { class: POINT; value: [number, number, number] },
): Promise<ThicknessMeasurementResult>
Measures the thickness of a shape at a given point. The shape is specified by a measurement target that points to a corresponding TopologyHandle. If the point does not lie on the shape, the closest point on the shape is used. The thickness is measured along the line defined by the normal of the shape at the given point.
Parameters
- topology: { class: TOPOLOGY; value: TopologyHandle }
  The measurement target representing the shape via a TopologyHandle.
- point: { class: POINT; value: [number, number, number] }
  The point at which the thickness should be measured.
Returns Promise<ThicknessMeasurementResult>
The result of the thickness measurement.

Inherited from MeasurementAPI.measureThickness

openSpace

openSpace(spaceHandle?: string): Promise<void>
Experimental
Opens a 3D space.

If a space handle is specified and it exists, switches to the 3D space referenced by the handle. If a space handle is specified and it does not exist, throws an error. If no space handle is specified, creates a new 3D space and clears the content.
Parameters
- OptionalspaceHandle: string
  The handle of the space to open. If undefined, a new space is created.
Returns Promise<void>
A promise that resolves when the space has been opened.

See
requestSpaceHandle to get a space handle.

Inherited from SpaceAPI.openSpace

performExplosion

performExplosion(explosionFactor: number): void
Performs the actual Explosion.
Parameters
- explosionFactor: number
  The value by which the parts are expanded.
Returns void
Inherited from ExplosionAPI.performExplosion

processInteractionInput

processInteractionInput(interactionData: InteractionData): void
Triggers an interaction on the current active interaction mode.
Parameters
- interactionData: InteractionData
  Definition of the triggered Interaction.
Returns void
Inherited from InteractionAPI.processInteractionInput

promoteSessionMember

promoteSessionMember(memberID: number): void
Parameters
- memberID: number
  The ID of the SessionMember.
Returns void
Deprecated
The whole SessionAPI is under consolidation and will be replaced in a future release.

Promotes a SessionMember to the Role of the Moderator.

Inherited from SessionAPI.promoteSessionMember

query

query(query: string | Query, nodeID?: number): Promise<QueryResult>
Executes the query on the specified subtree
Parameters
- query: string | Query
- OptionalnodeID: number
Returns Promise<QueryResult>
Inherited from QueryAPI.query

readSetting

readSetting<T extends string>(setting: T): ContextSettingType<T>
Returns the value of a setting.
Type Parameters
- T extends string
Parameters
- setting: T
  The name of the setting that should be read
Returns ContextSettingType<T>
The value of the specified setting

Inherited from SettingsAPI.readSetting

registerCustomProperty

registerCustomProperty(
    name: string,
    defaultValue: any,
    recursive?: boolean,
): void
Registers a new custom node property.

Custom properties allow developers to hook into the node hierarchy with custom data. This enables the creation of custom behaviors and interactions that can benefit from the NODE_* events, like the NodeChangedEvent, emitted by the InstanceGraphAPI.

Triggers a CustomPropertyRegisteredEvent
Parameters
- name: string
  The name of the new property.
- defaultValue: any
  Specifies the default value.
- Optionalrecursive: boolean
  Defines whether the property is recursive. Default: false
Returns void
Inherited from InstanceGraphAPI.registerCustomProperty

registerFrameListener

registerFrameListener(listener: FrameListener): void
Registers a frame listener which is executed on every tick of the internal update loop of the webvis context.
Parameters
- listener: FrameListener
  The listener to register.
Returns void
Inherited from FrameAPI.registerFrameListener

registerListener

registerListener<T extends WebVisEvent = WebVisEvent>(
    eventTypes: EventType[],
    listener: IEventListener<T>,
    nodeID?: number,
    observeSubTree?: boolean,
): number
Registers a listener for a set of EventTypes. If the given event types array is empty, the listener will react to all event types. The listener must implement the IEventListener interface. It will be called with events that extend the WebVisEvent base class. An event's type property specifies its EventType and determines its structure.

Scoping listeners in the node hierarchy
Several EventTypes are linked to a specific node in the hierarchy. These include all that have a NODE_ or TOPOLOGY_ prefix, as well as several animation-related event types.

When registering a listener for these event types, a listening scope must be specified in the node hierarchy. This is done by setting the optional parameters nodeID and observeSubTree. The observeSubTree flag determines whether the listener is scoped to only the specified node or the entire subtree under the node.

By default, listeners are scoped to the global root node and observeSubTree is false, such that listeners do not receive any events linked to added nodes. To listen to events from all nodes, set nodeID to 0 and observeSubTree to true.

There are a few things to note when scoping listeners:
- NODE_ADDED events are linked to the parent node of the added node.
- NODE_CHANGED events behave differently depending on the node property that has changed. When the node property is recursive, the event is passed to all listeners in the subtree. When the change to the node property affects the node's ancestors, events will also be triggered for the ancestors.
Type Parameters
- T extends WebVisEvent = WebVisEvent
  The type of event that the listener listens to. This can also be a union of multiple event types.
Parameters
- eventTypes: EventType[]
  The types of events that the listener listens to. If an empty array is passed, the listener will listen to all event types.
- listener: IEventListener<T>
  The event listener.
- OptionalnodeID: number
  The ID of the node to which the listener should be scoped. Default: 0
- OptionalobserveSubTree: boolean
  If set to true, the listener will be scoped to the whole subtree under the specified node. Default: false
Returns number
- The ID of the event listener.
Inherited from EventAPI.registerListener

remove

remove(nodeID?: number | number[], safe?: boolean): Promise<RemoveState>
Removes the node for the given node ID from the scene and all related snapshots. If no node ID is supplied, all nodes are deleted.

Triggers a NodeRemovedEvent.
Parameters
- OptionalnodeID: number | number[]
  The ID of the node that should be removed or undefined to remove all nodes.
- Optionalsafe: boolean
  Performs a safe remove which interrupt the removal process if the node is part of one or more snapshots. Default: false.
Returns Promise<RemoveState>
A promise that resolves with the RemoveState once the operation is complete.

See
SessionStorageAPI

Inherited from InstanceGraphAPI.remove

removeAnimationFrames

removeAnimationFrames(name: string): void
Removes an existing animation sequence.
Parameters
- name: string
  Specifies the name of the animation frames.
Returns void
Inherited from AnimationAPI.removeAnimationFrames

removeAnnotation

removeAnnotation(annotationId: number, safe?: boolean): RemoveState
Removes the Annotation from the scene and all related Snapshots and triggers an AnnotationRemovedEvent.
Parameters
- annotationId: number
  The ID of the Annotation.
- Optionalsafe: boolean
  Performs a safe remove which interrupt the removal process if the Annotation is part of one or more Snapshots.
Returns RemoveState
Inherited from AnnotationAPI.removeAnnotation

removeAttachment

removeAttachment(attachmentID: number, safe?: boolean): RemoveState
Removes the Attachment from the scene and all related snapshots.

Triggers an AttachmentRemovedEvent.
Parameters
- attachmentID: number
  Specifies the attachment object.
- Optionalsafe: boolean
  Performs a safe remove which interrupt the removal process if the attachment is part of one or more snapshots. If no safe remove, a snapshot could link to missing data. Default: false.
Returns RemoveState
The state of the removal process.

Inherited from AttachmentAPI.removeAttachment

removeCapping

removeCapping(clipPlaneId: number): Promise<void>
Experimental
Completely removes the generated capping geometry for a clip plane.

This method permanently deletes any capping geometry that was previously created for the specified clip plane. Unlike disableCapping, which merely hides the geometry, this method removes it entirely from the scene.

If you later want to see capping geometry again, you'll need to call createCapping to regenerate it.

Example usage:
```
// Get the webvis context
const context = webvis.getContext();

// Create a clip plane and generate capping geometry
const clipPlaneId = context.createClipPlane({
  normal: [0, 0, 1],
  position: [0, 0, 0]
});

await context.createCapping(clipPlaneId);

// Later, permanently remove the capping geometry
await context.removeCapping(clipPlaneId);
```
Parameters
- clipPlaneId: number
  The ID of the clip plane whose capping geometry should be removed
Returns Promise<void>
Promise that resolves when the capping geometry has been removed

Inherited from ClipPlaneAPI.removeCapping

removeClippingRoom

removeClippingRoom(safe?: boolean): RemoveState
Removes the clip room from the scene.

This method completely removes the clip room and disables its clipping effect. Only one clip room can exist at a time, so there's no need to specify an ID.

When the safe parameter is set to true and the clip room is referenced by snapshots, the removal will be prevented and the method will return REFERENCED_BY_SNAPSHOT. By default (safe is false), the clip room will be forcibly removed even if it's referenced by snapshots.

Triggers a ClippingRoomRemovedEvent when the clip room is successfully removed.

Example usage:
```
// Get the webvis context
const context = webvis.getContext();

// Safe remove - will fail if referenced by snapshots
const removeResult = context.removeClippingRoom(true);

if (removeResult === webvis.RemoveState.REFERENCED_BY_SNAPSHOT) {
  console.log("Cannot remove clip room - it's referenced by a snapshot");
} else if (removeResult === webvis.RemoveState.OK) {
  console.log("Clip room successfully removed");
}

// Force remove even if referenced by snapshots (default behavior)
context.removeClippingRoom();
```
Parameters
- Optionalsafe: boolean
  Whether to prevent removal if the clip room is referenced by snapshots. Default: false
Returns RemoveState
A RemoveState value indicating the result of the removal operation

Inherited from ClipPlaneAPI.removeClippingRoom

removeClipPlane

removeClipPlane(clipPlaneId: number, safe?: boolean): RemoveState
Removes a clip plane from the scene.

This method completely removes the specified clip plane from the scene. Any capping geometry associated with the clip plane will also be removed.

When the safe parameter is set to true and the clip plane is referenced by snapshots, the removal will be prevented and the method will return REFERENCED_BY_SNAPSHOT. By default (safe is false), clip planes will be forcibly removed even if they're referenced by snapshots.

Triggers a ClipPlaneRemovedEvent when the clip plane is successfully removed.

Example usage:
```
// Get the webvis context
const context = webvis.getContext();

// Safe remove - will fail if referenced by snapshots
const removeResult = context.removeClipPlane(clipPlaneId, true);

if (removeResult === webvis.RemoveState.REFERENCED_BY_SNAPSHOT) {
  console.log("Cannot remove clip plane - it's referenced by a snapshot");
} else if (removeResult === webvis.RemoveState.OK) {
  console.log("Clip plane successfully removed");
}

// Force remove even if referenced by snapshots (default behavior)
context.removeClipPlane(clipPlaneId);
```
Parameters
- clipPlaneId: number
  The ID of the clip plane to remove
- Optionalsafe: boolean
  Whether to prevent removal if the clip plane is referenced by snapshots. Default: false
Returns RemoveState
A RemoveState value indicating the result of the removal operation

Inherited from ClipPlaneAPI.removeClipPlane

removeCollection

removeCollection(collectionID: number): void
Parameters
- collectionID: number
  Specifies which collection should be removed
Returns void
Deprecated
removeCollection is deprecated and will be removed in future versions.

Removes the collection with the given id.

Inherited from CollectionAPI.removeCollection

removeDrawing

removeDrawing(drawingId: number, safe?: boolean): RemoveState
Removes a Drawing with the specified id. If a Drawing is part of a Snapshot the removal will fail with the State RemoveState.REFERENCED_BY_SNAPSHOT
Parameters
- drawingId: number
  The id of the to be removed Drawing.
- Optionalsafe: boolean
  Performs a safe remove which interrupt the removal process if the Drawing is part of one or more Snapshots.
Returns RemoveState
Inherited from DrawingAPI.removeDrawing

removeDrawingPlane

removeDrawingPlane(drawingPlaneId: number, safe?: boolean): RemoveState
Experimental
Removes a DrawingPlane with the specified ID. If a DrawingPlane is part of a Snapshot the removal will fail with the State RemoveState.REFERENCED_BY_SNAPSHOT.
Parameters
- drawingPlaneId: number
  The ID of the Drawing you want to remove.
- Optionalsafe: boolean
  Performs a safe remove which interrupt the removal process if the Drawing is part of one or more Snapshots.
Returns RemoveState
Inherited from DrawingPlaneAPI.removeDrawingPlane

removeFromCollection

removeFromCollection(
    collectionID: number,
    nodeID: number,
    recursive?: boolean,
): void
Parameters
- collectionID: number
  Specifies from which collection the node should be removed
- nodeID: number
  Specifies which node should be removed from the collection
- Optionalrecursive: boolean
  Specifies whether the children of the node should be removed from the collection too
Returns void
Deprecated
removeFromCollection is deprecated and will be removed in future versions.

Removes a node given by nodeID from the collection with id collectionID. If recursive is true, the descendants of the node are also removed.

Inherited from CollectionAPI.removeFromCollection

removeFromSelection

removeFromSelection(
nodeID: number | number[],
silent?: boolean,
): Promise<ChangeSelectionResult>
Removes the specified nodes from the current selection.

Triggers a SelectionChangedEvent if silent is set to false.
Parameters
- nodeID: number | number[]
  The ID or array of IDs of the nodes to remove from the selection.
- Optionalsilent: boolean
  If set to true, no event will be emitted. Default: false
Returns Promise<ChangeSelectionResult>
The result of the selection change.

Inherited from SelectionAPI.removeFromSelection

removeMaterial

removeMaterial(materialId: number, safe?: boolean): RemoveState
Experimental
Experimental. May be changed in the future without notice.

Removes the material from the scene and all related snapshots and triggers a MaterialRemovedEvent.
Parameters
- materialId: number
  The ID of the material.
- Optionalsafe: boolean
  Performs a safe remove which interrupts the removal process if the material is part of one or more Snapshots. Default: false
Returns RemoveState
The resulting state of the removal process.

Inherited from MaterialAPI.removeMaterial

removeMeasurement

removeMeasurement(measurementID: number, safe?: boolean): RemoveState
Removes the measurement entity with the specified ID from the webvis context and all related snapshots.

Triggers a MeasurementRemovedEvent when the measurement entity has been removed.
Parameters
- measurementID: number
  The ID of the measurement entity that should be removed.
- Optionalsafe: boolean
  Performs a safe remove which interrupts the removal process if the measurement is part of one or more snapshots. Default: false
Returns RemoveState
The resulting state of the removal process.

See
createMeasurement

Inherited from MeasurementAPI.removeMeasurement

removeSessionMember

removeSessionMember(memberID: number): void
Parameters
- memberID: number
  The ID of the SessionMember.
Returns void
Deprecated
The whole SessionAPI is under consolidation and will be replaced in a future release.

Removes a SessionMember from a Session.

Inherited from SessionAPI.removeSessionMember

removeSnapshot

removeSnapshot(snapshotID: number): void
Deletes the snapshot for the given snapshot ID.

Triggers a SnapshotRemovedEvent.
Parameters
- snapshotID: number
  The ID of the snapshot to delete.
Returns void
Inherited from SessionStorageAPI.removeSnapshot

removeTopologyFromSelection

removeTopologyFromSelection(
handle: TopologyHandle | TopologyHandle[],
): Promise<void>
Removes one or more topological entities from the current selection.
Parameters
- handle: TopologyHandle | TopologyHandle[]
  The topological entity or array of topological entities which should be removed from the current selection.
Returns Promise<void>
A promise which resolves when the operation is completed.
See
Inherited from TopologyAPI.removeTopologyFromSelection

removeViewer

removeViewer(viewer: ViewerAPI): void
Removes a viewer element.
Parameters
- viewer: ViewerAPI
  The id of the viewer.
Returns void

requestActiveSceneVolume

requestActiveSceneVolume(): Promise<BoxVolume>
Returns the active volume of the current scene. It is the smallest volume that contains all nodes of the scene that are enabled.

Returns Promise<BoxVolume>
See
Property.ENABLED

Inherited from InstanceGraphAPI.requestActiveSceneVolume

requestAnnotationData

requestAnnotationData(annotationId: number): Promise<AnnotationProperties>
Returns the AnnotationData for the specified Annotation ID.
Parameters
- annotationId: number
  The ID of the Annotation you want to request the data for.
Returns Promise<AnnotationProperties>
The requested Annotation data.

Inherited from AnnotationAPI.requestAnnotationData

requestAuxRootNodeIds

requestAuxRootNodeIds(scopeNodeId?: number): Promise<number[]>
Returns a list of all existing AUX root node IDs below the specified subtree.
Parameters
- OptionalscopeNodeId: number
  Specifies the top one node ID of the subtree to be searched. Default: 0
Returns Promise<number[]>
A list of AUX root node IDs.

Inherited from InstanceGraphAPI.requestAuxRootNodeIds

requestBoxDescriptor

requestBoxDescriptor(
nodeIds: number[],
): Promise<{ descriptor: TopologyBoxDescriptor; type: BOX }>
Returns a box descriptor for the combined bounding box of the specified nodes.
Parameters
- nodeIds: number[]
  The nodes for which the box descriptor should be created.
Returns Promise<{ descriptor: TopologyBoxDescriptor; type: BOX }>
The box descriptor for the combined bounding box of the specified nodes.

Inherited from TopologyAPI.requestBoxDescriptor

requestClipPlaneData

requestClipPlaneData(clipPlaneId: number): Promise<ClipPlaneProperties>
Retrieves the properties of a specific clip plane.

This method asynchronously fetches the current configuration of a clip plane, including its position, orientation, visibility settings, and any node exclusions. The data is returned as a ClipPlaneProperties object that can be inspected or used to create a similar clip plane.

Example usage:
```
// Get the webvis context
const context = webvis.getContext();

const properties = await context.requestClipPlaneData(clipPlaneId);
console.log(`Clip plane position: [${properties.position}]`);
console.log(`Clip plane normal: [${properties.normal}]`);
  
// Use the properties to create a similar clip plane
const newClipPlaneId = context.createClipPlane({
  ...properties,
  name: properties.name + " (copy)"
});
```
Parameters
- clipPlaneId: number
  The ID of the clip plane to get data for
Returns Promise<ClipPlaneProperties>
Promise resolving to the clip plane's properties

Inherited from ClipPlaneAPI.requestClipPlaneData

requestClipRoomData

requestClipRoomData(): Promise<ClipRoomProperties>

Retrieves the properties of the current clip room.

This method asynchronously fetches the current configuration of the clip room, including its size, position, transformation matrix, and visibility settings. The data is returned as a ClipRoomProperties object that can be inspected or used to create a similar clip room after the current one is removed.

Example usage:

// Get the webvis context
const context = webvis.getContext();

// Get the clip room properties and display information
const properties = await context.requestClipRoomData();
console.log(`Clip room size: [${properties.size}]`);
console.log(`Clip room transform: [${properties.transform}]`);

// Use the properties to create a similar clip room after removing the current one
context.removeClippingRoom();
context.createClippingRoom({
  ...properties,
  size: [properties.size[0] * 1.5, properties.size[1] * 1.5, properties.size[2] * 1.5],
  name: properties.name ? properties.name + " (enlarged)" : "Enlarged Room"
});

Returns Promise<ClipRoomProperties>

Promise resolving to the clip room's properties

requestDrawingData

requestDrawingData(drawingId: number): Promise<DrawingData>
Returns the DrawingData for the specified Drawing id.
Parameters
- drawingId: number
  The id of the Drawing from which the data is requested.
Returns Promise<DrawingData>
The requested Drawing data.

Inherited from DrawingAPI.requestDrawingData

requestFullSceneVolume

requestFullSceneVolume(): Promise<BoxVolume>
Returns the full volume of the current scene. It is the smallest volume that contains all nodes of the scene, regardless of their Property.ENABLED state.

Returns Promise<BoxVolume>
Inherited from InstanceGraphAPI.requestFullSceneVolume

requestHubVersion

requestHubVersion(): Promise<string>
Request the current version of the connected instant3Dhub-backend. May return undefined for older versions.

Returns Promise<string>
Returns a Promise which contains a string containing the version of the connected backend.

Inherited from HubAPI.requestHubVersion

requestL3DInformation

requestL3DInformation(targetNodeId: number): Promise<any>
Returns the L3D information of the specified node.
Parameters
- targetNodeId: number
  Specifies the target node ID.
Returns Promise<any>
The L3D information of the specified node

Inherited from InstanceGraphAPI.requestL3DInformation

requestMeasurementData

requestMeasurementData(measurementID: number): Promise<MeasurementProperties>
Returns the properties of the measurement entity with the specified ID. These include the result of the measurement, as well as its type and targets.
Parameters
- measurementID: number
  The ID of the measurement entity.
Returns Promise<MeasurementProperties>
The properties of the measurement entity.

See
createMeasurement

Inherited from MeasurementAPI.requestMeasurementData

requestMemberActions

requestMemberActions(memberId: number): Promise<MemberAction[]>
Experimental
Requests the actions available on a member.
Parameters
- memberId: number
  The ID of the member to request actions for.
Returns Promise<MemberAction[]>
A promise that resolves to an array of member actions.

Inherited from MemberAPI.requestMemberActions

requestMemberProperties

requestMemberProperties(id: number): Promise<MemberProperties>
Experimental
Requests the properties of a member.
Parameters
- id: number
  The ID of the member to request the properties for.
Returns Promise<MemberProperties>
A promise that resolves to the member properties, or undefined if the member does not exist.

Inherited from MemberAPI.requestMemberProperties

requestNeighboringEdges

requestNeighboringEdges(handle: TopologyHandle): Promise<TopologyHandle[]>
Returns the neighboring edges of the specified topological entity.
Parameters
- handle: TopologyHandle
  The topological entity for which the neighboring edges should be requested.
Returns Promise<TopologyHandle[]>
The neighboring edges of the specified topological entity.

Inherited from TopologyAPI.requestNeighboringEdges

requestNeighboringFaces

requestNeighboringFaces(handle: TopologyHandle): Promise<TopologyHandle[]>
Returns the neighboring faces of the specified topological entity.
Parameters
- handle: TopologyHandle
  The topological entity for which the neighboring faces should be requested.
Returns Promise<TopologyHandle[]>
The neighboring faces of the specified topological entity.

Inherited from TopologyAPI.requestNeighboringFaces

requestNodeIdsByBoxVolume

requestNodeIdsByBoxVolume(
    boxVolume: BoxVolume,
    includeOverlappingNodes?: boolean,
    includeDisabledNodes?: boolean,
    forceExpand?: boolean,
    scopeNodeId?: number,
): Promise<number[]>
Returns a list of all node IDs that are included in or overlapped by the specified bounding volume.
Parameters
- boxVolume: BoxVolume
  Specifies the bounding volume.
- OptionalincludeOverlappingNodes: boolean
  Specifies whether the result should include nodes which overlap the specified bounding volume as well. Default: false
- OptionalincludeDisabledNodes: boolean
  Specifies whether the result should include nodes which are disabled as well. Default: false
- OptionalforceExpand: boolean
  If set to true, L3D instances may be expanded to find their leaf nodes. Default: false
- OptionalscopeNodeId: number
  Specifies the top one node ID of the subtree to be searched. Default: 0
Returns Promise<number[]>
List of all node IDs which are included or overlapped by the specified bounding volume.

Inherited from InstanceGraphAPI.requestNodeIdsByBoxVolume

requestNodePathHandleMap

requestNodePathHandleMap(
paths: string[],
scope?: number,
): Promise<NodePathHandleMap>
requestNodePathHandleMap Returns an object mapping from input paths to the respective handles.
Parameters
- paths: string[]
  {Array<string | NodePathHandle>} The array of node path strings or handles.
- Optionalscope: number
  {number} [scope=0] nodeID specifying the scope as starting point for the paths
Returns Promise<NodePathHandleMap>
The resulting object mapping paths to handles

Inherited from NodePathAPI.requestNodePathHandleMap

requestNodePathStrings

requestNodePathStrings(
    handles: NodePathHandle[],
    scope?: number,
    typePriorities?: NodePathFragmentType[],
): Promise<string[]>
requestNodePathStrings Returns string representations for the respective node path handles.
Parameters
- handles: NodePathHandle[]
  {Array}
- Optionalscope: number
  {number} nodeID specifying the scope as starting point for the path resolution
- OptionaltypePriorities: NodePathFragmentType[]
  {Array} Array of priorities to control the fragments for the path string assembly.
Returns Promise<string[]>
String representation of the node path for the respective scope.

Inherited from NodePathAPI.requestNodePathStrings

requestRootNodeIds

requestRootNodeIds(scopeNodeId?: number, recursive?: boolean): Promise<number[]>
Returns a list of all existing root node IDs below the specified subtree.
Parameters
- OptionalscopeNodeId: number
  Specifies the top one node ID of the subtree to be searched. Default: 0
- Optionalrecursive: boolean
  Specifies if the subtree is traversed recursively. Default: false
Returns Promise<number[]>
A list of root node IDs.

Inherited from InstanceGraphAPI.requestRootNodeIds

requestServiceStates

requestServiceStates(): Promise<Map<ServiceType, ServiceState>>
Requests all available services of the backend and their current state.

Returns Promise<Map<ServiceType, ServiceState>>
Returns a Promise which contains a map of all available services and their states.

Inherited from HubAPI.requestServiceStates

requestSnapshotData

requestSnapshotData(snapshotID: number): Promise<SnapshotProperties>
Requests the data of the specified snapshot.
Parameters
- snapshotID: number
  The ID of the snapshot to request data for.
Returns Promise<SnapshotProperties>
The data of the specified snapshot.

Inherited from SessionStorageAPI.requestSnapshotData

requestSpaceHandle

requestSpaceHandle(role?: MemberRole): Promise<string>
Experimental
Requests a shareable space handle for the current 3D space.

A space handle is a URL that can be used to open the current 3D space. It has the following format:
- <HUB_URL>/api/space/v2/<SPACE_ID> if no role is specified.
- <HUB_URL>/api/space/v2/<SPACE_ID>?token=<TOKEN> if a role is specified. where <HUB_URL> is the URL of the hub, <SPACE_ID> is the ID of the current space, and <TOKEN> is the access token for the specified role.
Parameters
- Optionalrole: MemberRole
  The role to assign when the space is opened via the handle. If undefined, the MemberRole.VIEWER role will be assigned when opening the space via the handle.
Returns Promise<string>
A promise that resolves to the space handle.

Inherited from SpaceAPI.requestSpaceHandle

requestSupportedContentTypes

requestSupportedContentTypes(): Promise<ContentType[]>
Request a list of (model) data formats which are supported by the connected instance3Dhub-backend. If requested before the connection to the Hub is established, it will return the local list of content types.

Returns Promise<ContentType[]>
Returns a Promise which contains the list of all supported data formats.

Inherited from HubAPI.requestSupportedContentTypes

requestSupportedRenderSetups

requestSupportedRenderSetups(): Promise<{ name: string; value: string }[]>
Request all supported render setups if one or more are available. The render setup is a key value pair where the key is the name of the render setup and the value could be used as an input value for the ViewerSettingStrings.RENDER_SETUP setting.

Returns Promise<{ name: string; value: string }[]>
Returns a Promise which contains the list of supported render setups.

Inherited from HubAPI.requestSupportedRenderSetups

requestTopologyDescriptor

requestTopologyDescriptor(handle: TopologyHandle): Promise<TopologyDescriptor>
Returns a detailed descriptor for the specified topological entity. The descriptor contains the subtype and an object with a series of known attributes of the topological entity. For example, a descriptor for a circle includes the center and radius of the circle.
Parameters
- handle: TopologyHandle
  The topological entity.
Returns Promise<TopologyDescriptor>
A detailed descriptor for the specified topological entity.

Inherited from TopologyAPI.requestTopologyDescriptor

requestVariants

requestVariants(nodeId: number): Promise<VariantProperties[]>
Parameters
- nodeId: number
  The ID of the Node.
Returns Promise<VariantProperties[]>
The Variant(s) for a given nodeID.

Inherited from VariantsAPI.requestVariants

requestXRDeviceScreenshot

requestXRDeviceScreenshot(): Promise<string>
Experimental
Request a screenshot of the webview's content inside the native XR device application.

Returns Promise<string>
Returns a Promise which contains the base64 encoded image data when the operation was successful or rejects in an error case.

Inherited from RealityAPI.requestXRDeviceScreenshot

requestXRScanshot

requestXRScanshot(): Promise<XRScanshot>
Experimental
Requests a scanshot of the current view in the XR environment.

Returns Promise<XRScanshot>
The scanshot data.

Inherited from RealityAPI.requestXRScanshot

resetInteractionMode

resetInteractionMode(keepColorCompareActive?: boolean): void
Sets the current interaction mode back to the Default mode.
Parameters
- OptionalkeepColorCompareActive: boolean
  Specifies if the color comparison mode should stay active. (Default: false)
Returns void
See
isColorComparisonActive

Inherited from InteractionAPI.resetInteractionMode

resetProperties

resetProperties(
    nodeID: number,
    properties: string[],
    recursive?: boolean,
): Promise<void>
Resets the value of the specified properties of the given node.

Triggers a NodePropertiesResetEvent. If the property has changed, this will additionally trigger a NodeChangedEvent.
Parameters
- nodeID: number
  The ID of the node whose Property should be reset.
- properties: string[]
  List of properties which should be reset.
- Optionalrecursive: boolean
  If set to true, the properties are reset recursively. Default: false
Returns Promise<void>
Inherited from InstanceGraphAPI.resetProperties

resetProperty

resetProperty(
    nodeID: number,
    property: string,
    recursive?: boolean,
): Promise<void>
Resets the value of the specified property of the given node.

Triggers a NodePropertiesResetEvent. If the property has changed, this will additionally trigger a NodeChangedEvent.
Parameters
- nodeID: number
  The ID of the node whose Property should be reset.
- property: string
  The Property that should be reset.
- Optionalrecursive: boolean
  If set to true, the properties are reset recursively. Default: false
Returns Promise<void>
Inherited from InstanceGraphAPI.resetProperty

resetSetting

resetSetting(setting: ViewerSettingStrings | SettingStrings): void
Resets the value of a setting to the installation default.
Parameters
- setting: ViewerSettingStrings | SettingStrings
  The name of the setting that should be reset.
Returns void
Inherited from SettingsAPI.resetSetting

resetUserSettings

resetUserSettings(): void
Returns void
Inherited from SettingsAPI.resetUserSettings

restoreSession

restoreSession(handle: string): Promise<void>
Restores a session for the given access handle from the infrastructure.
Parameters
- handle: string
  The access handle of the session to restore.
Returns Promise<void>
A Promise that resolves when the session is restored.

Inherited from SessionStorageAPI.restoreSession

restoreSnapshot

restoreSnapshot(
snapshotID: number,
options?: SnapshotRestoreOptions,
): Promise<void>
Restores the snapshot for the given snapshot ID.

Triggers a SnapshotRestoreStartedEvent and, if successful, a SnapshotRestoredEvent.
Parameters
- snapshotID: number
  The ID of the snapshot to restore.
- Optionaloptions: SnapshotRestoreOptions
  Options to control the subset of snapshot data to restore.
Returns Promise<void>
A Promise that resolves when the snapshot is restored.

Inherited from SessionStorageAPI.restoreSnapshot

searchByVolume

searchByVolume(
    selectionBox: BoxVolume,
    includeOverlappingNodes: boolean,
    rootNodeID?: number,
): Promise<number>
Parameters
- selectionBox: BoxVolume
  3-dimensional search volume.
- includeOverlappingNodes: boolean
  Specifies whether the search result contains only those nodes which lie entirely in the search volume or if overlapping nodes are also included.
- OptionalrootNodeID: number
  Restricts the search to a subtree of a node with the given id.
Returns Promise<number>
A the id of the created collection of nodes that are fitting the given search criteria.

Deprecated
searchByVolume is deprecated and will be removed in future versions. Please use InstanceGraphAPI.requestNodeIdsByBoxVolume instead.

Finds nodes within the given BoxVolume (created using the createBoxVolume() function). If includeOverlappingNodes is false, only nodes fully contained by the box volume are returned. The rootNodeID specifies the node from which the subtree is searched.

Inherited from CollectionAPI.searchByVolume

seekXRPlayback

seekXRPlayback(frameIndex: number): Promise<void>
Experimental
Jump to the frame with the specified index in the playback sequence. To get the total amount of frames in the sequence, see XRPlaybackProperties and getXRPlaybackProperties method.

Triggers a XRPlaybackStateChangedEvent.
Parameters
- frameIndex: number
  The index of the frame to jump to
Returns Promise<void>
Returns a Promise which reports wether the operation was successful or not

Inherited from RealityAPI.seekXRPlayback

selectCollection

selectCollection(
collectionID: number,
silent?: boolean,
): Promise<ChangeSelectionResult>
Parameters
- collectionID: number
  The ID of the collection.
- Optionalsilent: boolean
  If set to true, no event will be emitted. Default: false
Returns Promise<ChangeSelectionResult>
Deprecated
selectCollection is deprecated, please use setSelection instead.

Replaces the current selection with the nodes from the given collection.

Triggers a SelectionChangedEvent if silent is set to false.

Inherited from SelectionAPI.selectCollection

setAttachmentData

setAttachmentData(attachmentID: number, data: Serializable): void
Sets the attachment data.

Triggers an AttachmentDataChangedEvent.
Parameters
- attachmentID: number
  Specifies the attachment object.
- data: Serializable
  The new attachment data.
Returns void
Inherited from AttachmentAPI.setAttachmentData

setAttachmentDataURI

setAttachmentDataURI(attachmentID: number, dataURI: string): void
Sets the attachment data URI.
Parameters
- attachmentID: number
  Specifies the attachment object.
- dataURI: string
  The attachment data URI.
Returns void
Inherited from AttachmentAPI.setAttachmentDataURI

setInteractionMode

setInteractionMode(
mode: string | string[],
keepColorCompareActive?: boolean,
): void
Set the current interaction mode.
Parameters
- mode: string | string[]
  Specifies the interaction mode you want set.
- OptionalkeepColorCompareActive: boolean
  Specifies if the color comparison mode should stay active. Default: false
Returns void
Deprecated
Calling setInteractionMode with the mode parameter of type string or string[] is deprecated, please use the InteractionMode enum instead.

See
isColorComparisonActive

Inherited from InteractionAPI.setInteractionMode
setInteractionMode(
mode: InteractionMode,
keepColorCompareActive?: boolean,
): void
Set the current interaction mode.
Parameters
- mode: InteractionMode
  Specifies the interaction mode you want set.
- OptionalkeepColorCompareActive: boolean
  Specifies if the color comparison mode should stay active. Default: false
Returns void
See
isColorComparisonActive

Inherited from InteractionAPI.setInteractionMode

setLayerFilterEnabled

setLayerFilterEnabled(
name: string,
enabled: boolean,
): SetLayerFilterEnabledResult
Sets the enabled state of a single layer filter.

Triggers a LayerFilterChangedEvent.
Parameters
- name: string
  The name of the layer filter
- enabled: boolean
  The new enabled state.
Returns SetLayerFilterEnabledResult
The result of the operation.

Inherited from LayerFilterAPI.setLayerFilterEnabled

setMemberName

setMemberName(name: string): void
Experimental
Sets the name of the local member.
Parameters
- name: string
  The new name for the local member.
Returns void
Inherited from MemberAPI.setMemberName

setMemberProfileEntry

setMemberProfileEntry(key: string, value: Serializable): Promise<void>
Experimental
Sets a profile entry of the local member.
Parameters
- key: string
  The key of the profile entry to set.
- value: Serializable
  The value to set for the profile entry.
Returns Promise<void>
A promise that resolves when the profile entry has been set.

Inherited from MemberAPI.setMemberProfileEntry

setParent

setParent(nodeID: number, newParentID: number): void
Sets a new parent for a given node ID.

Triggers a NodeChangedEvent.
Parameters
- nodeID: number
  The ID of the node whose parent should be set.
- newParentID: number
  The ID of the new parent node.
Returns void
Inherited from InstanceGraphAPI.setParent

setProperty

setProperty<T extends string>(
    nodeID: number | number[],
    property: T,
    value: PropertyType<T>,
    silent?: boolean,
): Promise<void>
Sets the specified property to the given value on the node(s) with the specified ID(s).

Triggers a NodeChangedEvent. Depending on the property it can trigger additional events, e.g. ActiveSceneVolumeChangedEvent.
Type Parameters
- T extends string
Parameters
- nodeID: number | number[]
  The ID(s) of the node(s) whose property has to be set.
- property: T
  The name of the Property that has to be set.
- value: PropertyType<T>
  The new value of the specified property.
- Optionalsilent: boolean
  The silent flag indicates that no NODE_CHANGED event is fired. Default: false
Returns Promise<void>
Inherited from InstanceGraphAPI.setProperty

setSelection

setSelection(
nodeID: number | number[],
silent?: boolean,
): Promise<ChangeSelectionResult>
Replaces the current selection with the specified nodes.

Triggers a SelectionChangedEvent if silent is set to false.
Parameters
- nodeID: number | number[]
  The ID or array of IDs of the nodes to select.
- Optionalsilent: boolean
  If set to true, no event will be emitted. Default: false
Returns Promise<ChangeSelectionResult>
The result of the selection change.

Inherited from SelectionAPI.setSelection

setTopologyProperty

setTopologyProperty<T extends keyof TopologyPropertyTypeMap>(
    handle: TopologyHandle | TopologyHandle[],
    property: T,
    value: TopologyPropertyTypeMap[T],
): Promise<PromiseSettledResult<void>[]>
Sets a property of one or more topological entities.
Type Parameters
- T extends keyof TopologyPropertyTypeMap
  The property which should be set.
Parameters
- handle: TopologyHandle | TopologyHandle[]
  The topological entity or array of topological entities which should be modified.
- property: T
  The property which should be set.
- value: TopologyPropertyTypeMap[T]
  The new value of the property.
Returns Promise<PromiseSettledResult<void>[]>
A promise which resolves when the operation is completed.

Inherited from TopologyAPI.setTopologyProperty

setTopologySelection

setTopologySelection(handle: TopologyHandle | TopologyHandle[]): Promise<void>
Sets the current selection to the specified topological entities.
Parameters
- handle: TopologyHandle | TopologyHandle[]
  One or more topological entities that should be selected.
Returns Promise<void>
A promise which resolves when the operation is completed.
See
Inherited from TopologyAPI.setTopologySelection

setVariantEnabled

setVariantEnabled(variant: number, enabled: boolean): Promise<void>
Enables or disables a given Variant.
Parameters
- variant: number
  The ID of the Variant.
- enabled: boolean
  The enabled state.
Returns Promise<void>
Inherited from VariantsAPI.setVariantEnabled

setXRPlaybackBoomerang

setXRPlaybackBoomerang(boomerang: boolean): Promise<void>
Experimental
Specify whether the playback should "boomerang" (play forward and backward in a loop). This is useful for creating a seamless transition at the end of a sequence in terms of pose updates.
Parameters
- boomerang: boolean
  Whether the playback should boomerang or not
Returns Promise<void>
Returns a Promise which reports whether the operation was successful or not

Inherited from RealityAPI.setXRPlaybackBoomerang

setXRPlaybackFrameRange

setXRPlaybackFrameRange(startFrame: number, endFrame: number): Promise<number>
Experimental
Sets the frame range to play back. The total amount of frames in a sequence can be found in the XRPlaybackProperties.

Triggers a XRPlaybackStateChangedEvent.
Parameters
- startFrame: number
  The index of the first frame to play back
- endFrame: number
  The index of the last frame to play back
Returns Promise<number>
Returns a Promise which resolves with the new amount of frames in the playback if successful and rejects otherwise

Inherited from RealityAPI.setXRPlaybackFrameRange

setXRPlaybackSource

setXRPlaybackSource(url: string): Promise<number>
Experimental
Set the URL pointing to the manifest.json file of the frame sequence to be played back.

Triggers a XRPlaybackStateChangedEvent.
Parameters
- url: string
  The URL of the frame sequence
Returns Promise<number>
Returns a Promise which resolves with the amount of frames in the playback if successful and rejects otherwise

Inherited from RealityAPI.setXRPlaybackSource

setXRPlaybackSpeed

setXRPlaybackSpeed(speed: number): void
Experimental
Set the desired playback speed. The specified speed must be a value between 0 and 1. It gives the playback speed as a fraction of the original FPS which is stored in the XRPlaybackProperties.

Triggers a XRPlaybackStateChangedEvent.
Parameters
- speed: number
  The desired playback speed. Must be a value between 0 and 1.
Returns void
Inherited from RealityAPI.setXRPlaybackSpeed

showXRBackgroundFeed

showXRBackgroundFeed(): Promise<void>
Experimental
Starts putting the image feed into the viewer's background. Also see hideXRBackgroundFeed.

This will trigger a XRStateChangedEvent with XRState.backgroundFeedVisible set to true.

Returns Promise<void>
Returns a Promise which resolved when the operation was successful or rejects in an error case

Inherited from RealityAPI.showXRBackgroundFeed

shutdownSession

shutdownSession(): Promise<void>
Returns Promise<void>
Deprecated
The whole SessionAPI is under consolidation and will be replaced in a future release.

Shuts down a Session and disconnects all joined SessionMembers.

Inherited from SessionAPI.shutdownSession

startXRPlayback

startXRPlayback(): void
Experimental
Start the XR playback.

Make sure to set the playback source before starting the playback. Triggers a XRPlaybackStateChangedEvent.

Returns void
Inherited from RealityAPI.startXRPlayback

startXRSpectate

startXRSpectate(sessionMemberId: number): Promise<void>
Experimental
Starts spectating the XRImage stream published by the session member with the specified ID within a shared session. This will also hide any other background feed that is currently shown.
Parameters
- sessionMemberId: number
  The session member id of the member to spectate
Returns Promise<void>
Returns a promise which resolves when the operation was successful or rejects in an error case

Inherited from RealityAPI.startXRSpectate

stopXRPlayback

stopXRPlayback(): void
Experimental
Stop the XR playback.

Triggers a XRPlaybackStateChangedEvent.

Returns void
Inherited from RealityAPI.stopXRPlayback

stopXRSpectate

stopXRSpectate(): void
Experimental
Stops spectating the currently spectated XRImage stream of a session member.

Returns void
Inherited from RealityAPI.stopXRSpectate

storeSession

storeSession(): Promise<string>
Temporarily stores the session in the connected hub instance and returns an access handle.

This function does not transfer caches of referenced resources to the hub instance. For transferring caches, see transferSession.

Returns Promise<string>
The access handle of the stored session.

Inherited from SessionStorageAPI.storeSession

transferSession

transferSession(progressCallback: StoreSessionProgressCallback): Promise<string>
Experimental
Parameters
- progressCallback: StoreSessionProgressCallback
  Can be used to track the progress of the transfer.
Returns Promise<string>
The access handle of the transferred session.

Deprecated
transferSession with progress callback is deprecated. Please use transferSession without parameters and utilize the returned promise instead!

Transfers the session to the connected hub instance and returns an access handle.

Transfers caches of referenced resources to the hub instance if they are not already present.

Inherited from SessionStorageAPI.transferSession
transferSession(): Promise<string>
Experimental
Transfers the session to the connected hub instance and returns an access handle.

Transfers caches of referenced resources to the hub instance if they are not already present.

Returns Promise<string>
The access handle of the transferred session.

Inherited from SessionStorageAPI.transferSession

unanchorXR

unanchorXR(): void
Experimental
Unanchors the model. This will have the effect that the model will no longer be anchored to the real world.

This will trigger a XRStateChangedEvent with XRState.anchored set to false.

Returns void
Inherited from RealityAPI.unanchorXR

unregisterFrameListener

unregisterFrameListener(listener: FrameListener): void
Unregisters a frame listener which has previously been registered via registerFrameListener.
Parameters
- listener: FrameListener
  The listener to unregister.
Returns void
Inherited from FrameAPI.unregisterFrameListener

unregisterListener

unregisterListener(listenerID: number): void
Unregisters the event listener with the given ID.
Parameters
- listenerID: number
  The ID of the event listener that should be unregistered.
Returns void
See
EventAPI

Inherited from EventAPI.unregisterListener

useMemberAction

useMemberAction<A extends MemberAction>(
    memberId: number,
    action: A,
    options?: MemberActionsToOptionsMap[A],
): Promise<void>
Experimental
Uses an action on a member.
Type Parameters
- A extends MemberAction
Parameters
- memberId: number
  The ID of the member to use the action on.
- action: A
  The action to use.
- Optionaloptions: MemberActionsToOptionsMap[A]
  Optional parameters for the action.
Returns Promise<void>
A promise that resolves when the action has been used.

Inherited from MemberAPI.useMemberAction

waitFor

waitFor(state: ContextState): Promise<void>
Register a callback to a specific state. The callback is executed once when the state is reached. If webVis is already in that state the callback is triggered immediately.
Parameters
- state: ContextState
  The state for which a callback is registered
Returns Promise<void>
A promise which throws an error if the requested state is invalid

The following states are allowed as target init - Is reached when webVis is fully configured and set up.
resourceStateUpdated - Is reached when there is state information available for all resources (This information can also be "still transcoding").
resourceProcessed - This is triggered when all resources are done transcoding.
renderingFinished - This is triggered when webVis is done with rendering. So no more image changes are imminent.

Inherited from ContextStateAPI.waitFor

Was this page helpful? Please leave a thumbs up or down.

ContextAPI¶

Interface ContextAPI

Hierarchy (View Summary)

Index

Methods

Methods

add

Parameters

Returns number

Parameters

Returns number

Deprecated

addCustomNode

Parameters

Returns number

See

addToCollection

Parameters

Returns void

Deprecated

addTopologyToSelection

Parameters

Returns Promise<void>

See

addToSelection

Parameters

Returns Promise<ChangeSelectionResult>

anchorXR

Parameters

Returns void

changeAnnotation

Parameters

Returns AnnotationProperties

Parameters

Returns void

Deprecated

changeClippingRoom

Parameters

Returns ClipRoomProperties

Parameters

Returns ClipRoomProperties

Deprecated

changeClipPlane

Parameters

Returns ClipPlaneProperties

Parameters

Returns void

Deprecated

changeDrawing

Parameters

Returns DrawingProperties

changeDrawingPlane

Parameters

Returns DrawingPlaneProperties

changeMaterial

Parameters

Returns MaterialProperties

changeMeasurement

Parameters

Returns MeasurementProperties

See

changeSetting

Type Parameters

Parameters

Returns boolean

changeSnapshot

Parameters

Returns SnapshotProperties

Parameters

Returns SnapshotProperties

Deprecated

clear

Returns Promise<void>

clearSelection

Parameters

Returns Promise<ChangeSelectionResult>

clearTopologySelection

Returns Promise<void>

See

clipOtherParts