Version: 2023.2
LanguageEnglish
  • C#

Collider2D.Distance

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public ColliderDistance2D Distance(Collider2D collider);

Parameters

collider A collider used to calculate the minimum separation against this collider.

Returns

ColliderDistance2D The minimum separation of collider and this collider.

Description

Calculates the minimum separation of this collider against another collider.

A valid collider must be provided for the ColliderDistance2D to be valid. If there are any problems with collider or this Collider2D such as they are disabled or do not contain any collision shapes then the separation will be invalid as indicated by ColliderDistance2D.isValid.

Additional resources: Physics2D.Distance and Rigidbody2D.Distance.


Declaration

public ColliderDistance2D Distance(Vector2 thisPosition, float thisAngle, Collider2D collider, Vector2 position, float angle);

Parameters

thisPosition The position to use for this Collider.
thisAngle The rotation to use for this Collider.
collider A collider used to calculate the minimum separation against this Collider.
position The position to use for the specified collider.
angle The rotation to use for the specified collider.

Returns

ColliderDistance2D The minimum separation of collider and this collider.

Description

A valid collider must be provided for the ColliderDistance2D to be valid. If there are any problems with collider or this Collider2D such as they are disabled or do not contain any collision shapes then the separation will be invalid as indicated by ColliderDistance2D.isValid.

A valid collider must be provided for the ColliderDistance2D to be valid. If there are any problems with collider or this Collider2D such as they are disabled or do not contain any collision shapes then the separation will be invalid as indicated by ColliderDistance2D.isValid.

NOTE: The positions and angles used here represent the position of the Rigidbody2D the respective Collider2D is attached to. If the Collider2D is offset from the center of mass then the Collider2D will use the same offset. This can be confusing so it is recommened that only Collider2D that align with the center of mass are used. If not then you must take this into account. If the Collider2D is not attached to a Rigidbody2D, this call cannot be used and will result in a warning.

Additional resources: Physics2D.Distance and Rigidbody2D.Distance.