Navigation Cube: Difference between revisions

From FreeCAD Documentation
Line 72: Line 72:
=== Advanced parameters ===
=== Advanced parameters ===


Some advanced Navigation Cube parameters cannot be changed in the [[Preferences_Editor#Navigation|Preferences Editor]]. These parameters can be set manually in the [[Std_DlgParameter|Parameter editor]] or via the [[Interface_Customization#CubeMenu|CubeMenu external workbench]]. The changes will become visible when a new 3D view is created (with [[Std_New|Std New]], [[Std_Open|Std Open]] or [[Std_ViewCreate|Std ViewCreate]]).
Some advanced Navigation Cube parameters cannot be changed in the [[Preferences_Editor#Navigation|Preferences Editor]]. These parameters can be set manually in the [[Std_DlgParameter|Parameter editor]] or via the [[Interface_Customization#CubeMenu|CubeMenu external workbench]]. Changes will become visible when a new 3D view is created (with [[Std_New|Std New]], [[Std_Open|Std Open]] or [[Std_ViewCreate|Std ViewCreate]]).


To manually set colors:
To manually set colors:


# Go to the [[Std_DlgParameter|Parameter editor]] and there to the path ''BaseApp/Preferences/NaviCube''.
# Start the [[Image:Std_DlgParameter.svg|16px]] [[Std_DlgParameter|Parameter editor]].
# In the panel on the left browse to {{MenuCommand|BaseApp → Preferences → NaviCube}}.
# Right-click in the window listing the parameter names and select in the appearing context menu to add the type ''New unsigned item''.
# Right-click the panel on the right and select {{MenuCommand|New unsigned item}} from the context menu.
# Input as name one of these available colors:
# Enter the name of one of these colors:
#* '''BorderColor''' (the lines separating the cube faces, default is ff323232)
#* '''ButtonColor''' (all elements around the cube, default is 80e2e9ef)
#* {{MenuCommand|BorderColor}}: the lines separating the cube faces, default is {{Value|4281479730}} (hex: {{Value|ff323232}}).
#* {{MenuCommand|ButtonColor}}: all elements around the cube, default is {{Value|2162354671}} (hex: {{Value|80e2e9ef}}).
#* '''FrontColor''' (all cube faces, default is c0e2e9ef)
#* {{MenuCommand|FrontColor}}: all cube faces, default is {{Value|3236096495}} (hex: {{Value|c0e2e9ef}}).
#* '''HiliteColor''' (the cube face that is currently highlighted, default is ffaae2ff)
#* {{MenuCommand|HiliteColor}}: the cube or arrow face that is currently highlighted, default is {{Value|4289389311}} (hex: {{Value|ffaae2ff}}).
#* '''TextColor''' (the text at the cube faces, default is ff000000)
#* {{MenuCommand|TextColor}}: the text on the cube faces, default is {{Value|4278190080}} (hex: {{Value|ff000000}}).
# Input the color value as number. The color has the form ''TTRRGGBB'' (each two hexadecimal digits for the ''T''ransparency, ''R''ed, ''G''reen, ''B''lue). This hexadecimal value has to be input as 32-bit unsigned integer. A suitable way to do this is to use an online convertor tool, for example [https://cryptii.com/pipes/integer-encoder this one]. So to get e.g. an orange color, the hexadecimal code would be "ffff8800" and the input would be "4294936576".
# The color value must be entered as a 32-bit unsigned integer. Translated to the hexadecimal format this integer has the form {{Value|AARRGGBB}}. Where {{Value|AA}} stands for the alpha channel (a measure for the transparency), and the other 3 digit pairs stand for red, green and blue. To convert a hexadecimal value to an unsigned integer you can use the [[Python_console|Python console]] (enter for example {{Incode|int("ff323232", 16)}}) or an online service such as [https://cryptii.com/pipes/integer-encoder this one].
# Press in the Parameter editor the button ''Save to disk''.
# Optionally set more colors.
# Press the {{Button|Close}} button.


To manually set the border width:
To manually set the border width:


# Go to the [[Std_DlgParameter|Parameter editor]] and there to the path ''BaseApp/Preferences/NaviCube''.
# Start the [[Image:Std_DlgParameter.svg|16px]] [[Std_DlgParameter|Parameter editor]].
# In the panel on the left browse to {{MenuCommand|BaseApp → Preferences → NaviCube}}.
# Right-click in the window listing the parameter names and select in the appearing context menu to add the type ''New float item''.
# Right-click the panel on the right and select {{MenuCommand|New float item}} from the context menu.
# Input the name '''BorderWidth''' (default is 1.1).
# Enter the name {{MenuCommand|BorderWidth}}, {{Value|default is 1.1}}.
# Input the width as value.
# Enter the width.
# Press in the Parameter editor the button ''Save to disk''.
# Press in the Parameter editor the button ''Save to disk''.
# Press the {{Button|Close}} button.





Revision as of 15:50, 19 February 2023

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 4281479730 (hex: ff323232).
    • ButtonColor: all elements around the cube, default is 2162354671 (hex: 80e2e9ef).
    • FrontColor: all cube faces, default is 3236096495 (hex: c0e2e9ef).
    • HiliteColor: the cube or arrow face that is currently highlighted, default is 4289389311 (hex: ffaae2ff).
    • TextColor: the text on the cube faces, default is 4278190080 (hex: ff000000).
  5. The color value must be entered as a 32-bit unsigned integer. Translated to the hexadecimal format this integer has the form AARRGGBB. Where AA stands for the alpha channel (a measure for the transparency), and the other 3 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("ff323232", 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 in the Parameter editor the button Save to disk.
  7. Press the Close button.