NAME

glInterleavedArrays - simultaneously specify and enable several interleaved arrays

C SPECIFICATION

void ggllIInntteerrlleeaavveeddAArrrraayyss( GLenum _f_o_r_m_a_t,
                          GLsizei _s_t_r_i_d_e,
                          const GLvoid _*_p_o_i_n_t_e_r )

PARAMETERS

_f_o_r_m_a_t
Specifies the type of array to enable. Symbolic constants GGLL__VV22FF, GGLL__VV33FF, GGLL__CC44UUBB__VV22FF, GGLL__CC44UUBB__VV33FF, GGLL__CC33FF__VV33FF, GGLL__NN33FF__VV33FF, GGLL__CC44FF__NN33FF__VV33FF, GGLL__TT22FF__VV33FF, GGLL__TT44FF__VV44FF, GGLL__TT22FF__CC44UUBB__VV33FF, GGLL__TT22FF__CC33FF__VV33FF, GGLL__TT22FF__NN33FF__VV33FF, GGLL__TT22FF__CC44FF__NN33FF__VV33FF, and GGLL__TT44FF__CC44FF__NN33FF__VV44FF are accepted.
_s_t_r_i_d_e
Specifies the offset in bytes between each aggregate array element.

DESCRIPTION

ggllIInntteerrlleeaavveeddAArrrraayyss lets you specify and enable individual color, normal, texture and vertex arrays whose elements are part of a larger aggregate array element. For some implementations, this is more efficient than specifying the arrays separately.

If _s_t_r_i_d_e is 0, the aggregate elements are stored consecutively. Otherwise, _s_t_r_i_d_e bytes occur between the beginning of one aggregate array element and the beginning of the next aggregate array element.

_f_o_r_m_a_t serves as a ``key'' describing the extraction of individual arrays from the aggregate array. If _f_o_r_m_a_t contains a T, then texture coordinates are extracted from the interleaved array. If C is present, color values are extracted. If N is present, normal coordinates are extracted. Vertex coordinates are always extracted.

The digits 2, 3, and 4 denote how many values are extracted. F indicates that values are extracted as floating-point values. Colors may also be extracted as 4 unsigned bytes if 4UB follows the C. If a color is extracted as 4 unsigned bytes, the vertex array element which follows is located at the first possible floating-point aligned address.

NOTES

ggllIInntteerrlleeaavveeddAArrrraayyss is available only if the GL version is 1.1 or greater.

If ggllIInntteerrlleeaavveeddAArrrraayyss is called while compiling a display list, it is not compiled into the list, and it is executed immediately.

Execution of ggllIInntteerrlleeaavveeddAArrrraayyss is not allowed between the execution of ggllBBeeggiinn and the corresponding execution of ggllEEnndd, but an error may or may not be generated. If no error is generated, the operation is undefined.

ggllIInntteerrlleeaavveeddAArrrraayyss is typically implemented on the client side.

Vertex array parameters are client-side state and are therefore not saved or restored by ggllPPuusshhAAttttrriibb and ggllPPooppAAttttrriibb. Use ggllPPuusshhCClliieennttAAttttrriibb and ggllPPooppCClliieennttAAttttrriibb instead.

When the GGLL__AARRBB__mmuullttiitteexxttuurree extension is supported, ggllIInntteerrlleeaavveeddAArrrraayyss only updates the texture coordinate array for the active active texture unit. The texture coordinate state for other client texture units is not update, regardless if they are enabled or not.

ERRORS

GGLL__IINNVVAALLIIDD__EENNUUMM is generated if _f_o_r_m_a_t is not an accepted value.

GGLL__IINNVVAALLIIDD__VVAALLUUEE is generated if _s_t_r_i_d_e is negative.

SEE ALSO

ggllAArrrraayyEElleemmeenntt((33GG)), ggllCClliieennttAAccttiivveeTTeexxttuurreeAARRBB((33GG)), ggllCCoolloorrPPooiinntteerr((33GG)), ggllDDrraawwAArrrraayyss((33GG)), ggllDDrraawwEElleemmeennttss((33GG)), ggllEEddggeeFFllaaggPPooiinntteerr((33GG)), ggllEEnnaabblleeCClliieennttSSttaattee((33GG)), ggllGGeettPPooiinntteerr((33GG)), ggllIInnddeexxPPooiinntteerr((33GG)), ggllNNoorrmmaallPPooiinntteerr((33GG)), ggllTTeexxCCoooorrddPPooiinntteerr((33GG)), ggllVVeerrtteexxPPooiinntteerr((33GG))