Função glRenderMode

A função glRenderMode define o modo de rasterização.

Sintaxe

GLint WINAPI glRenderMode(
   GLenum mode
);

Parâmetros

mode

O modo de rasterização. Os três valores a seguir são aceitos. O valor padrão é GL_RENDER.

Valor	Significado
GL_RENDER	Modo de renderização. Primitivos são rasterizados, produzindo fragmentos de pixel, que são gravados no framebuffer. Esse é o modo normal e também o modo padrão.
GL_SELECT	Modo de seleção. Nenhum fragmento de pixel é produzido e nenhuma alteração no conteúdo do framebuffer é feita. Em vez disso, um registro dos nomes de primitivos que teriam sido desenhados se o modo de renderização fosse GL_RENDER é retornado em um buffer selecionado, que deve ser criado (consulte glSelectBuffer) antes que o modo de seleção seja inserido.
GL_FEEDBACK	Modo de comentários. Nenhum fragmento de pixel é produzido e nenhuma alteração no conteúdo do framebuffer é feita. Em vez disso, as coordenadas e atributos de vértices que teriam sido desenhados se o modo de renderização tivesse sido GL_RENDER são retornados em um buffer de comentários, que deve ser criado (consulte glFeedbackBuffer) antes que o modo de comentários seja inserido.

Códigos de erro

Os códigos de erro a seguir podem ser recuperados pela função glGetError .

Nome	Significado
GL_INVALID_ENUM	mode não foi um dos três valores aceitos.
GL_INVALID_OPERATION	A função foi chamada com o argumento GL_SELECT antes de glSelectBuffer ser chamado pelo menos uma vez.
GL_INVALID_OPERATION	A função foi chamada com o argumento GL_FEEDBACK antes de glBeedbackBuffer ser chamado pelo menos uma vez.
GL_INVALID_OPERATION	A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

A função glRenderMode usa um argumento, mode, que pode assumir um dos três valores predefinidos acima.

O valor retornado da função glRenderMode é determinado pelo modo de renderização no momento em que glRenderMode é chamado, em vez de por modo. Os valores retornados para os três modos de renderização são os seguintes.

Valor	Significado
GL_RENDER	Zero.
GL_SELECT	O número de registros de ocorrência transferidos para o buffer selecionado.
GL_FEEDBACK	O número de valores (não vértices) transferidos para o buffer de comentários.

Consulte glSelectBuffer e glFeedbackBuffer para obter mais detalhes sobre a operação de seleção e comentários.

Se um erro for gerado, glRenderMode retornará zero, independentemente do modo de renderização atual.

A função a seguir recupera informações relacionadas a glRenderMode:

glGet com GL_RENDER_MODE de argumento

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Gl.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll

Confira também

glBegin

glEnd

glFeedbackBuffer

glInitNames

glLoadName

glPassThrough

glPushName

glSelectBuffer