MousePick

MousePick()

Syntax

Ergebnis = MousePick(#Camera, x, y [, PickMaske])

Beschreibung

Simuliert einen Mausklick und gibt zurück, welches Objekt sich unter dem angegebenen 2D-Punkt (x,y - in Pixel) auf der angegebenen #Camera befindert.

Parameter

#Camera Die zu verwendende Kamera.

x, y Die Koordinaten (in Pixel) des Punktes.

PickMaske (optional) Die während des Strahlenwurfs ("ray cast") zu verwendende Entity-Maske. Nur die Entities mit einer Maske übereinstimmend zur Pick-Maske werden zurückgemeldet. Wird dieser Parameter weggelassen, sind alle Entities gültig für das Feststellen eines Mausklicks. Diese Maske kann eine Kombination sein, um mehr als eine Entity-Gruppe auszuwählen. Um weitere Informationen über die Pick-Maske zu erhalten, siehe CreateEntity().

Rückgabewert

Der zurückgegebene Wert kann lauten:
  -1 : Nichts wurde bemerkt
  #PB_World_WaterPick: der Klick passierte auf dem Wasser.
  #PB_World_TerrainPick: der Klick passierte auf einem Terrain.
  0 und größer: der Klick traf das #Entity. Die Entity-Auswahl ("Pick") 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

<- LoadWorld() - Engine3D Inhaltsverzeichnis - MouseRayCast() ->

#Camera	Die zu verwendende Kamera.
x, y	Die Koordinaten (in Pixel) des Punktes.
PickMaske (optional)	Die während des Strahlenwurfs ("ray cast") zu verwendende Entity-Maske. Nur die Entities mit einer Maske übereinstimmend zur Pick-Maske werden zurückgemeldet. Wird dieser Parameter weggelassen, sind alle Entities gültig für das Feststellen eines Mausklicks. Diese Maske kann eine Kombination sein, um mehr als eine Entity-Gruppe auszuwählen. Um weitere Informationen über die Pick-Maske zu erhalten, siehe CreateEntity().