Player API

Modules

Camera

This module is for manipulating the camera.

Configurator

This module is for manipulating the configuration.

Player

This is the root player api.

Scene

This module is a high level scene graph manipulation and query library.

• Either id, name, or regex's can be used for node names.
• All get functions return the value, or undefined if no match is found
• All find functions return an id or a Path
• All filter functions return an array of id or Path

Tools

This module is for manipulating tools. The default set of tools installed will handle scene navigation (orbit, pan, zoom) for both mice and touch interfaces.

Members

includes ⇒ boolean

Check if a selectionSet includes a node.

Functions

toggle(query)

toggle nodes in a selectionSet

add(query)

add nodes to selectionSet.

remove(query)

remove nodes from selectionSet.

clear()

remove all nodes from selectionSet

set(query)

clear the selectionSet and add nodes from query equivalent to call clear and add together.

getStyle()

get the selectionSetStyle, including outlineColor, outlineThinkness, color and opacity

setStyle(selectionSetStyle)

set the selectionSetStyle, including outlineColor, outlineThinkness, color and opacity

Camera

This module is for manipulating the camera.

• Camera
  • ~orbit(dx, dy)
  • ~pan(dx, dy)
  • ~zoom(delta)
  • ~frameBoundingSphere([assetIds], [direction], [options])

Camera~orbit(dx, dy)

Orbit the active camera.

Kind: inner method of Camera

Example

player.camera.orbit(1, 0);

Camera~pan(dx, dy)

Pan the active camera.

Kind: inner method of Camera

Example

player.camera.pan(1, 0);

Camera~zoom(delta)

Zoom the active camera.

Kind: inner method of Camera

Example

player.camera.zoom(1);

Camera~frameBoundingSphere([assetIds], [direction], [options])

frame the active camera.

Kind: inner method of Camera

Example

player.cameraController.frameBoundingSphere();

Configurator

This module is for manipulating the camera.

Configurator~prefetchAttributes(attributes) ⇒ Promise

pretch all images for attributes options in 2d player

Kind: inner method of Configurator

Example

await api.configurator.prefetchAttributes(['Rotation'])

Player

This is the root player api.

• Player
  • .assetId : string
  • .camera : Camera
  • .selectionSet : SelectionSet
  • .scene : Scene
  • .THREE : THREE
  • .unload
  • .setImagePlaceholderMode
  • .getConfigurator() ⇒
  • .on(event, handler)
  • .when(event) ⇒ Promise
  • .setActiveCamera(id)
  • .snapshot([options]) ⇒ string

Player.assetId : string

The root asset id attached to the player

Kind: static property of Player

Player.camera : Camera

The camera controller module

Kind: static property of Player

Player.selectionSet : SelectionSet

The selectionSet controller module

Kind: static property of Player

Player.scene : Scene

The scene module

Kind: static property of Player

Player.THREE : THREE

The three.js math modules

Kind: static property of Player

Player.unload

Kind: static property of Player

Player.setImagePlaceholderMode

Kind: static property of Player

Player.getConfigurator() ⇒

Returns a promise that resolves to the active configurator.

Kind: static method of Player
Returns:

Promise

Player.on(event, handler)

Add event listener

Kind: static method of Player

Example

player.on(player.scene.PHASES.LOADED, () => console.log('loaded'));

Player.when(event) ⇒ Promise

Return a promise that resolves when phase has been reached

Kind: static method of Player

Example

await player.when(player.scene.PHASES.LOADED);

Player.setActiveCamera(id)

Set the active camera.

Kind: static method of Player

Example

player.setActiveCamera("42a3d1ef-5c42-4276-8a14-665d58d8174c");

Player.snapshot([options]) ⇒ string

Return a snapshot of the player encoded in base 64

Kind: static method of Player

Example

player.snapshot({ mimeType: "image/jpeg"});

Scene

This module is a high level scene graph manipulation and query library.

• Either id, name, or regex's can be used for node names.
• All get functions return the value, or undefined if no match is found
• All find functions return an id or a Path
• All filter functions return an array of id or Path

• Scene
  • ~find(query)
  • ~fetch(id)
  • ~alignNode(nodeId, alignNodeId)
  • "PHASES"

Scene~find(query)

Finds first matching node. (See {@tutorial sdk-SceneGraph})

Kind: inner method of Scene

Example

// Return the node uuid
scene.find({ name: 'Box' }); -> ['uuid']
// Return the path to the transform operator
scene.find({ name: 'Box', plug: 'Transform', property: 'translation' }); -> ['uuid','plugs','Transform',0]
// Match the first node that starts with Box
scene.find({ name: 'Box*' });

Scene~fetch(id)

Fetch an asset, to make it available for querying sceneGraph data.

Kind: inner method of Scene

Scene~alignNode(nodeId, alignNodeId)

Move nodeId to align with alignNodeId, optionally using anchorNodeId to do the alignment.

Kind: inner method of Scene

Example

// Move the sword to place the sword handle in the hand
scene.alignNode(swordId, handId, { anchorNodeId: swordHandleId, withRotation: true });

"PHASES"

There are three events that are triggered in turn as the scene loads: PRELOADED, LOADED, and RENDERED.

Kind: event emitted by Scene
Read only: true
Properties

Tools

This module is for manipulating tools. The default set of tools installed will handle scene navigation (orbit, pan, zoom) for both mice and touch interfaces.

• Tools
  • ~addTool(toolName)
  • ~addTools(toolNames)
  • ~removeTool(toolName)
  • ~removeTools(toolNames)
  • ~setPrimary(toolName)
  • ~getPrimaryTool() ⇒ string

Tools~addTool(toolName)

Add a tool to the player.

Kind: inner method of Tools

Example

player.addTool('orbit')

Tools~addTools(toolNames)

Add an array of tools to the player.

Kind: inner method of Tools

Example

player.addTools(['pan', 'orbit', 'zoom'])

Tools~removeTool(toolName)

Remove a tool from the player.

Kind: inner method of Tools

Example

player.removeTool('orbit')

Tools~removeTools(toolNames)

Remove an array of tools from the player.

Kind: inner method of Tools

Example

player.removeTools(['pan', 'orbit', 'zoom'])

Tools~setPrimary(toolName)

Set a tool as Primary tool.

Kind: inner method of Tools

Example

player.setPrimary('zoom')

Tools~getPrimaryTool() ⇒ string

Get the current primary tool.

Kind: inner method of Tools
Returns: string -

primaryToolName

player.getPrimaryTool()

includes ⇒ boolean

Check if a selectionSet includes a node.

Kind: global variable

toggle(query)

toggle nodes in a selectionSet

Kind: global function

Example

selectionSet.add({ name: 'Box' });

add(query)

add nodes to selectionSet.

Kind: global function

Example

selectionSet.add({ name: 'Box' });

remove(query)

remove nodes from selectionSet.

Kind: global function

Example

selectionSet.remove({ name: 'Box' });

clear()

remove all nodes from selectionSet

Kind: global function

set(query)

clear the selectionSet and add nodes from query equivalent to call clear and add together.

Kind: global function

getStyle()

get the selectionSetStyle, including outlineColor, outlineThinkness, color and opacity

Kind: global function

setStyle(selectionSetStyle)

set the selectionSetStyle, including outlineColor, outlineThinkness, color and opacity

Kind: global function

Example

selectionSet.setStyle({ outlineColor: '#00ff00', outlineThinkness: 5, color: '#ff0000', opacity: 0.5 });