OverlapParams
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Il tipo di dati memorizza i parametri per l'uso con le funzioni di query di confine , e .La proprietà OverlapParams.FilterDescendantsInstances memorizza un array di oggetti da utilizzare come lista di inclusione o esclusione in base all'enumerazione OverlapParams.FilterType e la proprietà OverlapParams.CollisionGroup può specificare un gruppo di collisione per l'operazione di query di confine.
A differenza della maggior parte dei tipi di dati in Luau, puoi cambiare tutti i membri di OverlapParams senza creare un nuovo oggetto, permettendoti di riutilizzare lo stesso oggetto più e più volte.
Sommario
Costruttori
- new()
Restituisce un oggetto vuoto OverlapParams .
Proprietà
Un array di oggetti i cui discendenti vengono utilizzati per filtrare i candidati.
Determina come viene utilizzata la lista OverlapParams.FilterDescendantsInstances .
La quantità massima di parti da restituire dalla Query.
Il gruppo di collisione utilizzato per l'operazione.
Determina se l'operazione di query di confine consideri il valore della proprietà di una parte BasePart.CanCollide sul suo valore BasePart.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 OverlapParams .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.
FilterType
Determina come viene utilizzato l'array , a seconda di quello fornito. Il predefinito è .
MaxParts
La quantità massima di parti da restituire dalla Query. Il valore predefinito di zero ( 0 ) rappresenta nessun limite.
CollisionGroup
Specifica un gruppo di collisione per l'operazione.Le parti nei gruppi di collisione che sono impostate su non collidono con questo gruppo vengono ignorate.Se questa proprietà viene omessa, l'operazione assume il Gruppodi collisione Predefinito .
RespectCanCollide
Questa Proprietà, se true , rende l'operazione di query di confine utilizzare il valore di BasePart.CanCollide di una parte interconnessa a favore del suo valore di BasePart.CanQuery quando si determina se quella parte è inclusa nell'array di risultati di query spaziali.
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.