w3dToolbar
Documentation of its tools.


toggle w3dToolbar On/Off

With this button you can switch the w3dToobar on and off.


If the w3dToobar is switched off, the w3dToolbar does nothing.


If the w3dToobar is switched on, the currently selected tool is active in your w3d world.

In the Authoring Miaw version the w3dToobar at first only monitors your mouse position until it rolls over a w3d sprite. If this happens and your movie is running, the toolbar temporary installs its 3d behavior into the scriptInstanceList of your sprite. It removes it again as soon as your mouse leaves the sprite, you stop your movie, or you click on the button again to switch the w3dToobar off.

 

drag camera

With this tool you can drag the current view and so change the cameras position within its x-y-plane.

Click on your w3d sprite and drag the mouse to change the view.

As long as the "drag camera" tool is active, a hand cursor is displayed when your mouse is within the w3d sprite. The cursor shows a small box when your mouse is also over a model.
When you click to start dragging the camera, while no model is touched , the calculation for the movement distance is based on the cameras viewpoint (in the plane of the spriteSpaceToWorldSpace position of the sprites center).
When you click to start dragging the camera, while a model is touched , the calucaltion is based on the isectPosition, so the model below the mouse will always exactly stay under your mouse while dragging the view.
Press the alt key if you do not want the action to depend on the models below the mouse.

While pressing the shift key, the movement just takes place in one single direction, depending if your mouse moves more horizontal or vertical.

 

rotate and orbit camera

With this tool you can rotate and orbit the current view.

ORBIT:

Click on your w3d sprite and drag the mouse to orbit around the clicked point.

As long as this tool is active, a camera-rotate cursor is displayed when your mouse is within the w3d sprite. The cursor shows a small box when your mouse is also over a model.
When you click to start rotating the camera, while no model is touched , the calculation for the rotation center and angle is based on the cameras viewpoint (in the plane of the spriteSpaceToWorldSpace position of the sprites center).
When you click to start rotating the camera, while a model is touched , the calucaltion is based on the isectPosition, so the camera rotates exactly around the clicked position of the model.
(Press the alt key if you do not want the action to depend on the models below the mouse.)

While pressing the shift key, the rotation just takes place in one single direction, depending if your mouse moves more horizontal or vertical.

ROTATE:

Click on a point of the rectangle, that is displayed while this tool is selected, and drag the mouse to rotate the camera around one axis.

As long as this tool is active, a rect is displayed as overlay on your w3d sprite.

Click on one of the points of the rectangle and start dragging the mouse to rotate the camera around one axis. The corner points allow rotating around the z-axis, the points on the left and right around the y-axis, and the points on top and bottom around the x-axis.

 

zoom camera

With this tool you can zoom the view, which means moving the camera forward and backward if the cameras projection mode is #persprective, and adapting the #orthoHeight if the cameras projection mode is #orthographic.

Click on your w3d sprite and drag the mouse up and down to zoom in and out.

As long as the "zoom camera" tool is active, a 'zoom camera' cursor is displayed when your mouse is within the w3d sprite. The cursor shows a small box when your mouse is also over a model.
When you click to start zooming the camera, while no model is touched , the calculation for zooming direcion and distance is based on the cameras viewpoint (in the plane of the spriteSpaceToWorldSpace position of the sprites center).
When you click to start zooming the camera, while a model is touched , the calucaltion is based on the isectPosition, so the camera will directly move towards the clicked point on the model, or away from it.
Press the alt key if you do not want the action to depend on the models below the mouse.

 

drag model

With this tool you can drag models to change their positions.
The following methods are available:

Parallel to the cameras x-y-plane:

Simply click on a model and drag it around.

While pressing the shift key, the movement just takes place in one single direction, depending if your mouse moves more horizontal or vertical.

While pressing the command key the movement takes place parallel to the z-axis of the camera, so in the views depth.

Parallel to a world's plane:

Press the x, y or z key while dragging a model.

The w3dToolbar displays a cursor depending on the pressed key, and a grid in the specific plane to help understanding the plane to move around.

While pressing the shift key, the movement just takes place in one single direction, depending to which axis of the world your mouse moves closer.

Along one axis of the model:

Click on an axis, that the w3dToolbar displays at the model under your mouse as long as the model is selected (click on it to select it), and drag the mouse along the axis.

 

rotate model

With this tool you can rotate models.

For a free rotation simply click on a model and drag the mouse to rotate it.

For rotating the model around one of its axis, click on an axis, that the w3dToolbar displays at the model under your mouse as long as the model is selected (click on it to select it), and drag the mouse away from the axis.
While pressing the shift key, the rotation happens in 45° steps.

 

scale model

With this tool you can scale models.

For a proportional scaling just click on a model and drag the mouse.

For scaling in one direction, click on an axis, that the w3dToolbar displays at the model unser your mouse as long as the model is selected (click on it to select it), and drag the mouse along the axis.
While pressing the alt key, the scaling happens in a way, that the opposite side of the bounding box remains fixed.

 

undo

Click on this button to Undo the last step that you did with the help of the w3dToolbar.