| minDepth | この値以上の Z 座標（深度）を持つオブジェクトのみを含みます。 |
| maxDepth | この値以下の Z 座標（深度）を持つオブジェクトのみを含みます。 |
| start | ワールド座標での線の開始地点 |
| end | ワールド座標での線の終了地点 |
| results | 線と交差するオブジェクトの配列を返します |
| layerMask | 特定のレイヤーのコライダーのみを判別するためのフィルター |
int
Returns the number of results placed in the results array.
Casts a line against colliders in the Scene.
Linecast とはワールド空間の 2点間に張った仮想の線です。このセンサーと接触したオブジェクトはすべて検知され報告されます。Raycast と似ていますが、その違いは Raycast の場合は原点と方向で線を指定するということです。
LinecastAll 関数に似ていますが、結果は引数の配列に返されるところが異なります。integer の戻り値はレイがヒットするオブジェクト数（ 0 もありえます）ですが、もし返された要素をすべて格納できない場合にリサイズはされません。重要なことは、この結果からメモリ割り当てが行なわれないために、Raycast が頻繁に実行された場合もガベージコレクションのパフォーマンスが改善されます。ラインは始点と終点の間で実行されることを想定しています。コライダーはラインの始点からの距離順で配列として取得します。
さらにこの関数は線の開始地点のコライダーを検知します。この場合線がコライダーの中で開始していてコライダーの表面と交差していません。つまり返された衝突の法線がテストする線のベクトルの反対にセットされた場合、衝突の法線が計算できません。このような結果は RaycastHit2D の 0 地点で得られるため、これを検知するのは容易です。
関連項目: LayerMask クラス、RaycastHit2D クラス、Linecast、LinecastAll、DefaultRaycastLayers、IgnoreRaycastLayer、raycastsHitTriggers.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.