Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|