OverlapParams 数据类型存储用于使用 WorldRoot 边界查询函数的参数,特别是 WorldRoot:GetPartBoundsInBox()、WorldRoot:GetPartBoundsInRadius() 和 WorldRoot:GetPartsInPart()。OverlapParams.FilterDescendantsInstances 属性存储一个阵列对象,用作包括或排除列表,基于 OverlapParams.FilterType 枚列,并且 OverlapParams.CollisionGroup 属性可以为边界查询操作指定碰撞集团。
与 Luau 中大多数数据类型不同,您可以不创建新对象就改变 OverlapParams 的所有成员,允许您重复使用相同的对象。
概要
构造工具
- new()
返回一个空白的 OverlapParams 对象。
属性
一组对象,其后裔被用于过滤候选人。
决定如何使用 OverlapParams.FilterDescendantsInstances 列表。
查询返回的最大部分数。
用于操作的碰撞组。
决定边界查询操作是否考虑零件的 BasePart.CanCollide 属性值对其 BasePart.CanQuery 值。
启用后,查询将忽略所有部件碰撞属性并对每个部件进行粗暴检查。
方法
添加提供给 FilterDescendantsInstances 的实例。
构造工具
属性
FilterType
决定如何使用 OverlapParams.FilterDescendantsInstances 阵列,取决于提供的 Enum.RaycastFilterType 。默认值为 Enum.RaycastFilterType.Exclude 。
RespectCanCollide
如果 true ,这个属性使边界查询操作使用交叉部分的 BasePart.CanCollide 值,而不是其 BasePart.CanQuery 值来确定是否将该部分包含在空间查询结果阵列中。