VIRTUAL EDITOR FUNCTIONS
Transformations
The click & drag transformation icons
work in three different ways, as follows:
Left mouse button, for view-relative translations/rotations.
Note that view pitch is ignored unless the [P] key is held pressed.
Right mouse button, for object-relative translations/rotations
Middle mouse button (or right mouse button + [Shift]), for world-relative translations/rotations.
World axes directions are represented by the red (X), green (Y) and blue (Z) crosshair.
Rotational transformation will snap to fixed values if the [Ctrl] key is held pressed.
Scaling icons may also be available for some objects, but resizing is always object-relative.
Scaling will be uniform (all axes) if the [Ctrl] key is held pressed while resizing.
Cursor
The crosshair is the Virtual Editor's 3d cursor.
You can place the cursor on an object by right-clicking the object in the Virtual Editor.
All rotations in the Virtual Editor are always about the cursor.
Clicking an object with the middle mouse button (or RMB+[Shift]) moves the cursor to
the natural center of the object.
NOTE: you can place the cursor to an object's center of mass (if it is defined),
by holding the [M] key pressed while right-clicking the object.
NOTE: you can snap together objects designed as modules you can assemble (like road elements for example)
by pressing the [S] key.
View
You move the editor camera about the cursor by clicking the Virtual Editor window
anywhere and dragging the mouse. View distance can be adjusted with the mouse-wheel
or by pressing the [PageUp]/[PageDown] keys.
2D Objects
If the current object is a 2D element (for example a sprite), you can click and drag to place it.
Dragging with the right mouse button scales it. Hold the [Ctrl] key to stretch it.
Other functions
To undo the last editing action, press [Ctrl]+[Z]. To re-do it press [Ctrl]+[Y].
There are up to 32 undo levels.
To add a new object to the project, press [Ctrl]+[A].
To clone the current object, press [Shift]+[A].
To remove the current object from the project, press [Delete].
To copy the settings from an object to another compatible object without opening their property dialogs,
select the source object, press [Ctrl]+[C], select the destination object, press [Ctrl]+[V].
NOTE: press [Ctrl]+[Shift]+[V] to copy all settings except orientation, location, scaling (where
these are applicable).
OBJECT LIST FUNCTIONS
The items in the Object List
can be selected with a click. Double clicking opens the properties dialog for the object.
The order of the items can be set by dragging them with the mouse.
Checkboxes near unselected items indicate what objects are linked to the current object.
NOTE: to switch the linked/unlinked state, either click a checkbox on the Object List
or right-click an object in the Virtual Editor window while holding [L] pressed
Linking/Un-linking Multiple Items At Once
You can link/unlink all objects between the red one and the clicked one
by holding the [Left-Shift] key pressed (link all objects to all objects) or the [Left-Ctrl]
key pressed (link all objects to the red one).
It is also possible to specify codes in the name of objects in the Object List, so that, when you link an object with a certain
code to another object, all objects that have the same code in the name get automatically linked to that object as well.
For example, imagine you have a ragdoll made of multiple RigdBody objects. If you name the RigdBody objects like
'Head #31', 'Torso #31', 'LeftArm #31' and so on, then, when you link for example the
'Head #31' object to the terrain object (to enable collision detection) all the other ragdoll elements will
get linked to the terrain automatically, because they all contain '#31' in the name too.
NOTE: this feature is useful in particular to addon authors because it allows you to hide all objects in a group except
one, thus making the task of connecting the addon to the main project easier, for the final user.
Hiding/Showing Objects In The Editor Window
Right clicking an unselected item on the Object List hides the object in the Virtual Editor.
Clicking (selecting) a hidden object automatically shows it in the Virtual Editor.
If you left-click an unselected item while the right mouse button is pressed the
currently selected object is hidden in the Virtual Editor.
Property Dialog Preview
A preview of the property dialog
appears when the mouse hovers over an item in the Object List.
This preview can be set to only appear when MMB is clicked,
by checking the
Object -> Use Middle-Mouse-Button For Properties Preview
option in the pull-down menu.