funzione glRenderMode

La funzione glRenderMode imposta la modalità di rasterizzazione.

Sintassi

GLint WINAPI glRenderMode(
   GLenum mode
);

Parametri

mode

Modalità di rasterizzazione. Vengono accettati i tre valori seguenti. Il valore predefinito è GL_RENDER.

Valore	Significato
GL_RENDER	Modalità di rendering. Le primitive vengono rasterizzate, producendo frammenti di pixel, scritti nel framebuffer. Questa è la modalità normale e anche la modalità predefinita.
GL_SELECT	Modalità di selezione. Non vengono generati frammenti di pixel e non viene apportata alcuna modifica al contenuto del framebuffer. Al contrario, un record dei nomi delle primitive che verrebbero disegnate se la modalità di rendering è stata GL_RENDER viene restituito in un buffer di selezione, che deve essere creato (vedere glSelectBuffer) prima dell'immissione della modalità di selezione.
GL_FEEDBACK	Modalità feedback. Non vengono generati frammenti di pixel e non viene apportata alcuna modifica al contenuto del framebuffer. Al contrario, le coordinate e gli attributi dei vertici che sarebbero stati disegnati se la modalità di rendering fosse stata GL_RENDER 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 l'argomento GL_SELECT prima che glSelectBuffer venisse chiamato almeno una volta.
GL_INVALID_OPERATION	La funzione è stata chiamata con l'argomento GL_FEEDBACK prima che glBeedbackBuffer sia stato chiamato 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, la modalità , che può presupporre uno dei tre valori predefiniti precedenti.

Il valore restituito della funzione glRenderMode è determinato dalla modalità di rendering al momento in cui viene chiamato glRenderMode 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 le 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