Função glBegin
As funções glBegin e glend delimitam os vértices de um primitivo ou um grupo de primitivos semelhantes.
Sintaxe
void WINAPI glBegin(
GLenum mode
);
Parâmetros
-
mode
-
Os primitivos ou primitivos que serão criados a partir de vértices apresentados entre glBegin e o glend subsequente. A seguir estão aceitas constantes simbólicas e seus significados:
Valor Significado - GL_POINTS
Trata cada vértice como um único ponto. O vértice n define o ponto n. N pontos são desenhados. - GL_LINES
Trata cada par de vértices como um segmento de linha independente. Vértices 2n - 1 e 2n definem a linha n. N/2 linhas são desenhadas. - GL_LINE_STRIP
Desenha um grupo conectado de segmentos de linha do primeiro vértice ao último. Os vértices n e n+1 definem a linha n. N – 1 linhas são desenhadas. - GL_LINE_LOOP
Desenha um grupo conectado de segmentos de linha do primeiro vértice ao último e, em seguida, volta para o primeiro. Os vértices n e n + 1 definem a linha n. A última linha, no entanto, é definida pelos vértices N e 1. N linhas são desenhadas. - GL_TRIANGLES
Trata cada trigêmeo de vértices como um triângulo independente. Vértices 3n - 2, 3n - 1 e 3n definem o triângulo n. Triângulos N/3 são desenhados. - GL_TRIANGLE_STRIP
Desenha um grupo conectado de triângulos. Um triângulo é definido para cada vértice apresentado após os dois primeiros vértices. Para n ímpares, os vértices n, n + 1 e n + 2 definem o triângulo n. Para n par, os vértices n + 1, n e n + 2 definem o triângulo n. N - 2 triângulos são desenhados. - GL_TRIANGLE_FAN
Desenha um grupo conectado de triângulos. um triângulo é definido para cada vértice apresentado após os dois primeiros vértices. Os vértices 1, n + 1, n + 2 definem o triângulo n. N - 2 triângulos são desenhados. - GL_QUADS
Trata cada grupo de quatro vértices como um quadrilátero independente. Vértices 4n - 3, 4n - 2, 4n - 1 e 4n definem quadrilateral n. N/4 quadriláteros são desenhados. - GL_QUAD_STRIP
Desenha um grupo conectado de quadriláteros. Um quadrilátero é definido para cada par de vértices apresentados após o primeiro par. Vértices 2n - 1, 2n, 2n + 2 e 2n + 1 definem quadrilateral n. N/2 - 1 quadriláteros são desenhados. Observe que a ordem na qual os vértices são usados para construir um quadrilátero com base em dados de faixa é diferente daquela usada com dados independentes. - GL_POLYGON
Desenha um polígono convexo único. Os vértices de 1 a N definem esse polígono.
Retornar valor
Essa função não retorna um valor.
Códigos de erro
Os códigos de erro a seguir podem ser recuperados pela função glGetError .
| Nome | Significado |
|---|---|
|
mode foi definido como um valor não aceita. |
|
Uma função diferente de glVertex, glColor, glIndex, glNormal, glTexCoord, glEvalCoord, glEvalPoint, glMaterial, glEdgeFlag, glCallList ou glCallLists foi chamada entre glBegin e o glend correspondente. A função glend foi chamada antes do glBegin correspondente ser chamado ou glBegin foi chamado dentro de uma sequência de glend glBegin/. |
Comentários
As funções glBegin e glend delimitam os vértices que definem um primitivo ou um grupo de primitivos semelhantes. A função glBegin aceita um único argumento que especifica qual dos dez primitivos os vértices compõem. Tomando n como uma contagem de inteiros começando em um e N como o número total de vértices especificado, as interpretações são as seguintes:
Você pode usar apenas um subconjunto de funções OpenGL entre glBegin e glend. As funções que você pode usar são:
Você também pode usar glCallList ou glCallLists para executar listas de exibição que incluem apenas as funções anteriores. Se qualquer outra função OpenGL for chamada entre glBegin e glend, o sinalizador de erro será definido e a função será ignorada.
Independentemente do valor escolhido para o modo em glBegin, não há limite para o número de vértices que você pode definir entre glBegin e glend. Linhas, triângulos, quadriláteros e polígonos especificados incompletamente não são desenhados. Resultados de especificação incompletos quando poucos vértices são fornecidos para especificar até mesmo um único primitivo ou quando um múltiplo incorreto de vértices é especificado. O primitivo incompleto é ignorado; os primitivos completos são desenhados.
A especificação mínima de vértices para cada primitivo é:
Número mínimo de vértices Tipo de primitivo 1 point 2 line 3 triangle 4 Quadrilátero 3 polygon Os modos que exigem um determinado múltiplo de vértices são GL_LINES (2), GL_TRIANGLES (3), GL_QUADS (4) e GL_QUAD_STRIP (2).
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 |
|