StartDrawing()

Syntax

Ergebnis = StartDrawing(OutputID)

Ändert die aktuelle Ausgabe auf den angegebenen Ausgabekanal. Nach dessen Festlegung werden alle Zeichenoperationen auf diesem ausgegeben. Sobald alle Zeichenoperationen abgeschlossen wurden, muss StopDrawing() aufgerufen werden.

Das 'Ergebnis' sollte immer überprüft werden, bevor Sie mit Zeichenfunktionen fortfahren. Ist das 'Ergebnis' gleich 0, dann kann der Ausgabekanal nicht zum Zeichnen verwendet werden, andernfalls ist alles OK.

Die Hintergrundfarbe wird auf schwarz (d.h. RGB(0,0,0)) und die Vordergrundfarbe auf weiß (d.h. RGB(255,255,255)) gesetzt.

Eine gültige 'OutputID' kann mit den folgenden Befehlen ermittelt werden:

  WindowOutput()   : Grafiken werden direkt auf dem Fenster gerendert
  ScreenOutput()   : Grafiken werden direkt auf dem Bildschirm gerendert (für Spiele)
  SpriteOutput()   : Grafiken werden direkt auf dem Sprite gerendert (für Spiele)
  ImageOutput()    : Grafiken werden direkt in die Bilddaten gerendert (siehe CreateImage())
  PrinterOutput()  : Grafiken werden direkt auf die Druckerausgabe gerendert
  TextureOutput()  : Grafiken werden direkt auf einer Textur gerendert

Für Zeichenoperationen stehen folgende Befehle zur Verfügung:

  Box()       : rechteckiger Kasten
  Circle()    : Kreis
  Ellipse()   : Ellipse
  FillArea()  : Füllfunktion
  Line()      : Linie (Breite und Höhe)
  LineXY()    : Linie (x1,y1 nach x2,y2)
  Plot()      : Punkt
  DrawImage() : Anzeige eines vorhandenen Bildes
  DrawText()  : Ausgabe von Text

Hinweis: Unter Windows ist es erforderlich, die mittels WindowOutput() direkt in ein Fenster gezeichneten Grafiken nach jedem Verdecken, Minimieren etc. des Fensters manuell neu zu zeichnen ("zu refreshen"). Es ist daher empfehlenswert, Grafiken über ImageOutput() in ein Bild zu zeichnen und dieses als ImageGadget() im Anwendungsfenster darzustellen sowie ggf. mittels SetGadgetState() upzudaten. Windows erledigt dann das Neuzeichnen der Grafiken automatisch.

Der 'Ergebnis'-Wert ist das DC- (Device Context) Handle, welches ggf. von einigen WindowsAPI-Funktionen benötigt wird.

Unterstützte OS

All