Page MenuHome

Blender 3.0: Code Architecture Wiki Documentation
Confirmed, NormalPublicTO DO

Assigned To
Authored By
Dalai Felinto (dfelinto)
Nov 26 2021, 3:49 PM
"Love" token, awarded by mindinsomnia."100" token, awarded by EAW."Y So Serious" token, awarded by shader."Love" token, awarded by liquidificador."Love" token, awarded by ShenCiao."Love" token, awarded by PiloeGAO."Love" token, awarded by Raimund58."Love" token, awarded by filedescriptor.


Architecture Wiki Documentation

The state of the online documentation is behind. As part of wrapping up the 3.0 release and preparing the 3.1 development a list of pasts of Blender will be tackled. The focus is on active areas that have overlap within different modules.

The audience is other developers that need to understand the main aspects of the code and its design constraints.

How to collaborate:

  • Choose one topic, edit this document to have your name besides this area.
  • Write the docs, ask for feedback, mark as done.

List of topics to be documented:

  • DNA (padding, rename, defaults).
  • ID Management. @Bastien Montagne (mont29)
    • Define general structure of this section.
    • Move existing Source/Architecture/ID page under this section and update it.
    • Get review for proposed structure.
    • Flesh out the documentation.
  • Undo (needs to be revised). Draft: P2674.
  • .blend file read/write
  • BMesh (relation with mesh, custom data, attributes).
  • Depsgraph (updated version).
  • Constraints.
  • Animation data.
  • Nodes sockets and animation data.
  • Geometry nodes and object types (point cloud, instances, curves, geometry nodes relation with other modifiers).
  • Gizmos.
  • message_bus.
  • Event system.
  • Notifiers.
  • Screen hierarchy.
  • GPU (batches).
  • Draw manager.
  • Selection.
  • Color management.
  • Overlay.
  • Motion track.
  • Bonus: Grease Pencil and Line Art.
  • Cycles
    • Scene graph
    • Closures
    • Volumes
    • Light sampling
    • Threads
    • EXR cache

Event Timeline

Dalai Felinto (dfelinto) changed the task status from Needs Triage to Confirmed.Nov 26 2021, 3:49 PM
Dalai Felinto (dfelinto) created this task.
Dalai Felinto (dfelinto) changed the subtype of this task from "Report" to "To Do".
Dalai Felinto (dfelinto) renamed this task from Blender 3.0: Architecture Wiki Documentation to Blender 3.0: Code Architecture Wiki Documentation.Nov 26 2021, 3:56 PM

Hi! As someone trying to get into Blender Dev, I'm a bit at a loss with the current state of the documentation and was wondering what happenned to this project? Specially since the 3.1 release is just around the corner and only a couple sub-items from this list appear to have been tackled.