All Superinterfaces:

Listener

All Known Implementing Classes:

CollisionAdapter
```
@Deprecated
public interface CollisionListener
extends Listener
```
Deprecated.
Deprecated in 4.0.0. Use the CollisionListener in the world package instead.
Interface to listen for collision events.
Events for a pair of bodies (as long as they pass the criteria for the event to be called) will be called in the following order:
1. Collision detected by the broadphase: collision(Body, BodyFixture, Body, BodyFixture)
2. Collision detected by the narrowphase: collision(Body, BodyFixture, Body, BodyFixture, Penetration)
3. Contact manifold created by the manifold solver:collision(Body, BodyFixture, Body, BodyFixture, Manifold)
4. Contact constraint created: collision(ContactConstraint)
Returning false from any of the listener methods will halt processing of that event. Other CollisionListeners will still be notified of that event, but subsequent events will not occur (this indicates that you didn't want the collision to be resolved later).
Modification of the World is permitted in these methods. Modification of the Body's fixtures is not permitted (adding/removing will cause a runtime exception).
Since:

1.0.0

Version:

4.0.0

Author:

William Bittle

Method Summary

All Methods Instance Methods Abstract Methods Deprecated Methods
Modifier and Type	Method	Description
`boolean`	`collision(Body body1, BodyFixture fixture1, Body body2, BodyFixture fixture2)`	Deprecated. Called when two `BodyFixture`s are colliding as determined by the `BroadphaseDetector`.
`boolean`	`collision(Body body1, BodyFixture fixture1, Body body2, BodyFixture fixture2, Manifold manifold)`	Deprecated. Called when two `BodyFixture`s are colliding and a contact `Manifold` has been found.
`boolean`	`collision(Body body1, BodyFixture fixture1, Body body2, BodyFixture fixture2, Penetration penetration)`	Deprecated. Called when two `BodyFixture`s are colliding as determined by the `NarrowphaseDetector`.
`boolean`	`collision(ContactConstraint contactConstraint)`	Deprecated. Called after a `ContactConstraint` has been created for a collision.

- Method Detail
  - collision
```
boolean collision(Body body1,
                  BodyFixture fixture1,
                  Body body2,
                  BodyFixture fixture2)
```
    Deprecated.
    
    Called when two BodyFixtures are colliding as determined by the BroadphaseDetector. *
    Body objects can have many Convex Shapes that make up their geometry. Because of this, this method may be called multiple times if two multi-fixtured Bodys are colliding.
    This method is called when the two BodyFixture's expanded AABBs are overlapping. Visually the bodies may not appear to be colliding (which is a valid case). If you need to make sure the Bodys are colliding, and not just their AABBs, use the collision(Body, BodyFixture, Body, BodyFixture, Penetration) method.
    Return false from this method to stop processing of this collision. Other CollisionListeners will still be notified of this event, however, no further collision or contact events will occur for this pair.
    The collision(Body, BodyFixture, Body, BodyFixture, Penetration) method is next in the sequence of collision events.
    
    Parameters:
    
    body1 - the first Body
    
    fixture1 - the first Body's BodyFixture
    
    body2 - the second Body
    
    fixture2 - the second Body's BodyFixture
    
    Returns:
    
    boolean true if processing should continue for this collision
    
    Since:
    
    3.2.0
  - collision
```
boolean collision(Body body1,
                  BodyFixture fixture1,
                  Body body2,
                  BodyFixture fixture2,
                  Penetration penetration)
```
    Deprecated.
    
    Called when two BodyFixtures are colliding as determined by the NarrowphaseDetector.
    Body objects can have many Convex Shapes that make up their geometry. Because of this, this method may be called multiple times if two multi-fixtured Bodys are colliding.
    Modification of the Penetration object is allowed. The Penetration object passed will be used to generate the contact manifold in the ManifoldSolver.
    Return false from this method to stop processing of this collision. Other CollisionListeners will still be notified of this event, however, no further collision or contact events will occur for this pair.
    The collision(Body, BodyFixture, Body, BodyFixture, Manifold) method is next in the sequence of collision events.
    
    Parameters:
    
    body1 - the first Body
    
    fixture1 - the first Body's BodyFixture
    
    body2 - the second Body
    
    fixture2 - the second Body's BodyFixture
    
    penetration - the Penetration between the Shapes
    
    Returns:
    
    boolean true if processing should continue for this collision
  - collision
```
boolean collision(Body body1,
                  BodyFixture fixture1,
                  Body body2,
                  BodyFixture fixture2,
                  Manifold manifold)
```
    Deprecated.
    
    Called when two BodyFixtures are colliding and a contact Manifold has been found.
    Body objects can have many Convex Shapes that make up their geometry. Because of this, this method may be called multiple times if two multi-fixtured Bodys are colliding.
    Modification of the Manifold object is allowed. The Manifold is used to create contact constraints.
    Return false from this method to stop processing of this collision. Other CollisionListeners will still be notified of this event, however, no further collision or contact events will occur for this pair.
    The collision(ContactConstraint) method is next in the sequence of collision events.
    
    Parameters:
    
    body1 - the first Body
    
    fixture1 - the first Body's BodyFixture
    
    body2 - the second Body
    
    fixture2 - the second Body's BodyFixture
    
    manifold - the contact Manifold for the collision
    
    Returns:
    
    boolean true if processing should continue for this collision
  - collision
```
boolean collision(ContactConstraint contactConstraint)
```
    Deprecated.
    
    Called after a ContactConstraint has been created for a collision.
    Body objects can have many Convex Shapes that make up their geometry. Because of this, this method may be called multiple times if two multi-fixtured Bodys are colliding.
    Modification of the friction and restitution (both computed using the CoefficientMixer and sensor fields is allowed.
    Setting the tangent velocity of the ContactConstraint can create a conveyor effect.
    Return false from this method to stop processing of this collision. Other CollisionListeners will still be notified of this event, however, no further collision or contact events will occur for this pair.
    This is the last collision event before contact processing (via ContactListeners) occur.
    
    Parameters:
    
    contactConstraint - the contact constraint
    
    Returns:
    
    boolean true if processing should continue for this collision
    
    Since:
    
    3.0.2

Interface CollisionListener

Method Summary

Method Detail

collision

collision

collision

collision