• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Name
2
3    OES_query_matrix
4
5Name Strings
6
7    GL_OES_query_matrix
8
9Contact
10
11    Kari Pulli, Nokia (kari.pulli 'at' nokia.com)
12
13Notice
14
15    Copyright (c) 2003-2013 The Khronos Group Inc. Copyright terms at
16        http://www.khronos.org/registry/speccopyright.html
17
18Status
19
20    Ratified by the Khronos BOP, July 23, 2003.
21
22Version
23
24    $Date: 2003/07/23 04:23:25 $ $Revision: 1.2 $
25
26Number
27
28    OpenGL ES Extension #16 (formerly OpenGL Extension #296)
29
30Dependencies
31
32    OpenGL 1.3 is required.
33    OES_fixed_point is required.
34
35Overview
36
37    Many applications may need to query the contents and status of the
38    current matrix at least for debugging purposes, especially as the
39    implementations are allowed to implement matrix machinery either in
40    any (possibly proprietary) floating point format, or in a fixed point
41    format that has the range and accuracy of at least 16.16 (signed 16 bit
42    integer part, unsigned 16 bit fractional part).
43
44    This extension is intended to allow application to query the components
45    of the matrix and also their status, regardless whether the internal
46    representation is in fixed point or floating point.
47
48IP Status
49
50    There is no intellectual property associated with this extension.
51
52Issues
53
54    None known.
55
56New Procedures and Functions
57
58    GLbitfield glQueryMatrixxOES( GLfixed mantissa[16],
59                                  GLint   exponent[16] )
60
61    mantissa[16] contains the contents of the current matrix in GLfixed
62    format.  exponent[16] contains the unbiased exponents applied to the
63    matrix components, so that the internal representation of component i
64    is close to mantissa[i] * 2^exponent[i].  The function returns a status
65    word which is zero if all the components are valid. If
66    status & (1<<i) != 0, the component i is invalid (e.g., NaN, Inf).
67    The implementations are not required to keep track of overflows.  In
68    that case, the invalid bits are never set.
69
70New Tokens
71
72    None
73
74Additions to Chapter 2 of the OpenGL 1.3 Specification (OpenGL Operation)
75
76    None
77
78Additions to Chapter 3 of the OpenGL 1.3 Specification (Rasterization)
79
80    None
81
82Additions to Chapter 4 of the OpenGL 1.3 Specification (Per-Fragment
83Operations and the Frame Buffer)
84
85    None
86
87Additions to Chapter 5 of the OpenGL 1.3 Specification (Special Functions)
88
89    None
90
91Additions to Chapter 6 of the OpenGL 1.3 Specification (State and
92State Requests)
93
94    Insert Overview and New Procedures and Functions to become Section 6.1.13.
95
96Additions to Appendix A of the OpenGL 1.3 Specification (Invariance)
97
98    None
99
100Additions to the AGL/GLX/WGL Specifications
101
102GLX Protocol
103
104    QueryMatrixxOES() is mapped to the equivalent protocol for
105    floating-point state queries.  Two queries are required; one to
106    retrieve the current matrix mode and another to retrieve the
107    matrix values.
108
109Dependencies on OES_fixed_point
110
111    OES_fixed_point is required for the GLfixed definition.
112
113Errors
114
115    None
116
117New State
118
119    None
120
121New Implementation Dependent State
122
123    None
124
125Revision History
126
127Apr 15, 2003    Kari Pulli      Created the document
128Jul 08, 2003    David Blythe    Clarified the Dependencies section,
129                                Added extension number
130Jul 12, 2003    David Blythe    Add GLX protocol note
131
132