OverlapParams

顯示已棄用項目

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

如果 ,這個屬性會使邊界查詢操作使用交叉部分的 值來決定是否將該部分包含在空間查詢結果的數組中。

BruteForceAllSlow

啟用時,查詢會忽略所有零件碰撞特性並對每個零件進行硬力檢查。這將對性能產生負面影響,不應在實時體驗中使用。

方法

AddToFilter

()
平行寫入

為了效率和簡單,這種方法是將實例添加到過濾篩選器的首選方式。它還有一個額外的優點,即可以從並行上下文中更新 FilterDescendantsInstances

參數

instances: Instance | Array

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

返回

()