Partikel-Shader

Partikel-Shader sind spezielle Vertex-Shader, die ausgeführt werden, bevor das Objekt gezeichnet wird. Sie werden zur Berechnung von Materialeigenschaften wie Farbe, Position und Drehung verwendet. Sie werden mit jedem regulären Material für CanvasItem oder Spatial gezeichnet, je nachdem, ob es sich um 2D oder 3D handelt.

Partikel-Shader sind einzigartig, da sie nicht zum Zeichnen des Objekts selbst verwendet werden. Sie werden zur Berechnung der Partikeleigenschaften verwendet, die dann von CanvasItem oder Spatial-Shader verwendet werden. Sie enthalten nur eine Vertex-Prozessorfunktion, die mehrere Eigenschaften ausgibt (siehe integrierte Funktionen unten).

Particle shaders use a transform feedback shader, which is a special type of vertex shader that runs on its own. It takes in data in a buffer like a regular vertex shader does, but it also outputs to data buffers instead of outputting to the fragment shader for pixel-processing. Because of this, transform feedback shaders can build on themselves each run, unlike other shaders that discard the data they have calculated once they draw to the frame buffer.

Bemerkung

Particle shaders are only available in the GLES3 backend. If you need particles in GLES2, use CPUParticles.

Render-Modi

Render Modus Beschreibung
keep_data Do not clear previous data on restart.
disable_force Disable attractor force. (Not currently implemented in 3.1)
disable_velocity Ignore VELOCITY value.

Built-ins

Values marked as "in" are read-only. Values marked as "out" are for optional writing and will not necessarily contain sensible values. Values marked as "inout" provide a sensible default value, and can optionally be written to. Samplers are not subjects of writing and they are not marked.

Global built-ins

Global built-ins are available everywhere, including custom functions.

Built-in Beschreibung
in float TIME Globale Zeit in Sekunden.

eingebaute Eckpunkt-Typen

In order to use the COLOR variable in a SpatialMaterial, set use_vertex_as_albedo to true. In a ShaderMaterial, access it with the COLOR variable.

Built-in Beschreibung
inout vec4 COLOR Particle color, can be written to and accessed in mesh's vertex function.
inout vec3 VELOCITY Particle velocity, can be modified.
out float MASS Particle mass, use for attractors (not implemented in 3.1).
inout bool ACTIVE true when Particle is active, can be set to false.
in bool RESTART true wenn das Partikel neu gestartet werden muss (Lebensdauerzyklus).
inout vec4 CUSTOM Custom particle data. Accessible from shader of mesh as INSTANCE_CUSTOM.
inout mat4 TRANSFORM Partikeltransformation.
in float LIFETIME Partikel Lebensdauer.
in float DELTA Delta Ausführungszeit.
in uint NUMBER Unique number since emission start.
in int INDEX Particle index (from total particles).
in mat4 EMISSION_TRANSFORM Emitter transform (used for non-local systems).
in uint RANDOM_SEED Random seed used as base for random.