Function to manipulate a collision context.

Functions
void	p3d_col_context_add_elem (p3d_collision_context **list_begin, void *param, p3d_collision_pair *pair)
	Add an element to a collision context.
void	p3d_col_context_merge_elem (p3d_collision_context **list_begin, void *param, p3d_collision_pair *pair)
	Add an element to a list of collision context.
void	p3d_col_context_del_elem (p3d_collision_context **list_begin, void *param, p3d_collision_pair *pair)
	Delete an element to a list of collision context.
void	p3d_col_context_del_param (p3d_collision_context **list_begin, void *param)
	Delete all the element to a list of collision context with the given parameter.
p3d_collision_context *	p3d_col_context_copy (p3d_collision_context *list_begin)
	Copy a list of collision context.
void	p3d_col_context_destroy (p3d_collision_context **list_begin)
	Destroy a list of collision context.
void	p3d_col_context_add (p3d_collision_context *src_context, p3d_collision_context **dest_context)
	Add two collision contexts into dest_context.
p3d_collision_pair *	p3d_col_context_sub (p3d_collision_context *src_context, p3d_collision_context *dest_context)
	Substract two collision contexts into dest_context.

---

Function Documentation

void p3d_col_context_add	(	p3d_collision_context *	src_context,
		p3d_collision_context **	dest_context
	)

Add two collision contexts into dest_context.

Parameters:

src_context,:	The context that must be copied into dest_context.
dest_context,:	The address of the pointer on the beginnig of the context in which src_context is copied.

Return values:

dest_context,:

The sum of the two contexts.

Note:

It does not merge with element with the same parameter (but do not copy two time if there is the same p3d_collision_pair).

It does not copy the context, it is just a link.

If the list is not initialized (*list_begin == NULL), it changes the value of *list_begin to point to the new element.

void p3d_col_context_add_elem	(	p3d_collision_context **	list_begin,
		void *	param,
		p3d_collision_pair *	pair
	)

Add an element to a collision context.

Parameters:

list_begin,:	The address of the pointer on the beginnig of the list.
param,:	The pointer to a parameter that identify the conditions to the context of collision.
pair,:	The collision pair.

Return values:

list_begin,:

If the list is void (*list_begin == NULL), it initializes it.

Note:

It does not merge with element with the same parameter (but do not copy two time if there is the same p3d_collision_pair).

It does not copy the context, it is just a link.

If the list is not initialized (*list_begin == NULL), it changes the value of *list_begin to point to the new element.

p3d_collision_context* p3d_col_context_copy

(

p3d_collision_context *

list_begin

)

Copy a list of collision context.

Parameters:

list_begin,:

The beginnig of the list.

Returns:

The copy of the list

void p3d_col_context_del_elem	(	p3d_collision_context **	list_begin,
		void *	param,
		p3d_collision_pair *	pair
	)

Delete an element to a list of collision context.

Parameters:

list_begin,:	The address of the pointer on the beginnig of the list.
param,:	The pointer to a parameter that identify the conditions to the context of collision.
pair,:	The collision pair.

Return values:

list_begin,:

The new beginning. If the list becomes void (*list_begin = NULL).

void p3d_col_context_del_param	(	p3d_collision_context **	list_begin,
		void *	param
	)

Delete all the element to a list of collision context with the given parameter.

Parameters:

list_begin,:	The address of the pointer on the beginnig of the list.
param,:	The pointer to a parameter that identify the conditions to the context of collision.

Return values:

list_begin,:

The new beginning. If the list becomes void (*list_begin = NULL).

void p3d_col_context_destroy

(

p3d_collision_context **

list_begin

)

Destroy a list of collision context.

Parameters:

list_begin,:

The address of the pointer on the beginnig of the list.

void p3d_col_context_merge_elem	(	p3d_collision_context **	list_begin,
		void *	param,
		p3d_collision_pair *	pair
	)

Add an element to a list of collision context.

Parameters:

list_begin,:	The address of the pointer on the beginnig of the list.
param,:	The pointer to a parameter that identify the conditions to the context of collision.
pair,:	The collision pair.

Return values:

list_begin,:

If the list is void (*list_begin == NULL), it initializes it.

Note:

It merges with element with the same parameter.

It does not copy the context, it is just a link.

If the list is not initialized (*list_begin == NULL), it changes the value of *list_begin to point to the new element.

p3d_collision_pair* p3d_col_context_sub	(	p3d_collision_context *	src_context,
		p3d_collision_context *	dest_context
	)

Substract two collision contexts into dest_context.

Parameters:

src_context,:	The context that must be substracted from dest_context.
dest_context,:	The address of the pointer on the beginnig of the context in which src_context is substracted.

Returns:

: The result of the substraction of the two contexts (dest_context - src_context).

Note:

It does not merge with element with the same parameter (but do not copy two time if there is the same p3d_collision_pair).

It does not copy the context, it is just a link.

If the list is not initialized (*list_begin == NULL), it changes the value of *list_begin to point to the new element.