Aufruf


Parameter

handle	Identität einer Textur oder gegrabten Teiltextur
x_pos#	Mitte X-Position der Textur
y_pos#	Mitte Y-Position der Textur
button	Buttonaktivierung (Standard = 0) 0 - Textur ist kein Button 1 - Textur ist ein Button ohne Glow handle - Textur ist ein Button mit automatischen Glow
angle#	Rotationswinkel der Textur (Standard = 0)
scale#	Zusätzliche X/Y-Skallierung der Textur (Standard = 1)
frame	Framebild welches angezeigt werden soll (Standard = 0)

Rückgabewert

-

Beschreibung

Dieser Befehl zeichnet ein Image auf dem Bildschirm, dessen Handle zuvor mit LoadImage3D oder CreateImage3D zurückgeliefert wurde. Man beachte, dass das Draw3D -Koordinatensystem nicht dem gewöhnlichen Koordinatensystem entspricht, sondern seinen Koordinatenursprung im Mittelpunkt des Bildschirms hat. Wobei X+ nach rechts und Y+ nach oben gehen.

''button'' legt fest, ob das Image als Button behandelt werden soll. Alternativ zu 0 (Image ist kein Button) und 1 (Image ist ein Button ohne Glow) kann auch ein Handle zu einer Textur angegeben werden, welches auf 'Over' und 'Down' über dem Image gezogen reagiert. Ist der Parameter 'Button' auf 1 gesetzt, so stehen in den globalen Variablen wie MouseOver3D etc. Informationen über den Zustand des Buttons. Enthält der Wert nun aber ein Handle auf eine Draw3D -Textur, so wird diese Textur als Glow über das Image gespannt, falls sich die Maus über den Image befindet. Ist die Maus gedrückt über dem Image, so wird die nächste Textur (geladene/erstellte/gegrabbte) als Glow benutzt. Klingt verwirrend? Ein kleines Beispiel: Wir laden eine Grafik, welches wir als normale Textur anzeigen lassen wollen. Dann laden wir eine Grafik, welches den normalen Glow enthält und dann laden wir eine Grafik, welche bei gedrückter Maustaste als Glow benutzt werden soll. Dann führen wir DrawImage3D aus, geben als normales Handle unsere Textur an, welches wir angezeigt haben wollen und bei Button tragen wir unsere Handle der normalen Textur an, das als Glow angezeigt werden soll. Die ganze Positionsabfrage mit der Maus, anzeigen des Glows etc. erledigt nun die Funktion für uns. Man kann auch Teiltexturen (GrabImage3D) für Gloweffekte erstellen. Wichtig ist nur die Framereihenfolge. Alle Informationen über die Buttonabfrage stehen nachher in den globalen Variablen, welche wir nun überprüfen und was auch immer damit machen. Wir können sogar noch den Winkel und die Skalierung angeben, mit dem das Bild gezeichnet werden soll, was sehr praktisch ist (kein Rumgemurkse mehr mit CopyImage/RotateImage).

''frame'' legt fest, welches Frame relativ zum Handle angezeigt wird. Ist Frame z.B. = 1, so wird einfach die Textur benutzt, das gleich nach der angegebener Textur geladen/erstellt/gegrabbt wurde. Man kann auch negative Framewerte angeben, wenn diese vorhanden sind.

Beispiel

Standardbeispiel: