OES_query_matrix

GL_OES_query_matrix

Kari Pulli, Nokia (kari.pulli 'at' nokia.com)

Copyright (c) 2003-2013 The Khronos Group Inc. Copyright terms at
    http://www.khronos.org/registry/speccopyright.html

Khronos-approved extension specifications are updated in response to
issues and bugs prioritized by the Khronos OpenGL ES Working Group. For
extensions which have been promoted to a core Specification, fixes will
first appear in the latest version of that core Specification, and will
eventually be backported to the extension document. This policy is
described in more detail at
    https://www.khronos.org/registry/OpenGL/docs/update_policy.php

Ratified by the Khronos BOP, July 23, 2003.

$Date: 2003/07/23 04:23:25 $ $Revision: 1.2 $

OpenGL ES Extension #16 (formerly OpenGL Extension #296)

OpenGL 1.3 is required.
OES_fixed_point is required.

Many applications may need to query the contents and status of the
current matrix at least for debugging purposes, especially as the
implementations are allowed to implement matrix machinery either in
any (possibly proprietary) floating point format, or in a fixed point
format that has the range and accuracy of at least 16.16 (signed 16 bit
integer part, unsigned 16 bit fractional part).

This extension is intended to allow application to query the components
of the matrix and also their status, regardless whether the internal
representation is in fixed point or floating point.

There is no intellectual property associated with this extension.

None known.

GLbitfield glQueryMatrixxOES( GLfixed mantissa[16],
                              GLint   exponent[16] )

mantissa[16] contains the contents of the current matrix in GLfixed
format.  exponent[16] contains the unbiased exponents applied to the
matrix components, so that the internal representation of component i
is close to mantissa[i] * 2^exponent[i].  The function returns a status
word which is zero if all the components are valid. If
status & (1<<i) != 0, the component i is invalid (e.g., NaN, Inf).
The implementations are not required to keep track of overflows.  In
that case, the invalid bits are never set.

None

None

None

None

None

Insert Overview and New Procedures and Functions to become Section 6.1.13.

None

QueryMatrixxOES() is mapped to the equivalent protocol for
floating-point state queries.  Two queries are required; one to
retrieve the current matrix mode and another to retrieve the
matrix values.

OES_fixed_point is required for the GLfixed definition.

None

None

None