DE/dxDrawRectangle

Diese Funktion zeichnet ein 2D Rechteck über den Bildschirm für 1 Bild. Diese Funktion sollte im Zusammenhang mit dem Event onClientRender verwendet werden, um es permanent darzustellen.

Syntax

bool dxDrawRectangle ( int startX, int startY, float width, float height [, int color = white, bool postGUI = false] )

Benötigte Argumente

• startX: Ein Integer der die Absolute-X-Koordinate auf dem Bildschirm, repräsentiert in Pixeln.
• startY: Ein Integer der die Absolute-Y-Koordinate auf dem Bildschirm, repräsentiert in Pixeln.
• width: Eine Fließkommazahl, diese repräsentiert die Breite, die auf dem Bildschirm dargestellt wird.
• height: Eine Fließkommazahl, diese repräsentiert die Weite, die auf dem Bildschirm dargestellt wird.

Optionale Argumente

• color: Ein Hexcode, der mit der tocolor-Funktion erstellt wird, oder auch mit dem Format 0xAARRGGBB erstellt werden kann.
• postGUI: Ein booleanischer-Wert der angibt, ob das Rectangle vor dem CEGUI gezeichnet wird, oder dahinter.

Rückgabe

Gibt true zurück wenn erfolgreich, false wenn nicht erfolgreich.

Beispiel

Click to collapse [-]

Client

Dieses Beispiel zeichnet ein Rechteck in die Mitte des Bildschirmes.

local sx, sy = guiGetScreenSize() -- Die Bildschirmauflösung des lokalen Spielers ermitteln

function renderRectangle ()
	dxDrawRectangle ( sx/2-(400/2), sy/2-(400/2), 400, 400, tocolor( 255, 0, 0 ), false) -- Zeichnet ein rotes Quadrat in die Mitte
end
addEventHandler ("onClientRender", root, renderRectangle ) -- Durch dieses Event wird das Bild permanent dargestellt, solange das Event auf der Funktion liegt.