Page MenuHome

Initial Particle Nodes
Confirmed, NormalPublicTO DO

Authored By
Jacques Lucke (JacquesLucke)
Aug 14 2019, 11:16 AM
"100" token, awarded by Dir-Surya."Love" token, awarded by Kubo_Wu."Love" token, awarded by PiloeGAO."Like" token, awarded by Schamph."Love" token, awarded by Shimoon."Love" token, awarded by ofuscado."Love" token, awarded by mistajuliax."Love" token, awarded by bnzs."Love" token, awarded by DaPaulus."Love" token, awarded by ace_dragon."Like" token, awarded by amonpaike.


This document lists what needs to be done to get an initial version of Particle Nodes in master. The merge is currently scheduled to be part of Blender 2.82.

The function branch consists of four main parts:

  1. C++ libraries in blenlib. (depends on nothing)
  2. Python code that defines the user interface including the nodes. (depends on nothing)
  3. The functions framework with a runtime type system that supports multiple backends. (depends on blenlib and the python ui)
  4. The bparticles system that parses a particle node tree and performs the simulation. (depends on blenlib, functions and the python ui)


While I have some changes planned (especially for the hash maps/sets), this code can go in at any time. A significant portion of this code is covered by unit tests. I happily continue improving and maintaining it when it is in master.

Also see:

Nodes UI

As mentioned, nodes are currently implemented in Python. I happily move this to C/C++ at some point, but it does not seem worth it right now.

Also see:


The function system consists of a couple of components which can be categorized into:

  • Backend: This is purely C++ and does not depend on the user interface at all.
  • Frontend: This takes a node tree as input and creates an internal data flow graph from it that can be handled by the backend.

The backend can be merged as soon as the libraries are merged. It should not impact anything else.

For the frontend to make sense, the node ui needs to be merged as well. This could be merged without actually exposing a new node tree type to the user.
Currently, there are also two new modifiers that I use for testing of the function system. I do not expect them to be merged.

Also see:

Particle System

While these other parts could almost be merged as they are, I have to spend more time on the actual particle system.
One particle simulation backend that is sufficient for a variety of particle effects is working, but the user interface is still lacking.

These things still have to be worked out:

  • How to structure the node tree exactly? I had an original proposal, but there are some weak points that need to be solved (see link below).
  • Where does the output of the simulation go? Currently, the particles are just output on a mesh as vertices. This might depend on the introduction of a new point cloud data type. Also, the output of the particle simulation might be particles of different types, that users will want to use different materials for.
  • Which nodes do we actually want to have? Currently, most nodes are just for testing and don't offer enough options for artists. I'll create separate design tasks for different categories soon.
  • How to integrate this with the current cache system? The problems of the current caching system are well known. There is probably not enough time to implement a new system before Blender 2.82.

Possible compromises to get this to merge sooner (not saying that we should not do these things, but we might need to trade-off features vs. time-to-market here):

  • No node group support. While it is not too difficult to implement node groups, it is still unclear how they should work exactly (see link below). We could postpone that until we have a better idea of how artists want to group things.
  • No integration with the current caching system. There is already very simple caching in the modifier directly. That could be made more usable. Then we could implement a new caching system a bit later and use it when it is ready.
  • No ability to use separate materials for different particle types. It should still be possible to get the particle type in a shader via an attribute, to shade different types differently nevertheless.

Also see:

Event Timeline

Jacques Lucke (JacquesLucke) lowered the priority of this task from 90 to Normal.Aug 14 2019, 11:16 AM
Jacques Lucke (JacquesLucke) created this task.

I absolutely love the amount of information you're making available about how these systems work/will work and how everything is coming along. I played around with the build yesterday and it looked pretty awesome! ^^ I managed to make some particles bounce off a plane :)

I feel like to answer some of these questions, you should put a "beta version" in front of artists, and advertise it(Blender Today), and see what they do with it and what they have to say about it.

My understanding was always that this is planned to be merged no sooner than 2.82, if we are lucky. It sounds like you want to get it in sooner, but I for one, am happy to wait for something that's more polished. Take your time man.

The compromises to get this in sooner seem a bit harsh in my book, so waiting until 2.82 at the earliest (especially with the 3 month release schedule) appears reasonable.