Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


IsTouching

Checks whether the collider is touching any of the collider(s) attached to this rigidbody or not.
Read time 2 minutesLast updated 10 days ago

Definition

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

IsTouching(Collider2D)

Checks whether the
collider
is touching any of the collider(s) attached to this rigidbody or not.
public bool IsTouching(Collider2D collider)

Parameters

collider

The collider to check if it is touching any of the collider(s) attached to this rigidbody.

Returns

Type

Description

boolWhether the
collider
is touching any of the collider(s) attached to this rigidbody or not.

Remarks

It is important to understand that checking whether colliders are touching or not is performed against the last physics system update; that is the state of touching colliders at that time. If you have just added a new Collider2D or have moved a Collider2D but a physics update has not yet taken place then the colliders will not be shown as touching. This function returns the same collision results as the physics collision or trigger callbacks.

IsTouching(Collider2D, ContactFilter2D)

Checks whether the
collider
is touching any of the collider(s) attached to this rigidbody or not with the results filtered by the
ContactFilter2D
.
public bool IsTouching(Collider2D collider, ContactFilter2D contactFilter)

Parameters

collider

The collider to check if it is touching any of the collider(s) attached to this rigidbody.

contactFilter

The contact filter used to filter the results differently, such as by layer mask, Z depth, or normal angle.

Returns

Type

Description

boolWhether the
collider
is touching any of the collider(s) attached to this rigidbody or not.

Remarks

It is important to understand that checking whether colliders are touching or not is performed against the last physics system update; that is the state of touching colliders at that time. If you have just added a new Collider2D or have moved a Collider2D but a physics update has not yet taken place then the colliders will not be shown as touching. This function returns the same collision results as the physics collision or trigger callbacks.

IsTouching(ContactFilter2D)

Checks whether any collider is touching any of the collider(s) attached to this rigidbody or not with the results filtered by the
ContactFilter2D
.
public bool IsTouching(ContactFilter2D contactFilter)

Parameters

contactFilter

The contact filter used to filter the results differently, such as by layer mask, Z depth, or normal angle.

Returns

Type

Description

boolWhether any collider is touching any of the collider(s) attached to this rigidbody or not.

Remarks

It is important to understand that checking whether colliders are touching or not is performed against the last physics system update; that is the state of touching colliders at that time. If you have just added a new Collider2D or have moved a Collider2D but a physics update has not yet taken place then the colliders will not be shown as touching. This function returns the same collision results as the physics collision or trigger callbacks.