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

Rigidbody2D.Overlap

提出更改建议

成功!

感谢您帮助我们提升 Unity 文档的质量。即使我们无法接受所有提交,但我们会阅读来自我们用户的每一条建议,并在可行的情况下进行更新。

关闭

提交失败

出于某种原因,您提出的更改建议无法提交。请在几分钟后 <a>重试</a>。感谢您抽出宝贵时间帮助我们提升 Unity 文档的质量。

关闭

取消

声明

public int Overlap(Vector2 position, float angle, List<Collider2D> results);

参数

position 在该位置进行刚体重叠。
angle 在该角度进行刚体重叠。
results 接收结果的列表。

返回

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

描述

获取与附加到该 Rigidbody2D 的所有碰撞器的所有碰撞器重叠的列表。

整数返回值是被写到 results 列表中的结果数量。如果结果列表不包含足够元素来报告所有结果,那么该列表将被重置大小。这可以避免在 results 列表不需要重置大小的情况下为结果分配内存,并可以在频繁执行查询时提高垃圾回收性能。

其他资源:Physics2D.OverlapColliderCollider2D.OverlapRigidbody2D.GetAttachedColliders


声明

public int Overlap(Vector2 position, float angle, ContactFilter2D contactFilter, List<Collider2D> results);

参数

position 在该位置进行刚体重叠。
angle 在该角度进行刚体重叠。
contactFilter 用于根据不同条件(如层级蒙版、Z 深度)过滤结果的接触过滤器。注意,重叠测试不使用法线角度。
results 接收结果的列表。

返回

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

描述

获取与附加到该 Rigidbody2D 的所有碰撞器的所有碰撞器重叠的列表。

整数返回值是被写到 results 列表中的结果数量。如果结果列表不包含足够元素来报告所有结果,那么该列表将被重置大小。这可以避免在 results 列表不需要重置大小的情况下为结果分配内存,并可以在频繁执行查询时提高垃圾回收性能。

其他资源:Physics2D.OverlapColliderCollider2D.OverlapRigidbody2D.GetAttachedColliders


声明

public int Overlap(List<Collider2D> results);

参数

results 接收结果的列表。

返回

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

描述

获取与附加到该 Rigidbody2D 的所有碰撞器的所有碰撞器重叠的列表。

整数返回值是被写到 results 列表中的结果数量。如果结果列表不包含足够元素来报告所有结果,那么该列表将被重置大小。这可以避免在 results 列表不需要重置大小的情况下为结果分配内存,并可以在频繁执行查询时提高垃圾回收性能。

其他资源:Physics2D.OverlapColliderCollider2D.OverlapRigidbody2D.GetAttachedColliders


声明

public int Overlap(ContactFilter2D contactFilter, List<Collider2D> results);

参数

contactFilter 用于根据不同条件(如层级蒙版、Z 深度)过滤结果的接触过滤器。注意,重叠测试不使用法线角度。
results 接收结果的列表。

返回

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

描述

获取与附加到该 Rigidbody2D 的所有碰撞器重叠且由 contactFilter 过滤的所有碰撞器的列表。

整数返回值是被写到 results 列表中的结果数量。如果结果列表不包含足够元素来报告所有结果,那么该列表将被重置大小。这可以避免在 results 列表不需要重置大小的情况下为结果分配内存,并可以在频繁执行查询时提高垃圾回收性能。

其他资源:Physics2D.OverlapColliderCollider2D.OverlapRigidbody2D.GetAttachedColliders


声明

public int Overlap(ContactFilter2D contactFilter, out Collider2D[] results);

参数

contactFilter 用于根据不同条件(如层级蒙版、Z 深度)过滤结果的接触过滤器。注意,重叠测试不使用法线角度。
results 接收结果的数组。数组的大小决定可返回的最大结果数。

返回

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

描述

获取与附加到该 Rigidbody2D 的所有碰撞器重叠且由 contactFilter 过滤的所有碰撞器的列表。

整型返回值是与 collider 重叠,并且可以在提供的数组中给定其长度存储的碰撞器的数量。如果结果数组不包含足以报告所有结果的元素,则其大小不会调整。这很重要,因为它没有为结果分配任何内存,因此当频繁执行检查时,垃圾回收性能将得到改善。

其他资源:Physics2D.OverlapColliderCollider2D.OverlapRigidbody2D.GetAttachedColliders