Lib.point.particle.ParticleSystem - tixl3d/tixl GitHub Wiki

ParticleSystem

in Lib.point.particle


Emits particles on emit points and applies the connected forces.

Please check the howto linked below [HowToUseParticles].


Input Parameters

Name (Relevancy & Type) Description
EmitPoints (BufferWithViewsRequired) Input for GPoints
Emit (Boolean) Enables emitting of the connected emit points.

Tip: For simulations of a fixed number of emitted points, you can set the MaxPointCount to -1 and use [Once] or [Trigger] to only trigger an initial emit burst.
Reset (Boolean) Clears all emitted points.

Tip: You can connect [HasTimeChanged] the clean up on rewind or looping.
Update (Boolean) -
MaxParticleCount (Int32) The length of the cycle buffer holding the simulated particles. Depending of the number of emitted particles it defines the maximum possible particle lifetime.

If set to -1 it will use the count of emit points.
InitialVelocity (Single) An initial velocity that is set for emitted particles along their z-axis.
RadiusFromW (Single) Some of the forces uses the partcile radius for collision calcuation. The radius is set on emit time by the emit point W attribute and the RadiusFromW factor.
For consistency we aligned that factor with the default point size for [DrawPoints] which renders points with a radius of 1/100 units..
EmitMode (Int32) This will effect how particles are inserted into the particle-buffer. This order will have an effect when drawing with lines.
Note that switching this setting might require to reset the system.
LifeTime (Single) The lifetime of particles in bars (depending on the current BPM rate).
A negative setting will compute the maximum lifetime from the MaxParticleCount and the number of currently emitted particles.
This will lead to flickering if changing the emit count during playback.
Speed (Single) The simulation speed. If set to 0 the simulation will be paused.
Negative simulation speed can shortly look like rewinding but the simulation will quickly become inconsistent.
OrientTowardsVelocity (Single) Rotates the particles in relation to their velocity
Drag (Single) A drag factor applied per simulation step. This can be useful for stabilizing simulations where forces insert too much energy (I.e. particle velocity) into the system.
SetWTo (Int32) Can be used for custimizing the rendering of the particles.

Note that many operators like [DrawPoints] use the W attribute to control the size of the points.
With other operators like [DrawBillboards] you can use the W parameter to colorize particles over their lifetime.

Keep Original W -> no change
Particle Age -> Normalized age between 0 ... 1
Velocity -> A representation of the particle's velocity.
ParticleForces (ParticleSystemRequired) Input for Forces or [SwitchParticleForce]

Outputs

Name Type
OutBuffer T3.Core.DataTypes.BufferWithViews

Please help use to improve this documentation. Feel free to improve the description.

⚠ Everything else is automatically generated and will be overwritten regularly.

⚠️ **GitHub.com Fallback** ⚠️