Module org.dyn4j

Package org.dyn4j.dynamics.contact

Interface ContactManager

All Superinterfaces:

Shiftable

All Known Implementing Classes:

DefaultContactManager, SimpleContactManager, WarmStartingContactManager

public interface ContactManager
extends Shiftable

Maintains ContactConstraints between Bodys and notifies ContactListeners of various events related to the life-cycle of a contact.

Since:

3.2.0

Version:

3.3.0

Author:

William Bittle

Method Summary

Modifier and Type	Method	Description
void	clear()	Clears the contact manager.
boolean	end(ContactConstraint constraint)	Manually ends the contacts associated with the given ContactConstraint.
int	getContactCount()	Returns the number of contact constraints in the manager.
int	getQueueCount()	Returns the number of contact constraints in the queue.
void	postSolveNotify(java.util.List<ContactListener> listeners)	Notifies the given ContactListeners of the post-solve event for all ContactConstraints that reached this stage.
void	preSolveNotify(java.util.List<ContactListener> listeners)	Notifies the given ContactListeners of the pre-solve event for all ContactConstraints that reached this stage.
void	queue(ContactConstraint constraint)	Queues a new ContactConstraint to be added to this ContactManager.
void	updateAndNotify(java.util.List<ContactListener> listeners, Settings settings)	Updates this ContactManager with the queued ContactConstraints and notifying the given ContactListeners of the respective events.

Methods inherited from interface org.dyn4j.geometry.Shiftable

shift

Method Detail

queue

void queue(ContactConstraint constraint)

Queues a new ContactConstraint to be added to this ContactManager.

The updateAndNotify(List, Settings) method should be called after all ContactConstraints have been queued.

Parameters:

constraint - the ContactConstraint

updateAndNotify

void updateAndNotify(java.util.List<ContactListener> listeners,
                     Settings settings)

Updates this ContactManager with the queued ContactConstraints and notifying the given ContactListeners of the respective events.

This method does not notify the ContactListener.preSolve(ContactPoint) or ContactListener.postSolve(SolvedContactPoint) events.

If any ContactListener method returns false, the contact will not continue to the next stage. In the event that all the contacts of a ContactConstraint do not continue to the next stage, the ContactConstraint itself will not continue.

Parameters:

listeners - the ContactListener to notify

settings - the world Settings

See Also:

ContactListener

preSolveNotify

void preSolveNotify(java.util.List<ContactListener> listeners)

Notifies the given ContactListeners of the pre-solve event for all ContactConstraints that reached this stage.

If any ContactListener method returns false, the contact will not continue to the next stage. In the event that all the contacts of a ContactConstraint do not continue to the next stage, the ContactConstraint itself will not continue.

Parameters:

listeners - the ContactListener to notify

postSolveNotify

void postSolveNotify(java.util.List<ContactListener> listeners)

Notifies the given ContactListeners of the post-solve event for all ContactConstraints that reached this stage.

Parameters:

listeners - the ContactListener to notify

end

boolean end(ContactConstraint constraint)

Manually ends the contacts associated with the given ContactConstraint.

This method does not call the ContactListener.end(ContactPoint) method for the contacts in the given ContactConstraint.

Parameters:

constraint - the ContactConstraint

Returns:

true if the ContactConstraint was found

clear

void clear()

Clears the contact manager.

getQueueCount

int getQueueCount()

Returns the number of contact constraints in the queue.

Returns:

int

Since:

3.3.0

getContactCount

int getContactCount()

Returns the number of contact constraints in the manager.

Returns:

int

Since:

3.3.0