RayCollide()

Syntax

Ergebnis = RayCollide(x, y, z, ZielX, ZielY, ZielZ [, KollisionsGruppe, KollisionsMaske]])

Wirft einen Strahl (englisch: "casts a ray") zwischen dem ersten und dem zweiten Punkt, und prüft, ob ein LibraryLink "Entity" "Entity" mit dem Strahl kollidiert. Nur Objekte (entities) mit einem Körper (body) reagieren auf den Strahl.

Diese Funktion basiert auf der Physik-Engine, welche vor Verwendung dieses Befehls mittels EnableWorldPhysics() aktiviert werden muss.

Um die Position des Kollisions-Punktes zu ermitteln, verwenden Sie PickX(), PickY() und PickZ(). Die Normalen-Werte am Kollisions-Punkt sind verfügbar mittels NormalX(), NormalY() und NormalZ().

Parameter

x, y, z	Die Koordinaten des ersten Punkts, in Welt-Einheiten.
ZielX, ZielY, ZielZ	Die Koordinaten des zweiten Punkts, in Welt-Einheiten.
KollisionsGruppe, KollisionsMaske (optional)	Die zu verwendende Kollisionsgruppe und Kollisionsmaske. Dies kann nützlich sein, um zu filtern, welches Entity mit dem Strahl kollidieren soll. Kollisionsgruppe und -maske können mit SetEntityCollisionFilter() verändert werden.

Rückgabewert

Gibt die Entity-Nummer zurück, wenn der Strahl mit einem kollidierte. Oder -1, wenn keine Kollision aufgetreten ist.

Siehe auch

NormalX(), NormalY(), NormalZ(), SetEntityCollisionFilter()

Unterstützte OS

Alle