Función glBegin
Las funciones glBegin y glend delimitan los vértices de un primitivo o un grupo de primitivos similares.
Sintaxis
void WINAPI glBegin(
GLenum mode
);
Parámetros
-
mode
-
Primitivos o primitivos que se crearán a partir de vértices presentados entre glBegin y el siguiente glend. A continuación se aceptan constantes simbólicas y sus significados:
Value Significado - GL_POINTS
Trata cada vértice como un único punto. El vértice n define el punto n. Se dibujan N puntos. - GL_LINES
Trata cada par de vértices como un segmento de línea independiente. Los vértices 2n - 1 y 2n definen la línea n. Se dibujan N/2 líneas. - GL_LINE_STRIP
Dibuja un grupo conectado de segmentos de línea desde el primer vértice hasta el último. Los vértices n y n+1 definen la línea n. N - 1 líneas se dibujan. - GL_LINE_LOOP
Dibuja un grupo conectado de segmentos de línea del primer vértice al último y, a continuación, vuelve al primero. Los vértices n y n + 1 definen la línea n. Sin embargo, la última línea se define mediante vértices N y 1. Se dibujan N líneas. - GL_TRIANGLES
Trata cada triplete de vértices como un triángulo independiente. Los vértices 3n - 2, 3n - 1 y 3n definen el triángulo n. Se dibujan triángulos N/3. - GL_TRIANGLE_STRIP
Dibuja un grupo conectado de triángulos. Se define un triángulo para cada vértice presentado después de los dos primeros vértices. Para n impares, vértices n, n + 1 y n + 2 definen el triángulo n. Para incluso n, los vértices n + 1, n y n + 2 definen el triángulo n. N - 2 triángulos se dibujan. - GL_TRIANGLE_FAN
Dibuja un grupo conectado de triángulos. se define un triángulo para cada vértice presentado después de los dos primeros vértices. Los vértices 1, n + 1, n + 2 definen el triángulo n. N - 2 triángulos se dibujan. - GL_QUADS
Trata cada grupo de cuatro vértices como un cuadrilátero independiente. Los vértices 4n - 3, 4n - 2, 4n - 1 y 4n definen quadrilaterales n. Se dibujan N/4 cuadrilaterales. - GL_QUAD_STRIP
Dibuja un grupo conectado de cuadrilaterales. Se define un cuadrilátero para cada par de vértices presentados después del primer par. Los vértices 2n - 1, 2n, 2n + 2 y 2n + 1 definen quadrilaterales n. N/2 - 1 cuadrilaterales se dibujan. Tenga en cuenta que el orden en que se usan los vértices para construir un cuadrilátero a partir de datos de bandas es diferente del utilizado con datos independientes. - GL_POLYGON
Dibuja un único polígono convexa. Los vértices 1 a N definen este polígono.
Valor devuelto
Esta función no devuelve ningún valor.
Códigos de error
La función glGetError puede recuperar los siguientes códigos de error.
| Nombre | Significado |
|---|---|
|
mode se estableció en un valor no aceptado. |
|
Se llamó a una función distinta de glVertex, glColor, glIndex, glNormal, glTexCoord, glEvalCoord, glEvalPoint, glMaterial, glEdgeFlag, glCallList o glCallLists entre glBegin y el glend correspondiente. Se llamó a la función glend antes de llamar a la glBegin correspondiente, o se llamó a glBegin dentro de una secuencia glBegin/glend . |
Comentarios
Las funciones glBegin y glend delimitan los vértices que definen un primitivo o un grupo de primitivos similares. La función glBegin acepta un único argumento que especifica cuál de diez primitivos componen los vértices. Tomando n como recuento de enteros a partir de uno y N como el número total de vértices especificados, las interpretaciones son las siguientes:
Solo puede usar un subconjunto de funciones de OpenGL entre glBegin y glend. Las funciones que puede usar son:
También puede usar glCallList o glCallLists para ejecutar listas de visualización que incluyan solo las funciones anteriores. Si se llama a cualquier otra función de OpenGL entre glBegin y glend, se establece la marca de error y se omite la función.
Independientemente del valor elegido para el modo en glBegin, no hay límite para el número de vértices que se pueden definir entre glBegin y glend. Las líneas, triángulos, cuadrilaterales y polígonos que están incompletos especificados no se dibujan. Los resultados de la especificación incompleta cuando se proporcionan demasiados vértices para especificar incluso un único primitivo o cuando se especifica un múltiplo incorrecto de vértices. Se omite el primitivo incompleto; se dibujan los primitivos completos.
La especificación mínima de vértices para cada primitivo es:
Número mínimo de vértices Tipo de primitivo 1 point 2 line 3 triangle 4 Cuadrilátero 3 polygon Los modos que requieren un determinado múltiplo de vértices son GL_LINES (2), GL_TRIANGLES (3), GL_QUADS (4) y GL_QUAD_STRIP (2).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|