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 |
|---|---|
|
mode não foi um dos três valores aceitos. |
|
A função foi chamada com o argumento GL_SELECT antes de glSelectBuffer ser chamado pelo menos uma vez. |
|
A função foi chamada com o argumento GL_FEEDBACK antes de glBeedbackBuffer ser chamado pelo menos uma vez. |
|
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 |
|
| Biblioteca |
|
| DLL |
|