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 |
|---|---|
|
der Modus war nicht einer von drei akzeptierten Werten. |
|
Die Funktion wurde mit dem Argument GL_SELECT aufgerufen , bevor glSelectBuffer mindestens einmal aufgerufen wurde. |
|
Die Funktion wurde mit dem Argument GL_FEEDBACK aufgerufen , bevor glBeedbackBuffer mindestens einmal aufgerufen wurde. |
|
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 |
|
| Bibliothek |
|
| DLL |
|