RaycastParams
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Il tipo di dati RaycastParams memorizza i parametri per le operazioni WorldRoot:Raycast() .La proprietà FilterDescendantsInstances memorizza un array di oggetti da utilizzare come lista di inclusione o esclusione in base all'enumero RaycastParams.FilterType.Se desiderato, la proprietà RaycastParams.IgnoreWater può essere utilizzata per ignorare Terrain l'acqua e la proprietà RaycastParams.CollisionGroup può specificare un gruppo di collisione per l'operazione di raycasting.
Questo oggetto è diverso dal similmente chiamato RaycastResult che fornisce i risultati di un raycast.
A differenza della maggior parte dei tipi di dati in Luau, puoi cambiare tutti i membri di RaycastParams senza creare un nuovo oggetto, permettendoti di riutilizzare lo stesso oggetto più e più volte.
Sommario
Costruttori
- new()
Restituisce un vuoto RaycastParams .
Proprietà
Un array di oggetti i cui discendenti vengono utilizzati per filtrare i candidati di raycasting.
Determina come viene utilizzato l'array FilterDescendantsInstances.
Determina se il materiale acqua è considerato quando viene lanciato contro Terrain .
Il gruppo di collisione utilizzato per l'operazione.
Determina se l'operazione di lancio del raggio consideri il valore della proprietà di una parte CanCollide sul suo valore CanQuery.
Quando è abilitato, la query ignorerà tutte le proprietà di collisione delle parti e eseguirà un controllo a forza bruta su ogni parte.
Metodi
Aggiunge le istanze fornite a FilterDescendantsInstances .
Costruttori
new
Restituisce un oggetto vuoto RaycastParams .A differenza di altri costruttori di tipo dati, questo costruttore non ha parametri, quindi dovresti impostare le sue proprietà in modo appropriato.
Proprietà
FilterDescendantsInstances
Un array di oggetti i cui discendenti vengono utilizzati per filtrare i candidati di raycasting.
FilterType
Determina come viene utilizzato l'array , a seconda di quello fornito.
CollisionGroup
Specifica un gruppo di collisione per l'operazione di lancio del raggio.Le parti nei gruppi di collisione che sono impostate su non collidono con questo gruppo vengono ignorate.Se questa proprietà viene omessa, il raycast assume il Gruppodi collisione Predefinito .
RespectCanCollide
Questa Proprietà, se true , rende l'operazione di lancio del raggio l'utilizzo del valore di CanCollide di una parte intersecata a favore del suo valore di CanQuery quando si determina se quella parte è inclusa nel RaycastResult .
BruteForceAllSlow
Quando è abilitato, la query ignorerà tutte le proprietà di collisione delle parti e eseguirà un controllo a forza bruta su ogni parte.Ciò influirà negativamente sulle prestazioni e non dovrebbe essere utilizzato in esperienze dal vivo.
Metodi
AddToFilter
Per efficienza e semplicità, questo metodo è il modo preferito per aggiungere istanze al Filtro.Ha il vantaggio aggiuntivo che consente FilterDescendantsInstances di essere aggiornato da un contesto parallelo.