función glVertexPointer
La función glVertexPointer define una matriz de datos de vértices.
Sintaxis
void WINAPI glVertexPointer(
GLint size,
GLenum type,
GLsizei stride,
const GLvoid *pointer
);
Parámetros
-
size
-
Número de coordenadas por vértice. El valor de size debe ser 2, 3 o 4.
-
type
-
Tipo de datos de cada coordenada de la matriz mediante las siguientes constantes simbólicas: GL_SHORT, GL_INT, GL_FLOAT y GL_DOUBLE.
-
Paso
-
Desplazamiento de bytes entre vértices consecutivos. Cuando el paso es cero, los vértices se empaquetan estrechamente en la matriz.
-
pointer
-
Puntero a la primera coordenada del primer vértice de la matriz.
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 |
|---|---|
|
el tamaño no era 2, 3 o 4. |
|
type no era un valor aceptado. |
|
el valor de stride o count fue negativo. |
Comentarios
La función glVertexPointer especifica la ubicación y los datos de una matriz de coordenadas de vértice que se van a usar al representar. El parámetro size especifica el número de coordenadas por vértice. El parámetro type especifica el tipo de datos de cada coordenada de vértice. El parámetro stride determina el desplazamiento de bytes de un vértice al siguiente, lo que permite el empaquetado de vértices y atributos en una sola matriz o almacenamiento en matrices independientes. En algunas implementaciones, almacenar los vértices y atributos en una sola matriz puede ser más eficaz que usar matrices independientes (consulte glInterleavedArrays).
Se habilita una matriz de vértices cuando se especifica la constante GL_VERTEX_ARRAY con glEnableClientState. Cuando se habilita, glDrawArrays, glDrawElements y glArrayElement usan la matriz de vértices. De forma predeterminada, la matriz de vértices está deshabilitada.
No se puede incluir glVertexPointer en las listas para mostrar.
Al especificar una matriz de vértices mediante glVertexPointer, los valores de todos los parámetros de matriz de vértices de la función se guardan en un estado del lado cliente y los elementos de matriz estática se pueden almacenar en caché. Dado que los parámetros de matriz de vértices son de estado del lado cliente, sus valores no se guardan ni restauran mediante glPushAttrib y glPopAttrib.
Aunque no se genera ningún error si llama a glVertexPointer dentro de pares glBegin y glEnd , los resultados no están definidos.
Las funciones siguientes recuperan información relacionada con glVertexPointer:
glGet con GL_VERTEX_ARRAY_SIZE de argumentos
glGet con GL_VERTEX_ARRAY_STRIDE de argumentos
glGet con GL_VERTEX_ARRAY_COUNT de argumentos
glGet con GL_VERTEX_ARRAY_TYPE de argumentos
glGetPointerv con GL_VERTEX_ARRAY_POINTER de argumentos
glIsEnabled con GL_VERTEX_ARRAY de argumentos
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 |
|