OverlapParams

显示已弃用

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

OverlapParams 数据类型存储用于使用 WorldRoot 边界查询函数的参数,特别是 WorldRoot:GetPartBoundsInBox()WorldRoot:GetPartBoundsInRadius()WorldRoot:GetPartsInPart()OverlapParams.FilterDescendantsInstances 属性存储一个阵列对象,用作包括或排除列表,基于 OverlapParams.FilterType 枚列,并且 OverlapParams.CollisionGroup 属性可以为边界查询操作指定碰撞集团。

与 Luau 中大多数数据类型不同,您可以不创建新对象就改变 OverlapParams 的所有成员,允许您重复使用相同的对象。

概要

构造工具

属性

方法

构造工具

new

返回一个空白的 OverlapParams 对象。与其他数据类型生成器不同,此生成器没有任何参数,因此您应该适当设置其属性。

属性

FilterDescendantsInstances

一组对象,其后裔被用于过滤候选人。

决定如何使用 OverlapParams.FilterDescendantsInstances 阵列,取决于提供的 Enum.RaycastFilterType 。默认值为 Enum.RaycastFilterType.Exclude

MaxParts

由查询返回的最大零件数。默认值为零()表示没有限制。

CollisionGroup

为操作指定碰撞组。设置为 碰撞的冲突组件的零件被忽略。如果该属性被忽略,操作默认使用 默认 碰撞集群组。

RespectCanCollide

如果 true ,这个属性使边界查询操作使用交叉部分的 BasePart.CanCollide 值,而不是其 BasePart.CanQuery 值来确定是否将该部分包含在空间查询结果阵列中。

BruteForceAllSlow

启用后,查询将忽略所有部件碰撞属性并对每个部件进行粗暴检查。这将对性能产生负面影响,不应在实时体验中使用。

方法

AddToFilter

()
写入并联

为了效率和简单性,这种方法是添加实例到过滤器的首选方式。它还有一个额外的优势,即它允许 FilterDescendantsInstances 从并行上下文中更新。

参数

instances: Instance | Array

一个实例或包含要添加的实例的阵列。

返回

()