[Bf-docboard-svn] bf-manual: [8666] branches/blender-3.0-release/blender_docs/manual: Asset Browser & Pose Library
Sybren A. Stüvel
noreply at blender.org
Tue Nov 23 17:24:55 CET 2021
Revision: 8666
https://developer.blender.org/rBM8666
Author: sybren
Date: 2021-11-23 17:24:54 +0100 (Tue, 23 Nov 2021)
Log Message:
-----------
Asset Browser & Pose Library
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/editors/asset_browser.rst
branches/blender-3.0-release/blender_docs/manual/files/asset_libraries/catalogs.rst
branches/blender-3.0-release/blender_docs/manual/files/asset_libraries/index.rst
Added Paths:
-----------
branches/blender-3.0-release/blender_docs/manual/images/asset_browser-asset_library_preferences.png
branches/blender-3.0-release/blender_docs/manual/images/asset_browser-assign_catalog.png
branches/blender-3.0-release/blender_docs/manual/images/asset_browser-gold-material.png
branches/blender-3.0-release/blender_docs/manual/images/asset_browser-pose_library-create_from_action_editor.png
branches/blender-3.0-release/blender_docs/manual/images/asset_browser-pose_library-use_from_viewport.png
branches/blender-3.0-release/blender_docs/manual/images/asset_browser-pose_library_ellie.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 12:04:03 UTC (rev 8665)
+++ branches/blender-3.0-release/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst 2021-11-23 16:24:54 UTC (rev 8666)
@@ -24,10 +24,12 @@
exactly one frame can be seen as pose asset.
Each pose in the library is stored in its own Action data-block. This means that
-it can get its own name, its own preview icon, and can be organised in
+it can get its own name, its own preview image, and can be organised in
:doc:`/files/asset_libraries/catalogs`.
+.. _bpy.ops.poselib.create_pose_asset:
+
Creating a Pose Library
=================================
@@ -35,10 +37,11 @@
can link in a character, props, etc., which can then not only be used to create
the poses, but also for :ref:`rendering previews <poselib-preview-images>`.
-.. TODO::
- 
+.. figure:: /images/asset_browser-pose_library_ellie.png
+ Example pose library of the Sprite Fright character Ellie.
+
Pose Creation via Action Editor
--------------------------------------------
@@ -47,9 +50,10 @@
create the new pose Action, which will contain keys for the current value of
each bone’s location, rotation, scale, and bendy-bone properties.
-.. TODO::
- https://i.imgur.com/QFlVvgW.jpg
+.. figure:: /images/asset_browser-pose_library-create_from_action_editor.png
+ To create a new pose asset, use the Create Pose Asset button in the Action editor.
+
**The created Action is now assigned to the armature.** This makes it possible
to inspect which bones are included and to tweak anything. In that respect, it’s
an Action like any other, and you can add or remove keys as usual. Just make
@@ -81,6 +85,8 @@
assets from the same character pose.
+.. _bpy.ops.poselib.restore_previous_action:
+
Pose Creation from Existing Animation
--------------------------------------------
@@ -106,6 +112,8 @@
had before.
+.. _bpy.ops.poselib.copy_as_asset:
+
Pose Creation by Copying from Other File
--------------------------------------------
@@ -127,7 +135,7 @@
will only find a single pose, but future versions of Blender may extend this
for other asset types. This is why the button is named so generically — it is
not pose-specific.
-- Give the pose a name, and click on the “refresh” button in the preview icon
+- Give the pose a name, and click on the “refresh” button in the preview image
panel to render a new preview if you want.
- **Save the file and quit Blender**.
- The original Blender is still running in the background and notices that the
@@ -153,8 +161,9 @@
Controlling the Look of Preview Images
--------------------------------------------
-The preview images are rendered with the active Scene camera. This approach was
-preferred over rendering a specific 3D Viewport for two main reasons:
+The preview images are rendered with the active :ref:`Scene camera <bpy-types-scene-camera>`.
+This approach was preferred over rendering a specific 3D Viewport for two main
+reasons:
- There is only one scene camera active at any time, making it predictable which
camera is used.
@@ -162,10 +171,11 @@
rendering the thumbnails. Pose library files are intended for that purpose: to
contain the poses and render their preview images.
-The preview images are rendered using the Workbench Engine. Switch the scene to
-use that as render engine, and you’ll see various options to influence the look.
-Select a pose asset and press the Generate Preview button to re-render the
-preview icon with the current settings.
+The preview images are rendered using the
+:doc:`Workbench Engine </render/workbench/index>`. Switch the scene to use that
+as render engine, and you’ll see various options to influence the look. Select a
+pose asset and press the Generate Preview button to re-render the preview image
+with the current settings.
You can also animate settings, such as the background colour, light positions
and intensities, etc. Use this to your advantage!
@@ -179,12 +189,12 @@
- Background colour can be animated. In this case just for fun, but for more
serious applications this could be used to indicate a certain character, or a
mood, or anything else.
-- The active camera can be switched by using camera markers.
+- The active camera can be switched by using :ref:`camera markers <bind-camera-to-markers>`.
Both make it possible to choose a specific frame to pick the background colour
-and camera angle. Pose the character, click the Create Pose Asset button, and
+and camera angle. Pose the character, click the *Create Pose Asset* button, and
the pose Action will be keyed on the current frame. This means it’s easy to edit
-the pose and refresh its preview icon, because you know exactly which frame it
+the pose and refresh its preview image, because you know exactly which frame it
was originally created on.
@@ -234,6 +244,10 @@
Use from 3D Viewport
--------------------------------------------
+.. figure:: /images/asset_browser-pose_library-use_from_viewport.png
+
+ 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
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
@@ -252,10 +266,7 @@
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.
-.. TODO::
- 
-
Old Pose Library
================
@@ -289,7 +300,7 @@
- In the Armature properties Pose Library panel, select the pose library you
want to convert.
-- Make sure the scene camera is set up correctly for rendering preview icons.
+- Make sure the scene camera is set up correctly for rendering preview images.
- Click the "Convert Old-Style Pose Library" button.
- Open the Asset Browser, and see the poses have been converted.
- If you're happy with the result, remove the old pose library Action.
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 12:04:03 UTC (rev 8665)
+++ branches/blender-3.0-release/blender_docs/manual/editors/asset_browser.rst 2021-11-23 16:24:54 UTC (rev 8666)
@@ -14,6 +14,11 @@
Interface
=========
+.. figure:: /images/asset_browser-gold-material.png
+
+ Asset Browser, showing materials in a small asset library.
+
+
Main Region
-----------
@@ -41,6 +46,17 @@
always show the assets from the current .blend file, regardless of whether it
is part of an Asset Library or not.
+.. _bpy.ops.asset.bundle_install:
+
+Copy Asset Bundle to Library
+ Shown when the Library Selector is set to Current File, the current .blend
+ file is considered an :ref:`Asset Bundle <asset-bundles>`, and is not yet
+ located inside any Asset Library.
+
+ The Copy Asset Bundle operator makes it simple to copy the file into the
+ asset library. The catalogs of the asset bundle will be merged into the asset
+ library.
+
Catalog Tree
Shows the :doc:`catalogs </files/asset_libraries/catalogs>` of the active
Asset Library.
@@ -64,6 +80,9 @@
the same .blend file.
Source
The full path of the .blend file that contains the asset.
+
+.. _bpy.ops.asset.open_containing_blend_file:
+
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
@@ -74,7 +93,7 @@
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`.
+ Shows the preview image of the asset. See :ref:`asset-previews`.
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
@@ -143,3 +162,39 @@
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.
+
+
+.. _asset-previews:
+
+Asset Previews
+===================
+
+Preview images are typically automatically generated when you
+:ref:`mark a data-block as asset <bpy.ops.asset.mark>`.
+
+
+
+
+.. _asset-bundles:
+
+Asset Bundles
+==============
+
+*Asset Bundles* are .blend files that do not reference any other file, and whose
+name ends in ``_bundle.blend``. Any textures and other external files need to be
+:doc:`packed </files/blend/packed_data>` into the current blend file.
+
+Asset Bundles can be installed via the :ref:`Asset Browser
+<bpy.ops.asset.bundle_install>`:
+
+- Open the asset bundle .blend file.
+- Switch its Asset Browser to Current File (if it's not set at that already).
+- Click on *Copy Bundle to Asset Library*.
+- Choose the asset library to copy it to.
+- A file dialog will open, showing the files of the selected Asset Library.
+ Choose the desired location of the .blend file, and click the *Copy to Asset
+ Library* button.
+- The .blend file will be saved at the chosen location, and any
+ :ref:`catalogs </files/asset_libraries/catalogs>` of the asset bundle will be
+ merged into the target asset library.
+
Modified: branches/blender-3.0-release/blender_docs/manual/files/asset_libraries/catalogs.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/files/asset_libraries/catalogs.rst 2021-11-23 12:04:03 UTC (rev 8665)
+++ branches/blender-3.0-release/blender_docs/manual/files/asset_libraries/catalogs.rst 2021-11-23 16:24:54 UTC (rev 8666)
@@ -38,8 +38,13 @@
Assigning an Asset
==============================
-To assign an action to a catalog, just drag the asset on top of the catalog.
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list