]> git.cworth.org Git - apitrace/blob - glretrace_main.cpp
Add a few comments/links to Cocoa development resources.
[apitrace] / glretrace_main.cpp
1 /**************************************************************************
2  *
3  * Copyright 2011 Jose Fonseca
4  * All Rights Reserved.
5  *
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:
12  *
13  * The above copyright notice and this permission notice shall be included in
14  * all copies or substantial portions of the Software.
15  *
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
22  * THE SOFTWARE.
23  *
24  **************************************************************************/
25
26
27 #include <string.h>
28
29 #include "image.hpp"
30 #include "retrace.hpp"
31 #include "glproc.hpp"
32 #include "glstate.hpp"
33 #include "glretrace.hpp"
34
35
36 namespace glretrace {
37
38 bool double_buffer = true;
39 bool insideGlBeginEnd = false;
40 Trace::Parser parser;
41 glws::Visual *visual = NULL;
42 glws::Drawable *drawable = NULL;
43 glws::Context *context = NULL;
44
45 unsigned frame = 0;
46 long long startTime = 0;
47 bool wait = false;
48
49 bool benchmark = false;
50 const char *compare_prefix = NULL;
51 const char *snapshot_prefix = NULL;
52 enum frequency snapshot_frequency = FREQUENCY_NEVER;
53
54 unsigned dump_state = ~0;
55
56 void
57 checkGlError(Trace::Call &call) {
58     GLenum error = glGetError();
59     if (error == GL_NO_ERROR) {
60         return;
61     }
62
63     std::ostream & os = retrace::warning(call);
64
65     os << "glGetError(";
66     os << call.name();
67     os << ") = ";
68
69     switch (error) {
70     case GL_INVALID_ENUM:
71         os << "GL_INVALID_ENUM";
72         break;
73     case GL_INVALID_VALUE:
74         os << "GL_INVALID_VALUE";
75         break;
76     case GL_INVALID_OPERATION:
77         os << "GL_INVALID_OPERATION";
78         break;
79     case GL_STACK_OVERFLOW:
80         os << "GL_STACK_OVERFLOW";
81         break;
82     case GL_STACK_UNDERFLOW:
83         os << "GL_STACK_UNDERFLOW";
84         break;
85     case GL_OUT_OF_MEMORY:
86         os << "GL_OUT_OF_MEMORY";
87         break;
88     case GL_INVALID_FRAMEBUFFER_OPERATION:
89         os << "GL_INVALID_FRAMEBUFFER_OPERATION";
90         break;
91     case GL_TABLE_TOO_LARGE:
92         os << "GL_TABLE_TOO_LARGE";
93         break;
94     default:
95         os << error;
96         break;
97     }
98     os << "\n";
99 }
100
101 /**
102  * Grow the current drawble.
103  *
104  * We need to infer the drawable size from GL calls because the drawable sizes
105  * are specified by OS specific calls which we do not trace.
106  */
107 void
108 updateDrawable(int width, int height) {
109     if (!drawable) {
110         return;
111     }
112
113     if (width  <= glretrace::drawable->width &&
114         height <= glretrace::drawable->height) {
115         return;
116     }
117
118     // Check for bound framebuffer last, as this may have a performance impact.
119     GLint draw_framebuffer = 0;
120     glGetIntegerv(GL_DRAW_FRAMEBUFFER_BINDING, &draw_framebuffer);
121     if (draw_framebuffer != 0) {
122         return;
123     }
124
125     glretrace::drawable->resize(width, height);
126     if (!drawable->visible) {
127         drawable->show();
128     }
129     glScissor(0, 0, width, height);
130 }
131
132
133 void snapshot(unsigned call_no) {
134     if (!drawable ||
135         (!snapshot_prefix && !compare_prefix)) {
136         return;
137     }
138
139     Image::Image *ref = NULL;
140
141     if (compare_prefix) {
142         char filename[PATH_MAX];
143         snprintf(filename, sizeof filename, "%s%010u.png", compare_prefix, call_no);
144         ref = Image::readPNG(filename);
145         if (!ref) {
146             return;
147         }
148         if (retrace::verbosity >= 0) {
149             std::cout << "Read " << filename << "\n";
150         }
151     }
152
153     Image::Image *src = glstate::getDrawBufferImage(GL_RGBA);
154     if (!src) {
155         return;
156     }
157
158     if (snapshot_prefix) {
159         if (snapshot_prefix[0] == '-' && snapshot_prefix[1] == 0) {
160             char comment[21];
161             snprintf(comment, sizeof comment, "%u", call_no);
162             src->writePNM(std::cout, comment);
163         } else {
164             char filename[PATH_MAX];
165             snprintf(filename, sizeof filename, "%s%010u.png", snapshot_prefix, call_no);
166             if (src->writePNG(filename) && retrace::verbosity >= 0) {
167                 std::cout << "Wrote " << filename << "\n";
168             }
169         }
170     }
171
172     if (ref) {
173         std::cout << "Snapshot " << call_no << " average precision of " << src->compare(*ref) << " bits\n";
174         delete ref;
175     }
176
177     delete src;
178 }
179
180
181 void frame_complete(unsigned call_no) {
182     ++frame;
183
184     if (snapshot_frequency == FREQUENCY_FRAME ||
185         snapshot_frequency == FREQUENCY_FRAMEBUFFER) {
186         snapshot(call_no);
187     }
188 }
189
190
191 static void display(void) {
192     retrace::Retracer retracer;
193
194     retracer.addCallbacks(gl_callbacks);
195     retracer.addCallbacks(glx_callbacks);
196     retracer.addCallbacks(wgl_callbacks);
197     retracer.addCallbacks(cgl_callbacks);
198
199     startTime = OS::GetTime();
200     Trace::Call *call;
201
202     while ((call = parser.parse_call())) {
203         retracer.retrace(*call);
204
205         if (!insideGlBeginEnd &&
206             drawable && context &&
207             call->no >= dump_state) {
208             glstate::dumpCurrentContext(std::cout);
209             exit(0);
210         }
211
212         delete call;
213     }
214
215     // Reached the end of trace
216     glFlush();
217
218     long long endTime = OS::GetTime();
219     float timeInterval = (endTime - startTime) * 1.0E-6;
220
221     if (retrace::verbosity >= -1) { 
222         std::cout << 
223             "Rendered " << frame << " frames"
224             " in " <<  timeInterval << " secs,"
225             " average of " << (frame/timeInterval) << " fps\n";
226     }
227
228     if (wait) {
229         while (glws::processEvents()) {}
230     } else {
231         exit(0);
232     }
233 }
234
235
236 static void usage(void) {
237     std::cout << 
238         "Usage: glretrace [OPTION] TRACE\n"
239         "Replay TRACE.\n"
240         "\n"
241         "  -b           benchmark mode (no error checking or warning messages)\n"
242         "  -c PREFIX    compare against snapshots\n"
243         "  -db          use a double buffer visual (default)\n"
244         "  -sb          use a single buffer visual\n"
245         "  -s PREFIX    take snapshots; `-` for PNM stdout output\n"
246         "  -S FREQUENCY snapshot frequency: frame (default), framebuffer, or draw\n"
247         "  -v           verbose output\n"
248         "  -D CALLNO    dump state at specific call no\n"
249         "  -w           wait on final frame\n";
250 }
251
252 extern "C"
253 int main(int argc, char **argv)
254 {
255
256     int i;
257     for (i = 1; i < argc; ++i) {
258         const char *arg = argv[i];
259
260         if (arg[0] != '-') {
261             break;
262         }
263
264         if (!strcmp(arg, "--")) {
265             break;
266         } else if (!strcmp(arg, "-b")) {
267             benchmark = true;
268             retrace::verbosity = -1;
269             glws::debug = false;
270         } else if (!strcmp(arg, "-c")) {
271             compare_prefix = argv[++i];
272             if (snapshot_frequency == FREQUENCY_NEVER) {
273                 snapshot_frequency = FREQUENCY_FRAME;
274             }
275         } else if (!strcmp(arg, "-D")) {
276             dump_state = atoi(argv[++i]);
277             retrace::verbosity = -2;
278         } else if (!strcmp(arg, "-db")) {
279             double_buffer = true;
280         } else if (!strcmp(arg, "-sb")) {
281             double_buffer = false;
282         } else if (!strcmp(arg, "--help")) {
283             usage();
284             return 0;
285         } else if (!strcmp(arg, "-s")) {
286             snapshot_prefix = argv[++i];
287             if (snapshot_frequency == FREQUENCY_NEVER) {
288                 snapshot_frequency = FREQUENCY_FRAME;
289             }
290             if (snapshot_prefix[0] == '-' && snapshot_prefix[1] == 0) {
291                 retrace::verbosity = -2;
292             }
293         } else if (!strcmp(arg, "-S")) {
294             arg = argv[++i];
295             if (!strcmp(arg, "frame")) {
296                 snapshot_frequency = FREQUENCY_FRAME;
297             } else if (!strcmp(arg, "framebuffer")) {
298                 snapshot_frequency = FREQUENCY_FRAMEBUFFER;
299             } else if (!strcmp(arg, "draw")) {
300                 snapshot_frequency = FREQUENCY_DRAW;
301             } else {
302                 std::cerr << "error: unknown frequency " << arg << "\n";
303                 usage();
304                 return 1;
305             }
306             if (snapshot_prefix == NULL) {
307                 snapshot_prefix = "";
308             }
309         } else if (!strcmp(arg, "-v")) {
310             ++retrace::verbosity;
311         } else if (!strcmp(arg, "-w")) {
312             wait = true;
313         } else {
314             std::cerr << "error: unknown option " << arg << "\n";
315             usage();
316             return 1;
317         }
318     }
319
320     glws::init();
321     visual = glws::createVisual(double_buffer);
322
323     for ( ; i < argc; ++i) {
324         if (!parser.open(argv[i])) {
325             std::cerr << "error: failed to open " << argv[i] << "\n";
326             return 1;
327         }
328
329         display();
330
331         parser.close();
332     }
333     
334     delete visual;
335     glws::cleanup();
336
337     return 0;
338 }
339
340 } /* namespace glretrace */