función glTexCoordPointer
La función glTexCoordPointer define una matriz de coordenadas de textura.
Sintaxis
void WINAPI glTexCoordPointer(
GLint size,
GLenum type,
GLsizei stride,
const GLvoid *pointer
);
Parámetros
-
size
-
Número de coordenadas por elemento de matriz. El valor de tamaño debe ser 1, 2, 3 o 4.
-
type
-
Tipo de datos de cada coordenada de textura de la matriz mediante las siguientes constantes simbólicas: GL_SHORT, GL_INT, GL_FLOAT y GL_DOUBLE.
-
Paso
-
Desplazamiento de bytes entre elementos de matriz consecutivos. Cuando el paso es cero, los elementos de matriz se empaquetan estrechamente en la matriz.
-
pointer
-
Puntero a la primera coordenada del primer elemento 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 |
|---|---|
|
type no era un valor aceptado. |
|
el tamaño no era 1, 2, 3 o 4. |
|
el paso fue negativo. |
Comentarios
La función glTexCoordPointer especifica la ubicación y los datos de una matriz de coordenadas de textura que se van a usar al representar. El parámetro size especifica el número de coordenadas usadas para cada elemento de la matriz. El parámetro type especifica el tipo de datos de cada coordenada de textura. El parámetro stride determina el desplazamiento de bytes de un elemento de matriz 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. Para obtener más información, consulte glInterleavedArrays. Cuando se especifica una matriz de coordenadas de textura, se guarda el estado del lado cliente, el tamaño, el tipo, el paso y el puntero.
Cuando se especifica la constante GL_TEXTURE_COORD_ARRAY con glEnableClientState, se habilita una matriz de coordenadas de textura. Cuando se habilita, glDrawArrays, glDrawElements y glArrayElement usan la matriz de coordenadas de textura. De forma predeterminada, la matriz de coordenadas de textura está deshabilitada.
No se puede incluir glTexCoordPointer en las listas para mostrar.
Cuando se especifica una matriz de coordenadas de textura mediante glTexCoordPointer, los valores de todos los parámetros de matriz de coordenadas de textura de la función se guardan en un estado del lado cliente y los elementos de matriz estáticos se pueden almacenar en caché. Dado que los parámetros de matriz de coordenadas de textura son de estado del lado cliente, sus valores no se guardan ni restauran mediante glPushAttrib y glPopAttrib.
Aunque no se genera ningún error al llamar a glTexCoordPointer dentro de los pares glBegin y glEnd , los resultados no están definidos.
Las siguientes funciones recuperan información relacionada con glTexCoordPointer:
glIsEnabled con GL_TEXTURE_COORD_ARRAY de argumento
glGet con GL_TEXTURE_COORD_ARRAY_SIZE de argumentos
glGet con GL_TEXTURE_COORD_ARRAY_STRIDE de argumentos
glGet con GL_TEXTURE_COORD_ARRAY_COUNT de argumentos
glGet con GL_TEXTURE_COORD_ARRAY_TYPE de argumentos
glGetPointerv con GL_TEXTURE_COORD_ARRAY_POINTER de argumento
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 |
|