OverlapParams
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Jenis data OverlapParams data menyimpan parameter untuk digunakan dengan fungsi WorldRoot pencarian batas, khususnya WorldRoot:GetPartBoundsInBox() , WorldRoot:GetPartBoundsInRadius() dan WorldRoot:GetPartsInPart().Properti OverlapParams.FilterDescendantsInstances menyimpan array objek untuk digunakan sebagai daftar termasuk atau pengecualian berdasarkan OverlapParams.FilterType enum, dan properti OverlapParams.CollisionGroup dapat menentukan kelompok tabrakan untuk operasi pencarian batas.
Tidak seperti kebanyakan jenis data di Luau, Anda dapat mengubah semua anggota OverlapParams tanpa membuat objek baru, memungkinkan Anda untuk menggunakan ulang objek yang sama berulang kali.
Rangkuman
Konstruktor
- new()
Kembalikan objek kosong OverlapParams .
Properti
Sebuah array objek yang keturunannya digunakan dalam penyaringan kandidat.
Menentukan bagaimana daftar OverlapParams.FilterDescendantsInstances digunakan.
Jumlah maksimum bagian yang akan dikembalikan oleh pencarian.
Kelompok kolisi yang digunakan untuk operasi.
Menentukan apakah operasi pencarian batas mempertimbangkan nilai properti bagian BasePart.CanCollide di atas nilai BasePart.CanQuery nya.
Saat diaktifkan, pencarian akan mengabaikan semua properti konflik bagian dan melakukan pemeriksaan kekuatan kasar pada setiap bagian.
Metode
Menambahkan instansi yang disediakan ke FilterDescendantsInstances .
Konstruktor
new
Kembalikan objek kosong OverlapParams .Tidak seperti konstruktor jenis data lain, konstruktor ini tidak memiliki parameter, jadi Anda harus mengatur propertinya sesuai.
Properti
FilterDescendantsInstances
Sebuah array objek yang keturunannya digunakan dalam penyaringan kandidat.
FilterType
Menentukan bagaimana array OverlapParams.FilterDescendantsInstances digunakan, tergantung pada Enum.RaycastFilterType yang disediakan. Standar adalah Enum.RaycastFilterType.Exclude .
MaxParts
Jumlah maksimum bagian yang dikembalikan oleh pencarian. Nilai default nol ( 0 ) mewakili batasan tidak ada.
CollisionGroup
Mengidentifikasi kelompok kolisi untuk operasi.Bagian dalam kelompok tabrakan yang ditetapkan ke tidak bertabrakan dengan kelompok ini diabaikan.Jika properti ini diabaikan, operasi mengasumsikan grupkolisi Default .
RespectCanCollide
Properti ini, jika true , membuat operasi penyelidikan batas menggunakan nilai BasePart.CanCollide dari bagian yang tertumpang demi kepentingan nilai BasePart.CanQuery ketika menentukan apakah bagian itu termasuk dalam array hasil pencarian spasial.
BruteForceAllSlow
Saat diaktifkan, pencarian akan mengabaikan semua properti konflik bagian dan melakukan pemeriksaan kekuatan kasar pada setiap bagian.Ini akan berdampak negatif pada kinerja dan tidak boleh digunakan dalam pengalaman langsung.
Metode
AddToFilter
Untuk efisiensi dan kesederhanaan, metode ini adalah cara terfavorit untuk menambahkan instans ke filter.Ini memiliki keuntungan tambahan bahwa ia memungkinkan FilterDescendantsInstances untuk diperbarui dari konteks paralel.