glRenderMode-Funktion

Die glRenderMode-Funktion legt den Rastermodus fest.

Syntax

GLint WINAPI glRenderMode(
   GLenum mode
);

Parameter

mode

Der Rastermodus. Die folgenden drei Werte werden akzeptiert. Der Standardwert ist GL_RENDER.

Wert	Bedeutung
GL_RENDER	Rendermodus. Primitive werden gerastert und erzeugen Pixelfragmente, die in den Framebuffer geschrieben werden. Dies ist der normale Modus und auch der Standardmodus.
GL_SELECT	Auswahlmodus. Es werden keine Pixelfragmente erzeugt, und es wird keine Änderung am Framebuffer-Inhalt vorgenommen. Stattdessen wird ein Datensatz der Namen von Primitiven, 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 eingegeben wird.
GL_FEEDBACK	Feedbackmodus. Es werden keine Pixelfragmente erzeugt, und es wird keine Änderung am Framebuffer-Inhalt vorgenommen. Stattdessen werden die Koordinaten und Attribute von Scheitelpunkten, die gezeichnet worden wären, wenn der Rendermodus GL_RENDER worden wäre, in einem Feedbackpuffer zurückgegeben, der vor dem Betreten des Feedbackmodus erstellt werden muss (siehe glFeedbackBuffer).

Fehlercodes

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

Name	Bedeutung
GL_INVALID_ENUM	der Modus war nicht einer von drei akzeptierten Werten.
GL_INVALID_OPERATION	Die Funktion wurde mit dem Argument GL_SELECT aufgerufen , bevor glSelectBuffer mindestens einmal aufgerufen wurde.
GL_INVALID_OPERATION	Die Funktion wurde mit dem Argument GL_FEEDBACK aufgerufen , bevor glBeedbackBuffer mindestens einmal aufgerufen wurde.
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glRenderMode-Funktion akzeptiert ein Argument, den Modus, der einen von drei vordefinierten Werten oben annehmen kann.

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

Wert	Bedeutung
GL_RENDER	Keinen.
GL_SELECT	Die Anzahl der Trefferdatensätze, die an den Select-Puffer übertragen wurden.
GL_FEEDBACK	Die Anzahl der Werte (nicht Scheitelpunkte), die an den Feedbackpuffer übertragen wurden.

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