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
Showing only changes of commit a8c808e5bf - Show all commits

View File

@ -225,11 +225,18 @@ 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. 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.
It is still possible to save a normal file with the `.asset.blend` extension. This will then not
be treated as an asset system file, Blender knows the difference.
Asset system files have one more special characteristic: You can open, but not save them. The
:ref:`Save As <bpy.ops.wm.save_as_mainfile>` operator can still be used to create a new file from
them, which will then be just a normal blend-file. Thus contained assets cannot be edited without
opening the file itself. Blender shows some clear warnings to communicate that asset system files
cannot be changed and saved the normal way.
The reason these files are special is that the asset system might need to regenerate them. Any
additional changes done by the user might be lost then. To prevent this data-loss, these files are
protected from user modifications.
Currently, only brush assets support this feature.