DE/dxDrawRectangle

From Multi Theft Auto: Wiki

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.