| javax.microedition.khronos.opengles.GL11Ext
All known Subclasses: com.sun.jsr239.GL11Impl,
| GL11Ext | | public interface GL11Ext extends GL(Code) | | The GL11Ext interface contains the Java(TM)
programming language bindings for all optional profile extensions
to OpenGL(R) ES 1.1.
This interface contains constants and methods associated with the
optional profile extensions for OpenGL ES 1.1. The runtime OpenGL
ES engine may or may not implement any particular extensions
defined in the extension pack. Functions that require a particular
extension will throw an UnsupportedOperationException
if the extension is not available at runtime.
The OpenGL ES 1.1 optional profile extensions comprise the
following:
- OES_draw_texture
- OES_matrix_palette
The documentation in this class is normative with respect to
instance variable names and values, method names and signatures,
and exception behavior. The remaining documentation is placed here
for convenience and does not replace the normative documentation
found in the OpenGL ES 1.1 specification and the OpenGL
specification versions it references.
|
| Method Summary | |
| void | glCurrentPaletteMatrixOES(int matrixpaletteindex)
(OES_matrix_palette extension) Defines which of the
palette’s matrices is affected by subsequent matrix operations. | | void | glDrawTexfOES(float x, float y, float z, float width, float height)
(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)
where n and f are the near and far values of
GL_DEPTH_RANGE respectively.
width and height specify the width and
height of the affected screen rectangle in pixels.
| | void | glDrawTexfvOES(float[] coords, int offset)
(OES_draw_texture extension)
Floating-point array version of glDrawTexOES. | | void | glDrawTexfvOES(FloatBuffer coords)
(OES_draw_texture extension)
Floating-point Buffer version of
glDrawTexOES. | | void | glDrawTexiOES(int x, int y, int z, int width, int height)
(OES_draw_texture extension)
Integer version of glDrawTexOES. | | void | glDrawTexivOES(int[] coords, int offset)
(OES_draw_texture extension)
Integer array version of glDrawTexOES. | | void | glDrawTexivOES(IntBuffer coords)
(OES_draw_texture extension)
Integer Buffer version of
glDrawTexOES. | | void | glDrawTexsOES(short x, short y, short z, short width, short height)
(OES_draw_texture extension)
Short integer version of glDrawTexOES. | | void | glDrawTexsvOES(short[] coords, int offset)
(OES_draw_texture extension)
Short integer array version of glDrawTexOES. | | void | glDrawTexsvOES(ShortBuffer coords)
(OES_draw_texture extension)
Short integer Buffer version of
glDrawTexOES. | | void | glDrawTexxOES(int x, int y, int z, int width, int height)
(OES_draw_texture extension)
Fixed-point version of glDrawTexOES. | | void | glDrawTexxvOES(int[] coords, int offset)
(OES_draw_texture extension)
Fixed-point array version of glDrawTexOES. | | void | glDrawTexxvOES(IntBuffer coords)
(OES_draw_texture extension)
Fixed-point Buffer version of
glDrawTexOES. | | void | glEnable(int cap)
(1.1 + OES_matrix_palette extension)
Enable server-side GL capabilities. | | void | glEnableClientState(int array)
(OES_matrix_palette extension)
Enable client-side capability.
The OES_matrix_palette extension adds three
additional values for array:
| | void | glLoadPaletteFromModelViewMatrixOES()
(OES_matrix_palette extension) Copies the current
model view matrix to a matrix in the current matrix palette. | | void | glMatrixIndexPointerOES(int size, int type, int stride, Buffer pointer)
(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.
| | void | glMatrixIndexPointerOES(int size, int type, int stride, int offset)
VBO version of glMatrixIndexPointerOES. | | void | glTexParameterfv(int target, int pname, float[] params, int offset)
(OES_draw_texture extension)
Set texture parameters. | | void | glWeightPointerOES(int size, int type, int stride, Buffer pointer)
(OES_matrix_palette extension) Define an array of weights.
glWeightPointer specifies the location and data
of an array of weights to use when rendering.
| | void | glWeightPointerOES(int size, int type, int stride, int offset)
(OES_matrix_palette extension) VBO version of
glWeightPointerOES. |
| GL_MATRIX_INDEX_ARRAY_BUFFER_BINDING_OES | | int GL_MATRIX_INDEX_ARRAY_BUFFER_BINDING_OES(Code) | | Constant for use with glGet
(OES_matrix_palette extension).
|
| GL_MATRIX_INDEX_ARRAY_OES | | int GL_MATRIX_INDEX_ARRAY_OES(Code) | | Constant for use with glEnableClientState and
glDisableClientState
(OES_matrix_palette extension).
|
| GL_MATRIX_INDEX_ARRAY_POINTER_OES | | int GL_MATRIX_INDEX_ARRAY_POINTER_OES(Code) | | Constant for use with glGetPointer
(OES_matrix_palette extension).
|
| GL_MATRIX_INDEX_ARRAY_SIZE_OES | | int GL_MATRIX_INDEX_ARRAY_SIZE_OES(Code) | | Constant for use with glGet
(OES_matrix_palette extension).
|
| GL_MATRIX_INDEX_ARRAY_STRIDE_OES | | int GL_MATRIX_INDEX_ARRAY_STRIDE_OES(Code) | | Constant for use with glGet
(OES_matrix_palette extension).
|
| GL_MATRIX_INDEX_ARRAY_TYPE_OES | | int GL_MATRIX_INDEX_ARRAY_TYPE_OES(Code) | | Constant for use with glGet
(OES_matrix_palette extension).
|
| GL_MATRIX_PALETTE_OES | | int GL_MATRIX_PALETTE_OES(Code) | | Constant for use with glMatrixMode
(OES_matrix_palette extension).
|
| GL_MAX_PALETTE_MATRICES_OES | | int GL_MAX_PALETTE_MATRICES_OES(Code) | | Constant for use with glGet
(OES_matrix_palette extension).
|
| GL_MAX_VERTEX_UNITS_OES | | int GL_MAX_VERTEX_UNITS_OES(Code) | | Constant for use with glGet
(OES_matrix_palette extension).
|
| GL_TEXTURE_CROP_RECT_OES | | int GL_TEXTURE_CROP_RECT_OES(Code) | | Constant for use with glTexParameter
(OES_draw_texture extension).
|
| GL_WEIGHT_ARRAY_BUFFER_BINDING_OES | | int GL_WEIGHT_ARRAY_BUFFER_BINDING_OES(Code) | | Constant for use with glGet
(OES_matrix_palette extension).
|
| GL_WEIGHT_ARRAY_OES | | int GL_WEIGHT_ARRAY_OES(Code) | | Constant for use with glEnableClientState and
glDisableClientState
(OES_matrix_palette extension).
|
| GL_WEIGHT_ARRAY_POINTER_OES | | int GL_WEIGHT_ARRAY_POINTER_OES(Code) | | Constant for use with glGetPointer
(OES_matrix_palette extension).
|
| GL_WEIGHT_ARRAY_SIZE_OES | | int GL_WEIGHT_ARRAY_SIZE_OES(Code) | | Constant for use with glGet
(OES_matrix_palette extension).
|
| GL_WEIGHT_ARRAY_STRIDE_OES | | int GL_WEIGHT_ARRAY_STRIDE_OES(Code) | | Constant for use with glGet
(OES_matrix_palette extension).
|
| GL_WEIGHT_ARRAY_TYPE_OES | | int GL_WEIGHT_ARRAY_TYPE_OES(Code) | | Constant for use with glGet
(OES_matrix_palette extension).
|
| glCurrentPaletteMatrixOES | | void glCurrentPaletteMatrixOES(int matrixpaletteindex)(Code) | | (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.
Parameters:
matrixpaletteindex - Specifies the index into the palette's matrices.
exception:
UnsupportedOperationException - if the underlyingruntime engine does not support theOES_matrix_palette extension.
|
| glDrawTexfOES | | void glDrawTexfOES(float x, float y, float z, float width, float height)(Code) | | (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)
where n and f are the near and far values of
GL_DEPTH_RANGE respectively.
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.
Parameters:
x - Specifies the x position of the affected screen rectangle.
Parameters:
y - Specifies the x position of the affected screen rectangle.
Parameters:
z - Specifies the x position of the affected screen rectangle.
Parameters:
width - Specifies the width of the affected screen rectanglein pixels.
Parameters:
height - Specifies the height of the affected screenrectangle in pixels.
exception:
UnsupportedOperationException - if theOES_draw_texture extension is not available.
|
| glDrawTexiOES | | void glDrawTexiOES(int x, int y, int z, int width, int height)(Code) | | (OES_draw_texture extension)
Integer version of glDrawTexOES.
exception:
UnsupportedOperationException - if theOES_draw_texture extension is not available. |
| glDrawTexxOES | | void glDrawTexxOES(int x, int y, int z, int width, int height)(Code) | | (OES_draw_texture extension)
Fixed-point version of glDrawTexOES.
exception:
UnsupportedOperationException - if theOES_draw_texture extension is not available. |
| glEnable | | void glEnable(int cap)(Code) | | (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.
See Also: GL11.glEnable(int cap) |
| glEnableClientState | | void glEnableClientState(int array)(Code) | | (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.
See Also: GL11.glEnableClientState(int array) |
| glLoadPaletteFromModelViewMatrixOES | | void glLoadPaletteFromModelViewMatrixOES()(Code) | | (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.
exception:
UnsupportedOperationException - if the underlyingruntime engine does not support theOES_matrix_palette extension.
|
| glMatrixIndexPointerOES | | void glMatrixIndexPointerOES(int size, int type, int stride, Buffer pointer)(Code) | | (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.
Parameters:
size - Specifies the number of matrix indices pervertex. Must be is less than or equal toGL_MAX_VERTEX_UNITS_OES. The initial value is 0.
Parameters:
type - Specifies the data type of each matrix index in thearray. Symbolic constant GL_UNSIGNED_BYTE isaccepted. The initial value is GL_UNSIGNED_BYTE.
Parameters:
stride - Specifies the byte offset between consecutivematrix indices. If stride is 0, the matrix indices are understoodto be tightly packed in the array. The initial value is 0.
Parameters:
pointer - Specifies a buffer containing the first matrixindex of the first vertex in the array. The initial value is 0.
exception:
UnsupportedOperationException - if the underlyingruntime engine does not support theOES_matrix_palette extension.
exception:
IllegalArgumentException - if pointer isnull.
exception:
IllegalStateException - if VBOs are enabled.
|
| glTexParameterfv | | void glTexParameterfv(int target, int pname, float[] params, int offset)(Code) | | (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.
See Also: GL11.glTexParameterfv(int targetint pnamefloat[] paramsint offset) |
| glWeightPointerOES | | void glWeightPointerOES(int size, int type, int stride, Buffer pointer)(Code) | | (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.
Parameters:
size - Specifies the number of weights per vertex. Must beis less than or equal toGL_MAX_VERTEX_UNITS_OES. The initial value is 0.
Parameters:
type - Specifies the data type of each weight in thearray. Symbolic constant GL_FIXED isaccepted. However, the common profile also accepts the symbolicconstant GL_FLOAT as well. The initial value isGL_FIXED for the common lite profile, orGL_FLOAT for the common profile.
Parameters:
stride - Specifies the byte offset between consecutiveweights. If stride is 0, the weights are understoodto be tightly packed in the array. The initial value is 0.
Parameters:
pointer - Specifies a Buffer containing theweights of each vertex in the array. The initial value is 0.
exception:
UnsupportedOperationException - if the underlyingruntime engine does not support theOES_matrix_palette extension.
exception:
IllegalArgumentException - if pointer isnull.
exception:
IllegalStateException - if VBOs are enabled.
|
|
|