Scene State

Modified on Tue, 12 Nov at 12:28 PM

Scene State

Note: The 3D models added in a scene are not visible in the Spatial Workplace app by default. To make the whole model or certain parts of it visible, add a scene state node to the workflow.

Connector view

To access the connector view, click on Connector in the top menu of the editor. The connector pane opens next to the main scene.

In the connector view, the spatial references and pins of the workflow can be seen as nodes in a 2D representation of their connections.

Scene state nodes

A scene state node performs a modification in the scene of the workflow. There are two different types of modifications in a single node:

Visible: The selected model or part becomes visible to the user.
Reset transform: If the selected model or part has been moved from its original place, this is undone and reset to its default state.

To change the visibility and add a scene state node:

Open the connector view, and click on Add > Scene State Node.
Click on the node to select it and, on the right, click on Add Scene Modifier > Visible.

3. Click on Add Targets to open the selection screen and select the parts of the model to make visible.

4. To make the whole model visible, open the scene explorer on the left, select the top assembly, and press EnterThe selected model is now highlighted in the scene. You can also choose just one of the parts to make it visible.

Note: Workflows with interactable elements are only supported by HoloLens.

In the example below, the first scene state node is added between the spatial reference and pin 1. This means that when the workflow starts, this scene state will already be loaded before pin 1 is shown.
Two changes are added to this node using the Add Scene Modifier button, making the target of the modification both interactable and visible. The user can add any number of targets to a modification.
In this case, the whole "arm" model was selected to make the entire robot arm visible and intractable. In any case, selecting a scene state node highlights the part that it modifies in the 3D scene.

add scene state nodes between spatial reference and pin.png

When pin 1 is loaded in the Spatial Workplace app, the user can see the model and interact with it. When the user clicks on Done in pin 1, the workflow goes through scene state 2.
This scene state contains a Reset Transform node with the selected arm part being the target. When activated, it resets the position of the model to its original state.

Recommended video links for this guide:

Frontline Spatial | Scene States and condition