This is the base class for all operations in action scripts. More...

#include <npcoperations.h>

Public Types
enum	OperationResult { OPERATION_NOT_COMPLETED, OPERATION_COMPLETED, OPERATION_FAILED }
enum	State { READY_TO_RUN, RUNNING, INTERRUPTED, COMPLETED }
enum	VelSource { VEL_DEFAULT, VEL_USER, VEL_WALK, VEL_RUN }
Public Member Functions
void	AddRandomRange (csVector3 &dest, float radius, float margin=0.0)
	Move a point somwhere random within radius of the orignial point.
virtual OperationResult	Advance (float timedelta, NPC *npc)
virtual bool	AtInterruptedAngle (const csVector3 &pos, const iSector *sector, float angle)
virtual bool	AtInterruptedAngle (NPC *npc)
virtual bool	AtInterruptedPosition (NPC *npc)
virtual bool	AtInterruptedPosition (const csVector3 &pos, const iSector *sector)
virtual bool	CheckEndPointOk (NPC npc, const csVector3 &myPos, iSector mySector, const csVector3 &endPos, iSector *endSector)
	Check if the end point where ok.
virtual bool	CheckMoveOk (NPC npc, csVector3 oldPos, iSector oldSector, const csVector3 &newPos, iSector *newSector, int resultFromExtrapolate)
	Check if the move where ok.
void	CopyCheckMoveOk (ScriptOperation *source)
	Copy CheckMoveOk paramters from the source script.
virtual void	Failure (NPC *npc)
	Called when the run operation return OPERATION_FAILED.
virtual float	GetAngularVelocity (NPC *npc)
virtual const csString &	GetCollisionPerception (NPC *npc)
	Return the Collision perception event name.
virtual const csString &	GetFallingPerception (NPC *npc)
	Return the Falling perception event name.
virtual const csString &	GetInBoundsPerception (NPC *npc)
	Return the In Bounds perception event name.
virtual const char *	GetName () const
virtual const csString &	GetOutOfBoundsPerception (NPC *npc)
	Return the Out of Bounds perception event name.
virtual State	GetState () const
virtual float	GetVelocity (NPC *npc)
	Return the velocity for the npc.
virtual void	InterruptOperation (NPC *npc)
virtual bool	Load (iDocumentNode *node)
bool	LoadCheckMoveOk (iDocumentNode *node)
	Load attributes for the CheckMoveOk check.
bool	LoadVelocity (iDocumentNode *node)
virtual ScriptOperation *	MakeCopy ()=0
virtual OperationResult	Run (NPC *npc, bool interrupted)=0
	ScriptOperation (const ScriptOperation *other)
	ScriptOperation (const char *sciptName)
void	SetAnimation (NPC npc, const char name)
	This function will set an animation for the NPC, the animation will play once.
void	SetParent (Behavior *behavior)
	Set the parent behavior for this operation.
virtual void	SetState (State state)
virtual	~ScriptOperation ()
Protected Member Functions
int	StartMoveTo (NPC npc, const csVector3 &dest, iSector sector, float vel, const char *action, float &angle)
	This function is used by MoveTo AND Navigate operations.
void	TurnTo (NPC npc, const csVector3 &dest, iSector destsect, csVector3 &forward, float &angle)
Static Protected Member Functions
static void	StopMovement (NPC *npc)
	Utility function used by many operation to stop movement of an NPC.
Protected Attributes
float	ang_vel
	Shared angular velocity, used by all that rotates.
bool	checkTribeHome
	Set to true if the tribe home should be checked by CheckMoveOk.
csString	collision
	Perception names to use for collision detected by CheckMoveOk.
int	consecCollisions
	Shared by move functions. Used by CheckMoveOk to detect collisions.
csString	failurePerception
	The Perception to fire when a operation return OPERATION_FAILED.
csString	falling
	Perception names to use for fall detected by CheckMoveOk.
csString	inBounds
	Perception names to use for in bounds detected by CheckMoveOk.
float	interrupted_angle
csVector3	interrupted_position
iSector *	interrupted_sector
csString	name
csString	outOfBounds
	Perception names to use for out of bounds detected by CheckMoveOk.
Behavior *	parent
State	state
float	vel
	Shared linear velocity, used by all that moves.
VelSource	velSource
	Source used for velocity.

Detailed Description

This is the base class for all operations in action scripts.

We will use these to set animation actions, move and rotate the mob, attack and so forth. These should be mostly visual or physical things, except for the ability to create new perceptions, which can kick off other actions.

Definition at line 69 of file npcoperations.h.

Member Enumeration Documentation

enum ScriptOperation::OperationResult

Enumerator:

OPERATION_NOT_COMPLETED	Used to indicate that an operation will complete at a later stage.
OPERATION_COMPLETED	All parts of this operation has been completed.
OPERATION_FAILED	The operation failed.

Definition at line 81 of file npcoperations.h.

enum ScriptOperation::State

Enumerator:

READY_TO_RUN
RUNNING
INTERRUPTED
COMPLETED

Definition at line 88 of file npcoperations.h.

enum ScriptOperation::VelSource

Enumerator:

VEL_DEFAULT
VEL_USER
VEL_WALK
VEL_RUN

Definition at line 72 of file npcoperations.h.

Constructor & Destructor Documentation

ScriptOperation::ScriptOperation ( const char * sciptName )

ScriptOperation::ScriptOperation ( const ScriptOperation * other )

virtual ScriptOperation::~ScriptOperation ( ) [inline, virtual]

Definition at line 149 of file npcoperations.h.

Member Function Documentation

void ScriptOperation::AddRandomRange	(	csVector3 &	dest,
		float	radius,
		float	margin = `0.0`
	)

Move a point somwhere random within radius of the orignial point.

Will add a random part to the dest. The margin can be used to prevent using the margin around the edge of the circle.

Parameters:

dest	The center position of the cicle. Will return with the new position.
radius	The radius of the circle.
margin	A margin around the circle that will not be used.

virtual OperationResult ScriptOperation::Advance	(	float	timedelta,
		NPC *	npc
	)		`[virtual]`

Reimplemented in MovementOperation, MoveOperation, MeleeOperation, MovePathOperation, RotateOperation, SitOperation, WaitOperation, WanderOperation, and WatchOperation.

virtual bool ScriptOperation::AtInterruptedAngle	(	const csVector3 &	pos,
		const iSector *	sector,
		float	angle
	)		`[virtual]`

virtual bool ScriptOperation::AtInterruptedAngle ( NPC * npc ) [virtual]

virtual bool ScriptOperation::AtInterruptedPosition ( NPC * npc ) [virtual]

virtual bool ScriptOperation::AtInterruptedPosition	(	const csVector3 &	pos,
		const iSector *	sector
	)		`[virtual]`

virtual bool ScriptOperation::CheckEndPointOk	(	NPC *	npc,
		const csVector3 &	myPos,
		iSector *	mySector,
		const csVector3 &	endPos,
		iSector *	endSector
	)		`[virtual]`

Check if the end point where ok.

Check if a move operation has collided and not ended in right position. Fire perceptions if not at end position.

virtual bool ScriptOperation::CheckMoveOk	(	NPC *	npc,
		csVector3	oldPos,
		iSector *	oldSector,
		const csVector3 &	newPos,
		iSector *	newSector,
		int	resultFromExtrapolate
	)		`[virtual]`

Check if the move where ok.

Check if a move operation has collided, walked out of bounds, or walked in bound. Will fire perceptions at these events with the names given by

See also:: LoadCheckMoveOk

void ScriptOperation::CopyCheckMoveOk ( ScriptOperation * source )

Copy CheckMoveOk paramters from the source script.

Parameters:

source The script to copy from.

virtual void ScriptOperation::Failure ( NPC * npc ) [virtual]

Called when the run operation return OPERATION_FAILED.

Default implementation will percept with the failure perception

virtual float ScriptOperation::GetAngularVelocity ( NPC * npc ) [virtual]

virtual const csString& ScriptOperation::GetCollisionPerception ( NPC * npc ) [virtual]

Return the Collision perception event name.

Will use the perception of the operation if defined, or it will check if a global perception event name is defined for the brain.

virtual const csString& ScriptOperation::GetFallingPerception ( NPC * npc ) [virtual]

Return the Falling perception event name.

Will use the falling perception of the operation if defined, or it will check if a global fall perception event name is defined for the brain.

virtual const csString& ScriptOperation::GetInBoundsPerception ( NPC * npc ) [virtual]

Return the In Bounds perception event name.

Will use the perception of the operation if defined, or it will check if a global perception event name is defined for the brain.

virtual const char* ScriptOperation::GetName ( ) const [inline, virtual]

Definition at line 271 of file npcoperations.h.

virtual const csString& ScriptOperation::GetOutOfBoundsPerception ( NPC * npc ) [virtual]

Return the Out of Bounds perception event name.

Will use the perception of the operation if defined, or it will check if a global perception event name is defined for the brain.

virtual State ScriptOperation::GetState ( ) const [inline, virtual]

Definition at line 164 of file npcoperations.h.

virtual float ScriptOperation::GetVelocity ( NPC * npc ) [virtual]

Return the velocity for the npc.

Determined by the script this could be the walk, run, or a defined velocity.

Reimplemented in ChaseOperation.

virtual void ScriptOperation::InterruptOperation ( NPC * npc ) [virtual]

Reimplemented in MovementOperation, MoveOperation, MeleeOperation, MovePathOperation, RotateOperation, WanderOperation, and WatchOperation.

virtual bool ScriptOperation::Load ( iDocumentNode * node ) [virtual]

Reimplemented in MovementOperation, AssessOperation, BuildOperation, UnbuildOperation, BusyOperation, CastOperation, ChangeBrainOperation, ChaseOperation, CopyLocateOperation, DeleteNPCOperation, MoveOperation, AutoMemorizeOperation, CircleOperation, ControlOperation, DebugOperation, DequipOperation, WorkOperation, DropOperation, EatOperation, EmoteOperation, EquipOperation, HateListOperation, InvisibleOperation, LocateOperation, LoopBeginOperation, LoopEndOperation, MeleeOperation, MemorizeOperation, MovePathOperation, MoveToOperation, NavigateOperation, NOPOperation, PerceptOperation, PickupOperation, ReproduceOperation, ResurrectOperation, RewardOperation, RotateOperation, VelSourceOperation, ProgressScriptOperation, SequenceOperation, SetBufferOperation, ShareMemoriesOperation, SitOperation, TalkOperation, TeleportOperation, TransferOperation, TribeHomeOperation, TribeTypeOperation, VisibleOperation, WaitOperation, WanderOperation, WatchOperation, and LootOperation.

bool ScriptOperation::LoadCheckMoveOk ( iDocumentNode * node )

Load attributes for the CheckMoveOk check.

Parameters:

node	The node to load attributes from.

bool ScriptOperation::LoadVelocity ( iDocumentNode * node )

virtual ScriptOperation* ScriptOperation::MakeCopy ( ) [pure virtual]

Implemented in AssessOperation, BuildOperation, UnbuildOperation, BusyOperation, CastOperation, ChangeBrainOperation, ChaseOperation, CopyLocateOperation, DeleteNPCOperation, MoveOperation, AutoMemorizeOperation, CircleOperation, ControlOperation, DebugOperation, DequipOperation, WorkOperation, DropOperation, EatOperation, EmoteOperation, EquipOperation, HateListOperation, InvisibleOperation, LocateOperation, LoopBeginOperation, LoopEndOperation, MeleeOperation, MemorizeOperation, MovePathOperation, MoveToOperation, NavigateOperation, NOPOperation, PerceptOperation, PickupOperation, ReproduceOperation, ResurrectOperation, RewardOperation, RotateOperation, VelSourceOperation, ProgressScriptOperation, SequenceOperation, SetBufferOperation, ShareMemoriesOperation, SitOperation, TalkOperation, TeleportOperation, TransferOperation, TribeHomeOperation, TribeTypeOperation, VisibleOperation, WaitOperation, WanderOperation, WatchOperation, and LootOperation.

virtual OperationResult ScriptOperation::Run	(	NPC *	npc,
		bool	interrupted
	)		`[pure virtual]`

Implemented in MovementOperation, AssessOperation, BuildOperation, UnbuildOperation, BusyOperation, CastOperation, ChangeBrainOperation, CopyLocateOperation, DeleteNPCOperation, MoveOperation, AutoMemorizeOperation, CircleOperation, ControlOperation, DebugOperation, DequipOperation, WorkOperation, DropOperation, EatOperation, EmoteOperation, EquipOperation, HateListOperation, InvisibleOperation, LocateOperation, LoopBeginOperation, LoopEndOperation, MeleeOperation, MemorizeOperation, MovePathOperation, NOPOperation, PerceptOperation, PickupOperation, ReproduceOperation, ResurrectOperation, RewardOperation, RotateOperation, VelSourceOperation, ProgressScriptOperation, SequenceOperation, SetBufferOperation, ShareMemoriesOperation, SitOperation, TalkOperation, TeleportOperation, TransferOperation, TribeHomeOperation, TribeTypeOperation, VisibleOperation, WaitOperation, WanderOperation, WatchOperation, and LootOperation.

void ScriptOperation::SetAnimation	(	NPC *	npc,
		const char *	name
	)

This function will set an animation for the NPC, the animation will play once.

void ScriptOperation::SetParent ( Behavior * behavior )

Set the parent behavior for this operation.

virtual void ScriptOperation::SetState ( State state ) [inline, virtual]

Definition at line 160 of file npcoperations.h.

int ScriptOperation::StartMoveTo	(	NPC *	npc,
		const csVector3 &	dest,
		iSector *	sector,
		float	vel,
		const char *	action,
		float &	angle
	)		`[protected]`

This function is used by MoveTo AND Navigate operations.

static void ScriptOperation::StopMovement ( NPC * npc ) [static, protected]

Utility function used by many operation to stop movement of an NPC.

void ScriptOperation::TurnTo	(	NPC *	npc,
		const csVector3 &	dest,
		iSector *	destsect,
		csVector3 &	forward,
		float &	angle
	)		`[protected]`

Member Data Documentation

float ScriptOperation::ang_vel [protected]

Shared angular velocity, used by all that rotates.

Definition at line 122 of file npcoperations.h.

bool ScriptOperation::checkTribeHome [protected]

Set to true if the tribe home should be checked by CheckMoveOk.

Definition at line 130 of file npcoperations.h.

csString ScriptOperation::collision [protected]

Perception names to use for collision detected by CheckMoveOk.

Definition at line 126 of file npcoperations.h.

int ScriptOperation::consecCollisions [protected]

Shared by move functions. Used by CheckMoveOk to detect collisions.

Definition at line 105 of file npcoperations.h.

csString ScriptOperation::failurePerception [protected]

The Perception to fire when a operation return OPERATION_FAILED.

Definition at line 117 of file npcoperations.h.

csString ScriptOperation::falling [protected]

Perception names to use for fall detected by CheckMoveOk.

Definition at line 129 of file npcoperations.h.

csString ScriptOperation::inBounds [protected]

Perception names to use for in bounds detected by CheckMoveOk.

Definition at line 128 of file npcoperations.h.

float ScriptOperation::interrupted_angle [protected]

Definition at line 103 of file npcoperations.h.

csVector3 ScriptOperation::interrupted_position [protected]

Definition at line 101 of file npcoperations.h.

iSector* ScriptOperation::interrupted_sector [protected]

Definition at line 102 of file npcoperations.h.

csString ScriptOperation::name [protected]

Definition at line 99 of file npcoperations.h.

csString ScriptOperation::outOfBounds [protected]

Perception names to use for out of bounds detected by CheckMoveOk.

Definition at line 127 of file npcoperations.h.

Behavior* ScriptOperation::parent [protected]

Definition at line 107 of file npcoperations.h.

State ScriptOperation::state [protected]

Definition at line 109 of file npcoperations.h.

float ScriptOperation::vel [protected]

Shared linear velocity, used by all that moves.

Definition at line 121 of file npcoperations.h.

VelSource ScriptOperation::velSource [protected]

Source used for velocity.

Definition at line 120 of file npcoperations.h.

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

npcclient/npcoperations.h

ScriptOperation Class ReferenceScript_operations

Public Types

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

ScriptOperation Class Reference
Script_operations