[Bf-docboard-svn] bf-manual: [9033] trunk/blender_docs/manual: Merge branch 'blender-3.1-release'
Brecht Van Lommel
noreply at blender.org
Fri Feb 25 20:00:21 CET 2022
Revision: 9033
https://developer.blender.org/rBM9033
Author: brecht
Date: 2022-02-25 20:00:21 +0100 (Fri, 25 Feb 2022)
Log Message:
-----------
Merge branch 'blender-3.1-release'
Modified Paths:
--------------
trunk/blender_docs/manual/animation/armatures/bones/properties/display.rst
trunk/blender_docs/manual/editors/index.rst
trunk/blender_docs/manual/editors/preferences/navigation.rst
trunk/blender_docs/manual/images/editors_index_menu.png
trunk/blender_docs/manual/interface/controls/buttons/buttons.rst
trunk/blender_docs/manual/interface/controls/buttons/menus.rst
trunk/blender_docs/manual/interface/controls/nodes/sidebar.rst
trunk/blender_docs/manual/interface/controls/templates/operator_search.rst
trunk/blender_docs/manual/interface/index.rst
trunk/blender_docs/manual/interface/undo_redo.rst
trunk/blender_docs/manual/interface/window_system/regions.rst
trunk/blender_docs/manual/render/cycles/object_settings/cameras.rst
Added Paths:
-----------
trunk/blender_docs/manual/interface/operators.rst
Property Changed:
----------------
trunk/blender_docs/
Index: trunk/blender_docs
===================================================================
--- trunk/blender_docs 2022-02-25 18:57:55 UTC (rev 9032)
+++ trunk/blender_docs 2022-02-25 19:00:21 UTC (rev 9033)
Property changes on: trunk/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -1,4 +1,4 ##
/branches/blender-2.92-release/blender_docs:7610-7921
/branches/blender-2.93-release/blender_docs:7959-8113
-/branches/blender-3.0-release/blender_docs:8543-8943
-/branches/blender-3.1-release/blender_docs:8904-9020
\ No newline at end of property
+/branches/blender-3.0-release/blender_docs:8543-9029
+/branches/blender-3.1-release/blender_docs:8904-9032
\ No newline at end of property
Modified: trunk/blender_docs/manual/animation/armatures/bones/properties/display.rst
===================================================================
--- trunk/blender_docs/manual/animation/armatures/bones/properties/display.rst 2022-02-25 18:57:55 UTC (rev 9032)
+++ trunk/blender_docs/manual/animation/armatures/bones/properties/display.rst 2022-02-25 19:00:21 UTC (rev 9033)
@@ -20,7 +20,6 @@
.. _bpy.types.PoseBone.custom_shape:
-.. _bpy.types.Bone.show_wire:
Custom Shape
============
@@ -32,12 +31,24 @@
Custom Object
Object that defines the custom shape of the selected bone.
+
+Scale X, Y, Z
+ Additional scaling factor to apply to the custom shape.
+
+Translation X, Y, Z
+ Additional translation factor to apply to the custom shape.
+
+Rotation X, Y, Z
+ Additional rotation factor to apply to the custom shape.
+
Override Transform
Bone that defines the display transform of the custom shape.
-Scale
- Additional scaling factor to apply to the custom shape.
+
Scale to Bone Length
Option not to use bones length, so that changes in Edit Mode don't resize the custom shape.
+
+.. _bpy.types.Bone.show_wire:
+
Wireframe
When enabled, bone is displayed in wireframe mode regardless of the viewport display mode.
Useful for non-obstructive custom bone chains.
Modified: trunk/blender_docs/manual/editors/index.rst
===================================================================
--- trunk/blender_docs/manual/editors/index.rst 2022-02-25 18:57:55 UTC (rev 9032)
+++ trunk/blender_docs/manual/editors/index.rst 2022-02-25 19:00:21 UTC (rev 9033)
@@ -29,10 +29,10 @@
3dview/index.rst
image/index.rst
uv/index.rst
- shader_editor.rst
compositor.rst
+ texture_node/index.rst
geometry_node.rst
- texture_node/index.rst
+ shader_editor.rst
video_sequencer/index.rst
clip/index.rst
@@ -68,5 +68,5 @@
properties_editor.rst
file_browser.rst
asset_browser.rst
+ spreadsheet.rst
preferences/index.rst
- spreadsheet.rst
Modified: trunk/blender_docs/manual/editors/preferences/navigation.rst
===================================================================
--- trunk/blender_docs/manual/editors/preferences/navigation.rst 2022-02-25 18:57:55 UTC (rev 9032)
+++ trunk/blender_docs/manual/editors/preferences/navigation.rst 2022-02-25 19:00:21 UTC (rev 9033)
@@ -50,9 +50,6 @@
it can be inconvenient for larger objects such as a terrain mesh,
where the center is not necessarily a point of interest.
-Natural Trackpad Direction
- Todo (macOS only).
-
.. _prefs-interface-auto-perspective:
.. _prefs-auto-depth:
Modified: trunk/blender_docs/manual/images/editors_index_menu.png
===================================================================
(Binary files differ)
Modified: trunk/blender_docs/manual/interface/controls/buttons/buttons.rst
===================================================================
--- trunk/blender_docs/manual/interface/controls/buttons/buttons.rst 2022-02-25 18:57:55 UTC (rev 9032)
+++ trunk/blender_docs/manual/interface/controls/buttons/buttons.rst 2022-02-25 19:00:21 UTC (rev 9033)
@@ -14,8 +14,9 @@
Operator button.
-Operator buttons perform an action when clicked with :kbd:`LMB`.
-Button may show an icon, text, or both.
+Operator buttons execute an :doc:`Operator </interface/operators>`
+which in summary execute an action when clicked with :kbd:`LMB`.
+Operator buttons may be an icon, text, or text with an icon.
.. container:: lead
Modified: trunk/blender_docs/manual/interface/controls/buttons/menus.rst
===================================================================
--- trunk/blender_docs/manual/interface/controls/buttons/menus.rst 2022-02-25 18:57:55 UTC (rev 9032)
+++ trunk/blender_docs/manual/interface/controls/buttons/menus.rst 2022-02-25 19:00:21 UTC (rev 9033)
@@ -4,7 +4,7 @@
Menus
*****
-Blender uses a variety of different menus for accessing options and operators.
+Blender uses a variety of different menus for accessing options and :doc:`/interface/operators`.
Selecting menus can be interacted with in the following ways:
Mouse selection
@@ -31,8 +31,8 @@
or by :kbd:`LMB` clicking anywhere out of it.
+.. _bpy.types.UIPopupMenu:
.. _ui-header-menu:
-.. _bpy.types.UIPopupMenu:
Header Menus
============
Modified: trunk/blender_docs/manual/interface/controls/nodes/sidebar.rst
===================================================================
--- trunk/blender_docs/manual/interface/controls/nodes/sidebar.rst 2022-02-25 18:57:55 UTC (rev 9032)
+++ trunk/blender_docs/manual/interface/controls/nodes/sidebar.rst 2022-02-25 19:00:21 UTC (rev 9033)
@@ -47,7 +47,7 @@
Color of the node background.
Node Color Specials
- This menu contains operators for working with nodes with custom colors.
+ This menu contains :doc:`/interface/operators` for working with nodes with custom colors.
.. _bpy.ops.node.node_copy_color:
Modified: trunk/blender_docs/manual/interface/controls/templates/operator_search.rst
===================================================================
--- trunk/blender_docs/manual/interface/controls/templates/operator_search.rst 2022-02-25 18:57:55 UTC (rev 9032)
+++ trunk/blender_docs/manual/interface/controls/templates/operator_search.rst 2022-02-25 19:00:21 UTC (rev 9033)
@@ -15,7 +15,8 @@
:Menu: :menuselection:`Edit --> Menu Search`
:Shortcut: :kbd:`F3`
-The Menu Search pop-up searches Blender's interface for a desired operator and allows you to execute that operator.
+The Menu Search pop-up searches Blender's interface for a desired
+:doc:`/interface/operators` and allows you to execute that operator.
It displays a list of matches and shows which menu the operator was found in.
Start typing the name of the operator you want to refine the list.
When the list is sufficiently narrowed, :kbd:`LMB` on the desired operator or
@@ -44,7 +45,8 @@
When :ref:`Developer Extras <prefs-interface-dev-extras>` are activated
the Operator Search can be accessed from the Edit menu in the Topbar.
-This search menu search all operators within Blender even if they are not exposed in a menu.
+This search menu search all :doc:`/interface/operators`
+within Blender even if they are not exposed in a menu.
This is useful for Python developers for testing purposes.
Blender might also include a few advanced operators that are not
exposed in a menu and can only be accessed via this search menu.
Modified: trunk/blender_docs/manual/interface/index.rst
===================================================================
--- trunk/blender_docs/manual/interface/index.rst 2022-02-25 18:57:55 UTC (rev 9032)
+++ trunk/blender_docs/manual/interface/index.rst 2022-02-25 19:00:21 UTC (rev 9033)
@@ -68,13 +68,14 @@
controls/nodes/index.rst
-Tools
-=====
+Tools & Operators
+=================
.. toctree::
:maxdepth: 1
tool_system.rst
+ operators.rst
undo_redo.rst
annotate_tool.rst
selecting.rst
Copied: trunk/blender_docs/manual/interface/operators.rst (from rev 9032, branches/blender-3.1-release/blender_docs/manual/interface/operators.rst)
===================================================================
--- trunk/blender_docs/manual/interface/operators.rst (rev 0)
+++ trunk/blender_docs/manual/interface/operators.rst 2022-02-25 19:00:21 UTC (rev 9033)
@@ -0,0 +1,42 @@
+
+*********
+Operators
+*********
+
+Operators execute an action as soon as the operator is started
+which make them different from tools which require some sort of input.
+Operators can be started from a :ref:`ui-operator-buttons`,
+:ref:`ui-header-menu`, or :ref:`bpy.ops.wm.search_menu`.
+Examples of operators include adding a new object,
+deleting it, or setting its shading to smooth.
+
+
+Operator Properties
+===================
+
+Most operators have properties that can be adjusted to refine the result of the operation.
+To adjust an operators properties, the operator must first be executed.
+This will execute the operation with its default property values.
+These properties can then be adjusted using :ref:`bpy.ops.screen.redo_last`.
+
+
+Modal Operators
+===============
+
+Modal operators exist as concept in between :doc:`Tools </interface/tool_system>`
+and regular described above operators.
+They require some sort of input to interactively control the operator's properties.
+
+
+Slider Operators
+----------------
+
+Slider operators are a type of modal operator used interactively adjust a factor property.
+Slider operators will display a percentage graphic in the editor's :ref:`ui-region-header`.
+Slider operators can adjust the operator's factor value by moving
+the mouse left or right to decrease or increase the factor property.
+
+Values can be snapped to 10% increments by holding :kbd:`Ctrl`
+and changed using precision by holding :kbd:`Shift`.
+Values can extend beyond the 0-100% range by toggling "overshoot" on with :kbd:`E`.
+Note, overshoot is not be available for all slider operators.
Modified: trunk/blender_docs/manual/interface/undo_redo.rst
===================================================================
--- trunk/blender_docs/manual/interface/undo_redo.rst 2022-02-25 18:57:55 UTC (rev 9032)
+++ trunk/blender_docs/manual/interface/undo_redo.rst 2022-02-25 19:00:21 UTC (rev 9033)
@@ -52,7 +52,7 @@
:Menu: :menuselection:`Edit --> Adjust Last Operation...`
:Shortcut: :kbd:`F9`
-After an operation is complete you can tweak the parameters of the operation afterwards.
+After an operation is complete you can tweak the parameters of :doc:`/interface/operators` afterwards.
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list