Programming Guide   >   Viewing   >   Scene Attributes

Axis Triad and NavCube

Both the Nav Cube and the Axis Triad are prebuilt tools that help with scene navigation that are drawn in an Overlay. For more info on overlays, see the Overlays Programming Guide and the Overlay Sample in the applications\client\examples directory.

Axis Triad

The Axis Triad is a visualization of the X, Y and Z axis orientation. The axis geometry is drawn in an overlay. Selecting an axis will rotate the scene to orient it along the selected axis. This is controlled by the Axis Triad operator.

Nav Cube

The Nav Cube is a visualization of the scene orientation. The cube geometry is drawn in an overlay. The Nav Cube is divided into sections that highlight as the mouse hovers over. Selecting the Nav Cube will rotate the scene to orient it along a specified view corresponding to the selected section. This is controlled by the NavCube operator.

Modifying the Axis Triad

The AxisTriad class provides an interface to enable / disable, set the anchor position, and change the axis colors for the axis triad. For example, the following snippet changes the axis triad X axis to yellow, and positions the axis triad in the center of the screen.

const axisTriad = hwv.view.getAxisTriad();
axisTriad.setAxisColor(Communicator.Axis.X, Communicator.Color.yellow());
axisTriad.setAnchor(Communicator.OverlayAnchor.Center);

Modifying the NavCube

The NavCube class provides an interface to enable / disable, and set the anchor position of the NavCube. For example, the following snippet positions the axis triad in the center of the screen.

const navCube = hwv.view.getNavCube();
navCube.setAnchor(Communicator.OverlayAnchor.Center);