言語: 日本語
  • C#
  • JS
  • Boo

スクリプト言語

お好みのスクリプト言語を選択すると、サンプルコードがその言語で表示されます。

Physics2D.LinecastNonAlloc

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

Sumbission failed

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

Close

Cancel

public static function LinecastNonAlloc(start: Vector2, end: Vector2, results: RaycastHit2D[], layerMask: int = DefaultRaycastLayers, minDepth: float = -Mathf.Infinity, maxDepth: float = Mathf.Infinity): int;
public static int LinecastNonAlloc(Vector2 start, Vector2 end, RaycastHit2D[] results, int layerMask = DefaultRaycastLayers, float minDepth = -Mathf.Infinity, float maxDepth = Mathf.Infinity);
public static def LinecastNonAlloc(start as Vector2, end as Vector2, results as RaycastHit2D[], layerMask as int = DefaultRaycastLayers, minDepth as float = -Mathf.Infinity, maxDepth as float = Mathf.Infinity) as int

Parameters

minDepth この値よりも大きなZ座標(深度)にあるオブジェクトのみを含みます。
maxDepth この値よりも小さなZ座標(深度)にあるオブジェクトのみを含みます。
start ワールド座標での線の開始地点
end ワールド座標での線の終了地点
results 線と交差するオブジェクトの配列を返します
layerMask 特定のレイヤーのコライダのみを判別するためのフィルター

Returns

int The number of results returned.

Description

シーン上のコライダーに対して線がヒットするか調べます

Linecast とはワールド座標上の二点間に張った仮想の線です。このセンサーと接触した任意オブジェクトを検知して報告することができます。 Raycast と似ていますが、この場合は原点と方向で線を指定します。 LinecastAll と似ていますが、引数の配列に結果が返されます。integer の戻り値は線にヒットしたオブジェクト数(ゼロもありえます)ですが、もし返された要素を全て格納できない場合にリサイズはされません。重要なことは、結果のためにメモリ割り当てが行なわれないために、Linecast が頻繁に実行された場合もガーベージコレクションのパフォーマンスが改善されます。線が開始地点から終了地点までの向きとすると、開始地点からの距離順にコライダーが並べられます。 さらにこの関数は線の開始地点のコライダーを検知します。この場合線がコライダーの中で開始していてコライダーの表面と交差していません。つまり返された衝突の法線がテストする線のベクトルの反対にセットされた場合、衝突の法線が計算できません。このような結果は RaycastHit2D のゼロ地点で得られるため、これを検知するのは容易です。 See Also: LayerMask クラス, RaycastHit2D クラス, Linecast, LinecastAll, DefaultRaycastLayers, IgnoreRaycastLayer, raycastsHitTriggers.