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 |
|---|---|
|
format no era un valor aceptado. |
|
stride era un valor negativo. |
|
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 |
|
| Biblioteca |
|
| Archivo DLL |
|