SessionStorageAPI

• webVis API Reference
• SessionStorageAPI

Interface SessionStorageAPI

With these functions the user can control webvis' management of SessionStorage objects and Snapshots.

The Session describes the whole state of the 3D Space, which can be shared, stored and restored. Snapshot are a subset of a 3D Space and describe a momentary state, which can include other elements of the 3D Space like Clipplanes and Measurements.

Hierarchy

• SessionStorageAPI
  • ContextAPI

Index

Methods

changeSnapshot createSnapshot getSnapshotData getSnapshots importSession isOfflineStorageAvailable removeSnapshot requestSnapshotData restoreSession restoreSnapshot storeSession

Methods

changeSnapshot

• changeSnapshot(snapshotID: number, properties: SnapshotProperties): SnapshotProperties

• Changes one or more properties of a Snapshot with the specified ID.

  Parameters

  • snapshotID: number

    The ID of the Snapshot you want to change.

  • properties: SnapshotProperties

    The properties of the Snapshot you want to change.

  Returns SnapshotProperties

  An object with the changed Properties.

• changeSnapshot(snapshotID: number, name?: string, screenshotURL?: string, order?: number): SnapshotProperties

• This changes the textual description of the Snapshot for given snapshotID to the value of text.

  Deprecated

  Calling changeSnapshot with single parameters is deprecated, please use SnapshotProperties instead.

  Parameters

  • snapshotID: number

    The ID of the Snapshot.

  • Optional name: string

    The new name of the Snapshot.

  • Optional screenshotURL: string

    The new screenshot URL of the Snapshot.

  • Optional order: number

  Returns SnapshotProperties

createSnapshot

• createSnapshot(name?: string, options?: SnapshotCreationOptions): Promise<number>

• Creates a Snapshot of the current.

  Parameters

  • Optional name: string

    The Name of the Snapshot.

  • Optional options: SnapshotCreationOptions

    Options used for the Snapshot creation.

  Returns Promise<number>

  The Snapshot ID.

getSnapshotData

• getSnapshotData(snapshotID: number): { attachmentID: number; name: string; order: number }

• Deprecated

  getSnapshotData is deprecated, please use requestSnapshotData instead.

  Parameters

  • snapshotID: number

  Returns { attachmentID: number; name: string; order: number }

  The data of the specified Snapshot.

  • attachmentID: number

  • name: string

  • order: number

getSnapshots

• getSnapshots(): number[]

• Returns the ids of all available Snapshots.

  Returns number[]

  The ids of all available Snapshots.

importSession

• importSession(data: any, format?: "xscn"): Promise<any>

• Imports a session from the data string of the given format. Supported formats are: JSON.

  Parameters

  • data: any

    the content of the file.

  • Optional format: "xscn"

  Returns Promise<any>

isOfflineStorageAvailable

• isOfflineStorageAvailable(): Promise<boolean>

• Checks if offline storage is currently available.

  Returns Promise<boolean>

removeSnapshot

• removeSnapshot(snapshotID: number): void

• Deletes the Snapshot for given snapshotID.

  Parameters

  • snapshotID: number

  Returns void

requestSnapshotData

• requestSnapshotData(snapshotID: number): Promise<SnapshotProperties>
• Parameters

  • snapshotID: number

  Returns Promise<SnapshotProperties>

  The data of the specified Snapshot.

restoreSession

• restoreSession(handle: string): Promise<void>

• Imports the Session for the given data handle from the infrastructure.

  Parameters

  • handle: string

  Returns Promise<void>

restoreSnapshot

• restoreSnapshot(snapshotID: number, options?: SnapshotRestoreOptions): Promise<void>

• Restores the Snapshot for the given snapshotID. The settings parameter allows to control the subset of the Snapshot data to be restored.

  Parameters

  • snapshotID: number

  • Optional options: SnapshotRestoreOptions

  Returns Promise<void>

storeSession

• storeSession(offline?: boolean, progressCallback?: StoreSessionProgressCallback): Promise<string | void>

• Temporarily stores the Session in the infrastructure and returns a handle.

  Parameters

  • Optional offline: boolean

    sets the space domain to the local one

  • Optional progressCallback: StoreSessionProgressCallback

  Returns Promise<string | void>