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 16 additions and 9 deletions
Showing only changes of commit 83394e1b6f - Show all commits

View File

@ -207,9 +207,7 @@ Included in this library are:
- :doc:`/modeling/geometry_nodes/normals/smooth_by_angle`
.. _asset-libraries-design-limitations:
.. _asset-system-files
.. _asset-system-files:
Asset System Files (`.asset.blend` Extention)
=============================================
@ -219,14 +217,15 @@ Blender saves these assets to libraries in special files using the `.asset.blend
are entirely managed by Blender's asset system, and only contain a single asset and its
dependencies.
`.asset.blend` files may be deleted or overwritten by Blender's asset system at any time. Hence,
saving changes to them is highly discouraged, as they can easily be lost. Attempting to save edits
to such a file will spawn a warning popup, giving you the choice to use
`.asset.blend` files may be deleted or overwritten by Blender's asset system. Hence, saving changes
to them is highly discouraged, as they can easily be lost. Attempting to save edits to such a file
will spawn a warning popup, giving you the choice to use
:ref:`Save As <bpy.ops.wm.save_as_mainfile>` to instead save the changes in a new, regular
blend-file.
Currently, only brush assets support this feature.
.. _asset-libraries-design-limitations:
Design Limitations
==================

View File

@ -2,7 +2,7 @@
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 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
@ -17,8 +17,16 @@ 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.
Brushes can be managed through a few operators that let Blender handle the act of saving and
updating the brushes in asset libraries for you. Assets managed this way will be saved in special
: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>`
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.
.. reference::