Navigation Cube/zh-cn: Difference between revisions

From FreeCAD Documentation
(Created page with "鼠标在导航立方上经过时,它会呈淡蓝色;点击时,会根据上面标明的视角对3D视图进行重新定位。在下面的示例中,已经通过Mouse...")
(Updating to match new version of source page)
 
(33 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{docnav|Mouse Model|Document structure}}
<div class="mw-translate-fuzzy">
{{docnav/zh-cn|[[Mouse Model/zh-cn|Mouse Model]]|[[Document structure/zh-cn|Document structure]]}}
</div>


{{TOCright}}
{{TOCright}}


== Introduction ==

<div class="mw-translate-fuzzy">
导航立方控制,或称'''导航立方'''是一种用于重新定位的图形用户界面。在默认情况下,它位于3D显示界面的右上角。如果您在标准的3D视图下查看,会发现它长相如下:
导航立方控制,或称'''导航立方'''是一种用于重新定位的图形用户界面。在默认情况下,它位于3D显示界面的右上角。如果您在标准的3D视图下查看,会发现它长相如下:
</div>


[[File:FreeCAD-v0-18-NavCube_Axonometric.png]]
[[File:Navigation_Cube_Example.png]]


<div class="mw-translate-fuzzy">
导航立方由以下几部分组成:
导航立方由以下几部分组成:
*指向箭头
*指向箭头
*主导航立方
*主导航立方
*微型立方菜单
*微型立方菜单
</div>

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 ({{Version|0.20}}), and 8 corner faces. Clicking any of them reorients the camera so that its direction is perpendicular to the selected face.

<span id="Directional_arrows"></span>
<div class="mw-translate-fuzzy">
== 指向箭头 ==
</div>

<div class="mw-translate-fuzzy">
导航立方有6个指向箭头:4个三角箭头,位列上、下、左、右;以及2个弯曲箭头,分列上箭头的两侧。
</div>

=== Reverse view button ===

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.

<span id="Mini-cube_menu"></span>
<div class="mw-translate-fuzzy">
== 微型立方菜单 ==
</div>

<div class="mw-translate-fuzzy">
在导航立方的右下方有一个小立方体。点击此立方体将弹出一个菜单,借此来改变视图类型(正交视图(orthographic),透视视图(perspective),等角视图(isometric))或执行“缩放至适当视图(zoom to fit)”。
</div>

== Customization ==

=== Preferences ===

The Navigation Cube is controlled by several preferences: {{MenuCommand|Edit → Preferences... → Display → Navigation → Navigation cube}}. See [[Preferences_Editor#Navigation|Preferences Editor]].

=== 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]].

To manually set colors:

# 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.

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.

{| class="wikitable"
|-
! 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.

{{Version|0.21}}
| 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


|-
鼠标在导航立方上经过时,它会呈淡蓝色;点击时,会根据上面标明的视角对3D视图进行重新定位。在下面的示例中,已经通过[[Mouse Model|mouse gesture]]将3D视图旋转到一个“非标准”的方位。现在,鼠标指针正停留在导航立方的一个角上(根据淡蓝色可以判断出);若点击此角,便会令3D视图重新定位至此角正对您的标准轴测图。
| 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


|-
[[File:FreeCAD-v0-18-NavCube_SelectCorner.png]]
| FontZoom
| The size of the labels:
* {{Value|FontZoom &#61; 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 &#61; 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.


{{Version|0.21}}
== Directional Arrows ==
| Float
| 0.3


|-
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.
| OffsetX
| The offset of the cube in the X direction relative to its corner position in pixels.
| Integer
| 0


|-
Clicking the triangular arrows will rotate the 3D view 45 degrees around a line perpendicular to the direction of the arrow.
| OffsetY
Clicking the curved arrows will rotate the 3D view around a line pointing towards you.
| The offset of the cube in the Y direction relative to its corner position in pixels.
<!-- Note: the rotational axes are not properly defined;
| Integer
each is the intersection of two planes, but I can't figure out how to describe them -->
| 0


|-
== Main Navigation Cube ==
| ShowCS
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.
| Toggles the display of the coordinate system (the X, Y and Z axis indicators).
| Boolean
| true


|-
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.
| TextBottom
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 text on the bottom face of the cube. The default value should be translated.
* The face facing you (does nothing, since that is the current view)
| String
* The four edges of the current face
| BOTTOM
* 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.
| TextFront
In particular, edges are not selectable, nor are the four corners of the immediately facing face.
| The text on the front face of the cube. Idem.
| String
| FRONT


|-
=== Face Selection ===
| TextLeft
Clicking on a face will orient the 3D view with that particular face facing you.
| The text on the left face of the cube. Idem.
From a face view, other selection points are available as noted above.
| String
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.
| LEFT
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 ===
| TextRear
Unfortunately, edge selection is currently broken. Attempting to select an edge will select the face which lies behind it.
| The text on the rear face of the cube. Idem.
Clicking an edge should center that edge so it is facing you.
| String
| REAR


|-
=== Corner Selection ===
| TextRight
Clicking one of the corners will give you an axonometric view as seen from that corner.
| The text on the right face of the cube. Idem.
As noted above, currently when a face is directly facing you, the corners of that face are not selectable.
| String
| RIGHT


|-
== Mini-cube Menu ==
| TextTop
| The text on the top face of the cube. Idem
| String
| TOP


|}
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.


<div class="mw-translate-fuzzy">
{{docnav|Mouse Model|Document structure}}
{{docnav/zh-cn|[[Mouse Model/zh-cn|Mouse Model]]|[[Document structure/zh-cn|Document structure]]}}
</div>


{{Userdocnavi{{#translation:}}}}
[[Category:User Documentation]]
[[Category:User Documentation{{#translation:}}]]

Latest revision as of 21:12, 11 June 2023

Introduction

导航立方控制,或称导航立方是一种用于重新定位的图形用户界面。在默认情况下,它位于3D显示界面的右上角。如果您在标准的3D视图下查看,会发现它长相如下:

导航立方由以下几部分组成:

  • 指向箭头
  • 主导航立方
  • 微型立方菜单

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.

指向箭头

导航立方有6个指向箭头:4个三角箭头,位列上、下、左、右;以及2个弯曲箭头,分列上箭头的两侧。

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.

微型立方菜单

在导航立方的右下方有一个小立方体。点击此立方体将弹出一个菜单,借此来改变视图类型(正交视图(orthographic),透视视图(perspective),等角视图(isometric))或执行“缩放至适当视图(zoom to fit)”。

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:

  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:
    • 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).
  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).
  6. Optionally set more parameters.
  7. 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.

introduced in version 0.21

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:
  • FontZoom = 1.0: Make the labels as big as possible individually.
  • 0.0 < FontZoom < 1.0: Idem but limit the maximum font size.
  • FontZoom = 0.0: Idem but use the same font size for all.
  • FontZoom < 0.0: Use the same font size for all, but scaled down.

introduced in version 0.21

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