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 |
|---|---|
|
mode 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. |
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 |
|
| Bibliothek |
|
| DLL |
|