OverlapParams
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Der OverlapParams Daten тип speichert Parameter für den Einsatz mit WorldRoot Grenzabfragefunktionen, insbesondere WorldRoot:GetPartBoundsInBox() , WorldRoot:GetPartBoundsInRadius() und WorldRoot:GetPartsInPart() .Die OverlapParams.FilterDescendantsInstances Eigenschaft speichert ein Array von Objekten, die entweder als Ausschlusskarte oder als Inklusionsliste basierend auf der OverlapParams.FilterType Enum verwendet werden, und die OverlapParams.CollisionGroup Eigenschaft kann eine Kollisionsgruppe für die Grenzabfrageoperation spezifizieren.
Im Gegensatz zu den meisten Datenarten in Luau kannst du alle Mitglieder von OverlapParams ändern, ohne ein neues Objekt zu erstellen, so dass du dasselbe Objekt wiederholt wiederverwenden kannst.
Zusammenfassung
Konstrukteure
- new()
Gibt ein leeres OverlapParams Objekt zurück.
Eigenschaften
Ein Array von Objekten, deren Nachkommen bei der Filterung von Kandidaten verwendet wird.
Legt fest, wie die OverlapParams.FilterDescendantsInstances-Liste verwendet wird.
Die maximale Anzahl von Teilen, die durch die Abfrage zurückgegeben werden.
Die Kollisionsgruppe, die für die Operation verwendet wird.
Legt fest, ob die Grenzabfrageoperation einen Teil-BasePart.CanCollide-Eigenschaftswert über seinen BasePart.CanQueryWert betrachtet oder nicht.
Wenn aktiviert, ignoriert die Abfrage alle Kollisions属性 von Teilen und führt einen Brute-Force-Check auf jedes Teil durch.
Methoden
Fügt die bereitgestellten Instanzen zu FilterDescendantsInstances hinzu.
Konstrukteure
new
Gibt ein leeres OverlapParams Objekt zurück.Im Gegensatz zu anderen Daten тип Konstruktoren hat dieser Konstruktor keine Parameter, du solltest seine Eigenschaften daher angemessen festlegen.
Eigenschaften
FilterDescendantsInstances
Ein Array von Objekten, deren Nachkommen bei der Filterung von Kandidaten verwendet wird.
FilterType
Legt fest, wie das OverlapParams.FilterDescendantsInstances -Array verwendet wird, abhängig von dem Enum.RaycastFilterType bereitgestellten. Standard ist Enum.RaycastFilterType.Exclude .
MaxParts
Die maximale Anzahl von Teilen, die durch die Abfrage zurückgegeben werden. Der Standardwert von null ( 0 ) repräsentiert keine Einschränkung.
CollisionGroup
Gibt eine Kollisionsgruppe für die Operation an.Teile in Kollisionsgruppen, die auf nicht eingestellt sind, stoßen mit dieser Gruppe nicht zusammen.Wenn diese Eigenschaft ausgelassen wird, übernimmt die Operation die Standard Kollisionsgruppe.
RespectCanCollide
Diese Eigenschaften, wenn true, macht die Grenzabfrageoperation die Werte der überschnittenen Teile BasePart.CanCollide zugunsten ihrer BasePart.CanQuery Werte verwenden, wenn sie feststellt, ob dieser Teil in der Liste der räumlichen Abfragenergebnisse enthalten ist.
BruteForceAllSlow
Wenn aktiviert, ignoriert die Abfrage alle Kollisions属性 von Teilen und führt einen Brute-Force-Check auf jedes Teil durch.Dies wirkt sich negativ auf die Leistung aus und sollte nicht in Live-Erlebnissen verwendet werden.
Methoden
AddToFilter
Für Effizienz und Einfachheit ist diese Methode die bevorzugte Art, Instanzen zum Filter hinzuzufügen.Es hat den zusätzlichen Vorteil, dass es ermöglicht, FilterDescendantsInstances aus einem parallelen Kontext zu aktualisieren.