[Bf-docboard-svn] bf-manual: [7022] trunk/blender_docs/manual: Combine gizmo docs
Aaron Carlisle
carlisle.b3d at gmail.com
Tue Sep 1 23:39:39 CEST 2020
Revision: 7022
https://developer.blender.org/rBM7022
Author: Blendify
Date: 2020-09-01 23:39:39 +0200 (Tue, 01 Sep 2020)
Log Message:
-----------
Combine gizmo docs
Modified Paths:
--------------
trunk/blender_docs/manual/editors/3dview/display/gizmo.rst
trunk/blender_docs/manual/scene_layout/object/editing/transform/control/index.rst
Removed Paths:
-------------
trunk/blender_docs/manual/scene_layout/object/editing/transform/control/gizmos.rst
Modified: trunk/blender_docs/manual/editors/3dview/display/gizmo.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/display/gizmo.rst 2020-09-01 21:11:59 UTC (rev 7021)
+++ trunk/blender_docs/manual/editors/3dview/display/gizmo.rst 2020-09-01 21:39:39 UTC (rev 7022)
@@ -1,3 +1,4 @@
+.. |gizmo-icon| image:: /images/scene-layout_object_editing_transform_control_gizmos_header.png
.. _bpy.types.SpaceView3D.show_gizmo:
***************
@@ -4,6 +5,12 @@
Viewport Gizmos
***************
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Object and Edit Modes
+ :Header: |gizmo-icon| :menuselection:`Viewport Gizmos --> Object Gizmos`
+
The way how gizmos are displayed in the 3D Viewport can be changed in the Viewport Gizmos pop-over.
There is a switch to turn off all gizmos for the 3D Viewport.
@@ -22,17 +29,57 @@
Object Gizmos
=============
+The Object Gizmos allows mouse controlled translation, rotation and scaling in the 3D Viewport.
+There is a separate gizmos for each operation.
+Each gizmo can be used separately or in combination with the others.
+You can use the gizmos by dragging one of the three colored axes with :kbd:`LMB`.
+The transformation will be locked to the clicked axis.
+
+Holding down :kbd:`Shift` *after* you :kbd:`LMB`
+the gizmo handle will constrain the action to smaller increments.
+Holding down :kbd:`Shift` *before* you :kbd:`LMB` click on one of the handles will cause the gizmo action
+to be performed relative to the other two axes. See :ref:`view3d-transform-plane-lock`.
+
Orientation
The orientation to use for the gizmo. The orientations can be
configured in the viewport orientation :doc:`Orientations menu </editors/3dview/controls/orientation>`.
Move
Show the gizmo to control the location.
+ Dragging the small white circle allows free transformation.
Rotate
Show the gizmo to control the rotation.
+ When you hover your mouse over the gizmo a highlighted circle will appear,
+ clicking this will activate :ref:`trackball rotation <view3d-transform-trackball>`.
Scale
Show the gizmo to control the scaling.
+.. list-table::
+ * - .. figure:: /images/scene-layout_object_editing_transform_control_gizmos_options-translate.png
+ :width: 320px
+
+ Move.
+
+ - .. figure:: /images/scene-layout_object_editing_transform_control_gizmos_options-rotate.png
+ :width: 320px
+
+ Rotate.
+
+ - .. figure:: /images/scene-layout_object_editing_transform_control_gizmos_options-scale.png
+ :width: 320px
+
+ Scale.
+
+ - .. figure:: /images/scene-layout_object_editing_transform_control_gizmos_options-all.png
+ :width: 320px
+
+ Combination.
+
+.. seealso::
+
+ The :ref:`Gizmo Preferences <prefs-viewport-gizmo-size>`.
+
+
Empty
=====
Deleted: trunk/blender_docs/manual/scene_layout/object/editing/transform/control/gizmos.rst
===================================================================
--- trunk/blender_docs/manual/scene_layout/object/editing/transform/control/gizmos.rst 2020-09-01 21:11:59 UTC (rev 7021)
+++ trunk/blender_docs/manual/scene_layout/object/editing/transform/control/gizmos.rst 2020-09-01 21:39:39 UTC (rev 7022)
@@ -1,92 +0,0 @@
-.. |gizmo-icon| image:: /images/scene-layout_object_editing_transform_control_gizmos_header.png
-
-*********************
-Transformation Gizmos
-*********************
-
-.. admonition:: Reference
- :class: refbox
-
- :Mode: Object and Edit Modes
- :Header: |gizmo-icon| :menuselection:`Viewport Gizmos --> Object Gizmos`
-
-The Transformation gizmo allows mouse controlled translation, rotation and scaling in the 3D Viewport.
-There is a separate gizmos for each operation.
-Each gizmo can be used separately or in combination with the others.
-
-.. container:: lead
-
- .. clear
-
-.. list-table:: The different Gizmos.
-
- * - .. figure:: /images/scene-layout_object_editing_transform_control_gizmos_options-translate.png
- :width: 320px
-
- Move.
-
- - .. figure:: /images/scene-layout_object_editing_transform_control_gizmos_options-rotate.png
- :width: 320px
-
- Rotate.
-
- - .. figure:: /images/scene-layout_object_editing_transform_control_gizmos_options-scale.png
- :width: 320px
-
- Scale.
-
- - .. figure:: /images/scene-layout_object_editing_transform_control_gizmos_options-scalecage.png
- :width: 320px
-
- Scale Cage.
-
- - .. figure:: /images/scene-layout_object_editing_transform_control_gizmos_options-all.png
- :width: 320px
-
- Combination.
-
-
-Tool Settings
-=============
-
-.. admonition:: Reference
- :class: refbox
-
- :Mode: Object and Edit Modes
- :Menu: :menuselection:`Tool Settings --> Orientation`
-
-Orientation
- Rotates the gizmo so that it is aligned to one of
- the :doc:`Transformation Orientations </editors/3dview/controls/orientation>`.
-
-
-Gizmo Controls
-==============
-
-Basic
------
-
-You can use the widget by dragging one of the three colored axes with :kbd:`LMB`.
-The transformation will be locked to the clicked axis.
-
-Dragging the small white circle allows free transformation.
-In case of the rotation gizmo a highlighted circle will appear when you hover your mouse over the object.
-This will activate :ref:`trackball rotation <view3d-transform-trackball>`.
-
-Releasing the mouse confirms the operation (*confirm on release*).
-
-
-Extended
---------
-
-The operations work in same way as described in
-:doc:`precision control </scene_layout/object/editing/transform/control/precision>` except:
-
-Holding down :kbd:`Shift` *after* you :kbd:`LMB`
-the gizmo handle will constrain the action to smaller increments.
-Holding down :kbd:`Shift` *before* you :kbd:`LMB` click on one of the handles will cause the gizmo action
-to be performed relative to the other two axes. See :ref:`view3d-transform-plane-lock`.
-
-.. seealso::
-
- The :ref:`Gizmo Preferences <prefs-viewport-gizmo-size>`.
Modified: trunk/blender_docs/manual/scene_layout/object/editing/transform/control/index.rst
===================================================================
--- trunk/blender_docs/manual/scene_layout/object/editing/transform/control/index.rst 2020-09-01 21:11:59 UTC (rev 7021)
+++ trunk/blender_docs/manual/scene_layout/object/editing/transform/control/index.rst 2020-09-01 21:39:39 UTC (rev 7022)
@@ -8,7 +8,6 @@
.. toctree::
:maxdepth: 2
- gizmos.rst
numeric_input.rst
axis_locking.rst
precision.rst
More information about the Bf-docboard-svn
mailing list