Navigation Cube: Difference between revisions
(→Cube Layout: add width setting) |
(Marked this version for translation) |
||
(45 intermediate revisions by 3 users not shown) | |||
Line 27: | Line 27: | ||
* The [[#Reverse_view_button|reverse view button]] (top right) {{Version|0.20}} |
* The [[#Reverse_view_button|reverse view button]] (top right) {{Version|0.20}} |
||
* The [[#Mini-cube_menu|mini-cube menu]] (bottom right) |
* The [[#Mini-cube_menu|mini-cube menu]] (bottom right) |
||
* X, Y and Z |
* X, Y and Z axis indicators |
||
<!--T:55--> |
<!--T:55--> |
||
Line 37: | Line 37: | ||
<!--T:58--> |
<!--T:58--> |
||
The main cube has 26 faces: 6 main faces, 12 rectangular edge faces ({{Version|0.20}}), and 8 corner faces. Clicking any of them |
The main cube has 26 faces: 6 main faces, 12 rectangular edge faces ({{Version|0.20}}), and 8 corner faces. Clicking any of them reorients the camera so that its direction is perpendicular to the selected face. |
||
=== Directional arrows === <!--T:27--> |
=== Directional arrows === <!--T:27--> |
||
<!--T:28--> |
<!--T:28--> |
||
There are six directional arrows: four triangular arrowheads and two curved arrows. Clicking one of the triangular arrows |
There are six directional arrows: four triangular arrowheads and two curved arrows. Clicking one of the triangular arrows rotates the [[3D_view|3D view]] around a line perpendicular to the direction of the arrow. Clicking a curved arrow rotates the [[3D_view|3D view]] around the view direction. |
||
=== Reverse view button === <!--T:59--> |
=== Reverse view button === <!--T:59--> |
||
<!--T:60--> |
<!--T:60--> |
||
Clicking the round button in the top right corner of the Navigation Cube |
Clicking the round button in the top right corner of the Navigation Cube rotates the [[3D_view|3D view]] 180 degrees around the vertical axis of the view. |
||
=== Mini-cube menu === <!--T:36--> |
=== Mini-cube menu === <!--T:36--> |
||
<!--T:37--> |
<!--T:37--> |
||
Clicking the small cube in the bottom right corner of the Navigation Cube |
Clicking the small cube in the bottom right corner of the Navigation Cube brings up a menu with the following options: |
||
* {{MenuCommand|[[Std_OrthographicCamera|Orthographic]]}}: switches to an orthographic view. |
* {{MenuCommand|[[Image:Std_OrthographicCamera.svg|16px]] [[Std_OrthographicCamera|Orthographic view]]}}: switches to an orthographic view. |
||
* {{MenuCommand|[[Std_PerspectiveCamera|Perspective]]}}: switches to a perspective view. |
* {{MenuCommand|[[Image:Std_PerspectiveCamera.svg|16px]] [[Std_PerspectiveCamera|Perspective view]]}}: switches to a perspective view. |
||
* {{MenuCommand|[[Std_ViewIsometric|Isometric]]}}: switches to an isometric view. |
* {{MenuCommand|[[Image:Std_ViewIsometric.svg|16px]] [[Std_ViewIsometric|Isometric]]}}: switches to an isometric view. |
||
* {{MenuCommand|[[Std_ViewFitAll| |
* {{MenuCommand|[[Image:Std_ViewFitAll.svg|16px]] [[Std_ViewFitAll|Fit all]]}}: zooms and pans the camera so that all visible objects fit inside the view. |
||
* {{MenuCommand|Movable navigation cube}}: if this checkbox ({{Version|0.21}}) is checked the entire Navigation Cube can be moved by holding down the left mouse button anywhere on the main cube and dragging. This is intended to temporarily move the cube out of the way. The [[#Advanced_parameters|advanced parameters]] OffsetX and OffsetY can be used to permanently reposition the cube, see below. |
|||
== Customization == <!--T:61--> |
== Customization == <!--T:61--> |
||
=== Move the Navigation Cube === <!--T:52--> |
|||
<!--T:38--> |
|||
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 === <!--T:62--> |
=== Preferences === <!--T:62--> |
||
Line 70: | Line 66: | ||
The Navigation Cube is controlled by several preferences: {{MenuCommand|Edit → Preferences... → Display → Navigation → Navigation cube}}. See [[Preferences_Editor#Navigation|Preferences Editor]]. |
The Navigation Cube is controlled by several preferences: {{MenuCommand|Edit → Preferences... → Display → Navigation → Navigation cube}}. See [[Preferences_Editor#Navigation|Preferences Editor]]. |
||
=== |
=== Advanced parameters === <!--T:64--> |
||
<!--T:65--> |
|||
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]]. |
|||
<!--T:66--> |
|||
To manually set colors: |
|||
<!--T:67--> |
|||
# 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 the panel on the right and select {{MenuCommand|New unsigned item}} from the context menu. |
|||
# Enter the name of one of these colors: |
|||
#* {{MenuCommand|BaseColor}}: the base color of all elements, the default is {{Value|3806916544}} (hex: {{Value|e2e8efc0}}). This color can be also set in the [[Preferences_Editor#Navigation|Preferences Editor]]. {{Version|0.21}} |
|||
#* {{MenuCommand|EmphaseColor}}: the color of the texts and lines, the default depends on the {{MenuCommand|BaseColor}}. It is either black: {{Value|255}} (hex: {{Value|000000ff}}), or white: {{Value|4294967295}} (hex: {{Value|ffffffff}}). {{Version|0.21}} |
|||
#* {{MenuCommand|HiliteColor}}: the color used to highlight the faces and buttons, the default is {{Value|2867003391}} (hex: {{Value|aae2ffff}}). |
|||
# The color value must be entered as a 32-bit unsigned integer. Translated to the hexadecimal format this integer has the form {{Value|RRGGBBAA}}. Where {{Value|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|Python console]], enter for example {{Incode|int("323232ff", 16)}}. |
|||
# Optionally set more parameters. |
|||
# Press the {{Button|Close}} button. |
|||
<!--T:70--> |
|||
The table below lists the other advanced Navigation Cube parameters that can be set in a similar manner. Use the information from the '''Type''' column to create a correct new item in step 3. |
|||
<!--T:71--> |
|||
{| class="wikitable" |
|||
|- |
|||
! Name |
|||
! Description |
|||
! Type |
|||
! Default |
|||
<!--T:72--> |
|||
|- |
|||
| BorderWidth |
|||
| The width of the edges of the cube and the borders around the buttons in pixels. |
|||
| Float |
|||
| 1.1 |
|||
<!--T:73--> |
|||
|- |
|||
| ChamferSize |
|||
| The size of the edges and corners as a factor of the cube size. Values should be in the 0.05 - 0.18 range. |
|||
<!--T:74--> |
|||
{{Version|0.21}} |
|||
| Float |
|||
| 0.12 |
|||
<!--T:75--> |
|||
|- |
|||
| FontStretch |
|||
| The font width as a percentage of the default width. Use 0 or 100 for the default font width. |
|||
| Integer |
|||
| 0 |
|||
<!--T:76--> |
|||
|- |
|||
| FontWeight |
|||
| The font weight. Higher values make the font more bold. The effect may depend on the font. Use 0 for the default font weight. |
|||
| Integer |
|||
| 0 |
|||
<!--T:77--> |
|||
|- |
|||
| FontZoom |
|||
| The size of the labels: |
|||
* {{Value|FontZoom = 1.0}}: Make the labels as big as possible individually. |
|||
* {{Value|0.0 < FontZoom < 1.0}}: Idem but limit the maximum font size. |
|||
* {{Value|FontZoom = 0.0}}: Idem but use the same font size for all. |
|||
* {{Value|FontZoom < 0.0}}: Use the same font size for all, but scaled down. |
|||
<!--T:78--> |
|||
{{Version|0.21}} |
|||
| Float |
|||
| 0.3 |
|||
<!--T:79--> |
|||
|- |
|||
| OffsetX |
|||
| The offset of the cube in the X direction relative to its corner position in pixels. |
|||
| Integer |
|||
| 0 |
|||
<!--T:80--> |
|||
|- |
|||
| OffsetY |
|||
| The offset of the cube in the Y direction relative to its corner position in pixels. |
|||
| Integer |
|||
| 0 |
|||
<!--T:81--> |
|||
|- |
|||
| ShowCS |
|||
| Toggles the display of the coordinate system (the X, Y and Z axis indicators). |
|||
| Boolean |
|||
| true |
|||
<!--T:82--> |
|||
|- |
|||
| TextBottom |
|||
| The text on the bottom face of the cube. The default value should be translated. |
|||
| String |
|||
| BOTTOM |
|||
<!--T:83--> |
|||
|- |
|||
| TextFront |
|||
| The text on the front face of the cube. Idem. |
|||
| String |
|||
| FRONT |
|||
<!--T:84--> |
|||
The layout of the cube can be controlled by special parameters. To set a color: |
|||
|- |
|||
# Go to the [[Std_DlgParameter|Parameter editor]] and there to the path ''BaseApp/Preferences/NaviCube'' |
|||
| TextLeft |
|||
# Right-click in the window listing the parameter names and select in the appearing context menu to add the type ''New unsigned item''. |
|||
| The text on the left face of the cube. Idem. |
|||
# Input as name one of these available colors: |
|||
| String |
|||
#* '''BorderColor''' (the lines separating the cube faces, default is ff323232) |
|||
| LEFT |
|||
#* '''ButtonColor''' (all elements around the cube, default is 80e2e9ef) |
|||
#* '''FrontColor''' (all cube faces, default is c0e2e9ef) |
|||
#* '''HiliteColor''' (the cube face that is currently highlighted, default is ffaae2ff) |
|||
#* '''TextColor''' (the text at the cube faces, default is 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". |
|||
# Press in the Parameter editor the button ''Save to disk''. |
|||
<!--T:85--> |
|||
The changes will become visible with the next new creation of a cube (creation of a new document, loading a document). |
|||
|- |
|||
| TextRear |
|||
| The text on the rear face of the cube. Idem. |
|||
| String |
|||
| REAR |
|||
<!--T:86--> |
|||
To the border width: |
|||
|- |
|||
# Go to the [[Std_DlgParameter|Parameter editor]] and there to the path ''BaseApp/Preferences/NaviCube'' |
|||
| TextRight |
|||
# Right-click in the window listing the parameter names and select in the appearing context menu to add the type ''New float item''. |
|||
| The text on the right face of the cube. Idem. |
|||
# Input the name '''BorderWidth''' (default is 1.1) |
|||
| String |
|||
# Input the width as value. |
|||
| RIGHT |
|||
# Press in the Parameter editor the button ''Save to disk''. |
|||
<!--T:87--> |
|||
|- |
|||
| TextTop |
|||
| The text on the top face of the cube. Idem |
|||
| String |
|||
| TOP |
|||
<!--T: |
<!--T:88--> |
||
|} |
|||
The [[Interface_Customization#CubeMenu|CubeMenu]] external workbench provides easier access to several more advanced customization options. |
|||
Latest revision as of 21:10, 11 June 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:
- The main cube
- Six directional arrows
- The reverse view button (top right) introduced in version 0.20
- The mini-cube menu (bottom right)
- X, Y and Z axis indicators
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 reorients 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 rotates the 3D view around a line perpendicular to the direction of the arrow. Clicking a curved arrow rotates the 3D view around the view direction.
Reverse view button
Clicking the round button in the top right corner of the Navigation Cube rotates the 3D view 180 degrees around the vertical axis of the view.
Clicking the small cube in the bottom right corner of the Navigation Cube brings up a menu with the following options:
- Orthographic view: switches to an orthographic view.
- Perspective view: switches to a perspective view.
- Isometric: switches to an isometric view.
- Fit all: zooms and pans the camera so that all visible objects fit inside the view.
- Movable navigation cube: if this checkbox (introduced in version 0.21) is checked the entire Navigation Cube can be moved by holding down the left mouse button anywhere on the main cube and dragging. This is intended to temporarily move the cube out of the way. The advanced parameters OffsetX and OffsetY can be used to permanently reposition the cube, see below.
Customization
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.
To manually set colors:
- Start the Parameter editor.
- In the panel on the left browse to BaseApp → Preferences → NaviCube.
- Right-click the panel on the right and select New unsigned item from the context menu.
- Enter the name of one of these colors:
- BaseColor: the base color of all elements, the default is
3806916544
(hex:e2e8efc0
). This color can be also set in the Preferences Editor. introduced in version 0.21 - EmphaseColor: the color of the texts and lines, the default depends on the BaseColor. It is either black:
255
(hex:000000ff
), or white:4294967295
(hex:ffffffff
). introduced in version 0.21 - HiliteColor: the color used to highlight the faces and buttons, the default is
2867003391
(hex:aae2ffff
).
- BaseColor: the base color of all elements, the default is
- The color value must be entered as a 32-bit unsigned integer. Translated to the hexadecimal format this integer has the form
RRGGBBAA
. WhereAA
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 exampleint("323232ff", 16)
. - Optionally set more parameters.
- Press the Close button.
The table below lists the other advanced Navigation Cube parameters that can be set in a similar manner. Use the information from the Type column to create a correct new item in step 3.
Name | Description | Type | Default |
---|---|---|---|
BorderWidth | The width of the edges of the cube and the borders around the buttons in pixels. | Float | 1.1 |
ChamferSize | The size of the edges and corners as a factor of the cube size. Values should be in the 0.05 - 0.18 range. | Float | 0.12 |
FontStretch | The font width as a percentage of the default width. Use 0 or 100 for the default font width. | Integer | 0 |
FontWeight | The font weight. Higher values make the font more bold. The effect may depend on the font. Use 0 for the default font weight. | Integer | 0 |
FontZoom | The size of the labels:
|
Float | 0.3 |
OffsetX | The offset of the cube in the X direction relative to its corner position in pixels. | Integer | 0 |
OffsetY | The offset of the cube in the Y direction relative to its corner position in pixels. | Integer | 0 |
ShowCS | Toggles the display of the coordinate system (the X, Y and Z axis indicators). | Boolean | true |
TextBottom | The text on the bottom face of the cube. The default value should be translated. | String | BOTTOM |
TextFront | The text on the front face of the cube. Idem. | String | FRONT |
TextLeft | The text on the left face of the cube. Idem. | String | LEFT |
TextRear | The text on the rear face of the cube. Idem. | String | REAR |
TextRight | The text on the right face of the cube. Idem. | String | RIGHT |
TextTop | The text on the top face of the cube. Idem | String | TOP |
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub