Overview

CC3VariegatedPointParticleHoseEmitter is a type of CC3PointParticleEmitter whose particles can have a color and size that evolves during the lifetime of the particle.

CC3VariegatedPointParticleHoseEmitter configures particles of that support the CC3VariegatedPointParticleProtocol, and can set an individual initial and final color and size for each particle, each selected randomly from a range of values.

Properties

maxParticleEndingColor

Indicates the upper bound of the range from which the final color of the particle will be chosen.

@property (nonatomic, assign) ccColor4F maxParticleEndingColor

Discussion

Whenever a particle is emitted, its starting color is determined by choosing a random value between the values specified by the minParticleStartingColor and maxParticleStartingColor properties. The color is randomized by choosing a random value for each component from the numerical range defined by the value of that component in the minParticleStartingColor and maxParticleStartingColor properties.

This final color is used to determine the rate at which the color will change while the particle is alive, and the result is set into the colorVelocity property of the particle.

In addition to a specific final color value, you can use the special values: – kCC3ParticleConstantColor – kCC3ParticleFadeOut to indicate, respectively, that the final color of the particle should be the same as the starting color, or that the final color should be the same as the starting color, except that it should fade away during the lifetime of the particle.

In a more general sense, setting any of the component values of either the minParticleEndingColor or maxParticleEndingColor properties to kCC3ParticleConstantComponent will cause the value of that component to stay constant throughout the lifetime of the particle.

Declared In

CC3PointParticleSamples.h

maxParticleEndingSize

Indicates the upper bound of the range from which the final size of the particle will be chosen.

@property (nonatomic, assign) GLfloat maxParticleEndingSize

Discussion

Whenever a particle is emitted, its final size is determined by choosing a random value between the values specified by the minParticleEndingSize and maxParticleEndingSize properties. This is used to determine the rate at which the size will change while the particle is alive, and the result is set into the sizeVelocity property of the particle.

In addition to a specific size value, you can use the special value kCC3ParticleConstantSize to indicate that the final size of the particle should be the same as the starting size. Using this value for either minParticleEndingSize or maxParticleEndingSize will allow the starting size to be set randomly and to stay constant throughout the life of the particle.

Declared In

CC3PointParticleSamples.h

maxParticleStartingColor

Indicates the upper bound of the range from which the initial color of the particle will be chosen.

@property (nonatomic, assign) ccColor4F maxParticleStartingColor

Discussion

Whenever a particle is emitted, its starting color is determined by choosing a random value between the values specified by the minParticleStartingColor and maxParticleStartingColor properties. The color is randomized by choosing a random value for each component from the numerical range defined by the value of that component in the minParticleStartingColor and maxParticleStartingColor properties.

Declared In

CC3PointParticleSamples.h

maxParticleStartingSize

Indicates the upper bound of the range from which the initial size of the particle will be chosen.

@property (nonatomic, assign) GLfloat maxParticleStartingSize

Discussion

Whenever a particle is emitted, its starting size is determined by choosing a random value between the values specified by the minParticleStartingSize and maxParticleStartingSize properties.

Declared In

CC3PointParticleSamples.h

minParticleEndingColor

Indicates the lower bound of the range from which the final color of the particle will be chosen.

@property (nonatomic, assign) ccColor4F minParticleEndingColor

Discussion

Whenever a particle is emitted, its starting color is determined by choosing a random value between the values specified by the minParticleStartingColor and maxParticleStartingColor properties. The color is randomized by choosing a random value for each component from the numerical range defined by the value of that component in the minParticleStartingColor and maxParticleStartingColor properties.

This final color is used to determine the rate at which the color will change while the particle is alive, and the result is set into the colorVelocity property of the particle.

In addition to a specific final color value, you can use the special values: – kCC3ParticleConstantColor – kCC3ParticleFadeOut to indicate, respectively, that the final color of the particle should be the same as the starting color, or that the final color should be the same as the starting color, except that it should fade away during the lifetime of the particle.

In a more general sense, setting any of the component values of either the minParticleEndingColor or maxParticleEndingColor properties to kCC3ParticleConstantComponent will cause the value of that component to stay constant throughout the lifetime of the particle.

Declared In

CC3PointParticleSamples.h

minParticleEndingSize

Indicates the lower bound of the range from which the final size of the particle will be chosen.

@property (nonatomic, assign) GLfloat minParticleEndingSize

Discussion

Whenever a particle is emitted, its final size is determined by choosing a random value between the values specified by the minParticleEndingSize and maxParticleEndingSize properties. This is used to determine the rate at which the size will change while the particle is alive, and the result is set into the sizeVelocity property of the particle.

In addition to a specific size value, you can use the special value kCC3ParticleConstantSize to indicate that the final size of the particle should be the same as the starting size. Using this value for either minParticleEndingSize or maxParticleEndingSize will allow the starting size to be set randomly and to stay constant throughout the life of the particle.

Declared In

CC3PointParticleSamples.h

minParticleStartingColor

Indicates the lower bound of the range from which the initial color of the particle will be chosen.

@property (nonatomic, assign) ccColor4F minParticleStartingColor

Discussion

Whenever a particle is emitted, its starting color is determined by choosing a random value between the values specified by the minParticleStartingColor and maxParticleStartingColor properties. The color is randomized by choosing a random value for each component from the numerical range defined by the value of that component in the minParticleStartingColor and maxParticleStartingColor properties.

Declared In

CC3PointParticleSamples.h

minParticleStartingSize

Indicates the lower bound of the range from which the initial size of the particle will be chosen.

@property (nonatomic, assign) GLfloat minParticleStartingSize

Discussion

Whenever a particle is emitted, its starting size is determined by choosing a random value between the values specified by the minParticleStartingSize and maxParticleStartingSize properties.

Declared In

CC3PointParticleSamples.h