iPcMover Struct Reference
This is a mover property class. More...
#include <propclass/mover.h>

Public Member Functions | |
virtual const csVector3 & | GetPosition () const =0 |
Get the end position that we want to move to. | |
virtual iSector * | GetSector () const =0 |
Get the end sector that we want to move to. | |
virtual float | GetSqRadius () const =0 |
Get the current squared radius. | |
virtual const csVector3 & | GetUp () const =0 |
virtual void | Interrupt ()=0 |
Interrupt a movement. | |
virtual bool | IsMoving () const =0 |
Return true if currently moving. | |
virtual bool | MoveTo (iSector *sector, const csVector3 &position, float sqradius, bool checklos=false)=0 |
Move to the specified position. | |
virtual bool | Start (iSector *sector, const csVector3 &position, const csVector3 &up, float sqradius)=0 |
Start moving. |
Detailed Description
This is a mover property class.
It works closely with pclinmove and pcactormove in order to move an object from one position to another while checking collision detection along the way.
This property class can send out the following messages to the behaviour (add prefix 'cel.parameter.' to get the ID for parameters):
- pcmover_impossible: don't even start the move: impossible. This message will have a 'meshname' parameter containing the name of the mesh that was preventing the move.
- pcmover_stuck: can't move further.
- pcmover_arrived: arrived at final position.
- pcmover_interrupted: movement has been interrupted.
This property class supports the following actions (add prefix 'cel.action.' to get the ID of the action and add prefix 'cel.parameter.' to get the ID of the parameter):
- MoveTo: parameters 'sectorname' (string), 'position' (vector3), ,'sqradius' (float) and optional 'checklos' (bool, default false).
- Start: parameters 'sectorname' (string), 'position' (vector3), 'up' (vector3), and 'sqradius' (float). This action is deprecated, you should use MoveTo instead.
- Interrupt: interrupt the current movement.
This property class supports the following properties (add prefix 'cel.property.' to get the ID of the property:
- position (vector3, read only): current end position.
- sqradius (float, read/write): current squared radius.
- moving (bool, read only): returns true if currently moving.
Definition at line 58 of file mover.h.
Member Function Documentation
virtual const csVector3& iPcMover::GetPosition | ( | ) | const [pure virtual] |
Get the end position that we want to move to.
virtual iSector* iPcMover::GetSector | ( | ) | const [pure virtual] |
Get the end sector that we want to move to.
virtual float iPcMover::GetSqRadius | ( | ) | const [pure virtual] |
Get the current squared radius.
virtual const csVector3& iPcMover::GetUp | ( | ) | const [pure virtual] |
- Deprecated:
- Handling of up vector by pcmover is deprecated.
virtual void iPcMover::Interrupt | ( | ) | [pure virtual] |
Interrupt a movement.
The behaviour will get a 'pcmover_interrupted' message if the mover was really moving. Otherwise nothing happens.
virtual bool iPcMover::IsMoving | ( | ) | const [pure virtual] |
Return true if currently moving.
virtual bool iPcMover::MoveTo | ( | iSector * | sector, | |
const csVector3 & | position, | |||
float | sqradius, | |||
bool | checklos = false | |||
) | [pure virtual] |
Move to the specified position.
When you call this function this property class will attempt to move the linmove to the correct position. If it fails the behaviour will get a 'pcmover_stuck' message. Otherwise it will get a 'pcmover_arrived' message. If checklos parameter is true a line of sight test will be made in advance, and if this function detects that line of sight is blocked then the behaviour will get a 'pcmover_impossible' message and this function will return false then. If this property class was already controlling a movement then that movement will be interrupted (possibly giving a pcmover_interrupted message).
- Parameters:
-
sector is the desired sector to move to. position is the desired position to move to. sqradius if the linmove ends up within the given squared radius of the desired position the movement will stop and be considered sucessful. checklos whether to check line of sight to destination on movement start.
virtual bool iPcMover::Start | ( | iSector * | sector, | |
const csVector3 & | position, | |||
const csVector3 & | up, | |||
float | sqradius | |||
) | [pure virtual] |
Start moving.
When you call this function this property class will attempt to move the linmove to the correct position. If it fails the behaviour will get a 'pcmover_stuck' message. Otherwise it will get a 'pcmover_arrived' message. If this function detects that it is completely impossible to move there in advance then the behaviour will get a 'pcmover_impossible' message and this function will return false then. If this property class was already controlling a movement then that movement will be interrupted (possibly giving a pcmover_interrupted message).
- Parameters:
-
sector is the desired sector to move to. position is the desired position to move to. up is the up vector (used for rotation). sqradius if the linmove ends up within the given squared radius of the desired position the movement will stop and be considered sucessful.
- Deprecated:
- Use MoveTo instead.
The documentation for this struct was generated from the following file:
- propclass/mover.h
Generated for CEL: Crystal Entity Layer 1.4.1 by doxygen 1.7.1