Brush Assets Project #104846
@ -20,6 +20,9 @@ It helps to narrow the list of objects so that you can find things quickly and e
|
||||
Shows all the collections and objects in the current view layer.
|
||||
:Video Sequencer:
|
||||
Lists data, images and videos, that are used by the :doc:`Video Sequencer </video_editing/index>`.
|
||||
|
||||
.. _outliner-blender-file-mode:
|
||||
|
||||
:Blender File:
|
||||
Lists all data in the current blend-file.
|
||||
:Data API:
|
||||
|
@ -100,6 +100,8 @@ When the current blend-file is part of an asset library, you can also see its as
|
||||
The assets that are in the current file are marked with an icon; only those are editable.
|
||||
|
||||
|
||||
.. _asset-life-cycle:
|
||||
|
||||
Life Cycle of an Asset
|
||||
======================
|
||||
|
||||
|
BIN
manual/images/sculpt-paint_brush_brush-management_asset-operators.png
(Stored with Git LFS)
Normal file
BIN
manual/images/sculpt-paint_brush_brush-management_asset-operators.png
(Stored with Git LFS)
Normal file
Binary file not shown.
BIN
manual/images/sculpt-paint_brush_brush-management_mark-as-asset.png
(Stored with Git LFS)
Normal file
BIN
manual/images/sculpt-paint_brush_brush-management_mark-as-asset.png
(Stored with Git LFS)
Normal file
Binary file not shown.
BIN
manual/images/sculpt_paint_brush_brush-management_asset-operators.png
(Stored with Git LFS)
BIN
manual/images/sculpt_paint_brush_brush-management_asset-operators.png
(Stored with Git LFS)
Binary file not shown.
@ -5,12 +5,13 @@ Manage Brushes
|
||||
Brush assets are stored in :doc:`asset libraries </files/asset_libraries/introduction>` to make them accessible from
|
||||
any Blender session. There are two ways of managing brush assets:
|
||||
|
||||
- :ref:`Asset Operators <brush-management-utility-operators>`: Create and update brush assets using utility operators
|
||||
from any Blender file. Storage is managed by Blender. Convenient for simple "on the fly" management of personal brush
|
||||
- Using :ref:`asset operators <brush-management-utility-operators>`: Create and update brush assets
|
||||
using utility operators from any Blender file. Storage is managed by Blender. Convenient for
|
||||
simple "on the fly" management of personal brush
|
||||
asset libraries.
|
||||
- :ref:`Manual Storage <brush-management-manual>`: Create and update brush assets by opening blend files within asset
|
||||
libraries, and managing brush asset data-blocks in there. Useful for careful curation of asset libraries, especially
|
||||
to prepare them for sharing with others.
|
||||
- Using :ref:`manual storage <brush-management-manual>`: Create and update brush assets by opening
|
||||
blend files within asset libraries, and managing brush asset data-blocks in there. Useful for
|
||||
careful curation of asset libraries, especially to prepare them for sharing with others.
|
||||
|
||||
.. _brush-management-utility-operators:
|
||||
|
||||
@ -22,11 +23,11 @@ updating the brushes in asset libraries for you. Assets managed this way will be
|
||||
:ref:`asset system files <asset-system-files>` using a `.asset.blend` file extension.
|
||||
|
||||
.. note::
|
||||
Note that only brush assets created via :ref:`Duplicate Asset... <bpy.ops.brush.asset_save_as>`
|
||||
Note that only brush assets created via :ref:`Duplicate Asset <bpy.ops.brush.asset_save_as>`
|
||||
can be edited further using these asset operators. For others, these operations will be grayed
|
||||
out, and :ref:`manual management <brush-management-manual>` is necessary.
|
||||
|
||||
Brushes from the **Essentials** asset library cannot be edited.
|
||||
Brushes from the *Essentials* asset library cannot be edited.
|
||||
|
||||
.. reference::
|
||||
|
||||
@ -35,11 +36,11 @@ updating the brushes in asset libraries for you. Assets managed this way will be
|
||||
:menuselection:`Properties --> Tool --> Brush Asset`
|
||||
:Menu: :menuselection:`Asset Shelf --> Context Menu`
|
||||
|
||||
.. figure:: /images/sculpt_paint_brush_brush-management_asset-operators.png
|
||||
.. figure:: /images/sculpt-paint_brush_brush-management_asset-operators.png
|
||||
:align: right
|
||||
:width: 300
|
||||
|
||||
Brush Asset panel in the tool settings showing asset operators.
|
||||
Brush Asset panel in the Sidebar showing asset operators.
|
||||
|
||||
.. _bpy.ops.brush.asset_save_as:
|
||||
|
||||
@ -82,6 +83,24 @@ Revert to Asset
|
||||
Manual Storage
|
||||
==============
|
||||
|
||||
It is also possible to manually manage brushes in blend-files. By marking brushes as assets and saving the file in an
|
||||
Asset Library, they become available from any Blender session. This gives full control over managing storage, and is
|
||||
particularly useful for curating asset libraries that can be shared with others.
|
||||
.. seealso::
|
||||
:ref:`asset-life-cycle`
|
||||
Complete description of the manual asset create, edit, share and use workflow.
|
||||
|
||||
It is also possible to manually manage brushes in blend-files like any other asset data-block. By
|
||||
marking brushes as assets and saving the file in an asset library, they become available from any
|
||||
Blender session. This gives full control over how assets are stored, and is particularly useful for
|
||||
curating asset libraries that can be shared with others.
|
||||
|
||||
.. figure:: /images/sculpt-paint_brush_brush-management_mark-as-asset.png
|
||||
:align: right
|
||||
:width: 350
|
||||
|
||||
The *Mark as Asset* operator used on a brush in the Outliner.
|
||||
|
||||
Brushes can be imported as normal data-blocks from other files (including from `.asset.blend` files
|
||||
from an asset library) through :ref:`appending <bpy.ops.wm.append>`. In the
|
||||
:ref:`Blender File <outliner-blender-file-mode>` mode of the Outliner, the brush will be listed
|
||||
under *Brushes*. Right-click the brush and select *Mark as Asset*. By saving the file inside of
|
||||
an asset library directory, the asset becomes available from all Blender sessions. If necessary,
|
||||
configure an asset library directory in the Preferences.
|
||||
|
Loading…
Reference in New Issue
Block a user