[Bf-docboard-svn] bf-manual: [8684] branches/blender-3.0-release/blender_docs/manual: Assets: Fixes and Updates
Aaron Carlisle
noreply at blender.org
Fri Nov 26 06:31:58 CET 2021
Revision: 8684
https://developer.blender.org/rBM8684
Author: Blendify
Date: 2021-11-26 06:31:58 +0100 (Fri, 26 Nov 2021)
Log Message:
-----------
Assets: Fixes and Updates
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
branches/blender-3.0-release/blender_docs/manual/files/blend/packed_data.rst
branches/blender-3.0-release/blender_docs/manual/files/linked_libraries/library_proxies.rst
branches/blender-3.0-release/blender_docs/manual/modeling/modifiers/generate/geometry_nodes.rst
Added Paths:
-----------
branches/blender-3.0-release/blender_docs/manual/files/asset_libraries/introduction.rst
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-26 04:34:23 UTC (rev 8683)
+++ branches/blender-3.0-release/blender_docs/manual/animation/armatures/posing/editing/pose_library.rst 2021-11-26 05:31:58 UTC (rev 8684)
@@ -8,8 +8,8 @@
:doc:`/editors/asset_browser`. For an overview of the asset system, see the
:doc:`/files/asset_libraries/index` section.
+.. note::
-.. note::
At the moment of writing, the pose library is meant to be used in Pose Mode.
In other words, it only works when posing an armature, and not for general
object animation.
@@ -16,7 +16,7 @@
What is a Pose Asset?
-=================================
+=====================
A *pose asset* is an Action that has been :ref:`marked as asset <asset-create>`,
and that contains exactly **one frame of animation** data. Usually these are created
@@ -31,9 +31,9 @@
.. _bpy.ops.poselib.create_pose_asset:
Creating a Pose Library
-=================================
+=======================
-A *pose library file* is typically a .blend file that is dedicated to poses. It
+A *pose library file* is typically a blend-file that is dedicated to poses. It
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>`.
@@ -43,7 +43,7 @@
Pose Creation via Action Editor
---------------------------------------------
+-------------------------------
To create a pose in the library from the Action Editor, **pose the character,
select the relevant bones, and click the *Create Pose Asset* button**. This will
@@ -74,6 +74,7 @@
pose asset as the armature’s active Action.
.. note::
+
The **Create Pose Asset** button creates a new Action. To make sure that this
is actually visible in the user interface, so that you know that something
happened, it tries to make sure that the Asset Browser shows the newly
@@ -88,7 +89,7 @@
.. _bpy.ops.poselib.restore_previous_action:
Pose Creation from Existing Animation
---------------------------------------------
+-------------------------------------
Animators eat and breathe time, so there is a fair chance that you already have
some poses lined up on the timeline. Creating a pose asset from existing
@@ -115,7 +116,7 @@
.. _bpy.ops.poselib.copy_as_asset:
Pose Creation by Copying from Other File
---------------------------------------------
+----------------------------------------
As described in :ref:`asset-libraries-design-limitations`, Blender only writes
data to the currently open blend file. To copy a pose from some other file into
@@ -144,7 +145,7 @@
Automatically Assigned Catalog
---------------------------------------------
+------------------------------
When you create a pose asset, Blender may automatically assign it to an asset
catalog. This only works if there is an asset browser visible; Blender then
@@ -156,12 +157,13 @@
- Otherwise Blender goes over the other windows (if there are any), and do a
similar search. The first window it sees that has an asset browser wins.
+
.. _poselib-preview-images:
Controlling the Look of Preview Images
---------------------------------------------
+---------------------------------------
-The preview images are rendered with the active :ref:`Scene camera <bpy-types-scene-camera>`.
+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:
@@ -180,8 +182,9 @@
You can also animate settings, such as the background colour, light positions
and intensities, etc. Use this to your advantage!
+
Scene Animation for Preview Images
---------------------------------------------
+----------------------------------
Sometimes it’s handy to have a few different background colours or camera angles
for your poses. Many facial poses are made with a specific camera angle in mind.
@@ -189,7 +192,7 @@
- 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 :ref:`camera markers <bind-camera-to-markers>`.
+- The active camera can be switched by using :ref:`camera markers <bpy.ops.marker.camera_bind>`.
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
@@ -198,9 +201,8 @@
was originally created on.
-
Using the Pose Library
-=================================
+======================
The Pose Library can be used to pose a character in a few different ways. In
short, you can fully apply a pose or blend it into the character's current pose
@@ -210,7 +212,7 @@
Use from the Asset Browser
---------------------------------------------
+--------------------------
The Pose Library can be used directly from the Asset Browser. The **Pose Library
panels will appear** when the active object is an Armature and in pose mode. The
@@ -242,7 +244,7 @@
Use from 3D Viewport
---------------------------------------------
+--------------------
.. figure:: /images/asset_browser-pose_library-use_from_viewport.png
@@ -290,11 +292,12 @@
The old Pose Library panel.
+
.. _pose-library-convert-old:
.. _bpy.ops.poselib.convert_old_poselib:
Converting Old Pose Libraries
---------------------------------------------
+-----------------------------
Old-style pose libraries can be converted to pose assets in the following way:
@@ -320,6 +323,7 @@
-------------------------------
.. warning::
+
This section describes the deprecated pose library. For the new, Asset
Browser based pose library, see :doc:`pose_library`.
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-26 04:34:23 UTC (rev 8683)
+++ branches/blender-3.0-release/blender_docs/manual/editors/asset_browser.rst 2021-11-26 05:31:58 UTC (rev 8684)
@@ -11,6 +11,7 @@
*The Asset Browser was introduced in Blender 3.0, and will be improved and
expanded over multiple subsequent releases.*
+
Interface
=========
@@ -33,17 +34,19 @@
asset browser context menu.
-Navigation & Usage Panel
-------------------------
+Source List Region
+------------------
The left-hand panel, toggled with :kbd:`T`, can be used for navigating and
:ref:`using assets <assets-using>`.
+.. _bpy.types.FileAssetSelectParams.asset_library_ref:
+
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
+ 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:
@@ -67,47 +70,81 @@
can show custom panels here.
+.. _bpy.types.AssetMetaData:
.. _editing-asset-metadata:
-Asset Metadata Panel
+Asset Details Region
--------------------
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.**
+**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.
+ the same blend-file.
+
+.. _bpy.types.WindowManager.asset_path_dummy:
+
Source
- The full path of the .blend file that contains the asset.
+ The full path of the blend-file that contains the asset.
-.. _bpy.ops.asset.open_containing_blend_file:
+ .. _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
- Blender instance; when it quits, the Asset Browser will be refreshed to show
- any updated assets.
+ 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.
+
+.. _bpy.types.AssetMetaData.description:
+
Description
Optional field for the asset description. Not used by Blender itself.
+
+.. _bpy.types.AssetMetaData.author:
+
Author
Optional field for the asset author. Not used by Blender itself.
+
+
Preview
- Shows the preview image of the asset. See :ref:`asset-previews`.
+^^^^^^^
+
+Shows the preview image of the asset. See :ref:`asset-previews`.
+
+.. _bpy.ops.ed.lib_id_load_custom_preview:
+
+Load Custom Preview
+ Opens a window with the File Browser to select an image for the asset preview.
+
+.. _bpy.ops.ed.lib_id_generate_preview:
+
+Generate Preview
+ Generate/update a preview for the asset.
+
+
+.. _bpy.ops.asset.tag_add:
+.. _bpy.ops.asset.tag_remove:
+.. _bpy.types.AssetMetaData.active_tag:
+
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`.
+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.
+.. note::
+ 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
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list