Third Guild

Stick-E Tool

Use for,

  • 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.

Overview

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.

Workflow Quickstart

Step-by-Step

To active this tool

  1. Select a mesh item or group locator.
  2. 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.

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.

Stick-E Tool UI.

Item Orient

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).

Auto Centre

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.

World

Initial Facing

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.

Height

The height above or below the ground plane. This is only used when Lock Height is active.

Grab Height

Set the Height attribute from the current position of the tool.

Lock Height

Lock the height of the tool above or below the ground plane to the value set in the Height attribute. 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.

Polygon BBox

Centre X

Moves the selected mesh item to the local right-axis centre of the bounding box of the hit polygon.

Lock X

Lock the local right-axis (red-coloured). Allowing movement only along the local-up (green-coloured) axis.

Centre Y

Centre the selected mesh item to local up-axis centre of the bounding box of the hit polygon.

Lock Y

Lock the local (green-coloured) up-axis. Allowing movement only along the local-right (red-coloured) axis.

Lock To Polygon (WIP)

When locks are active, movement of the item is locked to the current polygon; i.e. clicking on another polygon will be ignored. When this option is off, clicking or moving over a differet polygon will turn-off Lock X and Y.

Rotate

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.

Angle

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.

Reset

Resets the Rotate value to zero.

Show Handle

Turn-on to draw the rotate handle in the 3D view.

Push

Distance

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)

Reset

Resets the push distance value to zero.

Show Handle

Turn-on to draw the push handle in the 3D view.

Select

Select Through

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.

UI

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.

Position

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.

Orientation

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.

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.

Stick-E tool's 3D-view UI

Row One -- Initial Facing

X

Indicate that the item's original facing is along the X+ axis.

Y

Indicate that the item's original facing is along the Y+ axis.

Z

Indicate that the item's original facing is along the Z+ axis.

Row Two -- Local X (Red)

CEN

Centre the item along the local X-axis (red line) of the hit polygon's bounding box.

LOCK

Locks local x-axis movement when active, constraining movement to the local y-axis.

Row Three -- Local Y (Green)

CEN

Centre the item along the local Y-axis (green line) of the hit polygon's bounding box.

LOCK

Locks local y-axis movement when active, constraining movement to the local x-axis.

Row Four -- Local Z (Blue)

ROT

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

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.

RSET

Sets the rotation value to zero.

Row Five -- World Y-up

LOCK

Lock Height: Locks the height of the tool above or below the ground plane to the value set in the Height attribute. 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.

GRAB

Grab Height: Set the Height attribute from the current position of the tool.

Row Five -- Local Z

PUSH

Toggle drawing of the push handle, which allows you to move the item along the axis of the hit polygon's normal.

Kit User Guide