版本:Unity 6 (6000.0)
语言英语
  • C#

PhysicsScene2D.OverlapCapsule

建议更改

成功!

感谢您帮助我们提高 Unity 文档的质量。虽然我们无法接受所有提交,但我们确实会阅读用户提交的每条建议的更改,并在需要时做出更新。

关闭

提交失败

由于某些原因,无法提交您建议的更改。请<a>再试一次</a>,几分钟后即可。感谢您抽出时间帮助我们提高 Unity 文档的质量。

关闭

取消

声明

public Collider2D OverlapCapsule(Vector2 point, Vector2 size, CapsuleDirection2D direction, float angle, int layerMask = Physics2D.DefaultRaycastLayers);

声明

public Collider2D OverlapCapsule(Vector2 point, Vector2 size, CapsuleDirection2D direction, float angle, ContactFilter2D contactFilter);

参数

胶囊的中心。
尺寸 胶囊的尺寸。
方向 胶囊的方向。
角度 胶囊的角度。
图层蒙版 仅检查特定图层上的对象的筛选器。
接触筛选器 用于通过不同的方式过滤结果的接触筛选器,例如通过图层蒙版和 Z 深度。请注意,法线角不用于重叠测试。

返回值

Collider2D 覆盖胶囊的碰撞器。

说明

检查胶囊与 PhysicsScene2D 中的碰撞器,仅返回第一个交点。

理论上来说,“OverlapCapsule”就像通过胶囊形状观察场景以确定能看到什么。可以检测到任何可见的 Collider2D 并报告。

此函数返回一个与胶囊重叠的 Collider2D,如果没有重叠,则返回 NULL。

图层蒙版 可用于有选择性地仅检测某些图层上的对象(例如,这允许您仅将检测应用于敌方角色)。使用 contactFilter 的此方法的重载可以按 ContactFilter2D 中提供的选项过滤结果。

其他资源:PhysicsScene2DLayerMaskPhysics2D.DefaultRaycastLayersPhysics2D.IgnoreRaycastLayerPhysics2D.queriesHitTriggers


声明

public int OverlapCapsule(Vector2 point, Vector2 size, CapsuleDirection2D direction, float angle, Collider2D[] results, int layerMask = Physics2D.DefaultRaycastLayers);

声明

public int OverlapCapsule(Vector2 point, Vector2 size, CapsuleDirection2D direction, float angle, ContactFilter2D contactFilter, Collider2D[] results);

参数

胶囊的中心。
尺寸 胶囊的尺寸。
方向 胶囊的方向。
角度 胶囊的角度。
results 接收结果的数组。数组的大小决定了能返回的最大结果数。
图层蒙版 仅检查特定图层上的对象的筛选器。
接触筛选器 用于通过不同的方式过滤结果的接触筛选器,例如通过图层蒙版和 Z 深度。请注意,法线角不用于重叠测试。

返回值

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

说明

检查 PhysicsScene2D 中的胶囊与碰撞器,返回所有焦点。

理论上来说,“OverlapCapsule”就像通过胶囊形状观察场景以确定能看到什么。可以检测到任何可见的 Collider2D 并报告。

此函数返回重叠胶囊的 Collider2D 数组。

整型返回值是相交胶囊的对象数(可能为零),但如果 results 数组不包含足够元素来报告所有结果,它将不会被调整大小。这意味着结果不会分配内存,从而提高了垃圾回收性能。请注意,如果您传递了一个空数组,您将始终得到零结果。

图层蒙版 可用于有选择性地仅检测某些图层上的对象(例如,这允许您仅将检测应用于敌方角色)。使用 contactFilter 的此方法的重载可以按 ContactFilter2D 中提供的选项过滤结果。

其他资源:PhysicsScene2DLayerMaskPhysics2D.DefaultRaycastLayersPhysics2D.IgnoreRaycastLayerPhysics2D.queriesHitTriggers


声明

public int OverlapCapsule(Vector2 point, Vector2 size, CapsuleDirection2D direction, float angle, ContactFilter2D contactFilter, List<Collider2D> results);

参数

胶囊的中心。
尺寸 胶囊的尺寸。
方向 胶囊的方向。
角度 胶囊的角度。
接触筛选器 用于通过不同的方式过滤结果的接触筛选器,例如通过图层蒙版和 Z 深度。请注意,法线角不用于重叠测试。
results 接收结果的列表。

返回值

int 返回置于 results 列表中的结果数。

说明

检查 PhysicsScene2D 中的胶囊与碰撞器,返回所有焦点。

理论上来说,“OverlapCapsule”就像通过胶囊形状观察场景以确定能看到什么。可以检测到任何可见的 Collider2D 并报告。

此函数返回重叠胶囊的 Collider2D 数组。

整型返回值写入 results 列表中的结果数。如果 results 列表不包含足够元素来报告所有结果,它将被调整大小。这可防止在 results 列表不需要调整大小时为 results 分配内存,并在频繁执行查询时提高垃圾回收性能。

结果还可按 contactFilter 筛选。