RayPick

RayPick()

Syntax

Ergebnis = RayPick(x, y, z, ZielX, ZielY, ZielZ [, PickMaske])

Beschreibung

Wirft einen Strahl (englisch: "casts a ray") zwischen dem ersten und dem zweiten Punkt, und prüft, ob ein Objekt den Strahl überquert.

Parameter

x, y, z Die Koordinaten des ersten Punkts, in Welt-Einheiten.

ZielX, ZielY, ZielZ Die Koordinaten des zweiten Punkts, in Welt-Einheiten.

PickMaske (optional) Die während der Überprüfung des Strahls verwendete Entity-Maske. Nur die Entities mit einer Maske, die mit dem Wert der Pick-Maske übereinstimmt, werden gemeldet. Wird dieser Parameter weggelassen, sind alle Entities gültig für die Strahlen-Erkennung. Die Maske kann eine Kombination sein, um mehr als eine Entity-Gruppe auszuwählen. Um weitere Informationen über die Pick-Maske zu erhalten, siehe bei CreateEntity().

Rückgabewert

Der zurückgegebene Wert kann sein:
  -1 : Nichts wurde überquert.
  #PB_World_WaterPick: der Strahl durchquerte das Wasser.
  #PB_World_TerrainPick: der Strahl durchquerte ein Terrain.
  0 und darüber: der Strahl durchquerte ein #Entity. Die Erkennung des Entity basiert auf dessen Rahmen ("Bounding box"), nicht auf seinem Mesh.
Um weitere Informationen über die ausgewählte Objekt-Position zu erhalten, verwenden Sie PickX(), PickY() und PickZ().

Unterstützte OS

Alle

<- RayCollide() - Engine3D Inhaltsverzeichnis - RenderWorld() ->

x, y, z	Die Koordinaten des ersten Punkts, in Welt-Einheiten.
ZielX, ZielY, ZielZ	Die Koordinaten des zweiten Punkts, in Welt-Einheiten.
PickMaske (optional)	Die während der Überprüfung des Strahls verwendete Entity-Maske. Nur die Entities mit einer Maske, die mit dem Wert der Pick-Maske übereinstimmt, werden gemeldet. Wird dieser Parameter weggelassen, sind alle Entities gültig für die Strahlen-Erkennung. Die Maske kann eine Kombination sein, um mehr als eine Entity-Gruppe auszuwählen. Um weitere Informationen über die Pick-Maske zu erhalten, siehe bei CreateEntity().