Skip to main content

3D Editing Helpers

3D Editing Helpers

The SceneComposer offers a set of editing helpers that allow editing 3D scenes as simple and intuitive as possible.

All editing aids, which have a visual presentation, are configurable so that the user can disable them easily if not desired. This can be done from the dialog that opens from "File" - "Preferences" menu under the "Editor" node, the "3D" option.

drawing-7-1760596795.png

In 3D scenes, SceneComposer offers the following entries in the 3D section of Editor-Preferences:

  • Navigation Controls 
  • Grid 
  • Snap to Grid 
  • Snap to Objects 
  • Selection help 
  • Default Camera

For more details about Exact camera view, please refer to Other 3D Editing Aids.

You can also find some 3D Editing Aids in the "View" menu in section "3D Editing Helpers".

drawing-5-1724403400.png

Navigation Controls

Lift factor

Lift refers to up and down moving and the lift factor represents a multiplication factor of moving up and down speed. 0 = no action. 
The greater the value the faster the camera is moved. Example values: 1, 1.5, 2

Strafe factor

Strafe refers to sidewise moving and strafe factor represents a multiplication factor of sidewise moving speed. 0 = no action. 
The greater the value the faster the camera is moved. Example values: 1, 1.5, 2

Rotation Pitch Angle

Rotation refers to rotation the camera around its position and rotation pitch angle represents the pitch rotation angle applied to the camera after 1 second at full rotation speed (mouse outside of the rotation button). 
The angle is specified in Degrees.

Rotation Yaw Angle

Angle represents the Yaw rotation angle applied to the camera after 1 second at full rotation speed (mouse outside of the rotation button). 
The angle is specified in Degrees.

Pivot Rotation Pitch Angle

Pivot rotation refers to orbiting - rotation of the camera around a pivot point (a point in the scene) and pivot rotation pitch angle represents the pitch pivot rotation (orbiting) angle applied to the camera after 1 second at full rotation speed (mouse outside of the rotation button). 
The angle is specified in Degrees.

Pivot Rotation Yaw Angle

Represents the Yaw pivot rotation (orbiting) angle applied to the camera after 1 second at full rotation speed (mouse outside of the rotation button). 
The angle is specified in Degrees.

Zoom Factor

Zoom refers to moving camera forward / backward (perspective) or scaling the camera view (orthographic). The Zoom factor represents a multiplication zooming factor. 0 = no action. 
The greater the value the faster the camera is zoomed. Example values: 1, 1.5, 2

drawing-7-1676363297.png

Snapping

3D Grid

Enable 3D Grid option, when it is checked, enables the grid in a scene 3D. Grid represents a collection of points (1px) laid at a configurable step size.

  • The grid is enabled by checking the checkbox "Enable" from the section Grid, in the "Preferences" - "Editor" - "3D" dialog. 
  • The grid is rendered in the background. 
Snap to Grid

Snap to grid enables an object to become aligned to the grid when being translated.

  • When snap to grid is enabled, the grid you set works as a magnet; when a selected object is moved, the grid points appear to pull on it when it approaches. This is useful for accurate placement of image elements. 
  • Snapping is enabled for all the global bounding box coordinates. 
  • To enable this feature check the checkbox "Enable" from the section "Snap to grid" and configure the desired sensitivity (the range is the distance to guideline where the object sticks to the point). 
Snap to Objects

Snap to objects enables an object to be aligned to another object's rendering area when being translated. The rendering area is the area that bounds the vertices of the bounding box of the object.

  • An object will be snapped to the closest other object in its proximity. 
  • Snapping is available for RenderNodes objects only. 
  • A render node is in the proximity of another object (thus will be snapped) if one of the eight points of its bounding box is in the proximity of the rendering area of the other object (rendering area is always a not-rotated rectangle and it bounds the points of the bounding box). 
  • The snap feature can be activated/deactivated by checking/unchecking the checkbox "Enable" from the section "Snap to objects" and the proximity range is configurable using the slide control "Sensitivity". 

Positioning

Selection Help

There are three different types available for selection helper.

  • Bounding box: when this option is selected, the user will be able to see the edges of the surrounding invisible bounding box. 
  • Region sphere:
    • Camera aligned bounding circle: on this mode the camera will always be oriented toward one bounding circle that will surround the bounding box of the selected object.
    • Static gimbal: a circle for each axis - X, Y, Z will be displayed - not aligned to the camera. 

The bounding circle will be visible just if the "Radius" property under the "Bounding Local Shapes" section will be set at a value greater than 0.

  • Both previous types are available. All the modes available for the "Region sphere" type will be available, too. 
Object alignment

Object alignment (X Min, X Mid, X Max, Y min, Y Mid, Y Max, Z min, Z Mid, Z Max / relative to other objects): this feature enables automatically re-positioning of selected objects such that they are aligned on a specific criterion.

First selected object serves as reference for alignment.

  • It could be very helpful to use any of the predefined orthogonal views (Front, Rear, Top, Bottom, Left, and Right) of the camera. 
  • The object alignment feature is available for the 3D scenes by selecting the appropriate button from the toolbar. Each button corresponds to a criterion of alignment. 
drawing-5-1724403834.png
Available criteria
  • X Min alignment: the selected objects (excluding the reference one) will be positioned such that the minimum point of the edge which corresponds to the X axis of their global bounding box is aligned to the minimum point of the edge which corresponds to the X axis of the first (reference) object's global bounding box. 
  • X Mid alignment: the selected objects (excluding the reference one) will be positioned such that the middle point of the edge which corresponds to the X axis of their global bounding box is aligned to the middle point of the edge which corresponds to the X axis of the first (reference) object's global bounding box. 
  • X Max alignment: the selected objects (excluding the reference one) will be positioned such that the maximum point of the edge which corresponds to the X axis of their global bounding box is aligned to the maximum point of the edge which corresponds to the X axis of the first (reference) object's global bounding box. 
  • Y Min alignment: the selected objects (excluding the reference one) will be positioned such that the minimum point of the edge which corresponds to the Y axis of their global bounding box is aligned to the minimum point of the edge which corresponds to the Y axis of the first (reference) object's global bounding box. 
  • Y Mid alignment: the selected objects (excluding the reference one) will be positioned such that the middle point of the edge which corresponds to the Y axis of their global bounding box is aligned to the middle point of the edge which corresponds to the Y axis of the first (reference) object's global bounding box. 
  • Y Max alignment: the selected objects (excluding the reference one) will be positioned such that the maximum point of the edge which corresponds to the Y axis of their global bounding box is aligned to the maximum point of the edge which corresponds to the Y axis of the first (reference) object's global bounding box. 
  • Z Min alignment: the selected objects (excluding the reference one) will be positioned such that the minimum point of the edge which corresponds to the Z axis of their global bounding box is aligned to the minimum point of the edge which corresponds to the X axis of the first (reference) object's global bounding box. 
  • Z Mid alignment: the selected objects (excluding the reference one) will be positioned such that the middle point of the edge which corresponds to the Z axis of their global bounding box is aligned to the middle point of the edge which corresponds to the X axis of the first (reference) object's global bounding box. 
  • Z Max alignment: the selected objects (excluding the reference one) will be positioned such that the maximum point of the edge which corresponds to the X axis of their global bounding box is aligned to the maximum point of the edge which corresponds to the Z axis of the first (reference) object's rendering area. 
drawing-7-1676363633.png
Pivot 3D

The translate mode is possible only for the selected object or for the selected objects and its children.

drawing-5-1724404192.png
  • "ObjectOnly": translate only object 
  • "ObjectAndChildren": translate object and its children 

Default Camera

You can set the default camera for each Scene Editor (Scene Editor -0 through Scene Editor -3). The available default cameras are the Editor Camera, Scene Camera, and Orthogonal Cameras (Front/Rear/Top/Bottom/Left/Right).

drawing-7-1760596887.png

When the default camera is set to "Scene Camera", the first Camera node in the scene, in alphabetical order by name, is used. If the scene does not contain any Camera nodes, the Editor camera will be used instead.


Other 3D Editing Aids

Other 3D editing helpers available in SceneComposer are:

Exact Camera View in Scene Editor

"Exact Camera View" menu option will make the camera from the scene to ignore the current aspect ratio of the scene render.

  • When Exact Camera View is disabled the view of the active camera is stretched on the available rendering surface. 
  • When Exact Camera View is enabled, SceneComposer makes additional computations on the camera so that the camera view image does not get distorted on the scene rendering panel. 
  • Using this mode may lead to different output compared to the rendering output on display (the display on which the camera renders). 
drawing-5-1724412443.png
drawing-5-1724412453.png
Zoom to Selected Objects

Zoom to selected objects offers a shortcut command by using the "A" key for zoom operation on previous selected object. This functionality is available only in producer camera (perspective and orthogonal camera).

Zoom to Scene

Zoom to scene offers a shortcut command by using the "F" key for zoom operation on the current scene. This functionality is available only in producer camera (perspective and orthogonal camera).

"A" and "F" keys are activating the "Scene" or "Selection" option of the combobox from Toolbar.