RaycastParams

顯示已棄用項目

*此內容是使用 AI(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

一個例子或包含要新增 加至加的實例的數組。

返回

()