[Bf-docboard-svn] bf-manual: [8665] branches/blender-3.0-release/blender_docs/manual: More asset browser & pose library docs
Sybren A. Stüvel
noreply at blender.org
Tue Nov 23 13:04:03 CET 2021
Revision: 8665
https://developer.blender.org/rBM8665
Author: sybren
Date: 2021-11-23 13:04:03 +0100 (Tue, 23 Nov 2021)
Log Message:
-----------
More asset browser & pose library docs
Modified Paths:
--------------
branches/blender-3.0-release/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst
branches/blender-3.0-release/blender_docs/manual/animation/armatures/properties/pose_library.rst
branches/blender-3.0-release/blender_docs/manual/editors/asset_browser.rst
branches/blender-3.0-release/blender_docs/manual/files/asset_libraries/index.rst
branches/blender-3.0-release/blender_docs/manual/images/animation_armatures_properties_pose-library_panel.png
Modified: branches/blender-3.0-release/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst 2021-11-23 11:07:55 UTC (rev 8664)
+++ branches/blender-3.0-release/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst 2021-11-23 12:04:03 UTC (rev 8665)
@@ -274,7 +274,14 @@
:doc:`Pose Library Properties </animation/armatures/properties/pose_library>`.
+.. figure:: /images/animation_armatures_properties_pose-library_panel.png
+ :align: right
+ The old Pose Library panel.
+
+.. _pose-library-convert-old:
+.. _bpy.ops.poselib.convert_old_poselib:
+
Converting Old Pose Libraries
--------------------------------------------
@@ -298,9 +305,13 @@
.. _bpy.ops.poselib.browse_interactive:
-Browse Poses
-------------
+Browse Poses (Old Pose Library)
+-------------------------------
+.. warning::
+ This section describes the deprecated pose library. For the new, Asset
+ Browser based pose library, see :doc:`pose_library`.
+
.. reference::
:Mode: Edit Mode
@@ -319,9 +330,13 @@
.. _bpy.ops.poselib.pose_add:
-Add Pose
---------
+Add Pose (Old Pose Library)
+---------------------------
+.. warning::
+ This section describes the deprecated pose library. For the new, Asset
+ Browser based pose library, see :doc:`pose_library`.
+
.. reference::
:Mode: Edit Mode
@@ -346,9 +361,13 @@
.. _bpy.ops.poselib.pose_rename:
-Rename Pose
------------
+Rename Pose (Old Pose Library)
+------------------------------
+.. warning::
+ This section describes the deprecated pose library. For the new, Asset
+ Browser based pose library, see :doc:`pose_library`.
+
.. reference::
:Mode: Edit Mode
@@ -365,9 +384,13 @@
.. _bpy.ops.poselib.pose_remove:
-Remove Pose
------------
+Remove Pose (Old Pose Library)
+------------------------------
+.. warning::
+ This section describes the deprecated pose library. For the new, Asset
+ Browser based pose library, see :doc:`pose_library`.
+
.. reference::
:Mode: Edit Mode
Modified: branches/blender-3.0-release/blender_docs/manual/animation/armatures/properties/pose_library.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/animation/armatures/properties/pose_library.rst 2021-11-23 11:07:55 UTC (rev 8664)
+++ branches/blender-3.0-release/blender_docs/manual/animation/armatures/properties/pose_library.rst 2021-11-23 12:04:03 UTC (rev 8665)
@@ -8,6 +8,13 @@
:Mode: All Modes
:Panel: :menuselection:`Properties --> Object Data Properties --> Pose Library`
+.. warning::
+ This properties panel is obsolete and will be removed in a future release.
+
+ 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.
+ To convert poses to the new pose library, see :ref:`pose-library-convert-old`.
+
.. figure:: /images/animation_armatures_properties_pose-library_panel.png
:align: right
@@ -63,3 +70,7 @@
Move (up/down arrow icon)
Moves the pose up/down in the list.
+
+ Convert Old-Style Pose Library
+ Converts the pose library to pose assets. For more information, see
+ :ref:`pose-library-convert-old`.
\ No newline at end of file
Modified: branches/blender-3.0-release/blender_docs/manual/editors/asset_browser.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/editors/asset_browser.rst 2021-11-23 11:07:55 UTC (rev 8664)
+++ branches/blender-3.0-release/blender_docs/manual/editors/asset_browser.rst 2021-11-23 12:04:03 UTC (rev 8665)
@@ -11,6 +11,80 @@
*The Asset Browser was introduced in Blender 3.0, and will be improved and
expanded over multiple subsequent releases.*
+Interface
+=========
+
+Main Region
+-----------
+
+The main region of the Asset Browser acts similar to the
+:doc:`/editors/file_browser` built into Blender. It shows the assets contained
+in the selected catalog.
+
+Click an asset to select and activate it. Box-select by dragging :kbd:`LMB` or
+extend the selection with :kbd:`Shift-LMB` to select multiple assets.
+
+Depending on the selected keymap, either use :kbd:`RMB` or :kbd:`W` to show the
+asset browser context menu.
+
+
+Navigation & Usage Panel
+------------------------
+
+The left-hand panel, toggled with :kbd:`T`, can be used for navigating and
+:ref:`using assets <assets-using>`.
+
+Library Selector
+ Shows the active :doc:`asset library </files/asset_libraries/index>`, and
+ allows switching between Asset Libraries. The library
+ ":ref:`Current File <asset-library-current-file>`" is special, and will
+ always show the assets from the current .blend file, regardless of whether it
+ is part of an Asset Library or not.
+
+Catalog Tree
+ Shows the :doc:`catalogs </files/asset_libraries/catalogs>` of the active
+ Asset Library.
+
+Optional Panels
+ Add-ons and features like the
+ :doc:`/animation/armatures/posing/editing/pose_library`
+ can show custom panels here.
+
+
+.. _editing-asset-metadata:
+
+Asset Metadata Panel
+--------------------
+
+The right-hand panel, toggled with :kbd:`N`, shows metadata of the active asset.
+**Only metadata of assets contained in the current .blend file can be edited.**
+
+Name
+ The asset datablock name. This name is unique for the asset data type within
+ the same .blend file.
+Source
+ The full path of the .blend file that contains the asset.
+Open Blend File
+ This button will start a new Blender instance and open the .blend file that
+ contains the asset. In the background Blender will keep monitoring that new
+ Blender instance; when it quits, the Asset Browser will be refreshed to show
+ any updated assets.
+Description
+ Optional field for the asset description. Not used by Blender itself.
+Author
+ Optional field for the asset author. Not used by Blender itself.
+Preview
+ Shows the preview icon of the asset. See :ref:`asset-preview-icons`.
+Tags
+ Panel for viewing & editing asset tags. These do not have any meaning to
+ Blender, and can be chosen freely. When using the search bar to filter the
+ assets, those assets whose tags (partially) match the search string will also
+ be shown.
+
+Depending on the current object mode and the selected asset types, more panels
+may appear. For example, see :doc:`/animation/armatures/posing/editing/pose_library`.
+
+
.. _assets-using:
Using Assets
@@ -69,70 +143,3 @@
Objects), while keeping the Mesh and Materials linked to the asset files. This
will result in a local, and thus editable, Object, and keep the Mesh and
Materials automatically up to date with any changes in the asset library.
-
-.. _editing-asset-metadata:
-
-Asset Metadata
-==============
-
-Interface
-=========
-
-Main Region
------------
-
-The main region of the Asset Browser acts similar to the :doc:`/editors/file_browser` built into Blender.
-
-
-Header Region
--------------
-
-The Header Region is above the main region and can aid in navigating and adjust how items are displayed.
-
-
-Source List Region
-------------------
-
-Todo Catalogs.
-
-
-.. _bpy.types.AssetMetaData:
-
-Asset Details Region
---------------------
-
-Todo.
-
-.. _bpy.types.AssetMetaData.author:
-
-Author
- Name of the creator of the asset.
-
-
-Preview
-^^^^^^^
-
-Todo.
-
-Tags
-^^^^
-
-Todo.
-
-
-Navigating
-==========
-
-See file browser...
-
-
-Selecting
-=========
-
-See file browser...
-
-
-Editing
-=======
-
-Todo explain items in the context menu.
Modified: branches/blender-3.0-release/blender_docs/manual/files/asset_libraries/index.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/files/asset_libraries/index.rst 2021-11-23 11:07:55 UTC (rev 8664)
+++ branches/blender-3.0-release/blender_docs/manual/files/asset_libraries/index.rst 2021-11-23 12:04:03 UTC (rev 8665)
@@ -89,6 +89,8 @@
In the future, the asset type definition will be expanded; see
:ref:`asset-libraries-future-development` for more info.
+.. _asset-library-current-file:
+
The *Current File* Asset Library
======================================
Modified: branches/blender-3.0-release/blender_docs/manual/images/animation_armatures_properties_pose-library_panel.png
===================================================================
(Binary files differ)
More information about the Bf-docboard-svn
mailing list