GL11Ext

Constant for use with glGet (OES_matrix_palette extension).

Constant for use with glEnableClientState and glDisableClientState (OES_matrix_palette extension).

Constant for use with glGetPointer ( OES_matrix_palette extension).

Constant for use with glGet (OES_matrix_palette extension).

Constant for use with glGet (OES_matrix_palette extension).

Constant for use with glGet (OES_matrix_palette extension).

Constant for use with glMatrixMode ( OES_matrix_palette extension).

Constant for use with glGet (OES_matrix_palette extension).

Constant for use with glGet (OES_matrix_palette extension).

Constant for use with glTexParameter ( OES_draw_texture extension).

Constant for use with glGet (OES_matrix_palette extension).

Constant for use with glEnableClientState and glDisableClientState (OES_matrix_palette extension).

Constant for use with glGetPointer ( OES_matrix_palette extension).

Constant for use with glGet (OES_matrix_palette extension).

Constant for use with glGet (OES_matrix_palette extension).

Constant for use with glGet (OES_matrix_palette extension).

(OES_matrix_palette extension) Defines which of the palette’s matrices is affected by subsequent matrix operations.

glCurrentPaletteMatrixOES defines which of the palette’s matrices is affected by subsequent matrix operations when the current matrix mode is GL_MATRIX_PALETTE_OES.

Errors

GL_INVALID_VALUE is generated if index is not between 0 and GL_MAX_PALETTE_MATRICES_OES - 1.

(OES_draw_texture extension) glDrawTexOES draws a texture rectangle to the screen.

x and y are given directly in window (viewport) coordinates.

z is mapped to window depth Zw as follows:

 If z <= 0 then Zw = n
 If z >= 1 then Zw = f
 Otherwise Zw = n + z * (f - n)
 

width and height specify the width and height of the affected screen rectangle in pixels. These values may be positive or negative; however if either of these are negative, nothing is drawn.

Calling one of the DrawTex functions generates a fragment for each pixel that overlaps the screen rectangle bounded by ( x, y) and (x + width ), (y + height). For each generated fragment, the depth is given by Zw as defined above, and the color by the current color.

Texture coordinates for each texture unit are computed as follows:

Let X and Y be the screen x and y coordinates of each sample point associated with the fragment. Let Wt and Ht be the width and height in texels of the texture currently bound to the texture unit. (If the texture is a mipmap, let Wt and Ht be the dimensions of the level specified by GL_TEXTURE_BASE_LEVEL). Let Ucr, Vcr, Wcr and Hcr be (respectively) the four integers that make up the texture crop rectangle parameter for the currently bound texture. The fragment texture coordinates (s, t, r, q) are given by:

 s = (Ucr + (X - x) * (Wcr / width)) / Wt
 t = (Vcr + (Y - y) * (Hcr / height)) / Ht
 r = 0
 q = 1
 

Notes

In the specific case where X, Y, x and y are all integers, Wcr/width and Hcr/height are both equal to one, the base level is used for the texture read, and fragments are sampled at pixel centers, implementations are required to ensure that the resulting u, v texture indices are also integers. This results in a one-to-one mapping of texels to fragments.

Note that Wcr and/or Hcr can be negative. The formulas given above for s and t still apply in this case. The result is that if Wcr is negative, the source rectangle for glDrawTexOES operations lies to the left of the reference point (Ucr, Vcr) rather than to the right of it, and appears right-to-left reversed on the screen after a call to DrawTex. Similarly, if Hcr is negative, the source rectangle lies below the reference point (Ucr, Vcr) rather than above it, and appears upside-down on the screen.

Note also that s, t, r, and q are computed for each fragment as part of glDrawTexOES rendering. This implies that the texture matrix is ignored and has no effect on the rendered result.

glDrawTexOES is available only if the OES_draw_texture extension is supported by your implementation.

(OES_draw_texture extension) Floating-point Buffer version of glDrawTexOES.

(OES_draw_texture extension) Floating-point array version of glDrawTexOES.

(OES_draw_texture extension) Integer version of glDrawTexOES.

(OES_draw_texture extension) Integer array version of glDrawTexOES.

(OES_draw_texture extension) Integer Buffer version of glDrawTexOES.

(OES_draw_texture extension) Short integer version of glDrawTexOES.

(OES_draw_texture extension) Short integer Buffer version of glDrawTexOES.

(OES_draw_texture extension) Short integer array version of glDrawTexOES.

(OES_draw_texture extension) Fixed-point version of glDrawTexOES.

(OES_draw_texture extension) Fixed-point array version of glDrawTexOES.

(OES_draw_texture extension) Fixed-point Buffer version of glDrawTexOES.

(1.1 + OES_matrix_palette extension) Enable server-side GL capabilities.

The matrix palette extension is enabled if cap assumes the value GL_MATRIX_PALETTE_OES. See glMatrixMode.

(OES_matrix_palette extension) Enable client-side capability.

The OES_matrix_palette extension adds three additional values for array:

• GL_MATRIX_INDEX_ARRAY_OES

  If enabled, the matrix index array is enabled. See glMatrixIndexPointer.

• GL_WEIGHT_ARRAY_OES

  If enabled, the weight array is enabled. See glWeightPointer.

(OES_matrix_palette extension) Copies the current model view matrix to a matrix in the current matrix palette.

glLoadPaletteFromModelViewMatrixOES copies the current model view matrix to a matrix in the current matrix palette, as specified by glCurrentPaletteMatrix.

(OES_matrix_palette extension) Define an array of matrix indices.

glMatrixIndexPointer specifies the location and data of an array of matrix indices to use when rendering. size specifies the number of matrix indices per vertex and type the data type of the coordinates. stride specifies the byte stride from one matrix index to the next, allowing vertices and attributes to be packed into a single array or stored in separate arrays. (Single-array storage may be more efficient on some implementations.)

These matrices indices are used to blend corresponding matrices for a given vertex.

When a matrix index array is specified, size, type, stride, and pointer are saved as client-side state.

If the matrix index array is enabled, it is used when glDrawArrays, or glDrawElements is called. To enable and disable the vertex array, call glEnableClientState and glDisableClientState with the argument GL_MATRIX_INDEX_ARRAY_OES. The matrix index array is initially disabled and isn't accessed when glDrawArrays or glDrawElements is called.

Use glDrawArrays to construct a sequence of primitives (all of the same type) from prespecified vertex and vertex attribute arrays. Use glDrawElements to construct a sequence of primitives by indexing vertices and vertex attributes.

Notes

glMatrixIndexPointer is typically implemented on the client side.

Errors

GL_INVALID_VALUE is generated if size is greater than GL_MAX_VERTEX_UNITS_OES.

GL_INVALID_ENUM is generated if type is is not an accepted value.

GL_INVALID_VALUE is generated if stride is negative.

VBO version of glMatrixIndexPointerOES.

(OES_draw_texture extension) Set texture parameters. The OES_draw_texture extension adds an additoanl value for pname, GL_TEXTURE_CROP_RECT_OES, which sets the texture cropping rectangle for use by glDrawTexOES.

(OES_matrix_palette extension) VBO version of glWeightPointerOES.

(OES_matrix_palette extension) Define an array of weights.

glWeightPointer specifies the location and data of an array of weights to use when rendering. size specifies the number of weights per vertex and type the data type of the coordinates. stride specifies the byte stride from one weight to the next allowing vertices and attributes to be packed into a single array or stored in separate arrays. (Single-array storage may be more efficient on some implementations.)

These weights are used to blend corresponding matrices for a given vertex.

When a weight array is specified, size, type, stride, and pointer are saved as client-side state.

If the weight array is enabled, it is used when glDrawArrays , or glDrawElements is called. To enable and disable the vertex array, call glEnableClientState and glDisableClientState with the argument GL_WEIGHT_ARRAY_OES. The weight array is initially disabled and isn't accessed when glDrawArrays or glDrawElements is called.

Use glDrawArrays to construct a sequence of primitives (all of the same type) from prespecified vertex and vertex attribute arrays. Use glDrawElements to construct a sequence of primitives by indexing vertices and vertex attributes.

Notes

glWeightPointer is typically implemented on the client side.

Errors

GL_INVALID_VALUE is generated if size is greater than GL_MAX_VERTEX_UNITS_OES.

GL_INVALID_ENUM is generated if type is is not an accepted value.

GL_INVALID_VALUE is generated if stride is negative.