1 ##########################################################################
3 # Copyright 2010 VMware, Inc.
6 # Permission is hereby granted, free of charge, to any person obtaining a copy
7 # of this software and associated documentation files (the "Software"), to deal
8 # in the Software without restriction, including without limitation the rights
9 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 # copies of the Software, and to permit persons to whom the Software is
11 # furnished to do so, subject to the following conditions:
13 # The above copyright notice and this permission notice shall be included in
14 # all copies or substantial portions of the Software.
16 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
24 ##########################################################################/
27 """GL retracer generator."""
32 from retrace import Retracer
35 class GlRetracer(Retracer):
37 def retrace_function(self, function):
38 Retracer.retrace_function(self, function)
40 array_pointer_function_names = set((
48 "glSecondaryColorPointer",
50 "glInterleavedArrays",
56 "glTexCoordPointerEXT",
57 "glEdgeFlagPointerEXT",
58 "glFogCoordPointerEXT",
59 "glSecondaryColorPointerEXT",
61 "glVertexAttribPointer",
62 "glVertexAttribPointerARB",
63 "glVertexAttribPointerNV",
64 "glVertexAttribIPointer",
65 "glVertexAttribIPointerEXT",
66 "glVertexAttribLPointer",
67 "glVertexAttribLPointerEXT",
69 #"glMatrixIndexPointerARB",
72 draw_array_function_names = set([
75 "glDrawArraysIndirect",
76 "glDrawArraysInstanced",
77 "glDrawArraysInstancedARB",
78 "glDrawArraysInstancedEXT",
79 "glDrawMeshArraysSUN",
81 "glMultiDrawArraysEXT",
82 "glMultiModeDrawArraysIBM",
85 draw_elements_function_names = set([
87 "glDrawElementsBaseVertex",
88 "glDrawElementsIndirect",
89 "glDrawElementsInstanced",
90 "glDrawElementsInstancedARB",
91 "glDrawElementsInstancedBaseVertex",
92 "glDrawElementsInstancedEXT",
93 "glDrawRangeElements",
94 "glDrawRangeElementsBaseVertex",
95 "glDrawRangeElementsEXT",
96 "glMultiDrawElements",
97 "glMultiDrawElementsBaseVertex",
98 "glMultiDrawElementsEXT",
99 "glMultiModeDrawElementsIBM",
102 misc_draw_function_names = set([
107 "glBlitFramebufferEXT",
110 bind_framebuffer_function_names = set([
112 "glBindFramebufferARB",
113 "glBindFramebufferEXT",
116 def retrace_function_body(self, function):
117 is_array_pointer = function.name in self.array_pointer_function_names
118 is_draw_array = function.name in self.draw_array_function_names
119 is_draw_elements = function.name in self.draw_elements_function_names
120 is_misc_draw = function.name in self.misc_draw_function_names
122 if is_array_pointer or is_draw_array or is_draw_elements:
123 print ' if (glretrace::parser.version < 1) {'
125 if is_array_pointer or is_draw_array:
126 print ' GLint __array_buffer = 0;'
127 print ' glGetIntegerv(GL_ARRAY_BUFFER_BINDING, &__array_buffer);'
128 print ' if (!__array_buffer) {'
129 self.fail_function(function)
133 print ' GLint __element_array_buffer = 0;'
134 print ' glGetIntegerv(GL_ELEMENT_ARRAY_BUFFER_BINDING, &__element_array_buffer);'
135 print ' if (!__element_array_buffer) {'
136 self.fail_function(function)
142 if function.name in self.bind_framebuffer_function_names:
143 print ' if (glretrace::snapshot_frequency == glretrace::FREQUENCY_FRAMEBUFFER) {'
144 print ' glretrace::snapshot(call.no - 1);'
147 Retracer.retrace_function_body(self, function)
150 if function.name in ('glFlush', 'glFinish'):
151 print ' if (!glretrace::double_buffer) {'
152 print ' glretrace::frame_complete(call.no);'
154 if function.name == 'glReadPixels':
156 print ' if (glretrace::snapshot_frequency == glretrace::FREQUENCY_FRAME ||'
157 print ' glretrace::snapshot_frequency == glretrace::FREQUENCY_FRAMEBUFFER) {'
158 print ' glretrace::snapshot(call.no);'
160 if is_draw_array or is_draw_elements or is_misc_draw:
161 print ' if (glretrace::snapshot_frequency == glretrace::FREQUENCY_DRAW) {'
162 print ' glretrace::snapshot(call.no);'
166 def call_function(self, function):
167 if function.name == "glViewport":
168 print ' if (glretrace::drawable) {'
169 print ' int drawable_width = x + width;'
170 print ' int drawable_height = y + height;'
171 print ' if (drawable_width > (int)glretrace::drawable->width ||'
172 print ' drawable_height > (int)glretrace::drawable->height) {'
173 print ' glretrace::drawable->resize(drawable_width, drawable_height);'
174 print ' if (!glretrace::drawable->visible) {'
175 print ' glretrace::drawable->show();'
177 print ' glScissor(0, 0, drawable_width, drawable_height);'
181 if function.name == "glEnd":
182 print ' glretrace::insideGlBeginEnd = false;'
184 if function.name == 'memcpy':
185 print ' if (!dest || !src || !n) return;'
187 Retracer.call_function(self, function)
190 if function.name == "glBegin":
191 print ' glretrace::insideGlBeginEnd = true;'
192 elif function.name.startswith('gl'):
193 # glGetError is not allowed inside glBegin/glEnd
194 print ' if (!glretrace::benchmark && !glretrace::insideGlBeginEnd) {'
195 print ' glretrace::checkGlError(call);'
196 if function.name in ('glProgramStringARB', 'glProgramStringNV'):
197 print r' GLint error_position = -1;'
198 print r' glGetIntegerv(GL_PROGRAM_ERROR_POSITION_ARB, &error_position);'
199 print r' if (error_position != -1) {'
200 print r' const char *error_string = (const char *)glGetString(GL_PROGRAM_ERROR_STRING_ARB);'
201 print r' std::cerr << call.no << ": warning: " << error_string << "\n";'
203 if function.name == 'glCompileShader':
204 print r' GLint compile_status = 0;'
205 print r' glGetShaderiv(shader, GL_COMPILE_STATUS, &compile_status);'
206 print r' if (!compile_status) {'
207 print r' GLint info_log_length = 0;'
208 print r' glGetShaderiv(shader, GL_INFO_LOG_LENGTH, &info_log_length);'
209 print r' GLchar *infoLog = new GLchar[info_log_length];'
210 print r' glGetShaderInfoLog(shader, info_log_length, NULL, infoLog);'
211 print r' std::cerr << call.no << ": warning: " << infoLog << "\n";'
212 print r' delete [] infoLog;'
214 if function.name == 'glLinkProgram':
215 print r' GLint link_status = 0;'
216 print r' glGetProgramiv(program, GL_LINK_STATUS, &link_status);'
217 print r' if (!link_status) {'
218 print r' GLint info_log_length = 0;'
219 print r' glGetProgramiv(program, GL_INFO_LOG_LENGTH, &info_log_length);'
220 print r' GLchar *infoLog = new GLchar[info_log_length];'
221 print r' glGetProgramInfoLog(program, info_log_length, NULL, infoLog);'
222 print r' std::cerr << call.no << ": warning: " << infoLog << "\n";'
223 print r' delete [] infoLog;'
225 if function.name == 'glCompileShaderARB':
226 print r' GLint compile_status = 0;'
227 print r' glGetObjectParameterivARB(shaderObj, GL_OBJECT_COMPILE_STATUS_ARB, &compile_status);'
228 print r' if (!compile_status) {'
229 print r' GLint info_log_length = 0;'
230 print r' glGetObjectParameterivARB(shaderObj, GL_OBJECT_INFO_LOG_LENGTH_ARB, &info_log_length);'
231 print r' GLchar *infoLog = new GLchar[info_log_length];'
232 print r' glGetInfoLogARB(shaderObj, info_log_length, NULL, infoLog);'
233 print r' std::cerr << call.no << ": warning: " << infoLog << "\n";'
234 print r' delete [] infoLog;'
236 if function.name == 'glLinkProgramARB':
237 print r' GLint link_status = 0;'
238 print r' glGetObjectParameterivARB(programObj, GL_OBJECT_LINK_STATUS_ARB, &link_status);'
239 print r' if (!link_status) {'
240 print r' GLint info_log_length = 0;'
241 print r' glGetObjectParameterivARB(programObj, GL_OBJECT_INFO_LOG_LENGTH_ARB, &info_log_length);'
242 print r' GLchar *infoLog = new GLchar[info_log_length];'
243 print r' glGetInfoLogARB(programObj, info_log_length, NULL, infoLog);'
244 print r' std::cerr << call.no << ": warning: " << infoLog << "\n";'
245 print r' delete [] infoLog;'
247 if function.name in ('glMapBuffer', 'glMapBufferARB', 'glMapBufferRange', 'glMapNamedBufferEXT', 'glMapNamedBufferRangeEXT'):
248 print r' if (!__result) {'
249 print r' std::cerr << call.no << ": warning: failed to map buffer\n";'
251 if function.name in ('glGetAttribLocation', 'glGetAttribLocationARB'):
252 print r' GLint __orig_result = call.ret->toSInt();'
253 print r' if (__result != __orig_result) {'
254 print r' std::cerr << call.no << ": warning vertex attrib location mismatch " << __orig_result << " -> " << __result << "\n";'
256 if function.name in ('glCheckFramebufferStatus', 'glCheckFramebufferStatusEXT', 'glCheckNamedFramebufferStatusEXT'):
257 print r' GLint __orig_result = call.ret->toSInt();'
258 print r' if (__orig_result == GL_FRAMEBUFFER_COMPLETE &&'
259 print r' __result != GL_FRAMEBUFFER_COMPLETE) {'
260 print r' std::cerr << call.no << ": incomplete framebuffer (" << __result << ")\n";'
264 def extract_arg(self, function, arg, arg_type, lvalue, rvalue):
265 if function.name in self.array_pointer_function_names and arg.name == 'pointer':
266 print ' %s = static_cast<%s>(%s.toPointer());' % (lvalue, arg_type, rvalue)
269 if function.name in self.draw_elements_function_names and arg.name == 'indices':
270 self.extract_opaque_arg(function, arg, arg_type, lvalue, rvalue)
273 if arg.type is glapi.GLlocation \
274 and 'program' not in [arg.name for arg in function.args]:
275 print ' GLint program = -1;'
276 print ' glGetIntegerv(GL_CURRENT_PROGRAM, &program);'
278 if arg.type is glapi.GLlocationARB \
279 and 'programObj' not in [arg.name for arg in function.args]:
280 print ' GLhandleARB programObj = glGetHandleARB(GL_PROGRAM_OBJECT_ARB);'
282 Retracer.extract_arg(self, function, arg, arg_type, lvalue, rvalue)
284 # Don't try to use more samples than the implementation supports
285 if arg.name == 'samples':
286 assert arg.type is glapi.GLsizei
287 print ' GLint max_samples = 0;'
288 print ' glGetIntegerv(GL_MAX_SAMPLES, &max_samples);'
289 print ' if (samples > max_samples) {'
290 print ' samples = max_samples;'
294 if __name__ == '__main__':
298 #include "glproc.hpp"
299 #include "glretrace.hpp"
304 api.add_function(glapi.memcpy)
305 retracer = GlRetracer()
306 retracer.retrace_api(api)