[Bf-docboard-svn] bf-manual: [6996] trunk/blender_docs/manual: Todo: Pose Library
Aaron Carlisle
carlisle.b3d at gmail.com
Tue Aug 25 21:21:08 CEST 2020
Revision: 6996
https://developer.blender.org/rBM6996
Author: Blendify
Date: 2020-08-25 21:21:08 +0200 (Tue, 25 Aug 2020)
Log Message:
-----------
Todo: Pose Library
Modified Paths:
--------------
trunk/blender_docs/manual/animation/armatures/posing/editing/index.rst
trunk/blender_docs/manual/animation/armatures/properties/pose_library.rst
trunk/blender_docs/manual/images/animation_armatures_properties_pose-library_panel.png
Added Paths:
-----------
trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst
Modified: trunk/blender_docs/manual/animation/armatures/posing/editing/index.rst
===================================================================
--- trunk/blender_docs/manual/animation/armatures/posing/editing/index.rst 2020-08-25 18:48:03 UTC (rev 6995)
+++ trunk/blender_docs/manual/animation/armatures/posing/editing/index.rst 2020-08-25 19:21:08 UTC (rev 6996)
@@ -12,5 +12,6 @@
in_betweens.rst
propagate.rst
copy_paste.rst
+ pose_library.rst
flip_quats.rst
show_hide.rst
Added: trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst
===================================================================
--- trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst (rev 0)
+++ trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst 2020-08-25 19:21:08 UTC (rev 6996)
@@ -0,0 +1,106 @@
+.. _.. _bpy.ops.poselib:
+
+************
+Pose Library
+************
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Pose Mode
+ :Menu: :menuselection:`Pose --> Pose Library`
+
+The Pose Library is a way to store pose positions so the same position
+can be used again later in the animation or to store different rest poses.
+*Pose Libraries* are saved to :doc:`Actions </animation/actions>`.
+They are not generally used as actions, but can be converted to and from.
+
+.. seealso::
+
+ :doc:`Pose Library Properties </animation/armatures/properties/pose_library>`.
+
+
+.. _bpy.ops.poselib.browse_interactive:
+
+Browse Poses
+============
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Edit Mode
+ :Menu: :menuselection:`Pose --> Pose Library --> Browse Poses`
+ :Hotkey: :kbd:`Alt-L`
+
+Interactively browse poses in the 3D Viewport.
+After running the operator, cycle through poses using the :kbd:`Left` and :kbd:`Right` arrow keys.
+The name of the pose being previewed is displayed in the header region.
+After the desired pose is selected using :kbd:`Enter` or :kbd:`LMB` to make that the active pose;
+to cancel browsing, use :kbd:`Esc` or :kbd:`RMB`.
+
+Pose
+ Index of the pose to apply (-2 for no change, -1 to use the active pose).
+
+
+.. _bpy.ops.poselib.pose_add:
+
+Add Pose
+========
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Edit Mode
+ :Menu: :menuselection:`Pose --> Pose Library --> Add Pose`
+ :Hotkey: :kbd:`Shift-L`
+
+If a pose is added, a :ref:`pose marker <marker-pose-add>` is created.
+
+The :ref:`Whole Character keying set <whole-character-keying-set>` is used to
+determine which bones to key. If any bones are selected, only keyframes for
+those bones are added, otherwise all bones in the keying set are keyed.
+Bones that are ignored by the *Whole Character* keying set are always ignored,
+regardless of their selection state.
+
+Add New
+ Adds a new pose to the active Pose Library with the current pose of the armature.
+Add New (Current Frame).
+ Will add a pose to the Pose Library based on the current frame selected in the Timeline.
+ In contrast to *Add New* and *Replace Existing* which automatically allocate a pose to an action frame.
+Replace Existing
+ Replace an existing pose in the active Pose Library with the current pose of the armature.
+
+
+.. _bpy.ops.poselib.pose_rename:
+
+Rename Pose
+===========
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Edit Mode
+ :Menu: :menuselection:`Pose --> Pose Library --> Rename Pose`
+ :Hotkey: :kbd:`Shift-Ctrl-L`
+
+Changes the name of the specified pose from the active pose library.
+
+New Pose Name
+ The new name for the pose.
+Pose
+ The pose action to rename.
+
+
+.. _bpy.ops.poselib.pose_remove:
+
+Remove Pose
+===========
+
+.. admonition:: Reference
+ :class: refbox
+
+ :Mode: Edit Mode
+ :Menu: :menuselection:`Pose --> Pose Library --> Remove Pose`
+ :Hotkey: :kbd:`Shift-Alt-L`
+
+Deletes the specified pose from the active pose library.
Property changes on: trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/animation/armatures/properties/pose_library.rst
===================================================================
--- trunk/blender_docs/manual/animation/armatures/properties/pose_library.rst 2020-08-25 18:48:03 UTC (rev 6995)
+++ trunk/blender_docs/manual/animation/armatures/properties/pose_library.rst 2020-08-25 19:21:08 UTC (rev 6996)
@@ -1,8 +1,7 @@
-.. _bpy.ops.poselib:
-******************
-Pose Library Panel
-******************
+************
+Pose Library
+************
.. admonition:: Reference
:class: refbox
@@ -10,24 +9,32 @@
:Mode: All Modes
:Panel: :menuselection:`Properties --> Object Properties --> Pose Library`
-.. TODO2.8
- .. figure:: /images/animation_armatures_properties_pose-library_panel.png
- :align: right
+.. figure:: /images/animation_armatures_properties_pose-library_panel.png
+ :align: right
- The Pose Library panel.
+ The Pose Library panel.
-The *Pose Library* panel is used to save, apply, and manage armature poses.
+The Pose Library is a way to store pose positions so the same position
+can be used again later in the animation or to store different rest poses.
*Pose Libraries* are saved to :doc:`Actions </animation/actions>`.
They are not generally used as actions, but can be converted to and from.
+The *Pose Library* panel is used to save, apply, and manage armature poses.
+.. seealso::
+
+ :doc:`Pose Library Editing </animation/armatures/posing/editing/pose_library>`.
+
+
Action
A :ref:`ui-data-block` for Actions or Pose Libraries.
+
+.. _bpy.types.ActionPoseMarkers.active_index:
+
Pose Libraries
A :ref:`List view <ui-list-view>` of poses for the active Pose Library.
Add ``+``
If a pose is added, a :ref:`pose marker <marker-pose-add>` is created.
-
The :ref:`Whole Character keying set <whole-character-keying-set>` is used to
determine which bones to key. If any bones are selected, only keyframes for
those bones are added, otherwise all bones in the keying set are keyed.
@@ -41,28 +48,20 @@
In contrast to *Add New* and *Replace Existing* which automatically allocate a pose to an action frame.
Replace Existing
Replace an existing pose in the active Pose Library with the current pose of the armature.
+
+.. _bpy.ops.poselib.apply_pose:
+
Apply Pose (magnifying glass icon)
Applies the active pose to the selected pose bones.
+
+.. _bpy.ops.poselib.action_sanitize:
+
Sanitize Action (book icon)
Makes an action suitable for use as a Pose Library.
This is used to convert an Action to a Pose Library.
A pose is added to the Pose Library for each frame with keyframes.
+
+.. _bpy.ops.poselib.pose_move:
+
Move (up/down arrow icon)
Moves the pose up/down in the list.
-
-
-.. TODO Move to pose editing.
-
-Menu
-====
-
-.. admonition:: Reference
- :class: refbox
-
- :Mode: Pose Mode
- :Menu: :menuselection:`Pose --> Pose Library`
-
-- Browse Poses. :kbd:`Alt-L`.
-- Add Pose. :kbd:`Shift-L`.
-- Rename Pose. :kbd:`Shift-Ctrl-L`.
-- Remove Pose. :kbd:`Shift-Alt-L`.
Modified: trunk/blender_docs/manual/images/animation_armatures_properties_pose-library_panel.png
===================================================================
(Binary files differ)
More information about the Bf-docboard-svn
mailing list