glRenderMode-Funktion

Die glRenderMode-Funktion legt den Rastermodus fest.

Syntax

GLint WINAPI glRenderMode(
   GLenum mode
);

Parameter

mode

Der Rasterungsmodus. Die folgenden drei Werte werden akzeptiert. Der Standardwert ist GL _ RENDER.

Wert Bedeutung
GL _ RENDER
Rendermodus. Primitive werden rasterisiert und erzeugen Pixelfragmente, die in den Framepuffer geschrieben werden. Dies ist der normale Modus und auch der Standardmodus.
GL _ SELECT
Auswahlmodus. Es werden keine Pixelfragmente erstellt, und es werden keine Änderungen am Framepufferinhalt vorgenommen. Stattdessen wird ein Datensatz der Namen primitiver Typen, die gezeichnet worden wären, wenn der Rendermodus GL RENDER wäre, in einem Select-Puffer zurückgegeben, der erstellt werden muss _ (siehe glSelectBuffer), bevor der Auswahlmodus aktiviert wird.
GL _ FEEDBACK
Feedbackmodus. Es werden keine Pixelfragmente erstellt, und es werden keine Änderungen am Framepufferinhalt vorgenommen. Stattdessen werden die Koordinaten und Attribute von Scheitelungen, die gezeichnet worden wären, wenn der Rendermodus GL RENDER wäre, in einem Feedbackpuffer zurückgegeben, der erstellt werden muss _ (siehe glFeedbackBuffer),bevor der Feedbackmodus aktiviert wird.

Fehlercodes

Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.

Name Bedeutung
GL _ INVALID _ ENUM
mode war nicht einer von drei akzeptierten Werten.
UNGÜLTIGER _ _ GL-VORGANG
Die Funktion wurde mit dem Argument GL _ SELECT aufgerufen, bevor glSelectBuffer mindestens einmal aufgerufen wurde.
UNGÜLTIGER _ _ GL-VORGANG
Die Funktion wurde mit dem Argument GL _ FEEDBACK aufgerufen, bevor glBeedbackBuffer mindestens einmal aufgerufen wurde.
UNGÜLTIGER _ _ GL-VORGANG
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Hinweise

Die glRenderMode-Funktion verwendet ein Argument, mode, das einen von drei vordefinierten Werten oben annehmen kann.

Der Rückgabewert der glRenderMode-Funktion wird durch den Rendermodus zum Zeitpunkt des Aufrufens von glRenderMode und nicht durch den Modus bestimmt. Die für die drei Rendermodi zurückgegebenen Werte lauten wie folgt.

Wert Bedeutung
GL _ RENDER Keinen.
GL _ SELECT Die Anzahl der Trefferdatensätze, die an den Ausgewählten Puffer übertragen werden.
GL _ FEEDBACK Die Anzahl der Werte (nicht Scheitelzeichen), die an den Feedbackpuffer übertragen werden.

Weitere Informationen zum Auswahl- und Feedbackvorgang finden Sie unter glSelectBuffer und glFeedbackBuffer.

Wenn ein Fehler generiert wird, gibt glRenderMode unabhängig vom aktuellen Rendermodus null zurück.

Die folgende Funktion ruft Informationen im Zusammenhang mit glRenderMode ab:

glGet mit Argument GL _ RENDER _ MODE

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Siehe auch

glBegin

glEnd

glFeedbackBuffer

glInitNames

glLoadName

glPassThrough

glPushName

glSelectBuffer