Class Viewer

The xeokit SDK's Browser-based model viewer.

See "@xeokit/sdk/viewer" for usage.

Hierarchy (View Summary)

Constructors

constructor

Properties

capabilities destroyed dirty id numViews renderer scene startTime viewList views

Methods

clean cleanIfDirty clear createView destroy fromParams setDirty tickify toParams

Events

onDestroyed onLog onTick onViewCreated onViewDestroyed

Constructors

constructor

  • new Viewer(
        params: {
            id?: string;
            origin?: FloatArrayParam;
            renderer: Renderer;
            scale?: number;
            scene?: Scene;
            units?: string;
        },
    ): Viewer

  • Creates a Viewer.

    Parameters

    • params: {
          id?: string;
          origin?: FloatArrayParam;
          renderer: Renderer;
          scale?: number;
          scene?: Scene;
          units?: string;
      }

      Viewer configuration.

      • Optionalid?: string

        ID for this Viewer, automatically generated by default.

      • Optionalorigin?: FloatArrayParam

        The Real-space 3D origin, in current measurement units, at which the World-space coordinate origin [0,0,0] sits.

      • renderer: Renderer

        Manages rendering of models.

      • Optionalscale?: number

        The number of Real-space units in each World-space coordinate system unit.

      • Optionalscene?: Scene

        Contains model representations. A Scene can be attached to a maximum of one Viewer - don't share a Scene between multiple Viewers.

      • Optionalunits?: string

        The measurement unit type. Accepted values are "meters", "metres", , "centimeters", "centimetres", "millimeters", "millimetres", "yards", "feet" and "inches".

    Returns Viewer

    Throws

    SDKError The given Renderer is already attached to some other Viewer.

Properties

Readonlycapabilities

capabilities: Capabilities

Indicates the capabilities of this Viewer.

Readonlydestroyed

destroyed: boolean

True once this Viewer has been destroyed.

Don't use this Viewer if this is false.

Protecteddirty

dirty: boolean

Readonlyid

id: string

ID of this Viewer.

numViews

numViews: number

The number of Views belonging to this Viewer.

The maxiumum number of Views that a Viewer can have is determined by the Renderer implementation it was configured with, which is provided in Capabilities.maxViews.

Readonlyrenderer

renderer: Renderer

The Renderer that this Viewer was configured with via the Viewer's constructor. Th Renderer is only used by the Viewer, and is not intended to for users to use directly. It's provided via this property in order to verify which Render implementation the Viewer is configured with.

Readonlyscene

scene: Scene

The Viewer's scene representation.

The !SceneModel | SceneModels is the container of !SceneModel | SceneModels and !SceneObject | SceneObjects, which contain the geometry and materials for models currently loaded in the Viewer.

ReadonlystartTime

startTime: number = ...

The time that this Viewer was created. This is the number of milliseconds since the epoch, which is defined as the midnight at the beginning of January 1, 1970, UTC.

Readonly InternalviewList

viewList: View[]

List of all the Views in this Viewer.

Each View is an independently configurable view of the Viewer's models, with its own canvas, camera position, section planes, lights, and object visual states.

Readonlyviews

views: { [key: string]: View }

Map of all the Views in this Viewer.

Each View is mapped here against View.id.

Each View is an independently configurable view of the Viewer's models, with its own canvas, camera position, section planes, lights, and object visual states.

Methods

Protectedclean

ProtectedcleanIfDirty

clear

createView

  • createView(viewParams: ViewParams): SDKError | View

  • Creates a new View within this Viewer.

    • The maximum number of views you're allowed to create is provided in Capabilities.maxViews. This will be determined by the Renderer implementation the Viewer is configured with.
    • To destroy the View after use, call View.destroy.
    • You must add a View to the Viewer before you can create or load content into the Viewer's Viewer.

    Usage

    const view1 = myViewer.createView({
         id: "myView",
         elementId: "myView1"
     });

    if (view1 instanceof SDKError) {
         console.log(view1.message);
    } else {
         view1.camera.eye = [-3.933, 2.855, 27.018];
         view1.camera.look = [4.400, 3.724, 8.899];
         view1.camera.up = [-0.018, 0.999, 0.039];

         //...
    }

    Parameters

    Returns SDKError | View

    View

    • On success.

destroy

fromParams

ProtectedsetDirty

tickify

  • tickify(cb: any): any

  • This method will "tickify" the provided cb function.

    This means, the function will be wrapped so:

    • it runs time-aligned to scene ticks
    • it runs maximum once per scene-tick

    Parameters

    • cb: any

      The function to tickify

    Returns any

toParams

Events

onDestroyed

onDestroyed: EventEmitter<Component, null>

Emits an event when the Component has been destroyed.

ReadonlyonLog

onLog: EventEmitter<Viewer, string>

Emits an event each time a message is logged.

ReadonlyonTick

onTick: EventEmitter<Viewer, TickParams>

Emits an event each time a Viewer "tick" occurs (~10-60 times per second).

ReadonlyonViewCreated

onViewCreated: EventEmitter<Viewer, View>

Emits an event each time a View is created.

ReadonlyonViewDestroyed

onViewDestroyed: EventEmitter<Viewer, View>

Emits an event each time a View is destroyed.

Settings

Member Visibility

On This Page

Constructors
Properties
Methods
Events