blender/blender-manual
23
23
Fork 103
Code Issues 76 Pull Requests 7 Projects 1 Releases Wiki Activity

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
Conversation 0 Commits 32 Files Changed 134 +16 -9
2 changed files with 16 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 83394e1b6f - Show all commits

11
manual/files/asset_libraries/introduction.rst
View File

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

14
manual/sculpt_paint/brush/brush_management.rst
View File

@ -2,7 +2,7 @@
Manage Brushes 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: 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 - :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 Asset Operators
=============== ===============
Note that only assets created via :ref:`Duplicate Asset... <bpy.ops.brush.asset_save_as>` can be edited using these Brushes can be managed through a few operators that let Blender handle the act of saving and
operators. For others (including brush assets bundled in the Essentials library), these operations will be grayed out. 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:: .. reference::