RaycastParams

Veraltete anzeigen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Der RaycastParams Daten тип speichert Parameter für WorldRoot:Raycast() Operationen.Die FilterDescendantsInstances Eigenschaft speichert ein Array von Objekten, die entweder als Ausschlus- oder Einschlus列iste basierend auf dem RaycastParams.FilterType Enum verwendet werden.Wenn gewünscht, kann die Eigenschaft RaycastParams.IgnoreWater verwendet werden, um Wasser zu ignorieren Terrain und die Eigenschaft RaycastParams.CollisionGroup kann eine Kollisionsgruppe für die Raycasting-Operation spezifizieren.

Dieses Objekt unterscheidet sich vom ähnlich benannten RaycastResult, das die Ergebnisse eines Raycasts liefert.

Im Gegensatz zu den meisten Datenarten in Luau kannst du alle Mitglieder von RaycastParams ändern, ohne ein neues Objekt zu erstellen, so dass du dasselbe Objekt wiederholt wiederverwenden kannst.

Zusammenfassung

Konstrukteure

Eigenschaften

Methoden

Konstrukteure

new

Gibt ein leeres RaycastParams 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 Raycasting-Kandidaten verwendet werden.

Legt fest, wie das FilterDescendantsInstances-Array verwendet wird, abhängig von dem Enum.RaycastFilterType bereitgestellten.

IgnoreWater

Bestimmt, ob das Wassermaterial beim Raycasting gegen Terrain berücksichtigt wird.

CollisionGroup

Gibt eine Kollisionsgruppe für die Raycasting-Operation an.Teile in Kollisionsgruppen, die auf nicht eingestellt sind, stoßen mit dieser Gruppe nicht zusammen.Wenn diese Eigenschaft ausgelassen wird, übernimmt der Raycast die Standard Kollisionsgruppe.

RespectCanCollide

Diese Eigenschaften, wenn true , macht die Raycast-Operation die Werte der überschnittenen Teile CanCollide zugunsten ihrer CanQuery Werte verwenden, wenn sie feststellt, ob dieser Teil in den RaycastResult 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

()
Parallel schreiben

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.

Parameter

instances: Instance | Array

Eine Instanz oder ein Array mit Instanzen, die hinzufügenwerden müssen.

Rückgaben

()