Navigation Cube/ja: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(One intermediate revision by the same user not shown)
Line 27: Line 27:
=== Main cube ===
=== 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 will reorient the camera so that its direction is perpendicular to the selected face.
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>
<span id="Directional_arrows"></span>
Line 40: Line 40:
=== Reverse view button ===
=== Reverse view button ===


Clicking the round button in the top right corner of the Navigation Cube will rotate the [[3D_view|3D view]] 180 degrees around the vertical axis of the view.
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>
<span id="Mini-cube_menu"></span>
Line 54: Line 54:


== Customization ==
== Customization ==

=== Move the Navigation Cube ===

<div class="mw-translate-fuzzy">
==ナビゲーションキューブの表示を移動する==
メインナビゲーションキューブ内の任意の場所でマウスを押してドラッグすると、ナビゲーションキューブ制御構造全体を3D表示内の別の場所に移動できます。
この記事の執筆時点(0.18)では、マウスポインタがメインナビゲーションキューブの端を越えて移動するまで構造は開始されません。
</div>


=== Preferences ===
=== Preferences ===
Line 69: Line 61:
=== 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]]. 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]].


To manually set colors:
To manually set colors:
Line 77: Line 69:
# Right-click the panel on the right and select {{MenuCommand|New unsigned item}} from the context menu.
# 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:
# Enter the name of one of these colors:
#* {{MenuCommand|BorderColor}}: the lines separating the cube faces, default is {{Value|4281479730}} (hex: {{Value|ff323232}}).
#* {{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|ButtonColor}}: all elements around the cube, default is {{Value|2162354671}} (hex: {{Value|80e2e9ef}}).
#* {{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|FrontColor}}: all cube faces, default is {{Value|3236096495}} (hex: {{Value|c0e2e9ef}}).
#* {{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)}}.
#* {{MenuCommand|HiliteColor}}: the cube or arrow face that is currently highlighted, default is {{Value|4289389311}} (hex: {{Value|ffaae2ff}}).
# Optionally set more parameters.
#* {{MenuCommand|TextColor}}: the text on the cube faces, default is {{Value|4278190080}} (hex: {{Value|ff000000}}).
# 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 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("ff323232", 16)}}, or an online service such as [https://cryptii.com/pipes/integer-encoder this one].
# Optionally set more colors.
# Press the {{Button|Close}} button.
# 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.
To manually set the border width:


{| class="wikitable"
# Start the [[Image:Std_DlgParameter.svg|16px]] [[Std_DlgParameter|Parameter editor]].
|-
# In the panel on the left browse to {{MenuCommand|BaseApp → Preferences → NaviCube}}.
! Name
# Right-click the panel on the right and select {{MenuCommand|New float item}} from the context menu.
! Description
# Enter the name {{MenuCommand|BorderWidth}}, {{Value|default is 1.1}}.
! Type
# Enter the width.
! Default
# Press the {{Button|Close}} button.

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

|-
| 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:
* {{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}}
| 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

|}





Latest revision as of 21:11, 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.

ナビゲーションキューブは、次の部分で構成されています。

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

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

6つの方向矢印があります。4つの三角矢印、上、下、左、右に1つずつ。 2つの湾曲した矢印。1つは上の矢印の両側にあります。

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.

Mini-cube Menu

ナビゲーションキューブの右下隅には小さなキューブがあります。 この立方体をクリックすると、ビューのタイプを変更するために使用できるメニューが表示されます(直交図、遠近法、等角図)。 そして、「ズームしてフィット」を実行します。

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


Mouse Model
Document structure