OpenGL ES1.1.12 第二章 2.8

（仅是草稿，未做整理）

2.8　顶点数组

放在数组的顶点数据是保存在客户端的地址空间，或者放在服务端的地址空间（见2.9小节）。数组的块数据通过执行单个GL命令来定义多个几何元素。客户端可能会定义4+的MAX_TEXTURE_UNITS数组以上数值，用来保存顶点坐标，法线，颜色，点大小和一个或多个纹理坐标。

表2.4　顶点数组大小（每一个顶点大小）及数据类型。

void VertexPointer( int size,enum type,sizei stride,void *pointer );

void NormalPointer( enum type,sizei stride,void *pointer );

void ColorPointer( int size,enum type,sizei stride,void *pointer );

void PointSizePointerOES( enum type,sizei stride,void *pointer );

void TexCoordPointer( int size,enum type,sizei stride,void *pointer );

这些命令描述了这些数组的放置和组织。每一个命令，type为数据类型，如有size，那么表示为每一个顶点值在数组中的个数。由于法线通常由三个值来定义，点大小由一个值来定义，所以NormalPointer 和 PointSizePointerOES就没有size参数了。表2.4显示了size和type值所允许的值。对于type来说，BYTE,UNSIGNED BYTE, SHORT, FIXED,和FLOAT各自表示为byte,　ubyte, short, fixed,和 float。INVALID_VALUE错误的出现，是因为size所给定的值不是表2.4中所允许的值。

与单个顶点相关的数组中的一，二，三或四个值，构成了一个数组元素。这些数组元素在内存中是顺序保存的。如果stride赋值为0，那么数组元素也是顺序保存的。当stride为负数的时候，将会出现INVALID_VALUE的错误。否则，指向数组第i和(i+1)个的元素，会与stride的基本的平台单位不一致（通常是unsigned bytes）,指向第(i+1)元素的指针将会更大。每一个命令，指针会定义数组每一个元素的每一个值在内存中的位置。

通过以下命令可以使能或禁止一个独立的数组。

void EnableClientState( enum array );

void DisableClientState( enum array );

array参数可以设置为VERTEX_ARRAY, NORMAL_ARRAY, COLOR_ARRAY, POINT_ SIZE_ARRAY_OES,或者TEXTURE_COORD_ARRAY，分别对应顶点，法线，颜色，点大小，或者纹理坐标数组。

void ClientActiveTexture( enum texture );

此命令是用来选择顶点数组的客户端状态参数，此参数可以通过TexCoordPointer命令进行修改。命令EnableClientState和DisableClientState通过TEXTURE_COORD_ARRAY参数影响数组。此命令设置客户端状态的 CLIENT_ACTIVE_TEXTURE变量。每一个纹理单元都有一个客户端状态向量，通过ClientActiveTexture来选择。状态向量包括顶点数组状态。这个调用同时也会选择哪个纹理单元的用于查询客户端状态的向量。

如果使用了一个无效的texture值，那么会产生INVALID_ENUM错误。有效的texture参数值，与2.7小节所描述的MultiTexCoord命令一致。

数组元素转换。

当通过DrawArrays或DrawElements命令来对数组第i个元素进行转换，要对每一个使能的数组区别对待。

对于顶点数组，如果size为2，那么顶点坐标的x和y将在数组中。z和w坐标，则各自隐性地设置为0和1。如果size为3，那么x，y和z将会数组中定义。而w设置为1，如果size为4，那么所有坐标参数将会在数组中定义，此时将允许在投影空间里定义任意点。

对于颜色数组，通常都会定义所有四个参数。如果颜色数组没有使能，那么颜色将由Color命令所用到的颜色。

对于法线数组，通常会定义所有三个参数，byte,short, 或整型值转换成浮点值，如表2.7中定义的相应类型。如果法线数组没有使能，那么当前的法线值由Normal命令来定义。

对于点大小数组，size参数将会定义。如果点大小数组没有使能，那么点大小由PointSize命令定义，见3.3小节。

对于纹理坐标数组，如果size为2，那么s和t坐标将会被定义，而r和q则为各自为0和1，如果size为3，那么将会定义s，t，和r三个参数，而q为1。如果size为4，那么所有的坐标值都会定义。如果纹理坐标数组没有使能，那么纹理坐标值将由MultiTexCoord命令所定义。

void DrawArrays( enum mode,int first,sizei count );

此命令，对使能的GL数组中的first到first+count元素进行转换，从而创建一系列的几何元素。mode表示要创建哪一种几何元素，见2.6.1小节。

如果相应的数组使能，在DrawArrays命令执行后，那么颜色，法线，点大小，和纹理坐标各个数组将变为不确定性。而没有使能的数组的值将不会做修改。

如果first<0，那么结果是未定义的。此种情况下，建议产生INVALID_VALUE错误。

void DrawElements( enum mode,sizei count,enum type,void *indices );

此命令，是通过保存在GL的indices的值，来顺序转换count个元素，从而创建一系列的几何元素。第i个元素，是从每一个数组的indices[i]元素。type参数必须是UNSIGNED_BYTE 或UNSIGNED_SHORT中的一个，表明indices中的值为GL的ubyte和ushort类型。mode表示要创建何种几何元素，其值与DrawArrays命令中的mode一致。

与DrawArrays同样，如果相应的数组使能，在DrawElements命令执行后，那么颜色，法线，点大小，和纹理坐标各个数组将变为不确定性。而没有使能的数组的值将不会做修改。

如果所支持的纹理单元（(MAX _EXTURE_UNITS）的个数为k，要实现客户端状态，其顶点数组包括活动的纹理单元选择器的整型数值，4+k个布尔值，4+k内存指针，4+k个整数步长值，4+k个表示数组类型的常数值和2+k元素值。在初始状态，客户端的活动单元选择器的值为TEXTURE0,　布尔值为false，指针为NULL,步长值为0，元素值为4，对于Common profile来说，type为FLOAT,而Common profile-lite为FIXED。