Navigation Cube

From FreeCAD Documentation
Revision as of 13:56, 26 February 2023 by Roy 043 (talk | contribs) (Int value without leading zeros.)

Introduction

The Navigation Cube gives visual information about the camera orientation in the current 3D view and can be used to change it. By default it is visible and resides in the upper right corner of the view.

The Navigation Cube consists of a number of parts:

All parts, except the axis indicators, can be clicked.

Usage

Main cube

The main cube has 26 faces: 6 main faces, 12 rectangular edge faces (introduced in version 0.20), and 8 corner faces. Clicking any of them will reorient the camera so that its direction is perpendicular to the selected face.

Directional arrows

There are six directional arrows: four triangular arrowheads and two curved arrows. Clicking one of the triangular arrows will rotate the 3D view around a line perpendicular to the direction of the arrow. Clicking a curved arrow will rotate the 3D view around the view direction.

Reverse view button

Clicking the round button in the top right corner of the Navigation Cube will rotate the 3D view 180 degrees around the vertical axis of the view.

Mini-cube menu

Clicking the small cube in the bottom right corner of the Navigation Cube will bring up a menu with the following options:

  • Orthographic: switches to an orthographic view.
  • Perspective: switches to a perspective view.
  • Isometric: switches to an isometric view.
  • Zoom to fit: zooms and pans the camera so that all visible objects fit inside the view.

Customization

Move the Navigation Cube

The entire Navigation Cube can be moved by pressing the mouse anywhere on the main cube and dragging. The structure will not begin to move until the cursor moves beyond one of the edges of the main cube.

Preferences

The Navigation Cube is controlled by several preferences: Edit → Preferences... → Display → Navigation → Navigation cube. See Preferences Editor.

Advanced parameters

Some advanced Navigation Cube parameters cannot be changed in the Preferences Editor. These parameters can be set manually in the Parameter editor or via the CubeMenu external workbench. Changes will become visible when a new 3D view is created (with Std New, Std Open or Std ViewCreate).

To manually set colors:

  1. Start the Parameter editor.
  2. In the panel on the left browse to BaseApp → Preferences → NaviCube.
  3. Right-click the panel on the right and select New unsigned item from the context menu.
  4. Enter the name of one of these colors:
    • BorderColor: the lines separating the cube faces, default is 842150655 (hex: 323232ff).
    • ButtonColor: all elements around the cube, default is 3806916480 (hex: e2e9ef80).
    • FrontColor: all cube faces, default is 3806916544 (hex: e2e9efc0).
    • HiliteColor: the cube or arrow face that is currently highlighted, default is 2867003391 (hex: aae2ffff).
    • TextColor: the text on the cube faces, default is 255 (hex: 000000ff).
  5. The color value must be entered as a 32-bit unsigned integer. Translated to the hexadecimal format this integer has the form RRGGBBAA. Where AA stands for the alpha channel (a measure for the transparency), and the other three digit pairs stand for red, green and blue. To convert a hexadecimal value to an unsigned integer you can use the Python console, enter for example int("323232ff", 16), or an online service such as this one.
  6. Optionally set more colors.
  7. Press the Close button.

To manually set the border width:

  1. Start the Parameter editor.
  2. In the panel on the left browse to BaseApp → Preferences → NaviCube.
  3. Right-click the panel on the right and select New float item from the context menu.
  4. Enter the name BorderWidth, default is 1.1.
  5. Enter the width.
  6. Press the Close button.