Properties

CC3VariegatedPointParticleHoseEmitter Class Reference

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

#import <CC3PointParticleSamples.h>

Inheritance diagram for CC3VariegatedPointParticleHoseEmitter:
Inheritance graph
[legend]
Collaboration diagram for CC3VariegatedPointParticleHoseEmitter:
Collaboration graph
[legend]

List of all members.

Properties

ccColor4F maxParticleEndingColor
GLfloat maxParticleEndingSize
ccColor4F maxParticleStartingColor
GLfloat maxParticleStartingSize
ccColor4F minParticleEndingColor
GLfloat minParticleEndingSize
ccColor4F minParticleStartingColor
GLfloat minParticleStartingSize

Detailed Description

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

CC3VariegatedPointParticleHoseEmitter emit particles of type CC3UniformEvolutionParticle, and can set an individual initial and final color and size for each particle, each selected randomly from a range of values.

Although each particle is capable of having individual color and size values, you can configure whether either or both of these will be used when configuring this emitter using one of the populateForMaxParticles:... methods. For example, you may want particles with individual color, but not individual size.


Property Documentation

- (ccColor4F) maxParticleEndingColor [read, write, assign]

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

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.

- (GLfloat) maxParticleEndingSize [read, write, assign]

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

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.

- (ccColor4F) maxParticleStartingColor [read, write, assign]

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

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.

- (GLfloat) maxParticleStartingSize [read, write, assign]

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

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.

- (ccColor4F) minParticleEndingColor [read, write, assign]

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

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.

- (GLfloat) minParticleEndingSize [read, write, assign]

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

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.

- (ccColor4F) minParticleStartingColor [read, write, assign]

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

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.

- (GLfloat) minParticleStartingSize [read, write, assign]

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

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.


The documentation for this class was generated from the following file: