Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


GetContacts

Retrieves all contact points for contacts between _collider and _otherCollider.
Read time 2 minutesLast updated 4 days ago

Definition

  • Type: Method
  • Namespace: UnityEngine
  • Assembly: UnityEngine.Physics2DModule

GetContacts(ContactPoint2D[])

Retrieves all contact points for contacts between _collider and _otherCollider.
public int GetContacts(ContactPoint2D[] contacts)

Parameters

An array of ContactPoint2D used to receive the results.

Returns

Type

Description

intReturns the number of contacts placed in the
contacts
array.

Remarks

When retrieving contacts, you should ensure that the provided array is large enough to contain all the contacts you are interested in. The array is usually reused, so it should be large enough to return a reasonable quantity of contacts. This function also means that no allocations occur, which means no work is produced for the garbage collector.
You can check how many contacts are available using _contactCount.

GetContacts(List<ContactPoint2D>)

Retrieves all contact points for contacts between _collider and _otherCollider.
public int GetContacts(List<ContactPoint2D> contacts)

Parameters

A list of ContactPoint2D used to receive the results.

Returns

Type

Description

intReturns the number of contacts placed in the
contacts
list.

Remarks

When retrieving contacts, try to make the provided list large enough to contain all the contacts you need. If the list is not large enough, Unity will automatically increase its size so that it can contain all the contacts. The list is usually reused, so it should be large enough to return a reasonable quantity of contacts. If the list does not have to be increased in size then this function will not allocate any memory, which means no work is produced for the garbage collector.
You can check how many contacts are available using _contactCount.