Click or drag to resize
DigitalRuneSingleFadeEffector Class
Fades a particle parameter of type Single in and out.
Inheritance Hierarchy
SystemObject
  DigitalRune.ParticlesParticleEffector
    DigitalRune.Particles.EffectorsSingleFadeEffector

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

The SingleFadeEffector type exposes the following members.

Constructors
  NameDescription
Public methodSingleFadeEffector
Initializes a new instance of the SingleFadeEffector 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 (Inherited from ParticleEffector.)
Protected methodOnInitializeParticles (Inherited from ParticleEffector.)
Protected methodOnRequeryParameters (Overrides ParticleEffectorOnRequeryParameters.)
Protected methodOnUninitialize (Overrides ParticleEffectorOnUninitialize.)
Protected methodOnUpdateParticles
Called when UpdateParticles(TimeSpan, Int32, Int32) was called.
(Overrides ParticleEffectorOnUpdateParticles(TimeSpan, Int32, Int32).)
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 propertyEnabled
Gets or sets a value indicating whether this ParticleEffector is enabled.
(Inherited from ParticleEffector.)
Public propertyFadeInEnd
Gets or sets the threshold that defines when the fade-in ends.
Public propertyFadeInStart
Gets or sets the threshold that defines when the fade-in starts.
Public propertyFadeOutEnd
Gets or sets the threshold that defines when the fade-out ends.
Public propertyFadeOutStart
Gets or sets the threshold that defines when the fade-out starts.
Public propertyName
Gets the name of this particle effector.
(Inherited from ParticleEffector.)
Public propertyParticleSystem
Gets or sets the particle system.
(Inherited from ParticleEffector.)
Public propertyTargetValueParameter
Gets or sets the name of the parameter that defines the target value. (A varying or uniform parameter of type Single.)
Public propertyTimeParameter
Gets or sets the name of the parameter that defines the progress of the fade-in/out. (A varying or uniform parameter of type Single.)
Public propertyValueParameter
Gets or sets the name of the parameter that is faded in/out. (A varying or uniform parameter of type Single.)
Top
Remarks

All parameters must be of type Single.

This effector changes a parameter value from 0 to a target value ("fade-in"). Then the value is kept at the target value. Later the value is changed from the target value to 0 ("fade-out").

The fade-in interval is defined by FadeInStart and FadeInEnd. The fade-out interval is defined by FadeOutStart and FadeOutEnd. These intervals should be non-overlapping and the start values should be less than the corresponding end values. Usually, the fade-in interval lies before the fade-out interval, but it is allowed to swap the intervals to create a fade-out followed by a fade-in. The factor parameter (see TimeParameter) defines the progress of the fade-in/out. This parameter is usually the "NormalizedAge" of the particles.

Used particle parameters:

Particle ParameterDescription
ValueParameter A Single parameter that stores the result.
TargetValueParameter A Single parameter that defines the target value. This parameter is optional. If it is not set, the target value is 1.
TimeParameter A Single parameter that defines the fade-in/out factor. If this value is between FadeInStart and FadeInEnd, then the value parameter is faded in. If this value is between FadeOutStart and FadeOutEnd, then the value parameter is faded out. Per default, the parameter "NormalizedAge" is used.

See Also