ObjectParticles Class
This class is used to create particle systems. The particles are approximated with a sphere. They can be of different types (see the details) and radius (that can change with time). They are emitted from different emitters (see the details) with a specified spawn rate. The particles disappear after the set life time period or culled when hitting other nodes. They either collide with the outer surface of the approximation sphere or intersect only by the its center.
The particle flow direction can be influenced by:
- Gravity
- Point force (see the details), which has two properties:
- Deflectors of two types (see the details):
- Physicals nodes
The particle system can also initialized before it actually appears, so that it starts to be rendered with already spawned particles.
The following samples demonstrate the ObjectParticles class usage:
ObjectParticles Class
Members
ObjectParticles ()
Constructor. Creates a particle system.void setLengthFlattening (float flattening)
Sets a factor of the linear interpolation between Z axis and the camera direction for the length particles.Arguments
- float flattening - A flattening factor. If a negative value is provided, 0 will be used instead.
float getRotationMean ()
Returns the current mean value of the angles at which the emitted particles are rotated.Return value
The mean value in degrees.void setSpawnRate (float rate)
Sets a rate at which particles are created.Arguments
- float rate - A new spawn rate. If a too small value is provided, 1E-6 will be used instead.
void setForceAttractor (int num, float attractor)
Sets the attraction force that will be applied to the particles in the specified force radius.Arguments
- int num - The attraction force number.
- float attractor - The force value.
int getDeflectorType (int num)
Returns a type of a given deflector.Arguments
- int num - The deflector number.
Return value
OBJECT_PARTICLES_DEFLECTOR_REFLECTOR or OBJECT_PARTICLES_DEFLECTOR_CLIPPER.float getDurationMean ()
Returns the current mean value of particle emission intervals.Return value
The mean value in seconds.float getLengthStretch ()
Returns the current factor, by which length particles are stretched.Return value
The current stretch factor.void setWarming (int warming)
Enables the warm start for the particles. It means that the particle system starts to be rendered with already emitted particles, rather then from a zero point.Arguments
- int warming - Positive number to enable the warm start; 0 to disable.
void setDeflectorRestitution (int num, float restitution)
Sets restitution of the deflector. Makes sense only for reflectors.Arguments
- int num - The deflector number.
- float restitution - A new restitution. The provided value will be saturated in the range [0; 1].
float getGrowthDamping ()
Returns the current damping of particles growth in size.Return value
The current growth damping.void setNoiseStep (int num, vec3 step)
Sets the Step parameter coordinates values for the required noise.Arguments
- int num - The target noise number.
- vec3 step - Step coordinates values.
vec3 getContactVelocity (int num)
Returns the velocity in the collision point of the particles with other objects.Arguments
- int num - The collision point number.
Return value
Velocity values for each of space dimensions.void setNoiseAttached (int num, int attached)
Sets the noise as an attached.Arguments
- int num - The target noise number.
- int attached - 1 to enable the Attached flag, 0 to disable it.
float getPhysicalMass ()
Returns the current mass of the particles. This value matters only for computing physical interactions.Return value
Particles mass.void setDeflectorRoughness (int num, float roughness)
Sets roughness of the deflector surface. Makes sense only for reflectors.Arguments
- int num - The deflector number.
- float roughness - A new roughness. The provided value will be saturated in the range [0; 1].
void setSpawnThreshold (float threshold)
Sets the velocity threshold for spark and random emitters. They spawn particles if velocity of the parent particles is high enough.Arguments
- float threshold - A velocity threshold for the parent particles.
void setEmitterSync (int sync)
Sets a value indicating if a particle system emitter needs to be synchronized to a parent particle system.Arguments
- int sync - 1 to synchronize the emitter; otherwise, 0.
int getDepthSort ()
Returns a value indicating if depth sorting of particles is enabled. Depth sorting is required, if particles use alpha blending.Return value
Positive number if depth sorting is enabled; otherwise, 0.void setDeflectorAttached (int num, int attached)
Attaches or detaches a given deflector to the particle system.Arguments
- int num - The deflector number.
- int attached - 1 to attach the deflector, 0 to detach it.
float getDelayMean ()
Returns the mean value of particles initialization delay relative to the parent particle system.Return value
The mean value in seconds.int isDeflectorAttached (int num)
Returns a value indicating if a given deflector is attached to the particle system.Arguments
- int num - Number of the deflector.
Return value
1 if the deflector is attached; otherwise, 0.void setEmitterVelocity (vec3 velocity)
Sets the emitter velocity, which is added to the initial velocity of spawned particles. If the value equals 0, the actual velocity of emitter node will be used.Arguments
- vec3 velocity - Emitter velocity in units per second.
float getForceAttractor (int num)
Returns the current attraction force applied to the particles in the specified force radius.Arguments
- int num - The attraction force number.
Return value
The force value.vec3 getEmitterVelocity ()
Returns the current emitter velocity, which is added to the initial velocity of spawned particles. If the value equals 0, the actual velocity of emitter node will be used.Return value
The emitter velocity in units per second.int addNoise ()
Adds a new noise with default settings.Return value
The number of the new noise in the list of noises.int getEmitterSequence ()
Returns the current rendering order of the particle system inside the particles hierarchy.Return value
The current rendering priority.float getLifeMean ()
Returns the current mean value of particle lifetime duration.Return value
The mean value in seconds.int isNoiseAttached (int num)
Returns a value indicating if the given noise is attached to the particle system.Arguments
- int num - The target noise number.
Return value
1 if the noise is attached; otherwise, 0.void setNoiseOffset (int num, vec3 offset)
Sets the Offset parameter coordinates values for the required noise.Arguments
- int num - The target noise number.
- vec3 offset - Offset coordinates values.
float getSpawnThreshold ()
Returns the current velocity threshold for spark and random emitters. They spawn particles if velocity of the parent particles is high enough.Return value
The current velocity threshold of the parent particles.float getForceRadius (int num)
Returns the current radius set for applying the force.Arguments
- int num - The force number.
Return value
The current radius in units.void setEmitterBased (int based)
Sets a value indicating if particles should follow emitter transformations, i.e. the direction of their flow should change after the emitter.Arguments
- int based - 1 for particles to follow emitter transformations; 0 for them to flow independently.
void setIntersection (int intersection)
Enables or disables detecting collision by the center of the sphere that approximates the particles. This method is faster than collision detection, but less precise.Arguments
- int intersection - 1 to detect intersections, 0 not to detect.
vec3 getGravity ()
Returns the current gravity force influencing particles.Return value
Current gravity force.vec3 getEmitterDirection ()
Returns the current direction of particles emission along the axes.Return value
The current emission direction.float getLinearDamping ()
Returns the current linear damping of particles.Return value
The current linear damping.void setRadius (float mean, float spread)
Sets a particle radius in units.Arguments
- float mean - A mean value in units. If a too small value is provided, 1E-6 will be used instead.
- float spread - A spread value in units.
void setVariationX (int variationx)
Sets a value indicating if the initial orientation of particles diffuse texture should be randomly varied along the X axis.Arguments
- int variationx - 1 to add random variation along the X axis, 0 not to add.
int addDeflector ()
Adds a deflector with default settings.Return value
The number of the new deflector in the list of deflectors.float getGrowthMean ()
Returns the current mean value of the particle growth factor.Return value
The mean value.float getSpawnScale ()
Returns the current spawn scale that enables to modulate smooth and gradual initialization of the particle system starting with the given spawn state and up to the specified spawn rate.Return value
The current spawn scale.void setCollision (int collision)
Enables or disables detecting collision by the outer surface of the sphere that approximates the particles (each particle is approximated with the sphere). This method is slower than intersection detection, but more precise.Arguments
- int collision - 1 to enable sphere-based collision detection, 0 to disable it.
int isNoiseEnabled (int num)
Returns a value indicating if the given noise is enabled.Arguments
- int num - The target noise number.
Return value
1 if the noise is enabled; otherwise, 0.int getNumParticles ()
Returns the current number of particles.Return value
The number of particles.float getParticleRadius (int num)
Returns the radius of a given particle.Arguments
- int num - The particle number.
Return value
Radius of the particle.float getAngularDamping ()
Returns the current angular damping of particles.Return value
The current angular damping.void setRoughness (float roughness)
Sets a roughness of the particle surface.Arguments
- float roughness - A new roughness value. The provided value will be saturated in the range [0; 1].
int getIntersection ()
Returns a value indicating if collision is detected by the center of the sphere that approximates the particles. This method is faster than sphere-based collision detection, but less precise.Return value
1 if the sphere center-based intersection detection is enabled; otherwise, 0.int getNumDeflectors ()
Returns the current number of deflectors.Return value
The number of deflectors.float getLengthFlattening ()
Returns the current factor of the linear interpolation between Z axis and the camera direction for the length particles.Return value
The current flattening factor.int getEmitterSync ()
Returns a value indicating if a particle system emitter is synchronized to a parent particle system.Return value
1 if it is synchronized; otherwise, 0.float getForceRotator (int num)
Returns the current rotation force applied to the particles in the specified force radius.Arguments
- int num - The rotation force number.
Return value
The force value.void setEmitterType (int type)
Sets a type of the emitter.Arguments
- int type - One of the OBJECT_PARTICLES_EMITTER_* variables.
void setEmitterSequence (int sequence)
Sets the rendering order of the particle system inside the particles hierarchy.Arguments
- int sequence - The rendering priority. Particle systems with the lowest order number are rendered first.
int getEmitterLimit ()
Returns the current maximum number of particles that an emitter can possibly spawn per one frame.Return value
The maximum possible number of particles.float getForceAttenuation (int num)
Returns the current attenuation factor for the specified force.Arguments
- int num - The force number.
Return value
The current attenuation factor.unsigned int getSeed ()
Returns a seed value used for the particles' random generator.Return value
Seed value.void setEmitterContinuous (int continuous)
Sets a value indicating if additional spawn points should be generated when the emitter is moved, which provides a continuous flow of particles.Arguments
- int continuous - 1 to create the continuous flow of particles; 0 to create the discrete flow with sparse generation points.
float getNoiseScale (int num)
Returns the Scale parameter value for the required noise.Arguments
- int num - The target noise number.
Return value
The noise scale value.void setNumNoises (int noises)
Sets the new number of noises.Arguments
- int noises - Number of noises.
void addEmitterSpark (Vec3 point, vec3 normal, vec3 velocity)
Adds a spark emitter in the given point.Arguments
- Vec3 point - Point for sparks emission.
- vec3 normal - Normal of the point of spark emission.
- vec3 velocity - Velocity in the point of spark emission (velocity of source particles or node by contact).
float getDeflectorRestitution (int num)
Returns the current restitution of the deflector. Makes sense only for reflectors.Arguments
- int num - The deflector number.
Return value
The current restitution.void setDelay (float mean, float spread)
Sets delay of particle system initialization relative to the parent particle one.Arguments
- float mean - A mean value in seconds. If a negative value is provided, 0 will be used instead.
- float spread - A spread value in seconds.
void setPeriod (float mean, float spread)
Sets an interval of emitter inactivity in seconds.Arguments
- float mean - A mean value in seconds. If a negative value is provided, 0 will be used instead.
- float spread - A spread value in seconds.
Image getNoiseImage (int num)
Returns the spatial texture for the required noise.Arguments
- int num - The target noise number.
Return value
The texture of the noise.void setDeflectorTransform (int num, Mat4 transform)
Sets a transformation matrix for a given deflector. This matrix describes the position and orientation of the deflector.Arguments
- int num - The deflector number.
- Mat4 transform - A new transformation matrix.
void setForceRadius (int num, float radius)
Sets a radius for applying the force.Arguments
- int num - The force number.
- float radius - A radius in units. If a negative value is provided, 0 will be used instead.
int isEmitterBased ()
Returns a value indicating if particles follow emitter transformations, i.e. the direction of their flow changes after the emitter.Return value
Positive number if particles follow emitter transformations; otherwise, 0.Mat4 getForceTransform (int num)
Returns the current transformation matrix for the specified force.Arguments
- int num - The force number.
Return value
The transformation matrix.void setNoiseForce (int num, float force)
Sets the Force parameter value for the required noise.Arguments
- int num - The target noise number.
- float force - The noise force value.
int getPhysicalMask ()
Returns the bit mask for interactions with physicals. Two objects interact, if they both have matching masks.Return value
Integer, each bit of which is a mask.int addForce ()
Adds a force with default settings.Return value
The number of the new force in the list of forces.void removeNoise (int num)
Removes the given noise.Arguments
- int num - The target noise number.
void setEmitterEnabled (int enabled)
Enables or disables particle emission.Arguments
- int enabled - 1 to enable particle emission, 0 to disable it.
float getRadiusMean ()
Returns the current mean value of particle radii.Return value
The mean value in units.int getParticlesType ()
Returns the type of emitted particles.Return value
One of the OBJECT_PARTICLES_TYPE_* variables.void setGrowth (float mean, float spread)
Sets a particle growth factor.Arguments
- float mean - A mean value.
- float spread - A spread value.
void setParticlesType (int type)
Sets a type of particles to emit.Arguments
- int type - One of the OBJECT_PARTICLES_TYPE_* variables.
void setEmitterLimit (int limit)
Sets the maximum number of particles that an emitter can possibly spawn per one frame.Arguments
- int limit - The maximum possible number of particles. If a negative value is provided, 0 will be used instead.
float getRestitution ()
Returns the current restitution value for particles.Return value
The current restitution value.int isEmitterShift ()
Returns a value indicating if the emitter spawns particles only when it is moving. The further it has moved, if compared to its position in the previous frame, the more particles will be spawned. If the emitter is not moving, there are no particles at all.Return value
Positive number if the shift-based spawning is enabled; 0 if it is not.void removeDeflector (int num)
Removes a given point deflector.Arguments
- int num - Number of the deflector to remove.
void setForceAttached (int num, int attached)
Attaches or detaches the given force to the particle system.Arguments
- int num - Number of the force.
- int attached - 1 to attach the force, 0 to detach it.
float getSpawnRate ()
Returns the current particle spawn rate.Return value
The current spawn rate.Mat4 getDeflectorTransform (int num)
Returns a transformation matrix of a given deflector. This matrix describes the position and orientation of the deflector. The default is the identity matrix.Arguments
- int num - The deflector number.
Return value
The transformation matrix.int getNoiseSize (int num)
Returns the Size parameter value for the required noise.Arguments
- int num - The target noise number.
Return value
The noise size value.void setCulling (int culling)
Sets a value indicating if particles should disappear upon collision or intersection.Arguments
- int culling - 1 to make particles disappear; 0 to continue rendering of particles after collision/intersection.
int isForceEnabled (int num)
Returns a value indicating if the given force is enabled.Arguments
- int num - Number of the force.
Return value
1 if the force is enabled; otherwise, 0.void setNumForces (int forces)
Sets the new number of forces.Arguments
- int forces - Number of forces.
int getNumNoises ()
Returns the current number of noises.Return value
Number of noises.float getRadiusSpread ()
Returns the current spread value of particle radii.Return value
The spread value in units.void setDepthSort (int sort)
Enables or disables depth sorting of particles. Depth sorting is required, if particles use alpha blending.Arguments
- int sort - Positive number to enable depth sorting, 0 to disable it.
float getPeriodSpread ()
Returns the current spread value of emitter inactivity intervals.Return value
The spread value in seconds.void setPhysicalMass (float mass)
Sets the mass of the particles. This value matters only for computing physical interactions.Arguments
- float mass - The mass of the particles.
void setTextureAtlas (int atlas)
Sets a value indicating if a diffuse texture for the particles is a 4x4 texture atlas.Arguments
- int atlas - Positive number if a texture atlas is used; 0 if an ordinary diffuse texture is assigned.
void removeForce (int num)
Removes the given force.Arguments
- int num - The number of the force to remove.
float getDurationSpread ()
Returns the current spread value of particle emission intervals.Return value
The spread value in seconds.void setNumDeflectors (int deflectors)
Sets the new number of deflectors.Arguments
- int deflectors - Number of deflectiors.
vec3 getDeflectorSize (int num)
Returns the current dimensions of the given deflector.Arguments
- int num - The deflector number.
Return value
The current dimensions. Only the first two components should be taken into account (x and y).void setNoiseTransform (int num, Mat4 transform)
Sets the transformation matrix for the required noise.Arguments
- int num - The target noise number.
- Mat4 transform - The noise transformation matrix.
void setEmitterSpread (vec3 spread)
Sets the spread of particles emission along the axes.Arguments
- vec3 spread - The spread of particles emission.
int isEmitterContinuous ()
Returns a value indicating if additional spawn points are generated when the emitter is moved, which provides a continuous flow of particles.Return value
1 if particles are created in the continuous flow; otherwise, 0.void setVelocity (float mean, float spread)
Sets an initial particle velocity in units per second.Arguments
- float mean - A mean value in units per second.
- float spread - A spread value in units per second.
float getDelaySpread ()
Returns the spread value of particles initialization delay relative to the parent particle system.Return value
The spread value in seconds.float getDeflectorRoughness (int num)
Returns the current roughness of the deflector. Makes sense only for reflectors.Arguments
- int num - The deflector number.
Return value
The current roughness.float getVelocitySpread ()
Returns the current spread value of the initial particle velocities.Return value
The spread value in units per second.void getParticleTransforms (int transforms)
Returns transformation matrices for spawned particles.Arguments
- int transforms - ID of the return array.
void setDuration (float mean, float spread)
Sets a duration of each particle emission in seconds.Arguments
- float mean - Mean value in seconds. If a negative value is provided, 0 will be used instead.
- float spread - Spread value in seconds.
void setNoiseScale (int num, float scale)
Sets the Scale parameter value for the required noise.Arguments
- int num - The target noise number.
- float scale - The noise scale value.
vec3 getNoiseStep (int num)
Returns the Step parameter coordinates values for the required noise.Arguments
- int num - The target noise number.
Return value
Step coordinates values.void setLinearDamping (float damping)
Sets a linear damping of particles.Arguments
- float damping - A new linear damping. If a negative value is provided, 0 will be used instead.
float getRotationSpread ()
Returns the current spread value of the angles at which the emitted particles are rotated.Return value
The spread value in degrees.void setPhysicalMask (int mask)
Sets the bit mask for interactions with physicals. Two objects interact, if they both have matching masks.Arguments
- int mask - Integer, each bit of which is a mask.
void setRotation (float mean, float spread)
Sets an angle (in degrees) at which the emitted particles should be rotated.Arguments
- float mean - The mean value in degrees.
- float spread - The spread value in degrees.
void clearParticles ()
Deletes all particles spawned by the emitter.float getAngleMean ()
Returns the mean value of the emission angle.Return value
The mean value in degrees.void setForceRotator (int num, float rotator)
Sets a rotation force that will be applied to the particles in the specified force radius.Arguments
- int num - The rotation force number.
- float rotator - The force value.
void setEmitterSize (vec3 size)
Sets a size of the emitter.Arguments
- vec3 size - New emitter size. Depending on the type of the emitter, this value is interpreted as follows:
- OBJECT_PARTICLES_EMITTER_POINT, OBJECT_PARTICLES_EMITTER_RANDOM or OBJECT_PARTICLES_EMITTER_SPARK: all vector components are ignored.
- OBJECT_PARTICLES_EMITTER_SPHERE: the first vector component is the radius of the sphere.
- OBJECT_PARTICLES_EMITTER_CYLINDER: the first vector component is the radius of the cylinder, the second vector component is the height of the cylinder.
- OBJECT_PARTICLES_EMITTER_BOX: all vector components are interpreted as box dimensions (x, y, z).
int isEmitterEnabled ()
Returns a value indicating if particle emission is enabled.Return value
Positive number if emission is enabled; otherwise, 0.vec3 getNoiseOffset (int num)
Returns the Offset parameter coordinates values for the required noise.Arguments
- int num - The target noise number.
Return value
Offset coordinates values.float getLifeSpread ()
Returns the current spread value of particle lifetime duration.Return value
The spread value in seconds.void setGravity (vec3 gravity)
Sets a gravity force influencing particles.Arguments
- vec3 gravity - A gravity force.
float getRoughness ()
Returns the current roughness of the particle surface.Return value
The current roughness.int getNumForces ()
Returns the number of the currently acting forces.Return value
The number of forces.int isForceAttached (int num)
Returns a value indicating if the given force is attached to the particle system.Arguments
- int num - Number of the force.
Return value
1 if the force is attached; otherwise, 0.void setVariationY (int variationy)
Sets a value indicating if the initial orientation of particles diffuse texture should be randomly varied along the Y axis.Arguments
- int variationy - 1 to add random variation along the Y axis, 0 not to add.
void setLengthStretch (float stretch)
Sets a factor, by which length particles will be stretched.Arguments
- float stretch - Stretch factor. If a negative value is provided, 0 will be used instead.
void setAngle (float mean, float spread)
Sets an angle of emission.Arguments
- float mean - Mean value in degrees.
- float spread - Spread value in degrees.
void setForceTransform (int num, Mat4 transform)
Sets a transformation matrix for the specified force.Arguments
- int num - The force number.
- Mat4 transform - A transformation matrix.
void setRestitution (float restitution)
Sets a restitution value for particles.Arguments
- float restitution - A new restitution value. The provided value will be saturated in the range [0; 1].
float getGrowthSpread ()
Returns the current spread value of the particle growth factor.Return value
The spread value.float getPeriodMean ()
Returns the current mean value of emitter inactivity intervals.Return value
The mean value in seconds.int getEmitterType ()
Returns the type of the emitter. The default is OBJECT_PARTICLES_EMITTER_POINT .Return value
One of the OBJECT_PARTICLES_EMITTER_* variables.float getVelocityMean ()
Returns the current mean value of the initial particle velocities.Return value
The mean value in units per second.Mat4 getNoiseTransform (int num)
Returns the transformation matrix for the required noise.Arguments
- int num - The target noise number.
Return value
The noise transformation matrix.void setForceAttenuation (int num, float attenuation)
Sets an attenuation factor for the specified force.Arguments
- int num - The force number.
- float attenuation - An attenuation factor.
Vec3 getContactPoint (int num)
Returns the point of the particles collision with other objects.Arguments
- int num - The collision point number.
Return value
Collision point coordinates.int getCulling ()
Returns a value indicating if particles would disappear upon collision or intersection.Return value
1 if particles would disappear; otherwise, 0.Vec3 getWorldOffset ()
Returns the current world offset of the local origin of coordinates of the particle system. The offset of the origin of coordinates is changed depending on the position of the particle system so that the particles are simulated near their emitter.Return value
Offset coordinates values.void setDeflectorType (int num, int type)
Sets a type of a given deflector.Arguments
- int num - The deflector number.
- int type - OBJECT_PARTICLES_DEFLECTOR_REFLECTOR or OBJECT_PARTICLES_DEFLECTOR_CLIPPER.
void setEmitterShift (int shift)
Sets a value indicating if the emitter spawns particles only when it is moving. The further it has moved, if compared to its position in the previous frame, the more particles will be spawned. If the emitter is not moving, there are no particles at all.Arguments
- int shift - 1 to enable the shift-based spawning; 0 to disable.
void setForceEnabled (int num, int enabled)
Enables or disables the given force.Arguments
- int num - The force number.
- int enabled - 1 to enable the force, 0 to disable it.
vec3 getEmitterSpread ()
Returns the current spread of particles emission along the axes.Return value
The spread of particles emission.void setNoiseFrequency (int num, int frequency)
Sets the Frequency parameter value for the required noise.Arguments
- int num - The target noise number.
- int frequency - The noise frequency value.
void setDeflectorEnabled (int num, int enabled)
Enables or disables the given deflector.Arguments
- int num - The deflector number.
- int enabled - 1 to enable the deflector, 0 to disable it.
Vec3 getParticlePosition (int num)
Returns the position of a given particle.Arguments
- int num - The particle number.
Return value
Position coordinates for the particle.int isDeflectorEnabled (int num)
Returns a value indicating if a given deflector is enabled.Arguments
- int num - Number of the deflector.
Return value
1 if the deflector is enabled; otherwise, 0.void setDeflectorSize (int num, vec3 size)
Sets dimensions of a given deflector.Arguments
- int num - The deflector number.
- vec3 size - New dimensions. Only the first two components are taken into account (x and y).
void setLife (float mean, float spread)
Sets a lifetime duration of particles in seconds.Arguments
- float mean - A mean value in seconds. If a too small value is provided, 1E-6 will be used instead.
- float spread - A spread value in seconds.
void setSpawnScale (float scale)
Sets a spawn scale that enables to modulate smooth and gradual initialization of the particle system starting with the given spawn state and up to the specified spawn rate.Arguments
- float scale - A spawn scale. The provided value is clipped to range [0;1]. By the value of 0, there are no spawned particles at the start. By the value of 1, the system is initialized with the specified spawn rate.
int getTextureAtlas ()
Returns a value indicating if a diffuse texture for the particles is used as a 4x4 texture atlas.Return value
Positive number if a texture atlas is used; otherwise, 0.int getVariationX ()
Returns a value indicating if the initial orientation of particles diffuse texture is randomly varied along the X axis.Return value
1 if there is random variation along theX axis, 0 if there is not.int getVariationY ()
Returns a value indicating if the initial orientation of particles diffuse texture is randomly varied along the Y axis.Return value
1 if there is random variation along theY axis, 0 if there is not.void setAngularDamping (float damping)
Sets an angular damping of particles.Arguments
- float damping - A new angular damping. If a negative value is provided, 0 will be used instead.
vec3 getContactNormal (int num)
Returns the normal vector for the collision point of the particles with other objects.Arguments
- int num - The collision point number.
Return value
Normal vector coordinates.int getWarming ()
Returns a value indicating if the warm start is enabled for the particles. It means that the particle system starts to be rendered with already emitted particles, rather then from a zero point.Return value
1 if warm start is enabled; 0 if disabled.float getNoiseForce (int num)
Returns the Force parameter value for the required noise.Arguments
- int num - The target noise number.
Return value
The noise force value.vec3 getEmitterSize ()
Returns the current emitter size.Return value
Current size. Depending on the type of the emitter, this value is interpreted as follows:- OBJECT_PARTICLES_EMITTER_POINT, OBJECT_PARTICLES_EMITTER_SPARK or OBJECT_PARTICLES_EMITTER_RANDOM : all vector components should be ignored.
- OBJECT_PARTICLES_EMITTER_SPHERE: the first vector component is the radius of the sphere.
- OBJECT_PARTICLES_EMITTER_CYLINDER: the first vector component is the radius of the cylinder, the second vector component is the height of the cylinder.
- OBJECT_PARTICLES_EMITTER_BOX: all vector components are interpreted as box dimensions (x, y, z).
void setSeed (unsigned int seed)
Sets a seed value for the particles' random generator.Arguments
- unsigned int seed - Seed value.
float getAngleSpread ()
Returns the spread value of the emission angle.Return value
The spread value in degrees.vec3 getParticleVelocity (int num)
Returns the velocity vector for a specified particle.Arguments
- int num - The particle number.
Return value
The velocity vector.int getCollision ()
Returns a value indicating if collision is detected by the outer surface of the sphere that approximates the particles. This method is slower than sphere center-based intersection detection, but more precise.Return value
1 if the sphere-based collision detection is enabled; otherwise, 0.void setNoiseSize (int num, int size)
Sets the Size parameter value for the required noise.Arguments
- int num - Target noise number.
- int size - Noise size value.
void setEmitterDirection (vec3 direction)
Sets the direction of particles emission along the axes.Arguments
- vec3 direction - The emission direction.
void setGrowthDamping (float damping)
Sets the damping of particles growth in size.Arguments
- float damping - A new growth damping. If a negative value is provided, 0 will be used instead.
int getNoiseFrequency (int num)
Returns the Frequency parameter value for the required noise.Arguments
- int num - Target noise number.
Return value
Noise frequency value.Object getContactObject (int num)
Returns the object that collided with particles collided in a given collision point.Arguments
- int num - The collision point number.
Return value
The object participated in collision.int getNumContacts ()
Returns the total number of particles collisions with other objects.Return value
The number of collisions.void setNoiseEnabled (int num, int enabled)
Enables or disables the given noise.Arguments
- int num - The target noise number.
- int enabled - 1 to enable the noise, 0 to disable it.
int OBJECT_PARTICLES_TYPE_BILLBOARD
Description
Particles of this type are camera-oriented and rotating.int OBJECT_PARTICLES_TYPE_FLAT
Description
Particles of this type are perpendicular to the z-axis of their particle system.int OBJECT_PARTICLES_TYPE_POINT
Description
Particles of this type are similar to billboard particles, but do not rotate.int OBJECT_PARTICLES_TYPE_LENGTH
Description
Particles of this type are similar to billboard particles, but stretched along the direction of their motion and do not rotate.int OBJECT_PARTICLES_TYPE_RANDOM
Description
Particles of this type are arbitrary oriented ones.int OBJECT_PARTICLES_TYPE_ROUTE
Description
Particles of this type can be used to create tracks from moving objects (for example, foam after a ship). Each Route particle is flat (just like flat particles), but is oriented on the plane in the same way as the emitter when it spawned it.int OBJECT_PARTICLES_TYPE_CHAIN
Description
Particles of this type are camera-oriented and connected with each other at vertices forming continuous flow.int OBJECT_PARTICLES_EMITTER_POINT
Description
Point emitter. Particles are emitted from one single point.int OBJECT_PARTICLES_EMITTER_SPHERE
Description
Sphere emitter. Particles are emitted from a random point of the sphere.int OBJECT_PARTICLES_EMITTER_CYLINDER
Description
Cylinder emitter. Particles are emitted from a random point of the cylinder.int OBJECT_PARTICLES_EMITTER_BOX
Description
Box emitter. Particles are emitted from a random point of the box.int OBJECT_PARTICLES_EMITTER_RANDOM
Description
Arbitrary emitter. Particles are emitted from a random point of their parent node. With an emitter of this type you can create particles, which spawn particles themselves.int OBJECT_PARTICLES_EMITTER_SPARK
Description
Spark emitter. Particles are emitted from a single point and imitate sparks.int OBJECT_PARTICLES_DEFLECTOR_REFLECTOR
Description
When a particle hits a deflector of this type, the particle bounces off it.int OBJECT_PARTICLES_DEFLECTOR_CLIPPER
Description
When a particle hits a deflector of this type, the particle is removed.Last update: 2017-07-03
Help improve this article
Was this article helpful?
(or select a word/phrase and press Ctrl+Enter)