[Bf-docboard-svn] bf-manual: [8865] trunk/blender_docs/manual: Document new action frame range and bone opacity settings.

Alexander Gavrilov noreply at blender.org
Tue Jan 25 17:47:14 CET 2022 

Revision: 8865
          https://developer.blender.org/rBM8865
Author:   angavrilov
Date:     2022-01-25 17:47:14 +0100 (Tue, 25 Jan 2022)
Log Message:
-----------
Document new action frame range and bone opacity settings.

Ref rB1785286e rB5d59b386 rB72acce43

Modified Paths:
--------------
    trunk/blender_docs/manual/animation/actions.rst
    trunk/blender_docs/manual/editors/3dview/display/overlays.rst
    trunk/blender_docs/manual/editors/dope_sheet/introduction.rst
    trunk/blender_docs/manual/editors/nla/sidebar.rst
    trunk/blender_docs/manual/editors/timeline.rst

Added Paths:
-----------
    trunk/blender_docs/manual/images/animation_actions_range.png

Modified: trunk/blender_docs/manual/animation/actions.rst
===================================================================
--- trunk/blender_docs/manual/animation/actions.rst	2022-01-25 06:02:57 UTC (rev 8864)
+++ trunk/blender_docs/manual/animation/actions.rst	2022-01-25 16:47:14 UTC (rev 8865)
@@ -84,3 +84,41 @@
 
 This can be useful for adding deviation to a cyclic action like a :term:`Walk Cycle`,
 or to create a keyframe animation created from drivers or constraints.
+
+
+.. _actions-frame-range:
+
+Manual Frame Range
+==================
+
+.. figure:: /images/animation_actions_range.png
+   :align: center
+
+   Actions with and without a Manual Frame Range in Dope Sheet.
+
+It is possible to manually specify the intended useful frame range of an action via a panel
+available in the :doc:`Dope Sheet </editors/dope_sheet/introduction>` or the :doc:`NLA Editor </editors/nla/sidebar>`
+when a channel or NLA track is selected.
+
+Manual Frame Range
+   Specifies if the manual frame range should be used, and the frame values.
+
+   When the range is set, it is used instead of the actual range occupied by key frames
+   when adding a new track based on the action to NLA. It can also be used by exporters
+   to determine the range of frames to export.
+
+   The range is displayed in the background of the editor as diagonal hash fill, to
+   distinguish it from the solid fill of the current playback range.
+
+   The frame values are most commonly expected to be integers, but can be fractional.
+
+Cyclic Animation
+   Specifies that the action is intended to be cyclic over the specified range. The first and last
+   frames of the range should represent the same pose of the cycle one loop apart, i.e. the range
+   should include the duplicated initial key of the loop.
+
+   .. note::
+      This option signifies intent and does **not** make the action cycle on its own. However,
+      if :ref:`Cycle-Aware Keying <bpy.types.ToolSettings.use_keyframe_cycle_aware>` is enabled,
+      it will automatically enable cyclic extrapolation and set up the loop period for curves
+      newly added to the action.

Modified: trunk/blender_docs/manual/editors/3dview/display/overlays.rst
===================================================================
--- trunk/blender_docs/manual/editors/3dview/display/overlays.rst	2022-01-25 06:02:57 UTC (rev 8864)
+++ trunk/blender_docs/manual/editors/3dview/display/overlays.rst	2022-01-25 16:47:14 UTC (rev 8865)
@@ -317,14 +317,19 @@
    The opacity of the stencil mask overlay in Texture Paint Mode.
 
 
-Pose Mode
-=========
+Bones
+=====
 
 Fade Geometry
    Show the bones on top and face other geometry to the back.
    The opacity can be controlled with the slider.
 
+Bone Wireframe Opacity
+   Specifies the maximum opacity used for bones drawn in the *wireframe* style in Edit, Pose,
+   or Weight Paint modes. This is helpful when it is necessary to reduce clutter and focus on
+   the mesh rather than bones.
 
+
 .. _3dview-overlay-grease-pencil:
 
 Grease Pencil

Modified: trunk/blender_docs/manual/editors/dope_sheet/introduction.rst
===================================================================
--- trunk/blender_docs/manual/editors/dope_sheet/introduction.rst	2022-01-25 06:02:57 UTC (rev 8864)
+++ trunk/blender_docs/manual/editors/dope_sheet/introduction.rst	2022-01-25 16:47:14 UTC (rev 8865)
@@ -94,7 +94,10 @@
    * - Downwards arrow
      - Minimum Extreme keyframe (visible if :menuselection:`View --> Show Curve Extremes` are enabled)
 
+A diagonal hash fill in the background is used to display the
+:ref:`Manual Frame Range <actions-frame-range>` of the action the channel belong to.
 
+
 Selecting Keyframes
 -------------------
 
@@ -254,3 +257,19 @@
 Summary
    Toggles the "Dope Sheet Summary" channel at the top of the `Channels Region`_.
    This is used to give an overview of all the channels by combining all the actions into one channel.
+
+
+Sidebar Region
+--------------
+
+Action Panel
+^^^^^^^^^^^^
+
+.. figure:: /images/animation_actions_range.png
+   :align: center
+
+   Actions with and without a Manual Frame Range in Dope Sheet.
+
+When the editor is in the Action mode, or a channel belonging to an action is selected in
+Dope Sheet mode, this panel allows changing some settings of the selected action, specifically
+the :ref:`Manual Frame Range <actions-frame-range>`.

Modified: trunk/blender_docs/manual/editors/nla/sidebar.rst
===================================================================
--- trunk/blender_docs/manual/editors/nla/sidebar.rst	2022-01-25 06:02:57 UTC (rev 8864)
+++ trunk/blender_docs/manual/editors/nla/sidebar.rst	2022-01-25 16:47:14 UTC (rev 8865)
@@ -187,6 +187,17 @@
    Also expands the strip, but by looping from the first keyframe and going forward.
 
 
+Action
+------
+
+.. reference::
+
+   :Panel:     :menuselection:`Sidebar region --> Animations --> Action`
+
+This panel is identical to the one in Dope Sheet, and allows viewing or changing properties of the
+action used in the Action Clip, i.e. :ref:`Manual Frame Range <actions-frame-range>`.
+
+
 Modifiers
 =========
 

Modified: trunk/blender_docs/manual/editors/timeline.rst
===================================================================
--- trunk/blender_docs/manual/editors/timeline.rst	2022-01-25 06:02:57 UTC (rev 8864)
+++ trunk/blender_docs/manual/editors/timeline.rst	2022-01-25 16:47:14 UTC (rev 8865)
@@ -220,7 +220,11 @@
      it is remapped back inside the range.
    - When overwriting one of the end keys, the other one is updated accordingly.
 
+   In addition, when adding a new curve into an action with a :ref:`Manual Frame Range <actions-frame-range>`
+   and *Cyclic Animation* enabled, the curve is automatically made cyclic with the period matching the frame range.
+   For convenience this check and conversion is also done before adding the second keyframe to such a curve.
 
+
 .. Move to some content to animation?
 .. _bpy.types.ToolSettings.use_keyframe_insert_auto:
 

Added: trunk/blender_docs/manual/images/animation_actions_range.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/animation_actions_range.png
===================================================================
--- trunk/blender_docs/manual/images/animation_actions_range.png	2022-01-25 06:02:57 UTC (rev 8864)
+++ trunk/blender_docs/manual/images/animation_actions_range.png	2022-01-25 16:47:14 UTC (rev 8865)

Property changes on: trunk/blender_docs/manual/images/animation_actions_range.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+image/png
\ No newline at end of property

More information about the Bf-docboard-svn mailing list