CrystalSpace

Public API Reference

Main Page   Modules   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members   Related Pages  

iSequenceWrapper Struct Reference

A sequence wrapper. More...

#include <engseq.h>

Inheritance diagram for iSequenceWrapper:

iBase List of all members.

Public Methods

virtual iObjectQueryObject ()=0
 Query object. More...

virtual iSequenceGetSequence ()=0
 Get the sequence. More...

virtual iEngineSequenceParametersCreateBaseParameterBlock ()=0
 Create a parameter block for this sequence wrapper. More...

virtual iEngineSequenceParametersGetBaseParameterBlock ()=0
 Get the pointer to the base parameter block (or 0 if there is no such block). More...

virtual csPtr< iEngineSequenceParametersCreateParameterBlock ()=0
 Create a parameter block which you can then fill in and then give as a parameter running this sequence. More...

virtual void AddOperationSetVariable (csTicks time, iSharedVariable *var, float value, float dvalue=0)=0
 Operation: set a variable to a floating point value. More...

virtual void AddOperationSetVariable (csTicks time, iSharedVariable *var, iSharedVariable *value, iSharedVariable *dvalue=0)=0
 Operation: set a variable to the contents of another variable. More...

virtual void AddOperationSetVariable (csTicks time, iSharedVariable *var, const csVector3 &v)=0
 Operation: set a variable to a vector. More...

virtual void AddOperationSetVariable (csTicks time, iSharedVariable *var, const csColor &c)=0
 Operation: set a variable to a color. More...

virtual void AddOperationSetMaterial (csTicks time, iParameterESM *mesh, iParameterESM *mat)=0
 Operation: set a material on a mesh. More...

virtual void AddOperationSetPolygonMaterial (csTicks time, iParameterESM *polygon, iParameterESM *mat)=0
 Operation: set a material on a polygon. More...

virtual void AddOperationSetLight (csTicks time, iParameterESM *light, const csColor &color)=0
 Operation: set a light color. More...

virtual void AddOperationFadeLight (csTicks time, iParameterESM *light, const csColor &color, csTicks duration)=0
 Operation: fade a light to some color during some time. More...

virtual void AddOperationSetAmbient (csTicks time, iParameterESM *light, const csColor &color, iSharedVariable *colorvar)=0
 Operation: set dynamic ambient light color. More...

virtual void AddOperationFadeAmbient (csTicks time, iParameterESM *light, const csColor &color, csTicks duration)=0
 Operation: fade dynamic ambient light to some color during some time. More...

virtual void AddOperationRandomDelay (csTicks time, int min, int max)=0
 Operation: Delay executation of the rest of the script by a random time between min and max msec. More...

virtual void AddOperationSetMeshColor (csTicks time, iParameterESM *mesh, const csColor &color)=0
 Operation: set a mesh color. More...

virtual void AddOperationFadeMeshColor (csTicks time, iParameterESM *mesh, const csColor &color, csTicks duration)=0
 Operation: fade a mesh to some color during some time. More...

virtual void AddOperationSetFog (csTicks time, iParameterESM *sector, const csColor &color, float density)=0
 Operation: set a fog color and density. More...

virtual void AddOperationFadeFog (csTicks time, iParameterESM *sector, const csColor &color, float density, csTicks duration)=0
 Operation: fade fog to some color/density during some time. More...

virtual void AddOperationRotateDuration (csTicks time, iParameterESM *mesh, int axis1, float tot_angle1, int axis2, float tot_angle2, int axis3, float tot_angle3, const csVector3 &offset, csTicks duration)=0
 Operation: rotate object during some time. More...

virtual void AddOperationMoveDuration (csTicks time, iParameterESM *mesh, const csVector3 &offset, csTicks duration)=0
 Operation: move object (mesh or light) during some time. More...

virtual void AddOperationTriggerState (csTicks time, iParameterESM *trigger, bool en)=0
 Operation: enable/disable a given trigger. More...

virtual void AddOperationCheckTrigger (csTicks time, iParameterESM *trigger, csTicks delay)=0
 Operation: enable checking of trigger state every 'delay' milliseconds (or disable with delay == 0). More...

virtual void AddOperationTestTrigger (csTicks time, iParameterESM *trigger, iSequence *trueSequence, iSequence *falseSequence)=0
 Operation: test trigger state and run a sequence if trigger is still valid or another sequence if not (both sequences can be 0 in which case nothing is run). More...


Detailed Description

A sequence wrapper.

This objects holds the reference to the original sequence and also implements iObject. Basically a sequence corresponds to a series of operations that are time based and can be scheduled on the sequence manager. This class enhances iSequence with support for custom operations and parameter blocks.

Note that many parameters given to the AddOperation functions are of type iParameterESM.

Definition at line 159 of file engseq.h.


Member Function Documentation

virtual void iSequenceWrapper::AddOperationCheckTrigger csTicks    time,
iParameterESM   trigger,
csTicks    delay
[pure virtual]
 

Operation: enable checking of trigger state every 'delay' milliseconds (or disable with delay == 0).

Use this in combination with AddOperationTestTrigger().

virtual void iSequenceWrapper::AddOperationFadeAmbient csTicks    time,
iParameterESM   light,
const csColor   color,
csTicks    duration
[pure virtual]
 

Operation: fade dynamic ambient light to some color during some time.

virtual void iSequenceWrapper::AddOperationFadeFog csTicks    time,
iParameterESM   sector,
const csColor   color,
float    density,
csTicks    duration
[pure virtual]
 

Operation: fade fog to some color/density during some time.

virtual void iSequenceWrapper::AddOperationFadeLight csTicks    time,
iParameterESM   light,
const csColor   color,
csTicks    duration
[pure virtual]
 

Operation: fade a light to some color during some time.

virtual void iSequenceWrapper::AddOperationFadeMeshColor csTicks    time,
iParameterESM   mesh,
const csColor   color,
csTicks    duration
[pure virtual]
 

Operation: fade a mesh to some color during some time.

virtual void iSequenceWrapper::AddOperationMoveDuration csTicks    time,
iParameterESM   mesh,
const csVector3   offset,
csTicks    duration
[pure virtual]
 

Operation: move object (mesh or light) during some time.

After the time has elapsed the total relative move will be equal to the 'offset'.

virtual void iSequenceWrapper::AddOperationRandomDelay csTicks    time,
int    min,
int    max
[pure virtual]
 

Operation: Delay executation of the rest of the script by a random time between min and max msec.

virtual void iSequenceWrapper::AddOperationRotateDuration csTicks    time,
iParameterESM   mesh,
int    axis1,
float    tot_angle1,
int    axis2,
float    tot_angle2,
int    axis3,
float    tot_angle3,
const csVector3   offset,
csTicks    duration
[pure virtual]
 

Operation: rotate object during some time.

After the time has elapsed the rotation will be equal to the given angle here. Axis is 0, 1, or 2 for x, y, or z. If axis is -1 it is not used.

virtual void iSequenceWrapper::AddOperationSetAmbient csTicks    time,
iParameterESM   light,
const csColor   color,
iSharedVariable   colorvar
[pure virtual]
 

Operation: set dynamic ambient light color.

virtual void iSequenceWrapper::AddOperationSetFog csTicks    time,
iParameterESM   sector,
const csColor   color,
float    density
[pure virtual]
 

Operation: set a fog color and density.

virtual void iSequenceWrapper::AddOperationSetLight csTicks    time,
iParameterESM   light,
const csColor   color
[pure virtual]
 

Operation: set a light color.

virtual void iSequenceWrapper::AddOperationSetMaterial csTicks    time,
iParameterESM   mesh,
iParameterESM   mat
[pure virtual]
 

Operation: set a material on a mesh.

virtual void iSequenceWrapper::AddOperationSetMeshColor csTicks    time,
iParameterESM   mesh,
const csColor   color
[pure virtual]
 

Operation: set a mesh color.

virtual void iSequenceWrapper::AddOperationSetPolygonMaterial csTicks    time,
iParameterESM   polygon,
iParameterESM   mat
[pure virtual]
 

Operation: set a material on a polygon.

virtual void iSequenceWrapper::AddOperationSetVariable csTicks    time,
iSharedVariable   var,
const csColor   c
[pure virtual]
 

Operation: set a variable to a color.

virtual void iSequenceWrapper::AddOperationSetVariable csTicks    time,
iSharedVariable   var,
const csVector3   v
[pure virtual]
 

Operation: set a variable to a vector.

virtual void iSequenceWrapper::AddOperationSetVariable csTicks    time,
iSharedVariable   var,
iSharedVariable   value,
iSharedVariable   dvalue = 0
[pure virtual]
 

Operation: set a variable to the contents of another variable.

If 'dvalue' is not 0 then that will be used instead of the absolute value. In that case 'dvalue' is added. 'dvalue' has to be a floating point variable for that to work. 'value' can be any type. The type of 'var' will be set to the type of 'value' in that case.

virtual void iSequenceWrapper::AddOperationSetVariable csTicks    time,
iSharedVariable   var,
float    value,
float    dvalue = 0
[pure virtual]
 

Operation: set a variable to a floating point value.

If 'dvalue' is not 0 then that will be used instead of the absolute value. In that case 'dvalue' is added.

virtual void iSequenceWrapper::AddOperationTestTrigger csTicks    time,
iParameterESM   trigger,
iSequence   trueSequence,
iSequence   falseSequence
[pure virtual]
 

Operation: test trigger state and run a sequence if trigger is still valid or another sequence if not (both sequences can be 0 in which case nothing is run).

Use in combination with AddOperationCheckTrigger().

virtual void iSequenceWrapper::AddOperationTriggerState csTicks    time,
iParameterESM   trigger,
bool    en
[pure virtual]
 

Operation: enable/disable a given trigger.

virtual iEngineSequenceParameters* iSequenceWrapper::CreateBaseParameterBlock   [pure virtual]
 

Create a parameter block for this sequence wrapper.

After creating this you can initialized the parameters (with names and optional default values). Later on you can use GetSequenceParameters() to get a copy of a parameter block to use for running a sequence.

virtual csPtr<iEngineSequenceParameters> iSequenceWrapper::CreateParameterBlock   [pure virtual]
 

Create a parameter block which you can then fill in and then give as a parameter running this sequence.

This essentially creates a copy of the base parameter block created with CreateBaseParameterBlock(). Modifications on the parameter block returned by this function have no effect on the parameter block which is kept internally. You should only set the values of the given parameter block and not create/remove variables. This function returns 0 if there is no parameter block for this sequence.

virtual iEngineSequenceParameters* iSequenceWrapper::GetBaseParameterBlock   [pure virtual]
 

Get the pointer to the base parameter block (or 0 if there is no such block).

virtual iSequence* iSequenceWrapper::GetSequence   [pure virtual]
 

Get the sequence.

It is allowed to use the underlying sequence for general sequence operations like adding conditions, operations, and general sequence management. The AddOperationBla() functions provided in this wrapper do nothing more than add custom operations through the regular iSequence->AddOperation().

virtual iObject* iSequenceWrapper::QueryObject   [pure virtual]
 

Query object.


The documentation for this struct was generated from the following file:
Generated for Crystal Space by doxygen 1.2.14