MESA_shader_debug.spec revision 44d5c8668a43fc06115ea83554bb2249ea4d2c6f 
1Name
2
3    MESA_shader_debug
4
5Name Strings
6
7    GL_MESA_shader_debug
8
9Contact
10
11    Brian Paul (brian.paul 'at' tungstengraphics.com)
12    Michal Krol (mjkrol 'at' gmail.com)
13
14Status
15
16    XXX - Not complete yet!!!
17
18Version
19
20    Last Modified Date: May 29, 2006
21    Author Revision: 0.1
22    $Date: 2006/05/30 09:35:36 $ $Revision: 1.1 $
23
24Number
25
26    TBD
27
28Dependencies
29
30    OpenGL 1.5 is required.
31    The extension is written against the OpenGL 1.5 specification.
32    ARB_shading_language_100 is required.
33    ARB_shader_objects is required.
34    The extension is written against the OpenGL Shading Language
35    1.10 Specification.
36
37Overview
38
39    TBD
40
41IP Status
42
43    None
44
45Issues
46
47    None
48
49New Procedures and Functions
50
51    TBD
52
53New Types
54
55    None
56
57New Tokens
58
59    TBD
60
61Additions to Chapter 2 of the OpenGL 1.5 Specification
62(OpenGL Operation)
63
64    None
65
66Additions to Chapter 3 of the OpenGL 1.5 Specification (Rasterization)
67
68    None
69
70Additions to Chapter 4 of the OpenGL 1.5 Specification (Per-Fragment
71Operations and the Frame Buffer)
72
73    None
74
75Additions to Chapter 5 of the OpenGL 1.5 Specification
76(Special Functions)
77
78    None
79
80Additions to Chapter 6 of the OpenGL 1.5 Specification (State and State
81Requests)
82
83    None
84
85Additions to Appendix A of the OpenGL 1.5 Specification (Invariance)
86
87    None
88
89Additions to Chapter 1 of the OpenGL Shading Language 1.10 Specification
90(Introduction)
91
92    None
93
94Additions to Chapter 2 of the OpenGL Shading Language 1.10 Specification
95(Overview of OpenGL Shading)
96
97    None
98
99Additions to Chapter 3 of the OpenGL Shading Language 1.10 Specification
100(Basics)
101
102    None
103
104Additions to Chapter 4 of the OpenGL Shading Language 1.10 Specification
105(Variables and Types)
106
107    None
108
109Additions to Chapter 5 of the OpenGL Shading Language 1.10 Specification
110(Operators and Expressions)
111
112    None
113
114Additions to Chapter 6 of the OpenGL Shading Language 1.10 Specification
115(Statements and Structure)
116
117    None
118
119Additions to Chapter 7 of the OpenGL Shading Language 1.10 Specification
120(Built-in Variables)
121
122    None
123
124Additions to Chapter 8 of the OpenGL Shading Language 1.10 Specification
125(Built-in Functions)
126
127    Add a new section 8.10 "Debug Functions":
128
129    Debug functions are available to both fragment and vertex shaders.
130    They are used to track the execution of a shader by logging
131    passed-in arguments to the shader's info log. That values can be
132    retrieved and validated by the application after shader execution
133    is complete.
134
135    void printMESA(const float value);
136    void printMESA(const int value);
137    void printMESA(const bool value);
138    void printMESA(const vec2 value);
139    void printMESA(const vec3 value);
140    void printMESA(const vec4 value);
141    void printMESA(const ivec2 value);
142    void printMESA(const ivec3 value);
143    void printMESA(const ivec4 value);
144    void printMESA(const bvec2 value);
145    void printMESA(const bvec3 value);
146    void printMESA(const bvec4 value);
147    void printMESA(const mat2 value);
148    void printMESA(const mat3 value);
149    void printMESA(const mat4 value);
150    void printMESA(const sampler1D value);
151    void printMESA(const sampler2D value);
152    void printMESA(const sampler3D value);
153    void printMESA(const samplerCube value);
154    void printMESA(const sampler1DShadow value);
155    void printMESA(const sampler2DShadow value);
156
157Additions to Chapter 9 of the OpenGL Shading Language 1.10 Specification
158(Shading Language Grammar)
159
160    None
161
162Additions to Chapter 10 of the OpenGL Shading Language 1.10
163Specification (Issues)
164
165    None
166
167Additions to the AGL/EGL/GLX/WGL Specifications
168
169    None
170
171GLX Protocol
172
173    None
174
175Errors
176
177    TBD
178
179New State
180
181    TBD
182
183New Implementation Dependent State
184
185    TBD
186
187Sample Code
188
189    TBD
190
191Revision History
192
193    29 May 2006
194        Initial draft. (Michal Krol)
195