Version: 2017.3

Physics2D.CircleCastNonAlloc

切换到手册
public static int CircleCastNonAlloc (Vector2 origin, float radius, Vector2 direction, RaycastHit2D[] results, float distance= Mathf.Infinity, int layerMask= DefaultRaycastLayers, float minDepth= -Mathf.Infinity, float maxDepth= Mathf.Infinity);

参数

origin 圆形在 2D 空间中的起点。
radius 圆形的半径。
direction 表示圆形方向的向量。
results 用于接收结果的数组。
distance 将圆形投射的最大距离。
layerMask 过滤器,用于仅在特定层上检测碰撞体。
minDepth 仅包括 Z 坐标(深度)大于或等于该值的对象。
maxDepth 仅包括 Z 坐标(深度)小于或等于该值的对象。

返回

int 返回放置在 results 数组中的结果数。

描述

向场景中投射一个圆形,将与圆形接触的碰撞体返回到提供的结果数组中。

此函数类似于 CircleCastAll 函数,不同之处在于其结果会返回到提供的数组中。整数返回值是与该圆形交叠的对象数(可能为零),但如果结果数组中没有足够的元素来报告所有这些结果,则不会调整该数组的大小。其意义在于不为这些结果分配内存,因此在经常执行时会提高垃圾回收性能。

返回的 RaycastHit2D 将返回圆形将与碰撞体接触的点和法线。此外,它还返回当圆形接触该点时圆形的质心。

另请参阅:LayerMask 类、RaycastHit2D 类、CircleCastCircleCastAllDefaultRaycastLayersIgnoreRaycastLayerraycastsHitTriggers