[Bf-docboard-svn] bf-manual: [8688] trunk/blender_docs/manual: Asset Browser & Pose Library

Fri Nov 26 16:05:09 CET 2021

Revision: 8688
          https://developer.blender.org/rBM8688
Author:   sybren
Date:     2021-11-26 16:05:09 +0100 (Fri, 26 Nov 2021)
Log Message:
-----------
Asset Browser & Pose Library

Modified Paths:
--------------
    trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst
    trunk/blender_docs/manual/animation/armatures/properties/pose_library.rst
    trunk/blender_docs/manual/editors/asset_browser.rst
    trunk/blender_docs/manual/files/asset_libraries/introduction.rst
    trunk/blender_docs/manual/images/asset_browser-gold-material.png

Modified: trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst
===================================================================

--- trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst	2021-11-26 05:42:15 UTC (rev 8687)
+++ trunk/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst	2021-11-26 15:05:09 UTC (rev 8688)
@@ -250,7 +250,7 @@
 
    The pose library as a side-panel of the 3D Viewport.
 
-The right-hand panel of the 3D Viewport (toggle it with the N key) has a **Pose
+The right-hand panel of the 3D Viewport (toggle it with the :kbd:`N` key) has a **Pose
 Library panel in the Animations tab**. Contrary to the Asset Browser, which can
 be used for different asset types and also for some asset management tasks, this
 panel is dedicated to applying poses. This means that it can allow faster
@@ -265,19 +265,25 @@
 **Drag the pose thumbnail left to right to blend it** into the character's
 current pose. Just release the mouse button to confirm.
 
-To search for poses, hover your mouse over the poses, then press Ctrl+F and type
-a search query. This will filter the poses to match what you typed.
+To **search for poses**, hover your mouse over the poses, then press
+:kbd:`Ctrl-F` and type a search query. This will filter the poses to match what
+you typed. The scrollable area will automatically scroll the search box into
+view.
 
 
 Old Pose Library
 ================
 
-The Asset Browser based pose library, described above, was introduced in Blender
-3.0. It replaces the old pose library, which was introduced in Blender 2.46.
-This section describes the old pose library, including how to convert poses to
-the new system. The old pose library will be removed in a future release
-(potentially 3.1, but this has yet to be decided).
+The Asset Browser based pose library, described above, replaces the old pose
+library. This section describes that old pose library, including how to convert
+poses to the new system.
 
+.. warning::
+   The old pose library is deprecated in Blender 3.0, and will be mostly removed
+   Blender 3.1. Only the Python interface will remain a bit longer, and be
+   removed in Blender 3.2. The necessary functionality to convert old pose
+   libraries to pose assets will remain in Blender for the forseeable future.
+
 .. reference::
 
    :Mode:      Pose Mode

Modified: trunk/blender_docs/manual/animation/armatures/properties/pose_library.rst
===================================================================
--- trunk/blender_docs/manual/animation/armatures/properties/pose_library.rst	2021-11-26 05:42:15 UTC (rev 8687)
+++ trunk/blender_docs/manual/animation/armatures/properties/pose_library.rst	2021-11-26 15:05:09 UTC (rev 8688)
@@ -9,7 +9,7 @@
    :Panel:     :menuselection:`Properties --> Object Data Properties --> Pose Library`
 
 .. warning::
-   This properties panel is obsolete and will be removed in a future release.
+   This properties panel is obsolete and will be removed in Blender 3.1.
 
    The :doc:`Asset Browser based pose library </animation/armatures/posing/editing/pose_library>`
    was introduced in Blender 3.0 and replaces this pose library panel.

Modified: trunk/blender_docs/manual/editors/asset_browser.rst
===================================================================
--- trunk/blender_docs/manual/editors/asset_browser.rst	2021-11-26 05:42:15 UTC (rev 8687)
+++ trunk/blender_docs/manual/editors/asset_browser.rst	2021-11-26 15:05:09 UTC (rev 8688)
@@ -4,20 +4,30 @@
 Asset Browser
 *************
 
-This section describes the *Asset Browser*. For general information on Blender's
-asset library system, how to :ref:`create <asset-create>` and :ref:`edit <asset-edit>`
-assets, and design choices, see :doc:`/files/asset_libraries/index`.
+This section describes the *Asset Browser*, which is the main interface for
+organising and using assets.
 
-*The Asset Browser was introduced in Blender 3.0, and will be improved and
-expanded over multiple subsequent releases.*
+The Asset Browser was introduced in Blender 3.0, and will be improved and
+expanded over multiple subsequent releases.
 
+.. seealso::
 
+   :doc:`/files/asset_libraries/index`
+      for general information on Blender's asset library system, including how to :ref:`create <asset-create>` and :ref:`edit <asset-edit>` assets, and design choices.
+
+   :doc:`/files/asset_libraries/catalogs`
+      for organizing assets.
+
+   :doc:`/animation/armatures/posing/editing/pose_library`
+      build on top of the Asset Browser.
+
+
 Interface
 =========
 
 .. figure:: /images/asset_browser-gold-material.png
 
-   Asset Browser, showing materials in a small asset library.
+   Asset Browser, showing materials in an asset library.
 
 
 Main Region

Modified: trunk/blender_docs/manual/files/asset_libraries/introduction.rst
===================================================================
--- trunk/blender_docs/manual/files/asset_libraries/introduction.rst	2021-11-26 05:42:15 UTC (rev 8687)
+++ trunk/blender_docs/manual/files/asset_libraries/introduction.rst	2021-11-26 15:05:09 UTC (rev 8688)
@@ -7,10 +7,15 @@
 
 .. seealso::
 
-   - :doc:`/editors/asset_browser`
-   - :doc:`catalogs`
-   - :doc:`/animation/armatures/posing/editing/pose_library`
+   :doc:`/editors/asset_browser`
+      the main interface for organising and using assets
 
+   :doc:`/files/asset_libraries/catalogs`
+      for organizing assets.
+
+   :doc:`/animation/armatures/posing/editing/pose_library`
+      build on top of the Asset Browser.
+
    The following blog posts were written during the design & development of the
    asset browser. They are linked here for historical reasons, and to give some
    more context to the current design.

Modified: trunk/blender_docs/manual/images/asset_browser-gold-material.png
===================================================================
(Binary files differ)

