PhysicsShape.ContactFilterGroupMode.Group

Description

In this mode, the PhysicsShape.ContactFilter.groupIndex is used to control if contacts are never created (negative) or always created (positive). A non-zero group always overrides the PhysicsShape.ContactFilter.categories and PhysicsShape.ContactFilter.contacts masks. A group of zero has no effect. The rules for two shapes coming into contact are:

• If either shape has a group of zero then the group is ignored and the PhysicsShape.ContactFilter.categories and PhysicsShape.ContactFilter.contacts masks are used.
• If both shapes have a non-zero but different group then the PhysicsShape.ContactFilter.categories and PhysicsShape.ContactFilter.contacts masks are used.
• If both shapes have an identical and positive group then they will always produce a contact.
• If both shapes have an identical and negative group then they will never produce a contact.