RaycastParams

显示已弃用

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

RaycastParams 数据类型存储了 WorldRoot:Raycast() 操作的参数。FilterDescendantsInstances 属性存储一个阵列对象,用作包括或排除列表,基于 RaycastParams.FilterType 枚列。如果需要,RaycastParams.IgnoreWater 属性可以用来忽略Terrain 水,而RaycastParams.CollisionGroup 属性可以指定射线投射操作的碰撞组。

这个对象与类似名称的 RaycastResult 不同,提供射线投射的结果。

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

概要

构造工具

属性

方法

构造工具

new

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

属性

FilterDescendantsInstances

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

决定如何使用 FilterDescendantsInstances 阵列,取决于提供的 Enum.RaycastFilterType

IgnoreWater

决定是否在射线投射对 Terrain 时考虑水材料。

CollisionGroup

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

RespectCanCollide

这个属性,如果 true , 使射线投射操作使用交叉部分的 CanCollide 值来确定是否包含该部分在 CanQuery 中时,使用其 RaycastResult 值来取代射线投射操作使用的值。

BruteForceAllSlow

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

方法

AddToFilter

()
写入并联

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

参数

instances: Instance | Array

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

返回

()