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 draw_array_function_names = set([
43 "glDrawArraysIndirect",
44 "glDrawArraysInstanced",
45 "glDrawArraysInstancedARB",
46 "glDrawArraysInstancedEXT",
47 "glDrawMeshArraysSUN",
49 "glMultiDrawArraysEXT",
50 "glMultiModeDrawArraysIBM",
53 draw_elements_function_names = set([
55 "glDrawElementsBaseVertex",
56 "glDrawElementsIndirect",
57 "glDrawElementsInstanced",
58 "glDrawElementsInstancedARB",
59 "glDrawElementsInstancedBaseVertex",
60 "glDrawElementsInstancedEXT",
61 "glDrawRangeElements",
62 "glDrawRangeElementsBaseVertex",
63 "glDrawRangeElementsEXT",
64 #"glMultiDrawElements",
65 #"glMultiDrawElementsBaseVertex",
66 #"glMultiDrawElementsEXT",
67 #"glMultiModeDrawElementsIBM",
70 def call_function(self, function):
71 print ' if (Trace::Parser::version < 1) {'
73 if function.name in self.draw_array_function_names or \
74 function.name in self.draw_elements_function_names:
75 print ' GLint __array_buffer = 0;'
76 print ' glGetIntegerv(GL_ARRAY_BUFFER_BINDING, &__array_buffer);'
77 print ' if (!__array_buffer) {'
78 self.fail_function(function)
81 if function.name in self.draw_elements_function_names:
82 print ' GLint __element_array_buffer = 0;'
83 print ' glGetIntegerv(GL_ELEMENT_ARRAY_BUFFER_BINDING, &__element_array_buffer);'
84 print ' if (!__element_array_buffer) {'
85 self.fail_function(function)
90 if function.name == "glViewport":
91 print ' if (x + width > __window_width) {'
92 print ' __window_width = x + width;'
93 print ' __reshape_window = true;'
95 print ' if (y + height > __window_height) {'
96 print ' __window_height = y + height;'
97 print ' __reshape_window = true;'
100 if function.name == "glEnd":
101 print ' insideGlBeginEnd = false;'
103 Retracer.call_function(self, function)
105 if function.name == "glBegin":
106 print ' insideGlBeginEnd = true;'
108 # glGetError is not allowed inside glBegin/glEnd
109 print ' checkGlError();'
111 pointer_function_names = set([
113 #"glColorPointerEXT",
115 #"glEdgeFlagPointerEXT",
117 #"glFogCoordPointerEXT",
119 #"glIndexPointerEXT",
120 #"glMatrixIndexPointerARB",
122 #"glNormalPointerEXT",
123 "glSecondaryColorPointer",
124 #"glSecondaryColorPointerEXT",
126 #"glTexCoordPointerEXT",
127 #"glVertexAttribLPointer",
128 #"glVertexAttribPointer",
129 #"glVertexAttribPointerARB",
130 #"glVertexAttribPointerNV",
132 #"glVertexPointerEXT",
135 def extract_arg(self, function, arg, arg_type, lvalue, rvalue):
136 if function.name in self.pointer_function_names and arg.name == 'pointer':
137 print ' %s = %s.blob();' % (lvalue, rvalue)
140 if function.name in self.draw_elements_function_names and arg.name == 'indices':
141 print ' %s = %s.blob();' % (lvalue, rvalue)
144 if function.name.startswith('glUniform') and function.args[0].name == arg.name == 'location':
145 print ' GLint program = -1;'
146 print ' glGetIntegerv(GL_CURRENT_PROGRAM, &program);'
148 Retracer.extract_arg(self, function, arg, arg_type, lvalue, rvalue)
151 if __name__ == '__main__':
159 #include "glproc.hpp"
162 static bool double_buffer = false;
163 static bool insideGlBeginEnd = false;
165 static int __window_width = 256, __window_height = 256;
166 bool __reshape_window = false;
168 unsigned __frame = 0;
169 long long __startTime = 0;
172 bool __benchmark = false;
173 const char *__compare_prefix = NULL;
174 const char *__snapshot_prefix = NULL;
179 if (__benchmark || insideGlBeginEnd) {
183 GLenum error = glGetError();
184 if (error == GL_NO_ERROR) {
188 std::cerr << "warning: glGetError() = ";
190 case GL_INVALID_ENUM:
191 std::cerr << "GL_INVALID_ENUM";
193 case GL_INVALID_VALUE:
194 std::cerr << "GL_INVALID_VALUE";
196 case GL_INVALID_OPERATION:
197 std::cerr << "GL_INVALID_OPERATION";
199 case GL_STACK_OVERFLOW:
200 std::cerr << "GL_STACK_OVERFLOW";
202 case GL_STACK_UNDERFLOW:
203 std::cerr << "GL_STACK_UNDERFLOW";
205 case GL_OUT_OF_MEMORY:
206 std::cerr << "GL_OUT_OF_MEMORY";
208 case GL_INVALID_FRAMEBUFFER_OPERATION:
209 std::cerr << "GL_INVALID_FRAMEBUFFER_OPERATION";
211 case GL_TABLE_TOO_LARGE:
212 std::cerr << "GL_TABLE_TOO_LARGE";
222 retracer = GlRetracer()
223 retracer.retrace_api(glapi.glapi)
226 static Trace::Parser parser;
228 static void display_noop(void) {
233 static void snapshot(Image::Image &image) {
234 GLint drawbuffer = double_buffer ? GL_BACK : GL_FRONT;
235 GLint readbuffer = double_buffer ? GL_BACK : GL_FRONT;
236 glGetIntegerv(GL_READ_BUFFER, &drawbuffer);
237 glGetIntegerv(GL_READ_BUFFER, &readbuffer);
238 glReadBuffer(drawbuffer);
239 glReadPixels(0, 0, image.width, image.height, GL_RGBA, GL_UNSIGNED_BYTE, image.pixels);
241 glReadBuffer(readbuffer);
244 static void frame_complete(void) {
247 if (!__reshape_window && (__snapshot_prefix || __compare_prefix)) {
248 Image::Image *ref = NULL;
249 if (__compare_prefix) {
250 char filename[PATH_MAX];
251 snprintf(filename, sizeof filename, "%s%04u.png", __compare_prefix, __frame);
252 ref = Image::readPNG(filename);
257 std::cout << "Read " << filename << "\n";
260 Image::Image src(__window_width, __window_height, true);
263 if (__snapshot_prefix) {
264 char filename[PATH_MAX];
265 snprintf(filename, sizeof filename, "%s%04u.png", __snapshot_prefix, __frame);
266 if (src.writePNG(filename) && verbosity >= 0) {
267 std::cout << "Wrote " << filename << "\n";
272 std::cout << "Frame " << __frame << " average precision of " << src.compare(*ref) << " bits\n";
279 static void display(void) {
282 while ((call = parser.parse_call())) {
283 const std::string &name = call->name();
285 if ((name[0] == 'w' && name[1] == 'g' && name[2] == 'l') ||
286 (name[0] == 'g' && name[1] == 'l' && name[2] == 'X')) {
287 // XXX: We ignore the majority of the OS-specific calls for now
288 if (name == "glXSwapBuffers" ||
289 name == "wglSwapBuffers") {
301 if (name == "glFlush") {
302 if (!double_buffer) {
313 // Reached the end of trace
316 long long endTime = OS::GetTime();
317 float timeInterval = (endTime - __startTime) * 1.0E-6;
320 "Rendered " << __frame << " frames"
321 " in " << timeInterval << " secs,"
322 " average of " << (__frame/timeInterval) << " fps\n";
325 glutDisplayFunc(&display_noop);
332 static void idle(void) {
333 if (__reshape_window) {
334 // XXX: doesn't quite work
335 glutReshapeWindow(__window_width, __window_height);
336 __reshape_window = false;
341 static void usage(void) {
343 "Usage: glretrace [OPTION] TRACE\n"
346 " -b benchmark (no glgeterror; no messages)\n"
347 " -c PREFIX compare against snapshots\n"
348 " -db use a double buffer visual\n"
349 " -s PREFIX take snapshots\n"
350 " -v verbose output\n";
353 int main(int argc, char **argv)
357 for (i = 1; i < argc; ++i) {
358 const char *arg = argv[i];
364 if (!strcmp(arg, "--")) {
366 } else if (!strcmp(arg, "-b")) {
369 } else if (!strcmp(arg, "-c")) {
370 __compare_prefix = argv[++i];
371 } else if (!strcmp(arg, "-db")) {
372 double_buffer = true;
373 } else if (!strcmp(arg, "--help")) {
376 } else if (!strcmp(arg, "-s")) {
377 __snapshot_prefix = argv[++i];
378 } else if (!strcmp(arg, "-v")) {
380 } else if (!strcmp(arg, "-w")) {
383 std::cerr << "error: unknown option " << arg << "\n";
389 glutInit(&argc, argv);
390 glutInitWindowPosition(0, 0);
391 glutInitWindowSize(__window_width, __window_height);
392 glutInitDisplayMode(GLUT_DEPTH | GLUT_RGB | (double_buffer ? GLUT_DOUBLE : GLUT_SINGLE));
393 glutCreateWindow(argv[0]);
395 glutDisplayFunc(&display);
398 for (GLuint h = 0; h < 1024; ++h) {
402 for ( ; i < argc; ++i) {
403 if (parser.open(argv[i])) {
404 __startTime = OS::GetTime();