RaycastParams
*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
- new()
Gibt eine leere RaycastParams zurück.
Eigenschaften
Ein Array von Objekten, deren Nachkommen bei der Filterung von Raycasting-Kandidaten verwendet werden.
Legt fest, wie das FilterDescendantsInstances-Array verwendet wird.
Bestimmt, ob das Wassermaterial beim Raycasting gegen Terrain berücksichtigt wird.
Die Kollisionsgruppe, die für die Operation verwendet wird.
Legt fest, ob die Raycast-Operation einen Teil-CanCollide-Eigenschaftswert über seinen CanQuery-Wert 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 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.
FilterType
Legt fest, wie das FilterDescendantsInstances-Array verwendet wird, abhängig von dem Enum.RaycastFilterType bereitgestellten.
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
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.