Función glDrawElements
La función glDrawElements representa primitivos de los datos de matriz.
Sintaxis
void WINAPI glDrawElements(
GLenum mode,
GLsizei count,
GLenum type,
const GLvoid *indices
);
Parámetros
-
mode
-
Tipo de primitivos que se van a representar. Puede asumir uno de los siguientes valores simbólicos: GL_POINTS, GL_LINE_STRIP, GL_LINE_LOOP, GL_LINES, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, GL_TRIANGLES, GL_QUAD_STRIP, GL_QUADS y GL_POLYGON.
-
count
-
Número de elementos que se van a representar.
-
type
-
Tipo de los valores en índices. Debe ser uno de GL_UNSIGNED_BYTE, GL_UNSIGNED_SHORT o GL_UNSIGNED_INT.
-
índices
-
Puntero a la ubicación donde se almacenan los índices.
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 no era un valor aceptado. |
|
count era un valor negativo. |
|
Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd. |
Observaciones
La función glDrawElements permite especificar varios primitivos geométricos con muy pocas llamadas de función. En lugar de llamar a una función OpenGL para pasar cada vértice individual, normal o color, puede especificar matrices independientes de vértices, normales y colores de antemano y usarlas para definir una secuencia de primitivos (todo el mismo tipo) con una sola llamada a glDrawElements.
Cuando se llama a la función glDrawElements , se usan elementos secuenciales de recuento de índices para construir una secuencia de primitivos geométricos. El parámetro mode especifica qué tipo de primitivos se construyen y cómo se usan los elementos de matriz para construir estos primitivos. Si GL_VERTEX_ARRAY no está habilitado, no se generan primitivos geométricos.
Los atributos de vértice modificados por glDrawElements tienen un valor no especificado después de que glDrawElements devuelva. Por ejemplo, si GL_COLOR_ARRAY está habilitado, el valor del color actual no está definido después de que se ejecute glDrawElements . Los atributos que no se modifican permanecen sin cambios.
Puede incluir la función glDrawElements en las listas de visualización. Cuando glDrawElements se incluye en una lista de visualización, los datos de matriz necesarios (determinados por los punteros de matriz y los habilita) también se introducen en la lista de visualización. Dado que los punteros de matriz y los habilita son variables de estado del lado cliente, sus valores afectan a las listas de visualización cuando se crean las listas, no cuando se ejecutan las listas.
Nota
La función glDrawElements solo está disponible en OpenGL versión 1.1 o posterior.
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 |
|