blender
/
blender
129
398
Fork 572
Code Issues 6.2k Pull Requests 748 Projects 19 Wiki Activity

Brush Asset - Technical Core-level Design #101908

New Issue
Open
opened 2022-10-18 19:34:09 +02:00 by Bastien Montagne · 7 comments
Bastien Montagne commented 2022-10-18 19:34:09 +02:00
Owner
Copy Link

This task is to design and keep track of how handling brushes will be done in the new Brush Asset system, from the Core module perspective mainly.

Changes in Brush Handling

Brushes are now (in most cases) purely run-time data.

    • They do exist in the Main data-base.
    • They have a new ID tag to mark them as not writable (LIB_TAG_RUNTIME? Also related to #88555 (ID Management: Sanitize and clarify our ID tags) to some extent). b93025db59
    • RUNTIME IDs do not make linked data 'directly linked'.
    • RUNTIME IDs are written in global undo steps.
    • Brushes are not covered by Undo, they always remain in their state when applying undo/redo steps.
    • Brushes are not cleared when loading a new .blend file within a same Blender session. However:
    • They do get cleared when reloading startup or factory startup files.
    • Brushes in newly loaded .blend file are also kept, and replace potential existing ones in old blendfile in case of conflict. This is to allow opening an asset library .blend, otherwise local brushes there would always be removed on opening.
    • This implies a conditional mechanism to re-use brushes from old Main and copy them into new Main on file load (similar to other UI-related IDs like WindowManager e.g.).
    • A weak reference to the active brush must be stored in the toolsettings when writing a .blend file, such that it can be reloaded automatically on file opening when there is no active brushes in the current editing session.
    • Several brushes with the same name (coming from different asset repositories/libraries) must be supported.
    • Displaying them in the asset browser/asset shelf should not be an issue? (Check with @JulianEisel).
    • Local runtime overrides however need a unique name. One idea could be to hide their .xxx number suffix in the UI?
    • It is assumed that only Brush data itself needs to be editable, its dependencies (textures, etc.) can remain linked and readonly.

Typically, real local brush data should only exist in files part of an asset repository.

Brushes are reset when closing and re-opening Blender, however they are kept across file opening within and editing session. So they are handled in a similar way to UI data (WindowManager etc. IDs) when 'load UI' is disabled, and moved from old to new Main on file loading.

Selecting a Brush

When selecting the asset:

    • Brush is linked from asset .blend file (path given by asset system).
    • Existing local runtime liboverride of linked brush is searched for. If none is found, a new one is created.
    • That local runtime liboverride is assigned as active brush.

Undo & File Loading

No undo support should be needed for brush usage nor editing. Brushes can therefore be fully ignored by undo system, and existing brushes should just be re-used as-is.
Brushes are also kept across file loading within a same Blender session, unless the (factory) startup file is loaded, or when loading to/from a brush asset library file.

Technically this has several complex implications, especially in setup_app_data part of the file loading process, mainly due to the fact that brushes can use other data-blocks. Currently:

  • Dependencies are not fully guaranteed to be handled by the new behavior:
    • In undo case, other IDs are handled like any other data-block, i.e. changes to them are undone or redone (so editing an image or texture of a brush will be undoable). This is not ideal, but extremely hard to avoid in current situation.
    • In file loading case, other dependencies can be brought over from the old bmain into the new one. This implies that e.g. is a locale texture is assigned to a runtime only liboverride of a brush while editing file_a.blend, and then user open file_b.blend, a copy of that locale texture will become part of file_b.blend.
  • Opening another .blend file, in general:
    • All fully local, non-asset brushes are preserved (necessary for old brushes compatibility).
    • All fully local, asset brushes are discarded.
    • All local overrides of asset brushes are preserved (besides special cases noted below).
    • All linked brushes are preserved (besides special cases noted below).
  • Opening a file that is a library of current file (typical case: opening a Brush Asset library file):
    • Reset related brush assets to their status in the library (linked brushes and their local overrides are not preserved).
    • Have clear UI visibility of local assets having 'pending changes' in drafts.
    • Warn user that by opening the library file, they will lose their current non-drafted changes in these assets.
      • Requires detection of these cases.
  • Opening a .blend file that is using as library the current blend file.
    • Local asset brushes must be discarded in that case, this is covered by the general case described above.

do_version

For modes moved to the new BrushAssets system, existing local brushes in older .blend files are often redundant and should be cleaned up.

  • Local non-asset brushes which names and values match the current default 'embedded' brushes should be removed.
    • 'Matching' here is used as 'essentially equal', in the sense that some properties (like e.g. size) should not be considered in the comparison.
    • This implies keeping (or making) old brushes available for do_version code.
  • The others (non-matching) will be kept as local, non-asset brushes. Up to the user to clean them up or transform them into assets.

Local brushes that are not defined as assets will not be shown to the user in the UI (they will only be reachable through the Outliner editor, python API, etc.).

To Be Investigated

Toolslot

The 'toolslots' system is used at least by the 'smooth mode' toggle option of stroke code, which does a weird 'hot-swap' between current brush and a smooth brush, searched first in the relevant entry of the toolslot. This needs to be investigated further.

Note
One idea to fix the 'smooth mode' issue is that this toggle would not anymore search for an actual existing smooth brush, but would rather generate it's own private temp smooth brush, with default settings.

This task is to design and keep track of how handling brushes will be done in the new Brush Asset system, from the Core module perspective mainly. ## Changes in Brush Handling Brushes are now (in most cases) purely run-time data. * - [x] They do exist in the Main data-base. * - [x] They have a new ID tag to mark them as not writable (`LIB_TAG_RUNTIME`? Also related to #88555 (ID Management: Sanitize and clarify our ID tags) to some extent). b93025db59 * `RUNTIME` IDs **do not** make linked data 'directly linked'. * `RUNTIME` IDs **are** written in global undo steps. * - [x] Brushes are **not** covered by Undo, they always remain in their state when applying undo/redo steps. * - [x] Brushes are **not** cleared when loading a new .blend file within a same Blender session. However: * They do get cleared when reloading startup or factory startup files. * Brushes in newly loaded .blend file are also kept, and replace potential existing ones in old blendfile in case of conflict. *This is to allow opening an asset library .blend, otherwise local brushes there would always be removed on opening.* * This implies a conditional mechanism to re-use brushes from old Main and copy them into new Main on file load (similar to other UI-related IDs like WindowManager e.g.). * - [x] A weak reference to the active brush must be stored in the toolsettings when writing a .blend file, such that it can be reloaded automatically on file opening when there is no active brushes in the current editing session. * - [ ] Several brushes with the same name (coming from different asset repositories/libraries) must be supported. * Displaying them in the asset browser/asset shelf should not be an issue? (*Check with @JulianEisel*). * Local runtime overrides however need a unique name. One idea could be to hide their `.xxx` number suffix in the UI? * - [x] It is assumed that only Brush data itself needs to be editable, its dependencies (textures, etc.) can remain linked and readonly. Typically, real local brush data should only exist in files part of an asset repository. Brushes are reset when closing and re-opening Blender, however they are kept across file opening within and editing session. So they are handled in a similar way to UI data (WindowManager etc. IDs) when 'load UI' is disabled, and moved from old to new Main on file loading. ## Selecting a Brush When selecting the asset: * - [x] Brush is linked from asset .blend file (path given by asset system). * - [x] Existing local runtime liboverride of linked brush is searched for. If none is found, a new one is created. * - [x] That local runtime liboverride is assigned as active brush. ## Undo & File Loading No undo support should be needed for brush usage nor editing. Brushes can therefore be fully ignored by undo system, and existing brushes should just be re-used as-is. Brushes are also kept across file loading within a same Blender session, unless the (factory) startup file is loaded, or when loading to/from a brush asset library file. Technically this has several complex implications, especially in `setup_app_data` part of the file loading process, mainly due to the fact that brushes can use other data-blocks. Currently: * Dependencies are not fully guaranteed to be handled by the new behavior: * [x] In **undo** case, other IDs are handled like any other data-block, i.e. changes to them are undone or redone (so editing an image or texture of a brush will be undoable). This is not ideal, but extremely hard to avoid in current situation. * [x] In **file loading** case, other dependencies can be brought over from the old bmain into the new one. This implies that e.g. is a locale texture is assigned to a runtime only liboverride of a brush while editing `file_a.blend`, and then user open `file_b.blend`, a copy of that locale texture will become part of `file_b.blend`. * [x] Opening another .blend file, in general: * All fully local, non-asset brushes are preserved *(necessary for old brushes compatibility)*. * All fully local, asset brushes are discarded. * All local overrides of asset brushes are preserved (besides special cases noted below). * All linked brushes are preserved (besides special cases noted below). * [x] Opening a file that is a library of current file (typical case: opening a Brush Asset library file): * Reset related brush assets to their status in the library (linked brushes and their local overrides are not preserved). * Have clear UI visibility of local assets having 'pending changes' in drafts. * Warn user that by opening the library file, they will lose their current non-drafted changes in these assets. * Requires detection of these cases. * [x] Opening a .blend file that is using as library the current blend file. * *Local asset brushes must be discarded in that case, this is covered by the general case described above*. ## do_version For modes moved to the new BrushAssets system, existing local brushes in older .blend files are often redundant and should be cleaned up. * [ ] Local non-asset brushes which names and values match the current default 'embedded' brushes should be removed. * *'Matching' here is used as 'essentially equal', in the sense that some properties (like e.g. size) should not be considered in the comparison.* * This implies keeping (or making) old brushes available for do_version code. * [ ] The others (non-matching) will be kept as local, non-asset brushes. Up to the user to clean them up or transform them into assets. Local brushes that are not defined as assets will not be shown to the user in the UI (they will only be reachable through the Outliner editor, python API, etc.). ## To Be Investigated ### Toolslot The 'toolslots' system is used at least by the 'smooth mode' toggle option of stroke code, which does a weird 'hot-swap' between current brush and a smooth brush, searched first in the relevant entry of the toolslot. This needs to be investigated further. > **Note** > One idea to fix the 'smooth mode' issue is that this toggle would not anymore search for an actual existing smooth brush, but would rather generate it's own private temp smooth brush, with default settings.
Bastien Montagne commented 2022-10-18 19:34:09 +02:00
Author
Owner
Copy Link

Changed status from 'Needs Triage' to: 'Confirmed'

Changed status from 'Needs Triage' to: 'Confirmed'
Bastien Montagne commented 2022-10-18 19:34:09 +02:00
Author
Owner
Copy Link

Added subscribers: @mont29, @JulienKaspar, @JulianEisel, @dfelinto

Added subscribers: @mont29, @JulienKaspar, @JulianEisel, @dfelinto
Paul Larson commented 2022-10-24 17:27:32 +02:00
Copy Link

Added subscriber: @GeorgiaPacific

Added subscriber: @GeorgiaPacific
Julien Kaspar added this to the Sculpt, Paint & Texture project 2023-02-08 10:20:48 +01:00
Bastien Montagne modified the project from Sculpt, Paint & Texture to Core 2023-02-09 15:42:54 +01:00
Bastien Montagne removed this from the Core project 2023-02-09 18:20:29 +01:00
Philipp Oeser removed the
Interest
Sculpt, Paint & Texture
 label 2023-02-10 09:10:59 +01:00
Bastien Montagne added the
Interest
Asset Browser
Interest
Pipeline, Assets & IO
 labels 2023-02-10 16:08:13 +01:00
Julian Eisel added this to the Brush Assets & Asset Shelf project 2023-02-20 21:01:06 +01:00
Brecht Van Lommel commented 2023-02-28 13:26:20 +01:00
Owner
Copy Link

Is there a plan for how to handle versioning, how we will transitions from brushes saved in .blend files to assets?

I see that local brushes will be preserved. If asset brushes come bundled with Blender and are also loaded, for existing .blend files the user will be presented with duplicated brushes?

Should we automatically remove duplicated brushes? Or put local ones in a somewhat hidden state, with some way for users to add specific ones as draft and clear the remaining ones?

Also related to this, when you edit a brush asset .blend file, I guess it avoids loading the same brushes a second time through the asset system? In this case local brushes are not legacy data.

Is there a plan for how to handle versioning, how we will transitions from brushes saved in .blend files to assets? I see that local brushes will be preserved. If asset brushes come bundled with Blender and are also loaded, for existing .blend files the user will be presented with duplicated brushes? Should we automatically remove duplicated brushes? Or put local ones in a somewhat hidden state, with some way for users to add specific ones as draft and clear the remaining ones? Also related to this, when you edit a brush asset .blend file, I guess it avoids loading the same brushes a second time through the asset system? In this case local brushes are not legacy data.
Bastien Montagne commented 2023-02-28 15:31:01 +01:00
Author
Owner
Copy Link

Regarding versioning, I thought removing local brushes which names and values match exactly the current default 'embedded' brushes would do the trick? The others would be kept as local brushes, up to the user to clean them up or transform them into assets.

Local brushes that are not defined as assets will not be shown to the user in the UI (they will only be reachable through the Outliner editor).

Also related to this, when you edit a brush asset .blend file, I guess it avoids loading the same brushes a second time through the asset system? In this case local brushes are not legacy data.

This is handled by the asset system itself, local brushes are shown as local assets, and not directly exposed as local IDs (besides, once again, from the Outliner view).

Regarding versioning, I thought removing local brushes which names and values match exactly the current default 'embedded' brushes would do the trick? The others would be kept as local brushes, up to the user to clean them up or transform them into assets. Local brushes that are not defined as assets will not be shown to the user in the UI (they will only be reachable through the Outliner editor). > Also related to this, when you edit a brush asset .blend file, I guess it avoids loading the same brushes a second time through the asset system? In this case local brushes are not legacy data. This is handled by the asset system itself, local brushes are shown as local assets, and not directly exposed as local IDs (besides, once again, from the Outliner view).
Brecht Van Lommel commented 2023-02-28 15:42:08 +01:00
Owner
Copy Link

Ah right, if the brush selection UI for the various modes only lists asset brushes then I agree they are hidden well enough.

Removing duplicates by comparing with the default ones seems good too (maybe should be a to do item in this task?). Probably that comparison can be made a bit fuzzy by allowing some things to be different, e.g. a brush with just a different size does not need to be preserved. But not that important.

Ah right, if the brush selection UI for the various modes only lists asset brushes then I agree they are hidden well enough. Removing duplicates by comparing with the default ones seems good too (maybe should be a to do item in this task?). Probably that comparison can be made a bit fuzzy by allowing some things to be different, e.g. a brush with just a different size does not need to be preserved. But not that important.
Bastien Montagne commented 2023-02-28 17:50:47 +01:00
Author
Owner
Copy Link

maybe should be a to do item in this task

Good points indeed, will do.

> maybe should be a to do item in this task Good points indeed, will do.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
main
brush-assets-project
blender-v4.1-release
blender-v3.3-release
blender-v3.6-release
universal-scene-description
blender-v3.6-temp_wmoss_animrig_public
temp-sculpt-dyntopo
gpencil-next
anim/animation-id-113594
blender-v4.0-release
blender-projects-basics
bridge-curves
sculpt-blender
asset-browser-frontend-split
asset-shelf
tmp-usd-python-mtl
tmp-usd-3.6
blender-v3.5-release
blender-v2.93-release
realtime-clock
sculpt-dev
bevelv2
xr-dev
v4.1.1
v3.6.11
v3.3.18
v4.1.0
v3.3.17
v3.6.10
v3.6.9
v3.3.16
v3.6.8
v3.6.7
v3.3.14
v4.0.2
v4.0.1
v4.0.0
v3.6.5
v3.3.12
v3.6.4
v3.6.3
v3.3.11
v3.6.2
v3.3.10
v3.6.1
v3.3.9
v3.6.0
v3.3.8
v3.3.7
v2.93.18
v3.5.1
v3.3.6
v2.93.17
v3.5.0
v2.93.16
v3.3.5
v3.3.4
v2.93.15
v2.93.14
v3.3.3
v2.93.13
v2.93.12
v3.4.1
v3.3.2
v3.4.0
v3.3.1
v2.93.11
v3.3.0
v3.2.2
v2.93.10
v3.2.1
v3.2.0
v2.83.20
v2.93.9
v3.1.2
v3.1.1
v3.1.0
v2.83.19
v2.93.8
v3.0.1
v2.93.7
v3.0.0
v2.93.6
v2.93.5
v2.83.18
v2.93.4
v2.93.3
v2.83.17
v2.93.2
v2.93.1
v2.83.16
v2.93.0
v2.83.15
v2.83.14
v2.83.13
v2.92.0
v2.83.12
v2.91.2
v2.83.10
v2.91.0
v2.83.9
v2.83.8
v2.83.7
v2.90.1
v2.83.6.1
v2.83.6
v2.90.0
v2.83.5
v2.83.4
v2.83.3
v2.83.2
v2.83.1
v2.83
v2.82a
v2.82
v2.81a
v2.81
v2.80
v2.80-rc3
v2.80-rc2
v2.80-rc1
v2.79b
v2.79a
v2.79
v2.79-rc2
v2.79-rc1
v2.78c
v2.78b
v2.78a
v2.78
v2.78-rc2
v2.78-rc1
v2.77a
v2.77
v2.77-rc2
v2.77-rc1
v2.76b
v2.76a
v2.76
v2.76-rc3
v2.76-rc2
v2.76-rc1
v2.75a
v2.75
v2.75-rc2
v2.75-rc1
v2.74
v2.74-rc4
v2.74-rc3
v2.74-rc2
v2.74-rc1
v2.73a
v2.73
v2.73-rc1
v2.72b
2.72b
v2.72a
v2.72
v2.72-rc1
v2.71
v2.71-rc2
v2.71-rc1
v2.70a
v2.70
v2.70-rc2
v2.70-rc
v2.69
v2.68a
v2.68
v2.67b
v2.67a
v2.67
v2.66a
v2.66
v2.65a
v2.65
v2.64a
v2.64
v2.63a
v2.63
v2.61
v2.60a
v2.60
v2.59
v2.58a
v2.58
v2.57b
v2.57a
v2.57
v2.56a
v2.56
v2.55
v2.54
v2.53
v2.52
v2.51
v2.50
v2.49b
v2.49a
v2.49
v2.48a
v2.48
v2.47
v2.46
v2.45
v2.44
v2.43
v2.42a
v2.42
v2.41
v2.40
v2.37a
v2.37
v2.36
v2.35a
v2.35
v2.34
v2.33a
v2.33
v2.32
v2.31a
v2.31
v2.30
v2.28c
v2.28a
v2.28
v2.27
v2.26
v2.25
Labels
Clear labels   
Interest
Alembic

  
Interest
Animation & Rigging

  
Interest
Asset Browser

  
Interest
Asset Browser Project Overview

  
Interest
Audio

  
Interest
Automated Testing

  
Interest
Blender Asset Bundle

  
Interest
BlendFile

  
Interest
Collada

  
Interest
Compatibility
This issue affects/is about backward or forward compatibility

  
Interest
Compositing

  
Interest
Core

  
Interest
Cycles

  
Interest
Dependency Graph

  
Interest
Development Management

  
Interest
EEVEE

  
Interest
EEVEE & Viewport

  
Interest
Freestyle

  
Interest
Geometry Nodes

  
Interest
Grease Pencil

  
Interest
ID Management

  
Interest
Images & Movies

  
Interest
Import Export

  
Interest
Line Art

  
Interest
Masking

  
Interest
Metal

  
Interest
Modeling

  
Interest
Modifiers

  
Interest
Motion Tracking

  
Interest
Nodes & Physics

  
Interest
OpenGL

  
Interest
Overlay

  
Interest
Overrides

  
Interest
Performance

  
Interest
Physics

  
Interest
Pipeline, Assets & IO

  
Interest
Platforms, Builds & Tests

  
Interest
Python API

  
Interest
Render & Cycles

  
Interest
Render Pipeline

  
Interest
Sculpt, Paint & Texture

  
Interest
Text Editor

  
Interest
Translations

  
Interest
Triaging

  
Interest
Undo

  
Interest
USD

  
Interest
User Interface

  
Interest
UV Editing

  
Interest
VFX & Video

  
Interest
Video Sequencer

  
Interest
Virtual Reality

  
Interest
Vulkan

  
Interest
Wayland
Issues relating to Wayland windowing support.

  
Interest
Workbench

  
Interest: X11

Issues relating to Xorg/X11 support.

  
Legacy
Blender 2.8 Project

  
Legacy
Milestone 1: Basic, Local Asset Browser

  
Legacy
OpenGL Error

  
Meta
Good First Issue

  
Meta
Papercut

  
Meta
Retrospective

  
Meta
Security
Issues relating to security: https://wiki.blender.org/wiki/Process/Vulnerability_Reports

  
Module
Animation & Rigging

  
Module
Core

  
Module
Development Management

  
Module
EEVEE & Viewport

  
Module
Grease Pencil

  
Module
Modeling

  
Module
Nodes & Physics

  
Module
Pipeline, Assets & IO

  
Module
Platforms, Builds & Tests

  
Module
Python API

  
Module
Render & Cycles

  
Module
Sculpt, Paint & Texture

  
Module
Triaging

  
Module
User Interface

  
Module
VFX & Video

  
Platform
FreeBSD

  
Platform
Linux

  
Platform
macOS

  
Platform
Windows

  
Priority
High

  
Priority
Low

  
Priority
Normal

  
Priority
Unbreak Now!

  
Status
Archived

  
Status
Confirmed

  
Status
Duplicate

  
Status
Needs Info from Developers

  
Status
Needs Information from User

  
Status
Needs Triage

  
Status
Resolved

  
Type
Bug

  
Type
Design

  
Type
Known Issue

  
Type
Patch

  
Type
Report

  
Type
To Do

No Label
Interest
Alembic
Interest
Animation & Rigging
Interest
Asset Browser
Interest
Asset Browser Project Overview
Interest
Audio
Interest
Automated Testing
Interest
Blender Asset Bundle
Interest
BlendFile
Interest
Collada
Interest
Compatibility
Interest
Compositing
Interest
Core
Interest
Cycles
Interest
Dependency Graph
Interest
Development Management
Interest
EEVEE
Interest
EEVEE & Viewport
Interest
Freestyle
Interest
Geometry Nodes
Interest
Grease Pencil
Interest
ID Management
Interest
Images & Movies
Interest
Import Export
Interest
Line Art
Interest
Masking
Interest
Metal
Interest
Modeling
Interest
Modifiers
Interest
Motion Tracking
Interest
Nodes & Physics
Interest
OpenGL
Interest
Overlay
Interest
Overrides
Interest
Performance
Interest
Physics
Interest
Pipeline, Assets & IO
Interest
Platforms, Builds & Tests
Interest
Python API
Interest
Render & Cycles
Interest
Render Pipeline
Interest
Sculpt, Paint & Texture
Interest
Text Editor
Interest
Translations
Interest
Triaging
Interest
Undo
Interest
USD
Interest
User Interface
Interest
UV Editing
Interest
VFX & Video
Interest
Video Sequencer
Interest
Virtual Reality
Interest
Vulkan
Interest
Wayland
Interest
Workbench
Interest: X11
Legacy
Blender 2.8 Project
Legacy
Milestone 1: Basic, Local Asset Browser
Legacy
OpenGL Error
Meta
Good First Issue
Meta
Papercut
Meta
Retrospective
Meta
Security
Module
Animation & Rigging
Module
Core
Module
Development Management
Module
EEVEE & Viewport
Module
Grease Pencil
Module
Modeling
Module
Nodes & Physics
Module
Pipeline, Assets & IO
Module
Platforms, Builds & Tests
Module
Python API
Module
Render & Cycles
Module
Sculpt, Paint & Texture
Module
Triaging
Module
User Interface
Module
VFX & Video
Platform
FreeBSD
Platform
Linux
Platform
macOS
Platform
Windows
Priority
High
Priority
Low
Priority
Normal
Priority
Unbreak Now!
Status
Archived
Status
Confirmed
Status
Duplicate
Status
Needs Info from Developers
Status
Needs Information from User
Status
Needs Triage
Status
Resolved
Type
Bug
Type
Design
Type
Known Issue
Type
Patch
Type
Report
Type
To Do
Milestone
Clear milestone
No items
No Milestone
Projects
Clear projects
No project
Brush Assets & Asset Shelf
Assignees
Clear assignees
No Assignees
3 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: blender/blender#101908
No description provided.
Delete Branch "%!s(<nil>)"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?