Rigidbody2D.Cast

参数

返回

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

说明

附加到Rigidbody2D的所有Collider2D形状都会从每个碰撞器位置开始，投射到场景中，并忽略附加到同一Rigidbody2D的碰撞器。

此函数会获取附加到Rigidbody2D的所有Collider2D形状，并从碰撞器位置以指定的direction方向投射到场景中，获取可选的distance，并将结果返回到提供的results列表中。

整型返回值是写入results列表的结果数量。如果结果列表不包含报告所有结果的元素，则会调整其大小。当无需调整结果列表大小时，这会防止为结果分配内存，并在频繁执行查询时提升垃圾回收性能。

此外，此函数还会检测到与碰撞器起始位置重叠的其他碰撞器。在这种情况下，投射形状由碰撞器内部开始，可能不会与碰撞器表面相交。这意味着无法计算碰撞法线，此时返回的碰撞法线设置为待测试direction向量的反向向量。

参数

返回

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

说明

附加到Rigidbody2D的所有Collider2D形状都会从每个碰撞器位置开始，投射到场景中，并忽略附加到同一Rigidbody2D的碰撞器。

此函数会获取附加到Rigidbody2D的所有Collider2D形状，并从碰撞器位置以指定的direction方向投射到场景中，获取可选的distance，并将结果返回到提供的results列表中。

整型返回值是写入results列表的结果数量。如果结果列表不包含报告所有结果的元素，则会调整其大小。当无需调整结果列表大小时，这会防止为结果分配内存，并在频繁执行查询时提升垃圾回收性能。

contactFilter 参数可以通过 ContactFilter2D 中的选项筛选返回结果。

此外，此函数还会检测到与碰撞器起始位置重叠的其他碰撞器。在这种情况下，投射形状由碰撞器内部开始，可能不会与碰撞器表面相交。这意味着无法计算碰撞法线，此时返回的碰撞法线设置为待测试direction向量的反向向量。

参数

返回

int 返回放入 results 数组中的结果数量。

说明

附加到Rigidbody2D的所有Collider2D形状都会从每个碰撞器位置开始，投射到场景中，并忽略附加到同一Rigidbody2D的碰撞器。

此函数将获取附加到 Rigidbody2D 中的所有 Collider2D 形状，并从指定 direction 中的 Collider 位置开始将它们投射到场景中，用于可选 distance，并将结果返回到已提供的 results 数组中。

整型返回值是写入 results 数组中的结果数量。如果结果数组不包含报告所有结果所需的元素数量，它将不会调整大小。这样做的意义在于，不会为结果分配内存，因此，当频繁执行 Cast 时，垃圾回收性能得到提升。

此外，此函数还会检测到与碰撞器起始位置重叠的其他碰撞器。在这种情况下，投射形状由碰撞器内部开始，可能不会与碰撞器表面相交。这意味着无法计算碰撞法线，此时返回的碰撞法线设置为待测试direction向量的反向向量。

参数

返回

int 返回放入 results 数组中的结果数量。

说明

附加到Rigidbody2D的所有Collider2D形状都会从每个碰撞器位置开始，投射到场景中，并忽略附加到同一Rigidbody2D的碰撞器。

此函数将获取附加到 Rigidbody2D 中的所有 Collider2D 形状，并从指定 direction 中的 Collider 位置开始将它们投射到场景中，用于可选 distance，并将结果返回到已提供的 results 数组中。

整型返回值是写入 results 数组中的结果数量。如果结果数组不包含报告所有结果所需的元素数量，它将不会调整大小。这样做的意义在于，不会为结果分配内存，因此，当频繁执行 Cast 时，垃圾回收性能得到提升。

contactFilter 参数可以通过 ContactFilter2D 中的选项筛选返回结果。

此外，此函数还会检测到与碰撞器起始位置重叠的其他碰撞器。在这种情况下，投射形状由碰撞器内部开始，可能不会与碰撞器表面相交。这意味着无法计算碰撞法线，此时返回的碰撞法线设置为待测试direction向量的反向向量。

参数

返回

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

说明

Rigidbody2D 从指定位置和旋转开始投射到场景中。附加到 Rigidbody2D 的所有 Collider2D 形状都会随着它一起投射，同时忽略附加到相同 Rigidbody2D 的 Collider。

此函数与 Rigidbody2D.Cast 不同，它允许您投射 Rigidbody2D 及其所有附加 Collider2D 来浏览场景，但它也允许指定 Rigidbody2D 的起始 position 和 angle。

整型返回值是写入results列表的结果数量。如果结果列表不包含报告所有结果的元素，则会调整其大小。当无需调整结果列表大小时，这会防止为结果分配内存，并在频繁执行查询时提升垃圾回收性能。

注意：此外，它还将检测与开始位置重叠的其他碰撞器。在这种情况下，投射形状将从另一个碰撞器内部开始，并且可能不会与碰撞器表面相交。这意味着无法计算碰撞法线，在这种情况下，返回的碰撞法线设置为所测试的direction向量的逆。

其他资源：Rigidbody2D.Cast和ContactFilter2D。

参数

返回

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

说明

Rigidbody2D 从指定位置和旋转开始投射到场景中。附加到 Rigidbody2D 的所有 Collider2D 形状都会随着它一起投射，同时忽略附加到相同 Rigidbody2D 的 Collider。

此函数与 Rigidbody2D.Cast 不同，它允许您投射 Rigidbody2D 及其所有附加 Collider2D 来浏览场景，但它也允许指定 Rigidbody2D 的起始 position 和 angle。

此函数还使用指定的contactFilter，因此不会使用附加到此Rigidbody2D的每个Collider2D的特定LayerMask来检测接触。如果不需要这种情况，则应使用不带ContactFilter2D参数的CastFrom重载。

整型返回值是写入results列表的结果数量。如果结果列表不包含报告所有结果的元素，则会调整其大小。当无需调整结果列表大小时，这会防止为结果分配内存，并在频繁执行查询时提升垃圾回收性能。

注意：此外，它还将检测与开始位置重叠的其他碰撞器。在这种情况下，投射形状将从另一个碰撞器内部开始，并且可能不会与碰撞器表面相交。这意味着无法计算碰撞法线，在这种情况下，返回的碰撞法线设置为所测试的direction向量的逆。

其他资源：Rigidbody2D.Cast和ContactFilter2D。