Use is subject to License Terms. Your use of this web site or any of its content or software indicates your agreement to be bound by these License Terms.

Copyright © 2007 Sun Microsystems, Inc. All rights reserved.

javax.microedition.khronos.opengles
Interface GL10Ext

All Superinterfaces:

GL

public interface GL10Ext

extends GL

The GL10Ext interface contains the Java(TM) programming language bindings for the OES_query_matrix extension to OpenGL(R) ES 1.0.

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.0 specification and the OpenGL specification versions it references.

Method Summary

int	glQueryMatrixxOES(int[] mantissa, int mantissaOffset, int[] exponent, int exponentOffset) (OES_query_matrix extension) Return the values of the current matrix.

Method Detail

glQueryMatrixxOES

public int glQueryMatrixxOES(int[] mantissa,
                             int mantissaOffset,
                             int[] exponent,
                             int exponentOffset)

(OES_query_matrix extension) Return the values of the current matrix.

glQueryMatrixxOES returns the values of the current matrix. mantissa returns the 16 mantissa values of the current matrix, and exponent returns the correspnding 16 exponent values. The matrix value i is then close to mantissa[i] * 2^exponent[i].

Use glMatrixMode and glActiveTexture to select the desired matrix to return.

If all are valid (not NaN or Inf), glQueryMatrixxOES returns the status value 0. Otherwise, for every component i which is not valid, the ith bit is set.

Notes

glQueryMatrixxOES is available only if the GL_OES_query_matrix extension is supported by your implementation.

The implementation is not required to keep track of overflows. If overflows are not tracked, the returned status value is always 0.

Associated Gets

glGetString with argument GL_EXTENSIONS.

Parameters:

mantissa - Returns the mantissi of the current matrix.

exponent - Returns the exponents of the current matrix.

mantissaOffset - the starting offset within the mantissa array.

exponentOffset - the starting offset within the exponent array.

Returns:

a bitfield indicating which components contain invalid (NaN or Inf) values.

Throws:

UnsupportedOperationException - if the underlying runtime engine does not support the OES_query_matrix extension.

java.lang.IllegalArgumentException - if mantissa is null.

java.lang.IllegalArgumentException - if exponent is null.

java.lang.IllegalArgumentException - if mantissaOffset is less than 0.

java.lang.IllegalArgumentException - if exponentOffset is less than 0.

java.lang.IllegalArgumentException - if mantissa.length - mantissaOffset is less than 16.

java.lang.IllegalArgumentException - if exponent.length - exponentOffset is less than 16.