- Placement of mesh items in your scene; e.g. objects in a room.
- Orient items such as mesh presets to the hit surface normal.
- Placement of geometry used for cutting shapes.
Interactively sets the orientation and position of mesh items and group locators to the surface of hit polygons in your scene; i.e. enables you to rapidly place and position items in your scene.
To active this tool
- Select a mesh item or group locator.
- Left-click on a polygon surface to align to that surface; or Right-click to activate the tool without without changing its orientation.
To interactively move an item accross a surface
- Left-click-hold and drag the mouse to move the item across the polygon surface under the mouse.
To rotate and push the item
- Use the tool handles —toggle their visibility via the in-view UI or tool properties— or enter precise values in the tool properties panel.
In-view User Interface
This interface floats in the 3D view, alongide the hit polygon or selected geometry, allowing quick access to the most used functions of this tool. Note, this in-view interface is somewhat experimental and will be improved over time. You can disable it, if desired, within the tool properties panel.
Row One -- Initial Facing
Indicate that the item's original facing is along the X+ axis.
Indicate that the item's original facing is along the Y+ axis.
Indicate that the item's original facing is along the Z+ axis.
HIDE / SHOW
Toggle the visibility of the in-view UI.
Row Two -- Local X (Red)
Centre the item along the local X-axis (red line) of the hit polygon's bounding box.
Locks local x-axis movement when active, constraining movement to the local y-axis.
Row Three -- Local Y (Green)
Centre the item along the local Y-axis (green line) of the hit polygon's bounding box.
Locks local y-axis movement when active, constraining movement to the local x-axis.
LOCK TO POLY
Movement of the item is locked to the current polygon. Clicking on other polygons will be ignored and a red circle will be displayed at the hit location.
Row Four -- Local Z (Blue)
Toggle drawing of the rotation handle. Note, the rotate handle does not yet support angle snapping.
Rotates the selected item clockwise by 90 degrees.
Rotates the selected item counter-clockwise by 90 degrees.
Auto-rotate the gizmo. The tool will rotate itself to align with one of the edges of the hit polygon. Note, the rotation Angle value is added to this gizmo rotation.
Resets rotation to its original state.
Row Five -- Local Z (Blue Arrow)
Toggle drawing of the push handle, which allows you to move the item along the axis of the hit polygon's normal.
Set the push value to zero.
Row Five -- World Y-up (Green Arrow)
Sets the Height attribute to the current gizmo height and locks the tool to this height. This is useful when you wish to align multiple items at a given height on vertical surfaces; e.g. placing plug sockets or switches on walls. Whilst the lock is active, you can also set a precise height by adjusting the Height attribute, in tool properties.
Tool Properties (UI)
The user-interface appears in the tool properties panel (or pop-up) when the tool is activated. The function of each attribute is described below.
Correct Rest Position
Corrects the selecterd item's resting position on hit surface. Use when the initial position of the selected mesh is not resting on the plane (e.g. it's not sitting on the ground plane).
The geometry in your mesh item may not be centrered at the origin. Use this option to auto centre the mesh to the hit surface position.
Set which direction should be considered as the initial facing of the selected item. Use this to rotate the the item to the desired orientation on the hit surface. For example, choose Z for a picture frame which is position at the origin in the XY plane with its main surface (picture, glass) pointing in the direction of the Z+ axis.
Grab + Lock Height
Locks the height of the tool, above or below the ground plane, to the current gizmo height. This is useful when you wish to align multiple items at a given height on vertical surfaces; e.g. placing plug sockets or switches on walls. Whilst the lock is active, you can use the Height attribute to set a precise height.
Sets a fixed height for the tool, above or below the ground plane. Changing this value will auto-active Lock Height. Note, using Grab + Lock Height or Lock (from the floating UI) will override this value.
Moves the selected mesh item to the local right-axis centre of the bounding box of the hit polygon.
Lock the local right-axis (red-coloured). Allowing movement only along the local-up (green-coloured) axis.
Centre the selected mesh item to local up-axis centre of the bounding box of the hit polygon.
Lock the local (green-coloured) up-axis. Allowing movement only along the local-right (red-coloured) axis.
Lock To Polygon
Movement of the item is locked to the current polygon; i.e. clicks on other polygons will be ignored and a red circle will be displayed at the invalid hit location. When this option is off, clicking or moving over a differet polygon will turn-off Lock X and Y.
Auto Rotate Gizmo
The tool will rotate itself to align with one of the edges of the hit polygon. This is super useful when aligning to the polygon surface of an item that has been rotated. Turn-off to switch to the default alignment heristic. Note, the rotation Angle value is added to this gizmo rotation.
Set the angle of rotation for the item. This will rotate the selected item around the normal of the hit surface.
90 Deg CW
Rotates the item 90 degrees clockwise around the normal of the hit surface.
90 Deg CCW
Rotates the item 90 degrees counter-clockwise around the normal of the hit surface.
Resets the Rotate value to zero.
Turn-on to draw the rotate handle in the 3D view.
Moves the mesh along the normal of the hit surface. Values can be both positive (move away from the surface) and negative (move through the surface)
Resets the push distance value to zero.
Turn-on to draw the push handle in the 3D view.
Active modo's Select Though mode. Left-click once to change the item selection and then left-click on the item again, and drag to move the item across the surface under the mouse.
Draw In View
Draws a floating UI in the 3D. Allowing you to toggle some of the most used attibutes without having to move your mouse to the tool properties panel.
There's no one ideal position where to position the UI in the 3D view, hence, improvements for this are ongoing. Currently, three options are provided,
- Poly Fixed : Position to the mid-right hand point of the hit polygon's bounding box.
- Poly Tracked : Position to the mid-right hand point of the hit polygon's bounding box, but tracks the cross-hair's position.
- Item Tracked : Moves with the selected item; Offset to the right-hand side.
Alters the facing of the UI in the 3D view,
- View : Face the view camera.
- Polygon : Face the direction of the hit polygon's normal.
Draw BBox Alignment
Draws 3 sides of the object-aligned bounding box. Useful for bug reporting.
The opacity of the background element that is drawn behind the in-view UI buttons. A value of zero disables drawing of this element.