Particle-Emitter Animations
[RpPrtAdv]


Data Structures
struct	RpPrtAdvEmtPrtEmt
struct	RpPrtAdvPrtEmitter
Functions
RpPrtStdParticleBatch *	RpPrtAdvPrtEmtUpdateCB (RpPrtStdEmitter emt, RpPrtStdParticleBatch prtBatch, void *data)
RpPrtStdEmitter *	RpPrtAdvEmtPrtEmtEmitCB (RpAtomic atomic, RpPrtStdEmitter emt, void *data)
RpPrtStdEmitter *	RpPrtAdvEmtPrtEmtCloneCB (RpAtomic atomic, RpPrtStdEmitter emt, void *data)
RpPrtStdEmitter *	RpPrtAdvEmtPrtEmtStreamGetSizeCB (RpAtomic atomic, RpPrtStdEmitter emt, void *data)
RpPrtStdEmitter *	RpPrtAdvEmtPrtEmtStreamReadCB (RpAtomic atomic, RpPrtStdEmitter emt, void *data)
RpPrtStdEmitter *	RpPrtAdvEmtPrtEmtStreamWriteCB (RpAtomic atomic, RpPrtStdEmitter emt, void *data)

Function Documentation

RpPrtStdEmitter* RpPrtAdvEmtPrtEmtCloneCB ( RpAtomic * atomic,

RpPrtStdEmitter * emt,

void * data

)

RpPrtAdvEmtPrtEmtCloneCB is the clone callback for the sub-emitter emitter properties.
This callback clones the sub emitter property of the emitter. The sub emitter is not copied and is set NULL for the destination emitter. This is because it maybe unsafe to use the sub-emitter in the source emitter.
This callback should be added after the standard callback.
All other properties of the particles should be handled by the previous emit callback in the list.
Parameters:

atomic Pointer to the parent RpAtomic.

emt Pointer to the source RpPrtStdEmitter.

data Pointer to the destination RpPrtStdEmitter.

Returns:
Pointer to the destination RpPrtStdEmitter if successful, NULL otherwise.
See also:
RpPrtStdAtomicUpdate , RpPrtStdEClassSetCallBack , RpPrtStdEmitterStdBeginUpdateCB , RpPrtStdEClassStdCreate , RpPrtAdvEClassStdCreate , RpPrtStdEmitterStdCreateCB , RpPrtStdEmitterStdDestroyCB , RpPrtStdEmitterStdEndUpdateCB , RpPrtStdEmitterStdRenderCB , RpPrtStdPClassSetCallBack , RpPrtStdPClassStdCreate , RpPrtAdvPClassStdCreate

RpPrtStdEmitter* RpPrtAdvEmtPrtEmtEmitCB ( RpAtomic * atomic,

RpPrtStdEmitter * emt,

void * data

)

RpPrtAdvEmtPrtEmtEmitCB is the emit callback for the sub-emitter emitter properties.
This callback emits new particles using the current emitter. The particle class must contain the sub-emitter property.
This callback should be added after the standard callback.
All other properties of the particles should be handled by the previous emit callback in the list.
Parameters:

atomic Pointer to the parent RpAtomic.

emt Pointer to the RpPrtStdEmitter.

data Void pointer to private data for the emit callback. This callback expects the data to be a pointer to a RwReal representing the delta time elapsed.

Returns:
Pointer to the RpPrtStdEmitter if successful, NULL otherwise.
See also:
RpPrtStdAtomicUpdate , RpPrtStdEClassSetCallBack , RpPrtStdEmitterStdBeginUpdateCB , RpPrtStdEClassStdCreate , RpPrtAdvEClassStdCreate , RpPrtStdEmitterStdCreateCB , RpPrtStdEmitterStdDestroyCB , RpPrtStdEmitterStdEndUpdateCB , RpPrtStdEmitterStdRenderCB , RpPrtStdPClassSetCallBack , RpPrtStdPClassStdCreate , RpPrtAdvPClassStdCreate

RpPrtStdEmitter* RpPrtAdvEmtPrtEmtStreamGetSizeCB ( RpAtomic * atomic,

RpPrtStdEmitter * emt,

void * data

)

RpPrtAdvEmtPrtEmtStreamGetSizeCB is the callback used to determine the size, in bytes, of the binary representation of a sub-emitter emitter. This value is used in the binary chunk header to indicate the size of the chunk.
This callback should be added to a emitter class if the emitter contains the sub-emitter property.
Parameters:

atomic A pointer to the emitter's parent RpAtomic.

emt A pointer to the RpPrtStdEmitter.

data Void pointer to a RwInt32 to return the stream size.

Returns:
Pointer to the RpPrtStdEmitter if successful, NULL otherwise.
See also:
RpPrtStdEClassSetCallBack , RpPrtStdEClassStdCreate , RpPrtStdEmitterStdStreamGetSizeCB , RpPrtStdEmitterStdStreamReadCB , RpPrtStdEmitterStdStreamWriteCB , RpPrtAdvEmtPrtEmtStreamReadCB , RpPrtAdvEmtPrtEmtStreamWriteCB

RpPrtStdEmitter* RpPrtAdvEmtPrtEmtStreamReadCB ( RpAtomic * atomic,

RpPrtStdEmitter * emt,

void * data

)

RpPrtAdvEmtPrtEmtStreamReadCB is the stream in callback for the sub-emitter particle property.
This function streams in an emitter containing the sub-emitter property.
This callback should be added to an emitter class if the emitter contains the sub-emitter emitter property.
Parameters:

atomic A pointer to the emitter's parent RpAtomic.

emt A pointer to the RpPrtStdEmitter to stream into.

data Void pointer to the input stream.

Returns:
Pointer to the RpPrtStdEmitter if successful, NULL otherwise.
See also:
RpPrtStdEClassSetCallBack , RpPrtStdEClassStdCreate , RpPrtStdEmitterStdStreamGetSizeCB , RpPrtStdEmitterStdStreamReadCB , RpPrtStdEmitterStdStreamWriteCB , RpPrtAdvEmtPrtEmtStreamGetSizeCB , RpPrtAdvEmtPrtEmtStreamWriteCB

RpPrtStdEmitter* RpPrtAdvEmtPrtEmtStreamWriteCB ( RpAtomic * atomic,

RpPrtStdEmitter * emt,

void * data

)

RpPrtAdvEmtPrtEmtStreamWriteCB is the stream out callback for the sub-emitter particle property.
This function streams out an emitter containing the sub-emitter property.
This callback should be added to an emitter class if the emitter contains the sub-emitter emitter property.
Parameters:

atomic A pointer to the emitter's parent RpAtomic.

emt A pointer to the RpPrtStdEmitter.

data Void pointer to output stream.

Returns:
Pointer to the RpPrtStdEmitter if successful, NULL otherwise.
See also:
RpPrtStdEClassSetCallBack , RpPrtStdEClassStdCreate , RpPrtStdEmitterStdStreamGetSizeCB , RpPrtStdEmitterStdStreamReadCB , RpPrtStdEmitterStdStreamWriteCB , RpPrtAdvEmtPrtEmtStreamGetSizeCB , RpPrtAdvEmtPrtEmtStreamReadCB

RpPrtStdParticleBatch* RpPrtAdvPrtEmtUpdateCB ( RpPrtStdEmitter * emt,

RpPrtStdParticleBatch * prtBatch,

void * data

)

RpPrtAdvPrtEmtUpdateCB is the update callback for the sub-emitter particle property.
This callback updates the sub-emitter properties in a particle.
This callback should be added to a particle class if the particle contains the particle's sub-emitter property.
The callback must be placed so that it is called before the standard update callback.
Parameters:

emt Pointer to the parent RpPrtStdEmitter.

prtBatch Pointer to the RpPrtStdParticleBatch to be updated.

data Void pointer to private data for the update callback. This callback expects the data to be a pointer to a RwReal representing the delta time elapsed.

Returns:
Pointer to the RpPrtStdParticleBatch if successful, NULL otherwise.
See also:
RpPrtStdAtomicUpdate , RpPrtStdEClassSetCallBack , RpPrtStdEmitterStdBeginUpdateCB , RpPrtStdEClassStdCreate , RpPrtStdEmitterStdCreateCB , RpPrtStdEmitterStdDestroyCB , RpPrtStdEmitterStdEmitCB , RpPrtStdEmitterStdEndUpdateCB , RpPrtStdEmitterStdRenderCB , RpPrtStdPClassSetCallBack , RpPrtStdPClassStdCreate