Función glIndexPointer

La función glIndexPointer define una matriz de índices de color.

Sintaxis

void WINAPI glIndexPointer(
         GLenum  type,
         GLsizei stride,
   const GLvoid  *pointer
);

Parámetros

type

Tipo de datos de cada índice de color de la matriz mediante las siguientes constantes simbólicas: GL_SHORT, GL_INT, GL_FLOAT, GL_DOUBLE.

Paso

Desplazamiento de bytes entre índices de color consecutivos. Cuando el paso es cero, los índices de color se empaquetan estrechamente en la matriz.

pointer

Puntero al primer índice de color 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
GL_INVALID_ENUM	type no era un valor aceptado.
GL_INVALID_VALUE	stride o count fue negativo.

Comentarios

La función glIndexPointer especifica la ubicación y los datos de una matriz de índices de color que se usarán al representar. El parámetro type especifica el tipo de datos de cada índice de color y el intervalo determina el desplazamiento de bytes de un índice de color 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 la constante GL_INDEX_ARRAY con glEnableClientState, se habilita una matriz de índices de color. Cuando se habilita, glDrawArrays y glArrayElement usan la matriz de índices de color. De forma predeterminada, la matriz de índices de color está deshabilitada.

No se puede incluir glIndexPointer en las listas para mostrar.

Cuando se especifica una matriz de índices de color mediante glIndexPointer, los valores de todos los parámetros de matriz de índice de color 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 índice de color 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 glIndexPointer dentro de pares glBegin y glEnd , los resultados no están definidos.

Las siguientes funciones recuperan información relacionada con glIndexPointer:

glIsEnabled con GL_INDEX_ARRAY de argumento

glGet con GL_INDEX_ARRAY_STRIDE de argumentos

glGet con GL_INDEX_ARRAY_COUNT de argumentos

glGet con GL_INDEX_ARRAY_TYPE de argumentos

glGet con GL_INDEX_ARRAY_SIZE de argumentos

glGetPointerv con GL_INDEX_ARRAY_POINTER 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	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glArrayElement

glColorPointer

glDrawArrays

glEdgeFlagPointer

glGetPointerv

glGetString

glNormalPointer

glPushAttrib

glTexCoordPointer

glVertexPointer