Click or drag to resize
DigitalRuneStreamEmitter Class
Creates particles at a configurable emission rate.
Inheritance Hierarchy

Namespace: DigitalRune.Particles.Effectors
Assembly: DigitalRune.Particles (in DigitalRune.Particles.dll) Version: 1.4.0.0 (1.4.1.14427)
Syntax
public class StreamEmitter : ParticleEffector

The StreamEmitter type exposes the following members.

Constructors
  NameDescription
Public methodStreamEmitter
Initializes a new instance of the StreamEmitter class.
Top
Methods
  NameDescription
Public methodBeginUpdate
Called when the particle system begins its update.
(Inherited from ParticleEffector.)
Public methodClone
Creates a new ParticleEffector that is a clone of the current instance.
(Inherited from ParticleEffector.)
Protected methodCloneCore
Makes the instance a clone of the specified ParticleEffector.
(Overrides ParticleEffectorCloneCore(ParticleEffector).)
Protected methodCreateInstanceCore
When implemented in a derived class, creates a new instance of the ParticleEffector derived class.
(Overrides ParticleEffectorCreateInstanceCore.)
Public methodEndUpdate
Called when the particle system finishes its update.
(Inherited from ParticleEffector.)
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGetHashCode
Serves as a hash function for a particular type.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodInitialize
Initializes this particle effector.
(Inherited from ParticleEffector.)
Public methodInitializeParticles
Initializes new particles.
(Inherited from ParticleEffector.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Protected methodOnBeginUpdate
Called when BeginUpdate(TimeSpan) was called.
(Overrides ParticleEffectorOnBeginUpdate(TimeSpan).)
Protected methodOnEndUpdate
Called when BeginUpdate(TimeSpan) was called.
(Inherited from ParticleEffector.)
Protected methodOnInitialize (Overrides ParticleEffectorOnInitialize.)
Protected methodOnInitializeParticles (Inherited from ParticleEffector.)
Protected methodOnRequeryParameters (Overrides ParticleEffectorOnRequeryParameters.)
Protected methodOnUninitialize (Overrides ParticleEffectorOnUninitialize.)
Protected methodOnUpdateParticles
Called when UpdateParticles(TimeSpan, Int32, Int32) was called.
(Inherited from ParticleEffector.)
Public methodRequeryParameters
Requeries the particle parameters.
(Inherited from ParticleEffector.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Public methodUninitialize
Uninitializes this particle effector.
(Inherited from ParticleEffector.)
Public methodUpdateParticles
Updates particles.
(Inherited from ParticleEffector.)
Top
Properties
  NameDescription
Public propertyDefaultEmissionRate
Gets or sets the default emission rate that is used if the EmissionRateParameter is not found.
Public propertyEmissionLimit
Gets or sets the maximum number of emitted particles.
Public propertyEmissionRateParameter
Gets or sets the name of the particle parameter that defines the emission rate (particles per second). (A uniform parameter of type Single.)
Public propertyEnabled
Gets or sets a value indicating whether this ParticleEffector is enabled.
(Inherited from ParticleEffector.)
Public propertyName
Gets the name of this particle effector.
(Inherited from ParticleEffector.)
Public propertyParticleSystem
Gets or sets the particle system.
(Inherited from ParticleEffector.)
Top
Remarks

This effectors reads a uniform particle parameter (see EmissionRateParameter) to define the emission rate. If no emission rate parameter is found, the DefaultEmissionRate is used.

The emitter emits a stream of particles until EmissionLimit number of particles have been created. Then it will stop to emit particles. The internal particle counter is reset when Initialize is called (which is automatically called when a particle system is Reset).

This emitter can be configured to create particles in bursts: Simply set a high enough emission rate and limit the number of particles with EmissionLimit. To trigger another burst, simply increase EmissionLimit by the burst size.

See Also