Función glInterleavedArrays

La función glInterleavedArrays especifica y habilita simultáneamente varias matrices intercaladas en una matriz de agregados mayor.

Sintaxis

void WINAPI glInterleavedArrays(
         GLenum  format,
         GLsizei stride,
   const GLvoid  *pointer
);

Parámetros

format

Tipo de matriz que se va a habilitar. El parámetro puede suponer uno de los siguientes valores simbólicos: GL_V2F, GL_V3F, GL_C4UB_V2F, GL_C4UB_V3F, GL_C3F_V3F, GL_N3F_V3F, GL_C4F_N3F_V3F, GL_T2F_V3F, GL_T4F_V4F, GL_T2F_C4UB_V3F, GL_T2F_C3F_V3F, GL_T2F_N3F_V3F, GL_T2F_C4F_N3F_V3F o GL_T4F_C4F_N3F_V4F.

Paso

Desplazamiento en bytes entre cada elemento de matriz de agregado.

pointer

Puntero al primer elemento de una matriz de agregado.

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	format no era un valor aceptado.
GL_INVALID_VALUE	stride era un valor negativo.
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Observaciones

Con la función glInterleavedArrays , puede especificar y habilitar simultáneamente varios colores intercalados, normales, texturas y matrices de vértices cuyos elementos forman parte de un elemento de matriz agregado mayor. Para algunas arquitecturas de memoria, esto es más eficaz que especificar las matrices por separado.

Si el parámetro stride es cero, los elementos de matriz agregados se almacenan de forma consecutiva; De lo contrario, se producen bytes de intervalo entre los elementos de matriz de agregados.

El parámetro format actúa como clave que describe cómo extraer matrices individuales de la matriz de agregado:

• Si el formato contiene un T, las coordenadas de textura se extraen de la matriz intercalada.
• Si C está presente, se extraen los valores de color.
• Si N está presente, se extraen las coordenadas normales.
• Las coordenadas de vértice siempre se extraen.
• Los dígitos 2, 3 y 4 indican cuántos valores se extraen.
• F indica que los valores se extraen como valores de punto flotante.
• Si 4UB sigue a C, los colores también se pueden extraer como 4 bytes sin signo. Si se extrae un color como 4 bytes sin signo, el elemento de matriz de vértices siguiente se encuentra en la primera dirección alineada de punto flotante posible.

Si llamas a glInterleavedArrays mientras compilas una lista para mostrar, no se compila en la lista, pero se ejecuta inmediatamente.

No se pueden incluir llamadas a glInterleavedArrays en glDisableClientState entre las llamadas a glBegin y la llamada correspondiente a glEnd.

Nota

La función glInterleavedArrays solo está disponible en OpenGL versión 1.1 o posterior.

La función glInterleavedArrays se implementa en el lado cliente sin ningún protocolo. Dado que los parámetros de matriz de vértices son de estado del lado cliente, no se guardan ni restauran mediante glPushAttrib y glPopAttrib. Use glPushClientAttrib y glPopClientAttrib en su lugar.

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

Vea también

glArrayElement

glColorPointer

glDrawArrays

glDrawElements

glEdgeFlagPointer

glEnableClientState

glGetPointerv

glIndexPointer

glNormalPointer

glPushAttrib

glPushClientAttrib

glTexCoordPointer

glVertexPointer