This page has been translated automatically.
UnigineScript
The Language
Core Library
Engine Library
Node-Related Classes
GUI-Related Classes
Plugins Library
High-Level Systems
Samples
Usage Examples
C++ API
API Reference
Integration Samples
Usage Examples
C++ Plugins
Migration
Migrating to UNIGINE 2.0
C++ API Migration
Migrating from UNIGINE 2.0 to UNIGINE 2.1
注意! 这个版本的文档是过时的,因为它描述了一个较老的SDK版本!请切换到最新SDK版本的文档。
注意! 这个版本的文档描述了一个不再受支持的旧SDK版本!请升级到最新的SDK版本。

Scene Navigation

In UnigineEditor, there are controls that are used to move in the scene and control the camera behavior. All the available controls can be found on the Navigation tab of the Controls window.

Notice
To open the Controls window, choose Window -> Controls on the main menu or press K on the keyboard.

The camera can be moved freely in the scene or relative to a target. In terms of UnigineEditor, the target is a point relative to which the camera is positioned. You can set the target by focusing the camera on a selected node or a group of nodes.

Notice
If the camera is not focused on a node, the position of the target coincides with the camera position.

Whether the target is set or not, you can freely navigate in the scene: move the camera, change direction of the camera (horizontally and vertically), track the camera or zoom it in and out.

If the camera is focused on a node (in other words - positioned relative to the target), you can also orbit the camera about the target and zoom it towards or away from the target by using the dolly zoom.

In addition to the commonly used terms (for example, Move left, Move up and so on), the following terms are used in UnigineEditor:

  • Change direction means changing the yaw / pitch angle to rotate the camera around its vertical / horizontal axis respectively.
  • Track (Crab) means tracking the camera in the plane which is perpendicular to the view direction.
  • Orbit means tumbling around the target.
  • Zoom (Dolly) means zooming the camera towards or away from the target so that the camera cannot continue to zoom in when it reaches the target.

The following schemes demonstrate the main navigation controls that are used in the UnigineEditor:

Navigation controls used to freely move the camera in the scene
Additional navigation controls used to move the camera relative to the target

Focusing the Camera

To set and reset the camera focus, you can use the following default controls:

ControlDescription
FFocus the camera on the selected nodes.
GReset the camera focus.

When you focus the camera on the group of nodes, you should set the pivot point (see Pivot Point Toggle for details) on the main menu:

  • If the pivot point is set to Center (the button is active), the target will be set to the center of selection.

    The Center button is active
  • If the pivot point is set to Pivot (the button is active), the target will be set to the last selected node.

    The Pivot button is active; Node 2 is the last selected node

If you focus the camera on the node (or the group of nodes), the target position will coincide with the center of the node (or the group of nodes). Therefore, you will be able to orbit the camera around this target and zoom (dolly) the camera towards or away from this target.

Moving the Camera

To move in the scene, you can use the following default controls:

ControlDescription
RIGHT CLICK + Drag Change the camera direction.
  • Press and hold this key and drag the mouse left or right to change the yaw angle. In this case, the camera will rotate around its vertical axis.
  • Press and hold this key and drag the mouse up or down to change the pitch angle. In this case, the camera will rotate around its horizontal axis.
RIGHT CLICK + WMove the camera forward.
RIGHT CLICK + SMove the camera backward.
RIGHT CLICK + AMove the camera left.
RIGHT CLICK + DMove the camera right.
RIGHT CLICK + QMove the camera down.
RIGHT CLICK + EMove the camera up.
Alt + MIDDLE CLICK + Drag Track (crab) the camera in the plane which is perpendicular to the view direction.
Alt + LEFT CLICK + Drag Orbit the camera about the target.

Also you can change the camera position by setting coordinates on the UnigineEditor navigation panel as follows:

Zooming the Camera

To zoom the camera, you can use the following default controls:

ControlDescription
WHEEL UPZoom the camera in.
Notice
If the camera reaches the target and continues zooming, the target will be moved with the camera.
WHEEL DOWNZoom the camera out.
Notice
When zooming out, the position of the target remains the same.
Alt + RIGHT CLICK + Drag Zoom (dolly) the camera toward or away from the target by using the dolly zoom.

Changing the Camera Speed

There are 3 modes of the camera speed. You can switch between them via the navigation panel. Also you can change the speed value set for one of the speed modes. For example, you can change the value of the 1st speed node as follows:

In addition, the following controls can be used to change the camera speed:

ControlDescription
ShiftSpeed up the camera movement. Press and hold this key when moving the camera.
1 / 2 / 3Enable the 1st, the 2nd or the 3rd mode of the camera speed.

Camera Utilities

ControlDescription
LToggle a flashlight attached to the camera.

Using Several Cameras

In a large virtual world, you can use cameras as watchpoints for fast navigation: you can add and position any number of the cameras in different points of the world, save their positions and then switch between them via the Camera panel when it is necessary.

To create such watchpoint:

  1. Add a new camera to the world.
  2. Position the camera.
The following pictures show 2 cameras positioned in different points in the world:

dock camera used as watch-point
dock camera view
dock_bouse camera used as watch-point
dock_house camera view

When you switch to one of the saved cameras, you can freely move it in the world: changes in its position and orientation won't be saved.

Notice
Make sure that the camera is locked ( is set on the Camera panel) before moving it. Otherwise, all changes in its position and orientation will be recorded and you will have to position and save the camera again.
To return to the saved position and orientation of the camera, unlock () it and then lock () again.
Last update: 2017-07-03
Build: ()