HTMLCanvasElement that the viewer operates on. Defined only when the viewer is initialized.
List of canvas events, such as mouse events or pointer events or touch events that the viewer should listen to and redirect to the draggers and components.
By default, the following events are redirected:
The Client instance that is used to load model reference files from the Open Cloud Server.
List of names of available components.
List of names of available draggers.
The following draggers are available by default:
For a quick reference on how to implement your own dragger, see IDragger.
Statistical information about the GPU memory and the rendering process.
List of active loaders used to load models into the viewer.
List of models loaded into the viewer.
Viewer options.
Returns the active dragger reference, or null if there is no active dragger.
Registers a new listener for the event type.
The type of event to listen to.
The function that gets called when the event is fired.
Unloads an open file, clears the canvas and markups, and deactivates the active dragger.
Fires:
Saves the viewer state as a viewpoint.
To save a viewpoint to the Open Cloud Server for a specific file, use the File.saveViewpoint().
Fires:
The object handle or list of handles. To avoid collisions across models in multi-model scenes, use composite handles in the form "model:handle". All handles in the list must be in the same format.
Unloads an open file, clears the canvas and markups, and releases resources allocated by this viewer
instance. Call this method before releasing the Viewer instance.
Sets the viewer state to the specified viewpoint.
To get a list of available viewpoints from the Open Cloud Server for a specific file, use the
File.getViewpoints().
Fires:
Viewpoint data.
Fires the event. Alias to emitEvent().
The type of event that gets fired.
The event properties.
Fires the event. Calls each of the listeners registered for the event type event.type, in the
order they were registered.
The event that gets fired.
Executes the command denoted by the given command ID. If the command is not found, tries to set active dragger with the specified name.
Command ID or dragger name.
Parameters passed to the command handler function.
Returns the result of the command handler function or new active dragger instance. Returns
undefined if neither the command nor the dragger exists.
Explode index. Range is 0 to 100.
Returns the component reference, or null if there is no component with the specified name.
Component name. Can be one of the components list.
Returns a list of handles for the hidden objects.
Special cases:
Optionalmultimodel: booleanSpecifies if the returned handles should be formatted for a multi-model scene:
false (default): Returns raw handles as stored in the file. Useful for single-model scenes.true: Returns composite handles in the form model:handle. Useful for multi-model scenes.Returns a list of handles for the isolated objects.
Optionalmultimodel: booleanSpecifies if the returned handles should be formatted for a multi-model scene:
false (default): Returns raw handles as stored in the file. Useful for single-model scenes.true: Returns composite handles in the form model:handle. Useful for multi-model scenes.Returns a list of handles for the selected objects.
Optionalmultimodel: booleanSpecifies if the returned handles should be formatted for a multi-model scene:
false (default): Returns raw handles as stored in the file. Useful for single-model scenes.true: Returns composite handles in the form model:handle. Useful for multi-model scenes.Creates a snapshot image of the current viewer state.
If the viewer has an active markup, combines the viewer canvas with the markup overlay. Otherwise, captures only the viewer canvas.
Optionaltype: stringThe MIME type of the image format. Can be one of:
image/png - PNG format with lossless compression (recommended for quality)image/jpeg - JPEG format with lossy compression (smaller file size)image/webp - WebP format (modern browsers only)If not specified, uses snapshotMimeType option.
Optionalquality: numberA number between 0 and 1 indicating the image quality for lossy formats. If not specified, uses snapshotQuality option.
A Data URL string containing the snapshot image.
The object handle or list of handles. To avoid collisions across models in multi-model scenes, use composite handles in the form "model:handle". All handles in the list must be in the same format.
Initializes the viewer with the specified canvas. Call dispose() to release allocated resources.
Fires:
HTMLCanvasElement that the viewer operates on.
OptionalonProgress: (event: ProgressEvent) => voidA callback function that handles events measuring progress of viewer initialization.
Returns true if the currently opened model is a 3D model.
Returns true if viewer has been initialized.
Isolates the specified objects. If selected objects are hidden during isolation, they become unselected.
If no objects specified then all objects became hidden.
Fires:
The object handle or list of handles. To avoid collisions across models in multi-model scenes, use composite handles in the form "model:handle". All handles in the list must be in the same format.
Removes the listener from an event type. Alias to removeEventListener().
The type of the event that gets removed.
The listener function that gets removed.
Registers a new listener for the event type. Alias to addEventListener()
The type of event to listen to.
The function that gets called when the event is fired.
Loads a file into the viewer.
The viewer must be initialized before opening the file. Otherwise, open() does
nothing.
This method requires a Client instance to be specified to load file from the Open Cloud Server.
The file geometry data on the Open Cloud Server must be converted into a format suitable for the
viewer, otherwise an exception will be thrown.
For files from the Open Cloud Server, the default model will be loaded. If there is no default model, the first available model will be loaded. If no models are found in the file, an exception will be thrown.
For URLs, the file extension is used to determine the file format. For a ArrayBuffer and Data URL, a file format must be specified using params.format parameter. If no appropriate loader is
found for the specified format, an exception will be thrown.
If there was an active dragger before opening the file, it will be deactivated. After opening the file, you must manually activate the required dragger.
Fires:
File to load. Can be:
File, Assembly or Model instance from the Open Cloud ServerURL stringLoading parameters.
Optionalformat?: stringFile format. Required when loading a file as ArrayBuffer or Data URL.
Optionalmode?: stringFile opening mode. Can be one of:
file - Single file mode. Unloads an open file and opens a new one. This is default mode.assembly - Multi-model mode. Appends a file to an already open file. This mode is not supported
for all viewers.OptionalmodelId?: stringUnique model ID for opened file in the multi-model scene. Used as a model
prefix when selecting, hiding or isolating objects. Must not contain the ":" (colon). Required
when loading a file as ArrayBuffer or Data URL. Default value depends on the FileSource:
file ID - when loading a file from Open Cloud Server.file name - when loading from local File or URL.OptionalrequestHeader?: HeadersInitThe request header used in HTTP request.
OptionalwithCredentials?: booleanWhether the HTTP request uses credentials such as cookies, authorization headers or TLS client certificates. See XMLHttpRequest.withCredentials for more details.
If type is specified, removes all registered listeners for type, otherwise removes all registered
listeners.
Optionaltype: stringThe type of the listener that gets removed.
Removes the listener for the event type.
The type of the event that gets removed.
The listener function that gets removed.
Resets the state of the active dragger.
The object handle or list of handles. To avoid collisions across models in multi-model scenes, use composite handles in the form "model:handle". All handles in the list must be in the same format.
Changes the active dragger. The viewer must be initialized before activating the dragger, otherwise an exception will be thrown.
Fires:
Dragger name. Can be one of the draggers list or an empty string to deactivate the current dragger.
Returns the new active dragger reference or null if there is no dragger with the given
name.
Optionalhandles: string | string[]The object handle or list of handles. To avoid collisions across models in multi-model scenes, use composite handles in the form "model:handle". All handles in the list must be in the same format.
Deprecated since 27.11. Use setSelected instead.
Optionalhandles: string | string[]Resizes the output canvas to (width, height) with device pixel ratio taken into account.
Fires:
The width of the canvas.
The height of the canvas.
OptionalupdateStyle: booleanSetting updateStyle to false prevents any style changes to the output canvas.
The object handle or list of handles. To avoid collisions across models in multi-model scenes, use composite handles in the form "model:handle". All handles in the list must be in the same format.
Creates an overlay view. Overlay view is used to draw cutting planes and markups.
Toggles the selection of the specified objects by handles:
Fires:
The object handle or list of handles. To avoid collisions across models in multi-model scenes, use composite handles in the form "model:handle". All handles in the list must be in the same format.
Optionalforce: number | booleanIf true, updates the viewer immediately. If a number is specified and more than
the given amount of milliseconds has elapsed since the last rendering, the update is performed
immediately as well. Otherwise, the update will be scheduled for the next animation frame. Default
is false.
The object handle or list of handles. To avoid collisions across models in multi-model scenes, use composite handles in the form "model:handle". All handles in the list must be in the same format.
Viewer core interface.