DirectOutput
DirectOutput framework R2 for virtual pinball cabinets.
 All Classes Namespaces Files Functions Variables Enumerations Enumerator Properties Events Macros Pages
DirectOutput.FX.TimmedFX.DurationEffect Class Reference

Duration effect which triggers a specified target effect for a specified duration.
When this effect is triggered it triggers the target effect immediately with the same data it has received. After the specified duration it calls trigger on the target effect again with data for the same table elmenet, but with the value changed to 0.
More...

Inheritance diagram for DirectOutput.FX.TimmedFX.DurationEffect:
Collaboration diagram for DirectOutput.FX.TimmedFX.DurationEffect:

Public Member Functions

override void Trigger (Table.TableElementData TableElementData)
 Triggers the DurationEffect with the given TableElementData.
The duration is started, if the value portion of the TableElementData parameter is !=0. Trigger calls with a TableElement value=0 have no effect. More...
 
override void Finish ()
 Finishes the DurationEffect. More...
 
- Public Member Functions inherited from DirectOutput.FX.EffectEffectBase
override void Init (Table.Table Table)
 Initializes the EffectEffect.
Resolves the name of the TargetEffect. More...
 
- Public Member Functions inherited from DirectOutput.FX.EffectBase
abstract void Trigger (TableElementData TableElementData)
 Triggers the effect with the given TableElementData. More...
 

Properties

RetriggerBehaviourEnum RetriggerBehaviour [get, set]
 Gets or sets the retrigger behaviour.
The setting defines the behaviour of the effect if it is retriggered while it is still active.
This settings is only relevant, if the effect can be called from more than one table element. More...
 
int DurationMs [get, set]
 Gets or sets the duration for the effect in milliseconds. More...
 
bool Active [get, set]
 Gets a value indicating whether this DurationEffect is currently active. More...
 
- Properties inherited from DirectOutput.FX.EffectEffectBase
string TargetEffectName [get, set]
 Name of the target effect.
Triggers EffectNameChanged if value is changed. More...
 
IEffect TargetEffect [get, set]
 TargetEffect for the effect (ReadOnly).
The property is resolved from the TargetEffectName. If TargetEffectName is empty or unknown this property will return null. More...
 
Table.Table Table [get, set]
 Gets the table object which is hosting the effect. More...
 

Additional Inherited Members

- Protected Member Functions inherited from DirectOutput.FX.EffectEffectBase
void TriggerTargetEffect (TableElementData TriggerData)
 Triggers the target effect.
The method will deactivate the target effect if it throws a exception. More...
 
- Events inherited from DirectOutput.General.Generic.NamedItemBase
EventHandler< NameChangeEventArgsAfterNameChanged
 Event is fired after the value of the property Name has changed. More...
 
EventHandler< NameChangeEventArgsBeforeNameChange
 Event is fired before the value of the property Name is changed. More...
 
- Events inherited from DirectOutput.FX.IEffect
new EventHandler
< NameChangeEventArgs
AfterNameChanged
 This event must be fired after the Name property of a IEffect object has changed. More...
 
new EventHandler
< NameChangeEventArgs
BeforeNameChange
 This event must be fired before the Name property of a IEffect object is changed. More...
 

Detailed Description

Duration effect which triggers a specified target effect for a specified duration.
When this effect is triggered it triggers the target effect immediately with the same data it has received. After the specified duration it calls trigger on the target effect again with data for the same table elmenet, but with the value changed to 0.

FX_Duration.png
Duration effect

Member Function Documentation

override void DirectOutput.FX.TimmedFX.DurationEffect.Finish ( )
virtual

Finishes the DurationEffect.

Reimplemented from DirectOutput.FX.EffectEffectBase.

override void DirectOutput.FX.TimmedFX.DurationEffect.Trigger ( Table.TableElementData  TableElementData)

Triggers the DurationEffect with the given TableElementData.
The duration is started, if the value portion of the TableElementData parameter is !=0. Trigger calls with a TableElement value=0 have no effect.

Parameters
TableElementDataTableElementData for the TableElement which has triggered the effect.

Property Documentation

bool DirectOutput.FX.TimmedFX.DurationEffect.Active
getset

Gets a value indicating whether this DurationEffect is currently active.

true if active; otherwise false.

int DirectOutput.FX.TimmedFX.DurationEffect.DurationMs
getset

Gets or sets the duration for the effect in milliseconds.

The effect duration in milliseconds.

RetriggerBehaviourEnum DirectOutput.FX.TimmedFX.DurationEffect.RetriggerBehaviour
getset

Gets or sets the retrigger behaviour.
The setting defines the behaviour of the effect if it is retriggered while it is still active.
This settings is only relevant, if the effect can be called from more than one table element.

Valid values are Restart (Restarts the duration) or Ignore (keeps the org duration).


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