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>`
- |tick|
- |none|
- Used by paint tools.
- Used as brush assets in sculpt and paint modes.
* - :doc:`Camera </render/cameras>`
- |tick|
- |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
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
===============
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::
:Mode: All Paint Modes
@ -30,32 +33,34 @@ Asset Operators
Brush Asset panel in the tool settings showing asset operators.
.. _bpy.ops.brush.asset_save_as:
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
to use:
Name
A custom name to use for the new brush
A custom name to use for the new brush.
Library
Choose an Asset Library to store the new brush asset in. The available asset libraries are configured
:ref:`in the Preferences <bpy.types.UserAssetLibrary>`.
Catalog
Choose an Asset Catalog to assign the brush asset to. Entering a non-existent name/path will create a new catalog
accordingly.
Choose an :doc:`Asset Catalog </files/asset_libraries/catalogs>` to assign the brush asset to. Entering a
non-existent name/path will create a new catalog accordingly.
Delete Asset
Permanently remove this brush asset from the Asset Library it is stored in. This cannot be undone, so a popup will
ask for confirmation.
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
Choose an Asset Catalog to assign the brush asset to. Entering a non-existent name/path will create a new catalog
accordingly.
Choose an :doc:`Asset Catalog </files/asset_libraries/catalogs>` to assign the brush asset to. Entering a
non-existent name/path will create a new catalog accordingly.
Author
See :ref:`Asset Author <bpy.types.AssetMetaData.description>`
See :ref:`Asset Author <bpy.types.AssetMetaData.description>`.
Description
See :ref:`Asset Description <bpy.types.AssetMetaData.description>`
See :ref:`Asset Description <bpy.types.AssetMetaData.description>`.
Edit Preview Image...
Opens a window with the File Browser to select an image for the asset preview.
Update Asset