Unix/Linux Go Back    


CentOS 7.0 - man page for glinterleavedarrays (centos section 3G)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


GLINTERLEAVEDARRAYS(3G) 		  OpenGL Manual 		  GLINTERLEAVEDARRAYS(3G)

NAME
       glInterleavedArrays - simultaneously specify and enable several interleaved arrays

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

PARAMETERS
       format
	   Specifies the type of array to enable. Symbolic constants 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, and
	   GL_T4F_C4F_N3F_V4F are accepted.

       stride
	   Specifies the offset in bytes between each aggregate array element.

DESCRIPTION
       glInterleavedArrays 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 stride is 0, the aggregate elements are stored consecutively. Otherwise, stride bytes
       occur between the beginning of one aggregate array element and the beginning of the next
       aggregate array element.

       format serves as a ``key'' describing the extraction of individual arrays from the
       aggregate array. If format 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
       glInterleavedArrays is available only if the GL version is 1.1 or greater.

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

       Execution of glInterleavedArrays is not allowed between the execution of glBegin() and the
       corresponding execution of glEnd(), but an error may or may not be generated. If no error
       is generated, the operation is undefined.

       glInterleavedArrays is typically implemented on the client side.

       Vertex array parameters are client-side state and are therefore not saved or restored by
       glPushAttrib() and glPopAttrib(). Use glPushClientAttrib() and glPopClientAttrib()
       instead.

       For OpenGL versions 1.3 and greater, or when the ARB_multitexture extension is supported,
       glInterleavedArrays only updates the texture coordinate array for the client active
       texture unit. The texture coordinate state for other client texture units is not updated,
       regardless of whether the client texture unit is enabled or not.

       Secondary color values are not supported in interleaved vertex array formats.

ERRORS
       GL_INVALID_ENUM is generated if format is not an accepted value.

       GL_INVALID_VALUE is generated if stride is negative.

SEE ALSO
       glArrayElement(), glClientActiveTexture(), glColorPointer(), glDrawArrays(),
       glDrawElements(), glEdgeFlagPointer(), glEnableClientState(), glGetPointerv(),
       glIndexPointer(), glNormalPointer(), glSecondaryColorPointer(), glTexCoordPointer(),
       glVertexPointer()

COPYRIGHT
       Copyright (C) 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI
       Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.

AUTHORS
       opengl.org

opengl.org				    06/10/2014			  GLINTERLEAVEDARRAYS(3G)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 04:14 PM.