[Bf-docboard-svn] bf-manual: [9412] trunk/blender_docs/manual: Dopesheet: Add Custom Properties panel

[Aaron Carlisle]

Revision: 9412
          https://developer.blender.org/rBM9412
Author:   Blendify
Date:     2022-07-14 00:01:41 +0200 (Thu, 14 Jul 2022)
Log Message:
-----------
Dopesheet: Add Custom Properties panel

rB57816a6435c3a6efc98c575ec0a02ad0dd07622c

Modified Paths:
--------------
    trunk/blender_docs/manual/animation/actions.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

Modified: trunk/blender_docs/manual/animation/actions.rst
===================================================================
--- trunk/blender_docs/manual/animation/actions.rst	2022-07-13 21:46:00 UTC (rev 9411)
+++ trunk/blender_docs/manual/animation/actions.rst	2022-07-13 22:01:41 UTC (rev 9412)
@@ -65,11 +65,9 @@
 The :doc:`NLA Editor </editors/nla/index>` is used to blend multiple actions together.
 
 
-.. _actions-frame-range:
+Properties
+==========
 
-Manual Frame Range
-==================
-
 .. figure:: /images/animation_actions_range.png
    :align: center
 
@@ -79,8 +77,12 @@
 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.
 
+.. _bpy.types.Action.use_frame_range:
+
 Manual Frame Range
-   Specifies if the manual frame range should be used, and the frame values.
+   Manually specify the intended playback frame range for the action
+   (this range is used by some tools, but does not affect animation evaluation).
+   The manual frame range feature can be toggled with the checkbox.
 
    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
@@ -91,6 +93,8 @@
 
    The frame values are most commonly expected to be integers, but can be fractional.
 
+.. _bpy.types.Action.use_cyclic:
+
 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
@@ -97,7 +101,15 @@
    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.
+
+
+Custom Properties
+-----------------
+
+Create and manage your own properties to store data in the action's data block.
+See the :ref:`Custom Properties <files-data_blocks-custom-properties>` page for more information.

Modified: trunk/blender_docs/manual/editors/dope_sheet/introduction.rst
===================================================================
--- trunk/blender_docs/manual/editors/dope_sheet/introduction.rst	2022-07-13 21:46:00 UTC (rev 9411)
+++ trunk/blender_docs/manual/editors/dope_sheet/introduction.rst	2022-07-13 22:01:41 UTC (rev 9412)
@@ -95,7 +95,7 @@
      - 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.
+:ref:`Manual Frame Range <bpy.types.Action.use_frame_range>` of the action the channel belong to.
 
 
 Selecting Keyframes
@@ -275,4 +275,12 @@
 
 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>`.
+the :ref:`Manual Frame Range <bpy.types.Action.use_frame_range>`.
+
+
+Custom Properties
+^^^^^^^^^^^^^^^^^
+
+Create and manage your own properties to store data in the action's data block.
+See the :ref:`Custom Properties <files-data_blocks-custom-properties>` page for more information.
+

Modified: trunk/blender_docs/manual/editors/nla/sidebar.rst
===================================================================
--- trunk/blender_docs/manual/editors/nla/sidebar.rst	2022-07-13 21:46:00 UTC (rev 9411)
+++ trunk/blender_docs/manual/editors/nla/sidebar.rst	2022-07-13 22:01:41 UTC (rev 9412)
@@ -195,7 +195,7 @@
    :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>`.
+action used in the Action Clip, i.e. :ref:`Manual Frame Range <bpy.types.Action.use_frame_range>`.
 
 
 Modifiers

Modified: trunk/blender_docs/manual/editors/timeline.rst
===================================================================
--- trunk/blender_docs/manual/editors/timeline.rst	2022-07-13 21:46:00 UTC (rev 9411)
+++ trunk/blender_docs/manual/editors/timeline.rst	2022-07-13 22:01:41 UTC (rev 9412)
@@ -222,7 +222,7 @@
      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>`
+   In addition, when adding a new curve into an action with a :ref:`Manual Frame Range <bpy.types.Action.use_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.