Navigation Cube: Difference between revisions

From FreeCAD Documentation
m (skew -> 3D)
(Marked this version for translation)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>
<!--T:23-->
{{TOCright}}
{{TOCright}}
The navigational cube control, or '''navigation cube''', is a user interface graphic aid for reorienting the 3D view.
The navigational cube control, or '''navigation cube''', is a user interface graphic aid for reorienting the 3D view.
Line 6: Line 7:
If you are looking at the standard 3D view, it looks like the following:
If you are looking at the standard 3D view, it looks like the following:


<!--T:24-->
[[File:FreeCAD-v0-18-NavCube_Axonometric.png]]
[[File:FreeCAD-v0-18-NavCube_Axonometric.png]]


<!--T:25-->
The navigation cube consists of a number of parts:
The navigation cube consists of a number of parts:
*Directional Arrows
*Directional Arrows
Line 13: Line 16:
*Mini-cube Menu
*Mini-cube Menu


<!--T:26-->
Hovering the mouse pointer over a feature of the navigational cube turns the feature light blue;
Hovering the mouse pointer over a feature of the navigational cube turns the feature light blue;
clicking will reorient the 3D view as indicated by the feature.
clicking will reorient the 3D view as indicated by the feature.
Line 23: Line 27:


[[File:FreeCAD-v0-18-NavCube_SelectCorner.png]]
[[File:FreeCAD-v0-18-NavCube_SelectCorner.png]]
== Directional Arrows ==
== Directional Arrows == <!--T:27-->


<!--T:28-->
There are six directional arrows: four triangular arrowheads, one at the top, bottom, left and right; and two curved arrows, one on either side of the top arrow.
There are six directional arrows: four triangular arrowheads, one at the top, bottom, left and right; and two curved arrows, one on either side of the top arrow.


<!--T:29-->
Clicking the triangular arrows will rotate the 3D view 45 degrees around a line perpendicular to the direction of the arrow.
Clicking the triangular arrows will rotate the 3D view 45 degrees around a line perpendicular to the direction of the arrow.
Clicking the curved arrows will rotate the 3D view around a line pointing towards you.
Clicking the curved arrows will rotate the 3D view around a line pointing towards you.
Line 32: Line 38:
each is the intersection of two planes, but I can't figure out how to describe them -->
each is the intersection of two planes, but I can't figure out how to describe them -->


== Main Navigation Cube ==
== Main Navigation Cube == <!--T:30-->
The main navigation cube ("nav cube" in the rest of this section), tracks the orientation of the actual object in the main part of the 3D view. Any operation which reorients the main 3D view will reorient the nav cube as well.
The main navigation cube ("nav cube" in the rest of this section), tracks the orientation of the actual object in the main part of the 3D view. Any operation which reorients the main 3D view will reorient the nav cube as well.


<!--T:31-->
The nav cube is essentially a 3D view of a cube with its three main component types (faces, edges, and corners) enhanced so they may be easily clicked with the pointer. Clicking on a particular component will set the 3D view to have that component centered and facing you. The nav cube is somewhat "squashed", as if the feature farthest from you were larger than the feature directly facing you. This allows the features adjacent to the feature facing you to be seen and consequently selected.
The nav cube is essentially a 3D view of a cube with its three main component types (faces, edges, and corners) enhanced so they may be easily clicked with the pointer. Clicking on a particular component will set the 3D view to have that component centered and facing you. The nav cube is somewhat "squashed", as if the feature farthest from you were larger than the feature directly facing you. This allows the features adjacent to the feature facing you to be seen and consequently selected.
For example, in a "normal" view of a regular cube, when one face is facing you, you can also see the four edges of that face and the four corners of that face. In the "squashed" nav cube, you can also see features representing each of the adjacent faces, the four edges connecting the corners of the face facing you with the opposite face, and the corners of opposite face. This allows you to select any of the possible standard views except the opposite face and its edges (21 out of 26 possible views):
For example, in a "normal" view of a regular cube, when one face is facing you, you can also see the four edges of that face and the four corners of that face. In the "squashed" nav cube, you can also see features representing each of the adjacent faces, the four edges connecting the corners of the face facing you with the opposite face, and the corners of opposite face. This allows you to select any of the possible standard views except the opposite face and its edges (21 out of 26 possible views):
Line 47: Line 54:
* The edges of the opposite face
* The edges of the opposite face


<!--T:32-->
Note: As of this writing (v 0.18), there are some problems with the nav cube; not all features are currently selectable.
Note: As of this writing (v 0.18), there are some problems with the nav cube; not all features are currently selectable.
In particular, edges are not selectable, nor are the four corners of the immediately facing face.
In particular, edges are not selectable, nor are the four corners of the immediately facing face.


=== Face Selection ===
=== Face Selection === <!--T:33-->
Clicking on a face will orient the 3D view with that particular face facing you.
Clicking on a face will orient the 3D view with that particular face facing you.
From a face view, other selection points are available as noted above.
From a face view, other selection points are available as noted above.
Line 57: Line 65:
There is also an interior set of edges and corners, which are currently non-functional.
There is also an interior set of edges and corners, which are currently non-functional.


=== Edge Selection ===
=== Edge Selection === <!--T:34-->
Unfortunately, edge selection is currently broken. Attempting to select an edge will select the face which lies behind it.
Unfortunately, edge selection is currently broken. Attempting to select an edge will select the face which lies behind it.
Clicking an edge should center that edge so it is facing you.
Clicking an edge should center that edge so it is facing you.


=== Corner Selection ===
=== Corner Selection === <!--T:35-->
Clicking one of the corners will give you an axonometric view as seen from that corner.
Clicking one of the corners will give you an axonometric view as seen from that corner.
As noted above, currently when a face is directly facing you, the corners of that face are not selectable.
As noted above, currently when a face is directly facing you, the corners of that face are not selectable.


== Mini-cube Menu ==
== Mini-cube Menu == <!--T:36-->


<!--T:37-->
In the lower right corner of the navigational cube is a small cube.
In the lower right corner of the navigational cube is a small cube.
Clicking on this cube will bring up a menu you may use to change the type of view (Orthographic, Perspective, Isometric)
Clicking on this cube will bring up a menu you may use to change the type of view (Orthographic, Perspective, Isometric)
and to do a "Zoom to Fit".
and to do a "Zoom to Fit".


== Moving the Navigation Cube Display ==
== Moving the Navigation Cube Display == <!--T:38-->
You may move the entire navigation cube control structure to another location in the 3D display by pressing the mouse anywhere in the main navigation cube and dragging.
You may move the entire navigation cube control structure to another location in the 3D display by pressing the mouse anywhere in the main navigation cube and dragging.
As of this writing (v 0.18), the structure will not begin to move until the mouse pointer has moved past the edge of the main navigation cube.
As of this writing (v 0.18), the structure will not begin to move until the mouse pointer has moved past the edge of the main navigation cube.

Revision as of 21:22, 17 January 2019

The navigational cube control, or navigation cube, is a user interface graphic aid for reorienting the 3D view. By default, it is visible and resides in the upper right corner of the 3D display. If you are looking at the standard 3D view, it looks like the following:

The navigation cube consists of a number of parts:

  • Directional Arrows
  • Main Navigation Cube
  • Mini-cube Menu

Hovering the mouse pointer over a feature of the navigational cube turns the feature light blue; clicking will reorient the 3D view as indicated by the feature. (Note: As of this writing, the pointer does not register perfectly with some navigational cube features. If a feature you are trying to select does not turn light blue, move the mouse until you find a spot which causes the feature to turn blue.) In the example below, the 3D view has been rotated by a mouse gesture to a "non-standard" orientation. The pointer is over a corner (indicated by the blue color); clicking will reorient the 3D view to a standard axonometric view with that corner facing you.

Directional Arrows

There are six directional arrows: four triangular arrowheads, one at the top, bottom, left and right; and two curved arrows, one on either side of the top arrow.

Clicking the triangular arrows will rotate the 3D view 45 degrees around a line perpendicular to the direction of the arrow. Clicking the curved arrows will rotate the 3D view around a line pointing towards you.

Main Navigation Cube

The main navigation cube ("nav cube" in the rest of this section), tracks the orientation of the actual object in the main part of the 3D view. Any operation which reorients the main 3D view will reorient the nav cube as well.

The nav cube is essentially a 3D view of a cube with its three main component types (faces, edges, and corners) enhanced so they may be easily clicked with the pointer. Clicking on a particular component will set the 3D view to have that component centered and facing you. The nav cube is somewhat "squashed", as if the feature farthest from you were larger than the feature directly facing you. This allows the features adjacent to the feature facing you to be seen and consequently selected. For example, in a "normal" view of a regular cube, when one face is facing you, you can also see the four edges of that face and the four corners of that face. In the "squashed" nav cube, you can also see features representing each of the adjacent faces, the four edges connecting the corners of the face facing you with the opposite face, and the corners of opposite face. This allows you to select any of the possible standard views except the opposite face and its edges (21 out of 26 possible views):

  • The face facing you (does nothing, since that is the current view)
  • The four edges of the current face
  • The four corners of the current face
  • The four adjacent faces
  • The four edges leading to the opposite face
  • The four corners of the opposite face

Not possible:

  • The opposite face
  • The edges of the opposite face

Note: As of this writing (v 0.18), there are some problems with the nav cube; not all features are currently selectable. In particular, edges are not selectable, nor are the four corners of the immediately facing face.

Face Selection

Clicking on a face will orient the 3D view with that particular face facing you. From a face view, other selection points are available as noted above. There are four thin "bars" on each of the outside edges, representing the four adjacent faces; clicking them will select the view corresponding to the adjacent face. There are four round corners which may be used to set the corresponding axonometric view. There is also an interior set of edges and corners, which are currently non-functional.

Edge Selection

Unfortunately, edge selection is currently broken. Attempting to select an edge will select the face which lies behind it. Clicking an edge should center that edge so it is facing you.

Corner Selection

Clicking one of the corners will give you an axonometric view as seen from that corner. As noted above, currently when a face is directly facing you, the corners of that face are not selectable.

Mini-cube Menu

In the lower right corner of the navigational cube is a small cube. Clicking on this cube will bring up a menu you may use to change the type of view (Orthographic, Perspective, Isometric) and to do a "Zoom to Fit".

Moving the Navigation Cube Display

You may move the entire navigation cube control structure to another location in the 3D display by pressing the mouse anywhere in the main navigation cube and dragging. As of this writing (v 0.18), the structure will not begin to move until the mouse pointer has moved past the edge of the main navigation cube.

Mouse Model
Document structure