Version: Unity 6 Preview (6000.0)
LanguageEnglish
  • C#

RaycastHit2D

struct in UnityEngine

/

Implemented in:UnityEngine.Physics2DModule

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

Description

Returns information about 2D Colliders detected by a 2D physics query in the scene.

The RaycastHit2D struct is used to return results from many 2D physics queries. It contains many pieces of information about a detection result including the Collider2D detected along with extra detail such as the contact point, the distance traversed to that contact point, the contact normal at that contact point etc.

When using any physics query that returns a RaycastHit2D, you should always first check to see if it contains a valid result which indicates that a hit (intersection) was detected. You can do this by checking if the RaycastHit2D is true or false (see code examples). Also, when the result is invalid, all the RaycastHit2D fields will be at their default.

NOTE: This type is also used by the following physics queries:

Additional resources: Physics2D.Raycast, Physics2D.Linecast, Physics2D.BoxCast, Physics2D.CapsuleCast, Physics2D.CircleCast, Physics2D.GetRayIntersection, Collider2D.Cast, Rigidbody2D.Cast, PhysicsScene2D.Raycast, PhysicsScene2D.Linecast, PhysicsScene2D.BoxCast, PhysicsScene2D.CapsuleCast, PhysicsScene2D.CircleCast and PhysicsScene2D.GetRayIntersection.

Properties

centroidThe world space centroid (center) of the physics query shape when it intersects.
colliderThe Collider2D detected by the physics query.
distanceThe distance the physics query traversed before it detected a Collider2D.
fractionThe fraction of the distance specified to the physics query before it detected a Collider2D.
normalThe surface normal of the detected Collider2D.
pointThe world space position where the physics query shape intersected with the detected Collider2D surface.
rigidbodyThe Rigidbody2D that the Collider2D detected by the physics query is attached to.
transformThe Transform on the GameObject that the Collider2D is attached to.

Operators

boolImplicit operator used to return a true or false result indicating if the result is valid or not.