Create and edit scenes

Scene Editing

You can edit the content of that scene by either interacting with the content of the scene using the viewport, or by editing the properties of the scene’s nodes using the Property Editor.

A 3D scenes contains different types of data. The most common ones are:

  • Geometries
  • Cameras
  • Lights, including the default procedural sky or skydome
  • Materials and textures
  • Animations

Additional data may be displayed in the viewport such as the characters’ or animated object’s bones.

In PocketStudio, you can edit any of these types excepted animations. Each one of them may have limitations though. For example while you can change the position, the rotation or the scale of a geometry in a scene, in this version of PocketStudio you won’t be able to change the topology of the geometry itself. To do so, you will need to get back to your favorite modeling tool and re-import the geometry.

Regarding animations, you can play animations but you cannot edit them yet. You can import animations using the FBX, Alembic or glTF format.

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:

  1. Click on an object in the viewport. You know an object is selected because a line is drawn around it. It is highlighted.

  2. Select a node by clicking on its name in the Scene Graph.

    To open the scene graph, click on the icon 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.
Selecting the skydome or phsysical sky

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.

Deleting nodes

Press del to delete the selected nodes.

Duplicating nodes in a scene

  1. Select the nodes you wish to duplicate
  2. Press ctrl + c (copy) followed by ctrl + v (paste).
  3. 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).

  1. Open the scene you wish to to copy the nodes from
  2. Press ctrl + c to copy the nodes then close the scene
  3. Open the scene you wish to to copy the nodes to
  4. 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.

  1. Select one or more objects you wish to transform.
  2. 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.

ps docs orientation world local

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.

Each type of node in the scene graph has its own set of properties. For more information see Cameras, Lights and Materials.

Current limitations:

  • 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.