ScreenOutput()

Syntax

OutputID = ScreenOutput()

Gibt die 'OutputID' des aktuell benutzten Bildschirms zurück, um darauf 2D-Zeichenoperationen auszuführen. Hierfür wird die PureBasic 2DDrawing Bibliothek genutzt.

ScreenOutput() kann nur innerhalb eines StartDrawing() / StopDrawing() Blocks verwendet werden. Der von ScreenOutput() reservierte Speicher wird beim Aufruf von StopDrawing() freigegeben.

Parameter

Diese Funktion hat keine Parameter.

Rückgabewert

Die OutputID des aktuell verwendeten Bildschirms, um darauf 2D-Zeichenoperationen auszuführen.

Anmerkungen

Auf Linux und OS X kopiert ScreenOutput() den gesamten Bildschirmpuffer zurück in den Hauptspeicher, um 2D-Operationen auszuführen (OpenGL erlaubt keinen direkten Puffer-Zugriff). Damit ist das Zeichnen auf einem Bildschirm sehr langsam und sollte vermieden werden.
ScreenOutput() muß im selben Thread aufgerufen werden, in dem OpenScreen() aufgerufen wurde.
Die Verwendung von InitEngine3D() ist verboten, ScreenOutput() gibt 0 zurück.

Beispiel

  StartDrawing(ScreenOutput())
    ; hier folgen die Zeichenoperationen...
  StopDrawing()

Unterstützte OS

Alle