Bezeichnung
gl.RenderMode -- stellt den Rasterisierungsmodus ein
Übersicht
r = gl.RenderMode(mode)
Beschreibung
gl.RenderMode() setzt den Rasterisierungsmodus. Es braucht ein Argument, mode, das einen von drei vordefinierten Werten annehmen kann:

#GL_RENDER
Rendermodus. Grundmuster werden gerastert und erzeugen Pixelfragmente, die in den Rahmenbuffer geschrieben werden. Dies ist der Normalmodus und auch der Standardmodus.

#GL_SELECT
Auswahlmodus. Es werden keine Pixelfragmente erzeugt und es wird keine Änderung am Inhalt des Rahmenpuffers vorgenommen. Stattdessen wird ein Datensatz der Namen von Grundmustern, die gezeichnet worden wären, wenn der Rendermodus #GL_RENDER gewesen wäre, in einem Auswahl-Puffer zurückgegeben, der vor dem Eintritt in den Auswahlmodus erstellt werden muss. Siehe gl.SelectBuffer für Details.

#GL_FEEDBACK
Rückmelde-Modus. Es werden keine Pixelfragmente erzeugt und es wird keine Änderung am Inhalt des Rahmenpuffers vorgenommen. Stattdessen werden die Koordinaten und Attribute von Knoten, die gezeichnet worden wären, wenn der Rendermodus #GL_RENDER gewesen wäre, in einem Rückmelde-Puffer zurückgegeben, der erstellt werden muss, bevor der Rückmelde-Modus aufgerufen wird. Siehe gl.FeedbackBuffer für Details.

Der Rückgabewert von gl.RenderMode() wird durch den Rendermodus beim Aufruf von gl.RenderMode() und nicht durch mode bestimmt. Die zurückgegebenen Werte für die drei Rendermodi lauten wie folgt:

#GL_RENDER
0.

#GL_SELECT
Die Anzahl der Treffer, die in den Auswahl-Puffer übertragen werden.

#GL_FEEDBACK
Die Anzahl der Werte (nicht Eckpunkte), die in den Rückmelde-Puffer übertragen werden.

Siehe gl.SelectBuffer für weitere Details zur Auswahloperation.

Siehe gl.FeedbackBuffer für weitere Details zum Rückmelde-Betrieb.

Wenn ein Fehler erzeugt wird, gibt gl.RenderMode() 0 zurück, unabhängig vom aktuellen Rendermodus.

Weitere Informationen finden Sie in einem OpenGL-Referenzhandbuch.

Eingaben
mode
gibt den Rasterisierungsmodus an; der Initialwert ist #GL_RENDER (siehe oben).
Rückgabewerte
r
Rückgabewert (siehe oben)
Fehler
#GL_INVALID_ENUM wird erzeugt, wenn mode nicht einer der drei akzeptierten Werte ist.

#GL_INVALID_OPERATION wird generiert, wenn gl.SelectBuffer() aufgerufen wird, während der Render-Modus #GL_SELECT ist, oder wenn gl.RenderMode() mit dem Argument #GL_SELECT aufgerufen wird bevor gl.SelectBuffer() mindestens einmal aufgerufen wurde.

#GL_INVALID_OPERATION wird erzeugt, wenn gl.SelectBuffer() aufgerufen wird, während der Rendermodus #GL_SELECT ist, oder wenn gl.RenderMode() mit dem Argument #GL_SELECT aufgerufen wird, bevor gl.SelectBuffer() mindestens einmal aufgerufen wurde.

#GL_INVALID_OPERATION wird erzeugt, wenn gl.FeedbackBuffer() aufgerufen wird, während der Rendermodus #GL_FEEDBACK ist, oder wenn gl.RenderMode() mit dem Argument #GL_FEEDBACK aufgerufen wird, bevor gl.FeedbackBuffer() mindestens einmal aufgerufen wurde.

#GL_INVALID_OPERATION wird erzeugt, wenn gl.RenderMode() zwischen gl.Begin() und gl.End() ausgeführt wird.

Verbundene get-operationen
gl.Get() mit dem Argument #GL_RENDER_MODE


Navigation zeigen