NLPACS::UMoveContainer Class Reference

#include <u_move_container.h>

Inheritance diagram for NLPACS::UMoveContainer:

---

Detailed Description

A container for movable objects Some constraints: * The move bounding box must be lower than the cell size

Author:

Cyril 'Hulud' Corvazier

Nevrax France

Date:

2001

Definition at line 60 of file u_move_container.h.

Public Member Functions
Manage primitives.
virtual UMovePrimitive *	addCollisionablePrimitive (uint8 firstWorldImage, uint8 numWorldImage, const UMovePrimitive *copyFrom=NULL)=0
virtual void	addCollisionnablePrimitiveBlock (UPrimitiveBlock *pb, uint8 firstWorldImage, uint8 numWorldImage, std::vector< UMovePrimitive * > *primitives, float orientation, const NLMISC::CVector &position, bool dontSnapToGround=false, const NLMISC::CVector &scale=NLMISC::CVector(1.0f, 1.0f, 1.0f))=0
virtual UMovePrimitive *	addNonCollisionablePrimitive (const UMovePrimitive *copyFrom=NULL)=0
virtual void	getPrimitives (std::vector< const UMovePrimitive * > &dest) const=0
	Get all the primitives in the container.
virtual bool	loadCollisionablePrimitiveBlock (const char *filename, uint8 firstWorldImage, uint8 numWorldImage, std::vector< UMovePrimitive * > *primitives, float orientation, const NLMISC::CVector &position, bool dontSnapToGround=false)=0
virtual void	removePrimitive (UMovePrimitive *primitive)=0
World image management.
virtual void	duplicateWorldImage (uint8 source, uint8 dest)=0
virtual void	setAsStatic (uint8 worldImage)=0
Primitive evaluation.
virtual void	evalCollision (double deltaTime, uint8 worldImage)=0
virtual bool	evalNCPrimitiveCollision (double deltaTime, UMovePrimitive *primitive, uint8 worldImage)=0
virtual bool	testMove (UMovePrimitive *primitive, const NLMISC::CVectorD &speed, double deltaTime, uint8 worldImage, NLMISC::CVectorD *contactNormal)=0
Triggers info.
virtual uint	getNumTriggerInfo () const=0
	Get number of trigger informations.
virtual const UTriggerInfo &	getTriggerInfo (uint id) const=0
	Get the n-th trigger informations.

---

Member Function Documentation

virtual UMovePrimitive* NLPACS::UMoveContainer::addCollisionablePrimitive (  uint8  firstWorldImage, uint8  numWorldImage, const UMovePrimitive *  copyFrom = NULL )  [pure virtual]

Add a collisionable primitive in the container. Return the pointer on the primitive. This primitive will generate collisions when the system evaluate other primitives against. You must specify the ids of each world image where the primitive can be inserted. Thoses ids are consecutives. If you choose 5 as first id and 3 as id count, this primitive could be inserted in the world image #5, #6 and #7. This primtive should be inserted in a world image before use. See UMovePrimitive::insertInWorldImage. Parameters: firstWorldImage  is the first world image where the primitive can be inserted. numWorldImage  is the count of world image where the primitive can be inserted. Returns: a pointer on the new primitive. Implemented in NLPACS::CMoveContainer.

virtual void NLPACS::UMoveContainer::addCollisionnablePrimitiveBlock (  UPrimitiveBlock *  pb, uint8  firstWorldImage, uint8  numWorldImage, std::vector< UMovePrimitive * > *  primitives, float  orientation, const NLMISC::CVector &  position, bool  dontSnapToGround = false, const NLMISC::CVector &  scale = NLMISC::CVector(1.0f, 1.0f, 1.0f) )  [pure virtual]

The same as loadCollisionablePrimitiveBlock, but the primitive block is provided by the caller Implemented in NLPACS::CMoveContainer.

virtual UMovePrimitive* NLPACS::UMoveContainer::addNonCollisionablePrimitive (  const UMovePrimitive *  copyFrom = NULL  )  [pure virtual]

Add a noncollisionable primitive in the container. Return the pointer on the primitive. This primitive won't generate collisions when the system evaluate other primitives against. This primitive can't be inserted in a world image. Parameters: copyFrom  is an optional primitive to copy attributes from (so the primitive is initialised with same values) Returns: a pointer on the new primitive. Implemented in NLPACS::CMoveContainer.

UMoveContainer* NLPACS::UMoveContainer::createMoveContainer (  UGlobalRetriever *  retriever, uint  widthCellCount, uint  heightCellCount, double  primitiveMaxSize, uint8  numWorldImage = 1, uint  maxIteration = 100, uint  otSize = 100 )  [static]

UMoveContainer* NLPACS::UMoveContainer::createMoveContainer (  double  xmin, double  ymin, double  xmax, double  ymax, uint  widthCellCount, uint  heightCellCount, double  primitiveMaxSize, uint8  numWorldImage = 1, uint  maxIteration = 100, uint  otSize = 100 )  [static]

void NLPACS::UMoveContainer::deleteMoveContainer (  UMoveContainer *  container  )  [static]

virtual void NLPACS::UMoveContainer::duplicateWorldImage (  uint8  source, uint8  dest )  [pure virtual]

Duplicate a world image in another. All primitive will be removed from the destination world image. Then, the source world image will be copied in the destination world image. Warning, only primitives from the source that have been decalared as using the destintation world image will be copied. The source world image remain the same. Parameters: source  is the id of the source world image for the copy. dest  is the id of the destination world image for the copy. Implemented in NLPACS::CMoveContainer.

virtual void NLPACS::UMoveContainer::evalCollision (  double  deltaTime, uint8  worldImage )  [pure virtual]

Evaluation of a worldImage of the collision system. This method will evaluate the move of each modified collisionable primitives inserted in the world image. The method test first collisions against the terrai, then test collisions against primitives inserted in the world images declared as static, then test the collision against the primitives inserted in the world image to evaluate. Parameters: deltaTime  is the delta time of the system evaluation. worldImage  is the world image to eval. Implemented in NLPACS::CMoveContainer.

virtual bool NLPACS::UMoveContainer::evalNCPrimitiveCollision (  double  deltaTime, UMovePrimitive *  primitive, uint8  worldImage )  [pure virtual]

Evaluation of a single non collisionable primitive. The method test first collisions against the terrai, then test collisions against primitives inserted in the world images declared as static, then test the collision against the primitives inserted in the world image to evaluate. Parameters: deltaTime  is the delta time of the system evaluation. primitive  is the prmitive pointer worldImage  is the world image to eval. Returns: false if the primitive is a collisionable primitive. Implemented in NLPACS::CMoveContainer.

virtual uint NLPACS::UMoveContainer::getNumTriggerInfo (   )  const [pure virtual]

Get number of trigger informations. Implemented in NLPACS::CMoveContainer.

void NLPACS::UMoveContainer::getPACSCoordsFromMatrix (  NLMISC::CVector &  pos, float &  angle, const NLMISC::CMatrix &  mat )  [static]

Get a pacs position and an orientation from a matrix

virtual void NLPACS::UMoveContainer::getPrimitives (  std::vector< const UMovePrimitive * > &  dest  )  const [pure virtual]

Get all the primitives in the container. Implemented in NLPACS::CMoveContainer.

virtual const UTriggerInfo& NLPACS::UMoveContainer::getTriggerInfo (  uint  id  )  const [pure virtual]

Get the n-th trigger informations. Implemented in NLPACS::CMoveContainer.

virtual bool NLPACS::UMoveContainer::loadCollisionablePrimitiveBlock (  const char *  filename, uint8  firstWorldImage, uint8  numWorldImage, std::vector< UMovePrimitive * > *  primitives, float  orientation, const NLMISC::CVector &  position, bool  dontSnapToGround = false )  [pure virtual]

Load a PACS primitive block. (*.pacs_prim) Add a set of collisionable primitive in the container. If sucess, fill an array with primitives's pointers. The primitive are inserted in the requested world image of the container. Then a setGlobalPosition is done to place the primitives in the world image. The world images are not evaluated. You must specify the ids of each world image where the primitives can be inserted. Thoses ids are consecutives. If you choose 5 as first id and 3 as id count, those primitives could be inserted in the world image #5, #6 and #7. Those primtives should be inserted in a world image before use. See UMovePrimitive::insertInWorldImage. Return false if the world image numbers are not present in the move container. Can raise unhandled NLMISC::Exception if trouble during serialisation. Parameters: filename  is the file to load. firstWorldImage  is the first world image where the primitive can be inserted. numWorldImage  is the count of world image where the primitive can be inserted. primitives  is a pointer on an array of primitive pointer to fill if success. If NULL, Do return nothing. orientation  is the orientation to give to the primitives. position  is the position to give to the primitives. primitives  is a pointer on an array of primitive pointer to fill if success. If NULL, Do return nothing. dontSnapToGround  force the inserted primitive to be flagged as 'DontSnapToGround' See also: addCollisionablePrimitive getPACSCoordsFromMatrix Returns: true if the file is successfully loaded, else return false. Implemented in NLPACS::CMoveContainer.

virtual void NLPACS::UMoveContainer::removePrimitive (  UMovePrimitive *  primitive  )  [pure virtual]

Remove a primitive from the container. Parameters: primitive  is the pointer on the primitive to remove. Implemented in NLPACS::CMoveContainer.

virtual void NLPACS::UMoveContainer::setAsStatic (  uint8  worldImage  )  [pure virtual]

Set world image as static world image. This method set this world image as static. It means that primitives inserted there don't move. Each primitive evaluation methods will first test all the primitives in the world images declared as static. Then, the evalutation test the primtive in the asked worldImage. Parameters: worldImage  is the id of the world image to set as static. Implemented in NLPACS::CMoveContainer.

virtual bool NLPACS::UMoveContainer::testMove (  UMovePrimitive *  primitive, const NLMISC::CVectorD &  speed, double  deltaTime, uint8  worldImage, NLMISC::CVectorD *  contactNormal )  [pure virtual]

Test the move of a primitive in a specific world image. This method will test the move of each modified primitives inserted in the world image. The method will test first collisions against primitives inserted in the world images declared as static, then test the collision against the primitives inserted in the world image choosed to test the move of the primitive. Parameters: primitive  is a pointer on the primitive speed  is the wanted speed of the primitive deltaTime  is the deltaTime of the move of the primitive. worldImage  is the world image where you want to test the move of the primitive. contactNormal  is a pointer to CVectorD to store contactNormal with terrain, if not NULL Returns: true if the move is successful, false else. Implemented in NLPACS::CMoveContainer.

---

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

• u_move_container.h

---