Brush Assets Project #104846

Merged
Julian Eisel merged 32 commits from JulianEisel/blender-manual:temp-brush-assets into main 2024-07-08 18:45:49 +02:00
2 changed files with 17 additions and 12 deletions
Showing only changes of commit 8c84e9e6f7 - Show all commits

View File

@ -101,7 +101,7 @@ Pack
* - :doc:`Brush </sculpt_paint/brush/index>` * - :doc:`Brush </sculpt_paint/brush/index>`
- |tick| - |tick|
- |none| - |none|
- Used by paint tools. - Used as brush assets in sculpt and paint modes.
* - :doc:`Camera </render/cameras>` * - :doc:`Camera </render/cameras>`
- |tick| - |tick|
- |none| - |none|

View File

@ -1,6 +1,6 @@
**************** **************
Brush Management Manage Brushes
**************** **************
Brush assets are stored in :doc:`asset libraries </files/asset_libraries/introduction>` to make them accesible from Brush assets are stored in :doc:`asset libraries </files/asset_libraries/introduction>` to make them accesible from
any Blender session. There are two ways of managing brush assets: any Blender session. There are two ways of managing brush assets:
@ -17,6 +17,9 @@ any Blender session. There are two ways of managing brush assets:
Asset Operators Asset Operators
=============== ===============
Note that only assets created via :ref:`Duplicate Asset... <bpy.ops.brush.asset_save_as>` can be edited using these
operators. For others (including brush assets bundled in the Essentials library), these operations will be grayed out.
.. reference:: .. reference::
:Mode: All Paint Modes :Mode: All Paint Modes
@ -30,32 +33,34 @@ Asset Operators
Brush Asset panel in the tool settings showing asset operators. Brush Asset panel in the tool settings showing asset operators.
.. _bpy.ops.brush.asset_save_as:
Duplicate Asset... (Duplicate icon) Duplicate Asset... (Duplicate icon)
Creates a copy of the currently active brush as asset, and activates it. A popup is spawned to input some settings Creates a copy of the currently active brush as asset, and activates it. A popup is spawned to input some settings
to use: to use:
Name Name
A custom name to use for the new brush A custom name to use for the new brush.
Library Library
Choose an Asset Library to store the new brush asset in. The available asset libraries are configured Choose an Asset Library to store the new brush asset in. The available asset libraries are configured
:ref:`in the Preferences <bpy.types.UserAssetLibrary>`. :ref:`in the Preferences <bpy.types.UserAssetLibrary>`.
Catalog Catalog
Choose an Asset Catalog to assign the brush asset to. Entering a non-existent name/path will create a new catalog Choose an :doc:`Asset Catalog </files/asset_libraries/catalogs>` to assign the brush asset to. Entering a
accordingly. non-existent name/path will create a new catalog accordingly.
Delete Asset Delete Asset
Permanently remove this brush asset from the Asset Library it is stored in. This cannot be undone, so a popup will Permanently remove this brush asset from the Asset Library it is stored in. This cannot be undone, so a popup will
ask for confirmation. ask for confirmation.
Edit Metadata... Edit Metadata...
Spawns a popup to change some of the available :ref:`asset metadata <editing-asset-metadata>` fields. Spawns a popup to change some of the available :ref:`asset metadata <editing-asset-metadata>` fields:
Catalog Catalog
Choose an Asset Catalog to assign the brush asset to. Entering a non-existent name/path will create a new catalog Choose an :doc:`Asset Catalog </files/asset_libraries/catalogs>` to assign the brush asset to. Entering a
accordingly. non-existent name/path will create a new catalog accordingly.
Author Author
See :ref:`Asset Author <bpy.types.AssetMetaData.description>` See :ref:`Asset Author <bpy.types.AssetMetaData.description>`.
Description Description
See :ref:`Asset Description <bpy.types.AssetMetaData.description>` See :ref:`Asset Description <bpy.types.AssetMetaData.description>`.
Edit Preview Image... Edit Preview Image...
Opens a window with the File Browser to select an image for the asset preview. Opens a window with the File Browser to select an image for the asset preview.
Update Asset Update Asset