RaycastParams
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Tipe data RaycastParams menyimpan parameter untuk WorldRoot:Raycast() operasi.Properti FilterDescendantsInstances menyimpan array objek untuk digunakan sebagai daftar termasuk atau dikecualikan berdasarkan enum RaycastParams.FilterType.Jika diinginkan, properti RaycastParams.IgnoreWater dapat digunakan untuk mengabaikan Terrain air, dan properti RaycastParams.CollisionGroup dapat menentukan kelompok kolisi untuk operasi raycasting.
Objek ini berbeda dari yang bernama serupa RaycastResult yang memberikan hasil raycast.
Tidak seperti kebanyakan jenis data di Luau, Anda dapat mengubah semua anggota RaycastParams tanpa membuat objek baru, memungkinkan Anda untuk menggunakan ulang objek yang sama berulang kali.
Rangkuman
Konstruktor
- new()
Kembalikan kosong RaycastParams .
Properti
Sebuah array objek yang keturunannya digunakan dalam menyaring kandidat raycasting.
Menentukan bagaimana array FilterDescendantsInstances digunakan.
Menentukan apakah material air dianggap saat melakukan raycasting terhadap Terrain .
Kelompok kolisi yang digunakan untuk operasi.
Menentukan apakah operasi raycast mempertimbangkan nilai properti bagian CanCollide di atas nilai 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 RaycastParams .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 menyaring kandidat raycasting.
FilterType
Menentukan bagaimana array FilterDescendantsInstances digunakan, tergantung pada Enum.RaycastFilterType yang disediakan.
CollisionGroup
Mengidentifikasi kelompok kolisi untuk operasi raycasting.Bagian dalam kelompok tabrakan yang ditetapkan ke tidak bertabrakan dengan kelompok ini diabaikan.Jika properti ini diabaikan, raycast mengasumsikan grupkolisi default Default .
RespectCanCollide
Properti ini, jika true , membuat operasi raycast menggunakan nilai CanCollide dari bagian yang berinterseks untuk mendukung nilai CanQuery ketika menentukan apakah bagian itu termasuk dalam RaycastResult .
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.