Function to manipulate collision pairs.

Functions
void	p3d_col_pair_activate_col_env (p3d_collision_pair *pair, p3d_obj *obj)
	Add the collision test of a movable object with the environment.
void	p3d_col_pair_activate_dist_env (p3d_collision_pair *pair, p3d_obj *obj)
	Add the distance computation of a movable object with the environment.
void	p3d_col_pair_activate_env (p3d_collision_pair *pair, p3d_obj *obj)
	Add the test and the distance computation of a movable object with the environment.
void	p3d_col_pair_activate_col_pair (p3d_collision_pair *pair, p3d_obj *obj1, p3d_obj *obj2)
	Add the collision test between two movable objects.
void	p3d_col_pair_activate_dist_pair (p3d_collision_pair *pair, p3d_obj *obj1, p3d_obj *obj2)
	Add the distance computation between two movable objects.
void	p3d_col_pair_activate_pair (p3d_collision_pair *pair, p3d_obj *obj1, p3d_obj *obj2)
	Add the test and the distance computation between two movable objects.
void	p3d_col_pair_deactivate_col_env (p3d_collision_pair *pair, p3d_obj *obj)
	Deactive the test of a movable object with the environment.
void	p3d_col_pair_deactivate_dist_env (p3d_collision_pair *pair, p3d_obj *obj)
	Deactive the distance computation of a movable object with the environment.
void	p3d_col_pair_deactivate_env (p3d_collision_pair *pair, p3d_obj *obj)
	Deactive the test and the distance computation of a movable object with the environment.
void	p3d_col_pair_deactivate_col_pair (p3d_collision_pair *pair, p3d_obj *obj1, p3d_obj *obj2)
	Deactive the test between two movable objects.
void	p3d_col_pair_deactivate_dist_pair (p3d_collision_pair *pair, p3d_obj *obj1, p3d_obj *obj2)
	Deactive the distance computation between two movable objects.
void	p3d_col_pair_deactivate_pair (p3d_collision_pair *pair, p3d_obj *obj1, p3d_obj *obj2)
	Deactive the test and the distance computation between two movable objects.
void	p3d_col_pair_deactivate_all (p3d_collision_pair *pair)
	Deactive all the test of collisions.
int	p3d_col_pair_is_test_col_env (p3d_collision_pair *pair, p3d_obj *obj)
	Show if there is a test of the movable object with the environment.
int	p3d_col_pair_is_calc_dist_env (p3d_collision_pair *pair, p3d_obj *obj)
	Show if there is a distance computed of the movable object with the environment.
int	p3d_col_pair_is_test_col_pair (p3d_collision_pair *pair, p3d_obj *obj1, p3d_obj *obj2)
	Show if there is a test between the two movable objects.
int	p3d_col_pair_is_calc_dist_pair (p3d_collision_pair *pair, p3d_obj *obj1, p3d_obj *obj2)
	Show if there is a distance computed between the two movable objects.
void	p3d_col_pair_add_into (p3d_collision_pair *src_pair, p3d_collision_pair *dest_pair)
	Add the test of collision in src_pair into the collision pair dest_pair.
void	p3d_col_pair_sub_into (p3d_collision_pair *src_pair, p3d_collision_pair *dest_pair)
	Substract the test of collision in src_pair into the collision pair dest_pair.
void	p3d_col_pair_copy_into (p3d_collision_pair *src_pair, p3d_collision_pair *dest_pair)
	Copy the test of collision in src_pair into the collision pair dest_pair.
p3d_collision_pair *	p3d_col_pair_create (void)
	Create a new collision pairs structure.
p3d_collision_pair *	p3d_col_pair_copy (p3d_collision_pair *pair)
	Create a new collision pair.
void	p3d_col_pair_destroy (p3d_collision_pair *pair)
	Release the memory of a collision pair.

---

Function Documentation

void p3d_col_pair_activate_col_env	(	p3d_collision_pair *	pair,
		p3d_obj *	obj
	)

Add the collision test of a movable object with the environment.

Parameters:

pair,:	the collision pair.
obj,:	the Move3D object. This must be a movable object (body).

Note:

This function does not change the distance computation status.

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_activate_col_pair	(	p3d_collision_pair *	pair,
		p3d_obj *	obj1,
		p3d_obj *	obj2
	)

Add the collision test between two movable objects.

Parameters:

pair,:	the collision pair.
obj1,:	the first movable object.
obj2,:	the secon movable object.

Note:

This function does not change the distance computation status.

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_activate_dist_env	(	p3d_collision_pair *	pair,
		p3d_obj *	obj
	)

Add the distance computation of a movable object with the environment.

Parameters:

pair,:	the collision pair.
obj,:	the Move3D object. This must be a movable object (body).

Note:

This function does not change the collision test status.

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_activate_dist_pair	(	p3d_collision_pair *	pair,
		p3d_obj *	obj1,
		p3d_obj *	obj2
	)

Add the distance computation between two movable objects.

Parameters:

pair,:	the collision pair.
obj1,:	the first movable object.
obj2,:	the secon movable object.

Note:

This function does not change the collision test status.

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_activate_env	(	p3d_collision_pair *	pair,
		p3d_obj *	obj
	)

Add the test and the distance computation of a movable object with the environment.

Parameters:

pair,:	the collision pair.
obj,:	the Move3D object. This must be a movable object (body).

Note:

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_activate_pair	(	p3d_collision_pair *	pair,
		p3d_obj *	obj1,
		p3d_obj *	obj2
	)

Add the test and the distance computation between two movable objects.

Parameters:

pair,:	the collision pair.
obj1,:	the first movable object.
obj2,:	the secon movable object.

Note:

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_add_into	(	p3d_collision_pair *	src_pair,
		p3d_collision_pair *	dest_pair
	)

Add the test of collision in src_pair into the collision pair dest_pair.

Parameters:

src_pair,:	the collision pair that is added to dest_pair.
dest_pair,:	the collision pair in which src_pair is added.

This is the incrementation function (+=).

It is use for example to add new collision test valid to a localpath.

Note:

If src_pair == ::NULL then use the current collision pair.

If dest_pair == ::NULL then use the current collision pair.

p3d_collision_pair* p3d_col_pair_copy

(

p3d_collision_pair *

pair

)

Create a new collision pair.

Parameters:

pair,:

the collision pair that copied into the new contex.

Returns:

The new collision pair (p3d_collision_pair).

In this new pair, there is the same test of collisions than in pair.

Note:

If pair == ::NULL then copy the current collision pairs.

void p3d_col_pair_copy_into	(	p3d_collision_pair *	src_pair,
		p3d_collision_pair *	dest_pair
	)

Copy the test of collision in src_pair into the collision pair dest_pair.

Parameters:

src_pair,:	the collision pair that copied into dest_pair.
dest_pair,:	the collision pair in which src_pair is copied.

This is the affectation function (=).

Note:

If src_pair == ::NULL then use the current collision pair.

If dest_pair == ::NULL then use the current collision pair.

p3d_collision_pair* p3d_col_pair_create

(

void

)

Create a new collision pairs structure.

Returns:

The new collision pairs (p3d_collision_pair).

Remarks:

In this new pair, there is no test of collisions.

void p3d_col_pair_deactivate_all

(

p3d_collision_pair *

pair

)

Deactive all the test of collisions.

Parameters:

pair,:

the collision pair.

Note:

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_deactivate_col_env	(	p3d_collision_pair *	pair,
		p3d_obj *	obj
	)

Deactive the test of a movable object with the environment.

Parameters:

pair,:	the collision pair.
obj,:	the Move3D object. This must be a movable object (body).

Note:

This function does not change the distance computation status.

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_deactivate_col_pair	(	p3d_collision_pair *	pair,
		p3d_obj *	obj1,
		p3d_obj *	obj2
	)

Deactive the test between two movable objects.

Parameters:

pair,:	the collision pair.
obj1,:	the first movable object.
obj2,:	the secon movable object.

Note:

This function does not change the distance computation status.

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_deactivate_dist_env	(	p3d_collision_pair *	pair,
		p3d_obj *	obj
	)

Deactive the distance computation of a movable object with the environment.

Parameters:

pair,:	the collision pair.
obj,:	the Move3D object. This must be a movable object (body).

Note:

This function does not change the collision test status.

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_deactivate_dist_pair	(	p3d_collision_pair *	pair,
		p3d_obj *	obj1,
		p3d_obj *	obj2
	)

Deactive the distance computation between two movable objects.

Parameters:

pair,:	the collision pair.
obj1,:	the first movable object.
obj2,:	the secon movable object.

Note:

This function does not change the collision test status.

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_deactivate_env	(	p3d_collision_pair *	pair,
		p3d_obj *	obj
	)

Deactive the test and the distance computation of a movable object with the environment.

Parameters:

pair,:	the collision pair.
obj,:	the Move3D object. This must be a movable object (body).

Note:

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_deactivate_pair	(	p3d_collision_pair *	pair,
		p3d_obj *	obj1,
		p3d_obj *	obj2
	)

Deactive the test and the distance computation between two movable objects.

Parameters:

pair,:	the collision pair.
obj1,:	the first movable object.
obj2,:	the secon movable object.

Note:

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_destroy

(

p3d_collision_pair *

pair

)

Release the memory of a collision pair.

Parameters:

pair,:

the collision pair to be deleted.

Note:

Do not use this function for the default collision pair.

If the collision pair is in the stack, all the stack is switched.

int p3d_col_pair_is_calc_dist_env	(	p3d_collision_pair *	pair,
		p3d_obj *	obj
	)

Show if there is a distance computed of the movable object with the environment.

Parameters:

pair,:	the collision pair.
obj,:	the Move3D object. This must be a movable object (body).

Returns:

TRUE/FALSE, TRUE if the pair check the collision.

Note:

Only use the data of Kcd

If pair == ::NULL then use the current collision pair.

int p3d_col_pair_is_calc_dist_pair	(	p3d_collision_pair *	pair,
		p3d_obj *	obj1,
		p3d_obj *	obj2
	)

Show if there is a distance computed between the two movable objects.

Parameters:

pair,:	the collision pair.
obj1,:	the first movable object.
obj2,:	the secon movable object.

Returns:

TRUE/FALSE, TRUE if the pair check the collision.

Note:

Only use the data of Kcd

If pair == ::NULL then use the current collision pair.

int p3d_col_pair_is_test_col_env	(	p3d_collision_pair *	pair,
		p3d_obj *	obj
	)

Show if there is a test of the movable object with the environment.

Parameters:

pair,:	the collision pair.
obj,:	the Move3D object. This must be a movable object (body).

Returns:

TRUE/FALSE, TRUE if the pair check the collision.

Note:

Only use the data of Kcd

If pair == ::NULL then use the current collision pair.

int p3d_col_pair_is_test_col_pair	(	p3d_collision_pair *	pair,
		p3d_obj *	obj1,
		p3d_obj *	obj2
	)

Show if there is a test between the two movable objects.

Parameters:

pair,:	the collision pair.
obj1,:	the first movable object.
obj2,:	the secon movable object.

Returns:

TRUE/FALSE, TRUE if the pair check the collision.

Note:

Only use the data of Kcd

If pair == ::NULL then use the current collision pair.

void p3d_col_pair_sub_into	(	p3d_collision_pair *	src_pair,
		p3d_collision_pair *	dest_pair
	)

Substract the test of collision in src_pair into the collision pair dest_pair.

Parameters:

src_pair,:	the collision pair that subtracts dest_pair.
dest_pair,:	the collision pair in which src_pair is subtracted.

This is the decrementation function (-=).

It is used, for example, to know what are the test needed to valid a localpath in the environment. In this case, the collision needed are dest_pair, but we have already tested the localpath in the src_pair, so we only need to test (dest_pair - src_pair).

Note:

If src_pair == ::NULL then use the current collision pair.

If dest_pair == ::NULL then use the current collision pair.