Version: 2018.4
public int Cast (Vector2 direction, RaycastHit2D[] results, float distance= Mathf.Infinity);

パラメーター

directionCollider2D 形状をキャストする方向を示すベクトル
results結果を受け取る配列
distance形状をキャストする最大距離

戻り値

int 引数の変数に結果が代入されます。

説明

All the Collider2D shapes attached to the Rigidbody2D are cast into the Scene starting at each collider position ignoring the colliders attached to the same Rigidbody2D.

This function will take all the Collider2D shapes attached to the Rigidbody2D and cast them into the Scene starting at the collider position in the specified direction for an optional distance and return the results in the provided results array. The integer return value is the number of results written into the results array. The results array will not be resized if it doesn't contain enough elements to report all the results. The significance of this is that no memory is allocated for the results and so garbage collection performance is improved when casts are performed frequently.

さらに、この関数はコライダーの開始位置で重複する他のコライダーを検知します。この場合は、キャストする形状はコライダーの内部で開始し、コライダーの表面を横切らない場合もあります。つまり、返された衝突の法線が、テストする direction ベクトルのリバースに設定される場合は、衝突の法線が計算されません。


public int Cast (Vector2 direction, ContactFilter2D contactFilter, RaycastHit2D[] results, float distance= Mathf.Infinity);

パラメーター

directionCollider2D 形状をキャストする方向を示すベクトル
contactFilterFilter results defined by the contact filter.
results結果を受け取る配列
distance形状をキャストする最大距離

戻り値

int 引数の変数に結果が代入されます。

説明

All the Collider2D shapes attached to the Rigidbody2D are cast into the Scene starting at each collider position ignoring the colliders attached to the same Rigidbody2D.

This function will take all the Collider2D shapes attached to the Rigidbody2D and cast them into the Scene starting at the collider position in the specified direction for an optional distance and return the results in the provided results array. The integer return value is the number of results written into the results array. The results array will not be resized if it doesn't contain enough elements to report all the results. The significance of this is that no memory is allocated for the results and so garbage collection performance is improved when casts are performed frequently.

The contactFilter parameter, can filter the returned results by the options in ContactFilter2D.

さらに、この関数はコライダーの開始位置で重複する他のコライダーを検知します。この場合は、キャストする形状はコライダーの内部で開始し、コライダーの表面を横切らない場合もあります。つまり、返された衝突の法線が、テストする direction ベクトルのリバースに設定される場合は、衝突の法線が計算されません。