funzione glRenderMode

La funzione glRenderMode imposta la modalità di rasterizzazione.

Sintassi

GLint WINAPI glRenderMode(
   GLenum mode
);

Parametri

mode

Modalità di rasterizzazione. I tre valori seguenti sono accettati. Il valore predefinito è GL_RENDER.

Valore Significato
GL_RENDER
Modalità di rendering. Le primitive vengono rasterizzate, generando frammenti di pixel, scritti nella cornice. Questa è la modalità normale e anche la modalità predefinita.
GL_SELECT
Modalità di selezione. Nessun frammento di pixel viene prodotto e non viene apportata alcuna modifica al contenuto del framebuffer. Viene invece restituito un record dei nomi delle primitive che sarebbero state disegnate se la modalità di rendering era GL_RENDER viene restituita in un buffer di selezione, che deve essere creato (vedere glSelectBuffer) prima che venga immessa la modalità di selezione.
GL_FEEDBACK
Modalità feedback. Nessun frammento di pixel viene prodotto e non viene apportata alcuna modifica al contenuto del framebuffer. Al contrario, le coordinate e gli attributi dei vertici che sarebbero stati disegnati avevano GL_RENDER modalità di rendering vengono restituite in un buffer di feedback, che deve essere creato (vedere glFeedbackBuffer) prima che venga immessa la modalità di feedback.

Codici di errore

I codici di errore seguenti possono essere recuperati dalla funzione glGetError .

Nome Significato
GL_INVALID_ENUM
la modalità non era uno dei tre valori accettati.
GL_INVALID_OPERATION
La funzione è stata chiamata con argomento GL_SELECT prima che glSelectBuffer sia stata chiamata almeno una volta.
GL_INVALID_OPERATION
La funzione è stata chiamata con argomento GL_FEEDBACK prima che glBeedbackBuffer sia stata chiamata almeno una volta.
GL_INVALID_OPERATION
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

La funzione glRenderMode accetta un argomento, modalità, che può assumere uno dei tre valori predefiniti precedenti.

Il valore restituito della funzione glRenderMode è determinato dalla modalità di rendering al momento in cui glRenderMode viene chiamato anziché in modalità. I valori restituiti per le tre modalità di rendering sono i seguenti.

Valore Significato
GL_RENDER Zero.
GL_SELECT Numero di record di hit trasferiti nel buffer di selezione.
GL_FEEDBACK Numero di valori (non vertici) trasferiti nel buffer di feedback.

Per altri dettagli sull'operazione di selezione e feedback, vedere glSelectBuffer e glFeedbackBuffer .

Se viene generato un errore, glRenderMode restituisce zero indipendentemente dalla modalità di rendering corrente.

La funzione seguente recupera informazioni correlate a glRenderMode:

glGet con argomento GL_RENDER_MODE

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Intestazione
Gl.h
Libreria
Opengl32.lib
DLL
Opengl32.dll

Vedi anche

glBegin

glEnd

glFeedbackBuffer

glInitNames

glLoadName

glPassThrough

glPushName

glSelectBuffer