Create and edit scenes
A 3D scenes contains different types of data such as:
You can edit the nodes of a scene either interactively using the viewport, or manually by editing the properties of the scene’s nodes using the Property Editor.
You can import (using the FBX, Alembic or glTF format) and play animations in PocketStudio but you can’t edit them in the application itself at the moment.
The scene scale in PocketStudio is 1 unit = 1 meter (See preferences for more info). The grid that is drawn centred on the origin in preview mode is 20x20m, with each square in the grid representing 1m².
If a parameter does not explicitly state its units (focal length for example states that its units are millimeters), then its units is in meters or degrees depending on whether it is a distance or an angle. For example, the subsurface radius parameters is expressed in meters. A good value for a human avatar should thus be somewhere between 0.1 and 0.25.
In the preview mode, geometry is rendered single sided by default. You can toggle on double sidedness with this checkbox. In RTX/High-Quality mode, objects are always rendered as double sided.
Single vs double sided shading (backface culling) example:
In order to edit a node you will first need to select it. You can do so using either one of the two following options:
Click on an object in the viewport. You know an object is selected because a line is drawn around it. It is highlighted.
Select a node by clicking on its name in the Scene Graph.
To open the scene graph, click on theicon located in the upper left corner of the application (below the Import Panel icon). This icon is a toggle. Clicking on it will turn the Scene Graph panel on and off.
Walking through the scene hierarchy using keys: you can move from one node to another in the scene hierarchy using the ← and → keys. You can also select a node’s parent or child using the ↑ and ↓ keys.
You can select multiple objects at once. In the Viewport, draw a rectangle around the objects you want to select. All objects contained in that rectangle will be selected. Using the Scene Graph:
- Hold down the Alt key and click to select or deselect nodes one by one.
- Hold down the shift key and click in two different parts of the tree to select all nodes contained between these two locations.
- Hold down the shift key and with the pressed, drag the mouse over the nodes you want to select.
Each scene is created by default with a physical sky or a skydome (you can switch between them). This light can not be selected from the Scene Graph. To display its properties you need to click on the sky itself in the viewport. See lights: physical sky.
Press del to delete the selected nodes.
Duplicating nodes in a scene
- Select the nodes you wish to duplicate
- Press ctrl + c (copy) followed by ctrl + v (paste).
- Duplicated objects are selected after the copy. Move them around to separate them from the original nodes.
Duplicating nodes from one scene to another
It is also possible to copy nodes from one scene to another (within the same project - you cannot copy nodes from one project to another).
- Open the scene you wish to to copy the nodes from
- Press ctrl + c to copy the nodes then close the scene
- Open the scene you wish to to copy the nodes to
- Press ctrl + v to paste the nodes in that scene
Special UI objects called gizmos are displayed in the viewport to help you transform objects interactively. Each type of transform (translation, rotation, scaling) has its own gizmo.
- Select one or more objects you wish to transform.
- Press one of the following keys:
- W to get the move gizmo
- E to get the rotate gizmo
- R to get scale gizmo
Alternatively you can select a node (using the Viewport or the Scene Graph) and edit the translation, rotation or scale values of that node in the Property Editor.
Local and world transformations
Press F8 to toggle between local and world transformations.
Select the objects you want to hide, then press ctrl + H to hide them.
Alternatively each node has a Visibility property that you can toggle on and off in the Property Editor.
Select the invisible nodes from the Scene Graph panel, then press shift + H to show them.
Every time you select a node either through the viewport or through the Scene Graph panel, the Property Editor panel will be refreshed with the properties of the selected node. Once the properties of a node (a geometry, a light, a camera, etc.) are displayed in the Property Editor panel, you can then edit them manually.
The way you can edit a property depends on the property types. For example if the property is a float, you can simply enter a new value for that property by hand. You can also use the arrow keys along side the property’s text field in order to increment or decrement the value by a regular amount. If the property is of color type, clicking on this attribute to edit its value will open the Color Editor window.
You will need to select the nodes one by one in order to edit their properties. There is no API available yet to edit these values with a script.
- Properties cannot be animated yet.
- Values of properties cannot be set or accessed through an API yet.
Use the following keys:
- undo: ctrl + Z
- redo: ctrl + Y
If you edit a scene with others simultaneously, you can only undo-redo your own changes.
A few properties belong to the scene itself. These properties are the fog color and the fog distance.