CollisionDetection.ContactFilter Property

CollisionDetectionContactFilter Property

Gets or sets the contact filter.

Namespace: DigitalRune.Geometry.Collisions
Assembly: DigitalRune.Geometry (in DigitalRune.Geometry.dll) Version: 1.18.0.0 (1.18.2.14427)

Syntax

public IContactFilter ContactFilter { get; set; }

Public Property ContactFilter As IContactFilter
	Get
	Set

public:
property IContactFilter^ ContactFilter {
	IContactFilter^ get ();
	void set (IContactFilter^ value);
}

member ContactFilter : IContactFilter with get, set

Type: IContactFilter
The contact filter. Can be to disable contact filtering. The default filter is a ContactReducer.

Remarks

Contact filters are called in the narrow phase (in CollisionAlgorithms) to post-process the found contacts. Example usages of a contact filter:

Remove redundant contacts. Some applications, like rigid body physics, needs only a minimal set of contacts, e.g. only 4 contacts per ContactSet.
Remove "bad" contacts, for example contacts where the normal direction points into an undesired direction.
Merge contacts. For some applications it is useful to keep only one contact which is the average of all other contacts.