IPFOperator.h

Functions
virtual bool	Proceed (IObject *pCont, PreciseTimeValue timeStart, PreciseTimeValue &timeEnd, Object *pSystem, INode *pNode, INode *actioNode, IPFIntegrator *integrator)=0
	Returns true if the operation has been proceeded successfully.
PFExport bool	Proceed (IObject *pCont, TimeValue timeStart, TimeValue &timeEnd, Object *pSystem, INode *pNode, INode *actionNode, FPInterface *integrator)
	"function publishing" alternative for the method above
virtual bool	HasPreProceed (IObject *pCont, PreciseTimeValue timeStart, PreciseTimeValue &timeEnd)
	Three methods apply the Proceed method as a pre-procedure before the regular proceed for all operators starts.
virtual void	PreProceedBegin (IObject *pCont, PreciseTimeValue timeStart, PreciseTimeValue &timeEnd)
	See virtual bool HasPreProceed(}.
virtual void	PreProceedEnd (IObject *pCont, PreciseTimeValue timeStart, PreciseTimeValue &timeEnd)
	See virtual bool HasPreProceed(}.
virtual bool	HasPostProceed (IObject *pCont, PreciseTimeValue time)
	Three methods apply the Proceed method as a post procedure when the amount of particles in all particle groups has been established and there won't be any particle transfers from one particle group to another.
virtual void	PostProceedBegin (IObject *pCont, PreciseTimeValue time)
	See virtual bool HasPostProceed(}.
virtual void	PostProceedEnd (IObject *pCont, PreciseTimeValue time)
	See virtual bool HasPostProceed(}.
FPInterfaceDesc *	GetDesc ()

---

Function Documentation

Proceed	(	IObject *	pCont,
		PreciseTimeValue	timeStart,
		PreciseTimeValue &	timeEnd,
		Object *	pSystem,
		INode *	pNode,
		INode *	actioNode,
		IPFIntegrator *	integrator
	)		[pure virtual, inherited]

Search for all occurrences

Returns true if the operation has been proceeded successfully.

methods' signatures are presented in two forms: one is compact, and the other one is for function-publishing where PreciseTimeValue is presented as a pair (int,float).

Parameters:

pCont,:	particleContainer timeStart: the time for particle to start from the simulation. Each particle may have its own current valid time greater than timeStart. In this case the operator should consider the current particle time and timeEnd parameter. Some operators (like Birth) may not consider current particle time since it works with timeStart and timeEnd parameters only.
timeEnd,:	the time for particles to come to; each particle may have its own current valid time; the parameter sets the time for all particles to synchronize to. If current particle time is greater than timeEnd it means that the particle doesn't require processing at all; the particle has been already updated beyond the interval ]timeStart, timeEnd] of the current operator. Sometimes the operator may not be able to proceed all the particles to the given timeEnd. In this case the operator proceeds the particles as far as possible and set the parameter to the time achieved. All the following operators will be given the new timeEnd value as a time value for particles to come to, and the particle system will run another round of operator stack modification in the attempt to proceed all the particles to the initially set time.
pSystem,:	the particle system that generates the particle stream; the same operator may get calls from different particle systems; if the result varies according to the particle system that generates particles, then this parameter is useful.
pNode:INode	of the particle system that generates the particles.
actionNode,:	INode of the operator (if any; can be NULL)
integrator,:	an operator to proceed particles according to "inertia" rules. The operator updates time, speed, position, spin, orientation channels on the basis of time, acceleration, speed, angular acceleration and spin channels. Each particle system has a default inertia operator. When an operator want to update current time for particles, it uses the "inertia" operator. An Action in the ActionList stack my "switch" the suggested "inertia" operator by its own if the Action support the "inertial" operator interface. The particle system recognizes such an Action as a holder of "inertia" interface, and use it for "inertia" purposes later on. If the parameter is NULL then the particle system doesn't allow the operator to advance particles in the time channel.

PFExport bool Proceed	(	IObject *	pCont,
		TimeValue	timeStart,
		TimeValue &	timeEnd,
		Object *	pSystem,
		INode *	pNode,
		INode *	actionNode,
		FPInterface *	integrator
	)		[inherited]

Search for all occurrences

"function publishing" alternative for the method above

bool HasPreProceed	(	IObject *	pCont,
		PreciseTimeValue	timeStart,
		PreciseTimeValue &	timeEnd
	)		[inline, virtual, inherited]

Search for all occurrences

Three methods apply the Proceed method as a pre-procedure before the regular proceed for all operators starts.

It is not recommended to modify particle container. The call is mostly used to give an operator opportunity to snapshot the state of particle container before any operator modifies it. The Proceed method is called in between PretProceedBegin and PreProceedEnd methods if HasPreProceed method returns "true". Those methods are not supported in MaxScript intentionally.

{ return false; }

void PreProceedBegin	(	IObject *	pCont,
		PreciseTimeValue	timeStart,
		PreciseTimeValue &	timeEnd
	)		[inline, virtual, inherited]

Search for all occurrences

See virtual bool HasPreProceed(}.

{ ; }

void PreProceedEnd	(	IObject *	pCont,
		PreciseTimeValue	timeStart,
		PreciseTimeValue &	timeEnd
	)		[inline, virtual, inherited]

Search for all occurrences

See virtual bool HasPreProceed(}.

{ ; }

bool HasPostProceed	(	IObject *	pCont,
		PreciseTimeValue	time
	)		[inline, virtual, inherited]

Search for all occurrences

Three methods apply the Proceed method as a post procedure when the amount of particles in all particle groups has been established and there won't be any particle transfers from one particle group to another.

The Proceed method is called again in between PostProceedBegin and PostProceedEnd methods if HasPostProceed method returns "true". Since the post proceed methods are applied after everything has established, it is applied to a "time" moment, not [timeStart, timeEnt] interval. The Proceed method is called with the same value for timeStart and timeEnd. Those methods are not supported in MaxScript intentionally.

{ return false; }

void PostProceedBegin	(	IObject *	pCont,
		PreciseTimeValue	time
	)		[inline, virtual, inherited]

Search for all occurrences

See virtual bool HasPostProceed(}.

{ ; }

void PostProceedEnd	(	IObject *	pCont,
		PreciseTimeValue	time
	)		[inline, virtual, inherited]

Search for all occurrences

See virtual bool HasPostProceed(}.

{ ; }

FPInterfaceDesc * GetDesc

(

)

[inline, virtual, inherited]

Search for all occurrences

Remarks:

Returns a pointer to the class which contains the interface metadata.

Implements FPInterface.

{ return GetDescByID(PFOPERATOR_INTERFACE); }