1 /*********************************************************************
3 * Copyright 2011 Jose Fonseca
4 * Copyright 2012 Intel Corporation
7 * Permission is hereby granted, free of charge, to any person
8 * obtaining a copy of this software and associated documentation
9 * files (the "Software"), to deal in the Software without
10 * restriction, including without limitation the rights to use, copy,
11 * modify, merge, publish, distribute, sublicense, and/or sell copies
12 * of the Software, and to permit persons to whom the Software is
13 * furnished to do so, subject to the following conditions:
15 * The above copyright notice and this permission notice shall be
16 * included in all copies or substantial portions of the Software.
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
21 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
22 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
23 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
24 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
27 *********************************************************************/
30 #include <limits.h> // for CHAR_MAX
36 #include "os_string.hpp"
37 #include "os_process.hpp"
39 static const char *synopsis = "Dump frame images obtained from a trace.";
44 std::cout << "usage apitrace dump-images [OPTIONS] TRACE_FILE\n"
47 " -h, --help show this help message and exit\n"
48 " --calls=CALLSET dump images only for specified calls\n"
49 " (default value is \"*/frame\" which\n"
50 " which dumps an image for each frame)\n"
51 " -o, --output=PREFIX prefix to use in naming output files\n"
52 " (default is trace filename without extension)\n"
57 CALLS_OPT = CHAR_MAX + 1,
63 const static struct option
65 {"help", no_argument, 0, 'h'},
66 {"calls", required_argument, 0, CALLS_OPT},
67 {"output", required_argument, 0, 'o'},
72 command(int argc, char *argv[])
75 const char *calls, *filename, *output = NULL;
78 while ((opt = getopt_long(argc, argv, shortOptions, longOptions, NULL)) != -1) {
90 std::cerr << "error: unexpected option `" << opt << "`\n";
97 std::cerr << "error: apitrace dump-images requires a trace file as an argument.\n";
102 if (optind < argc - 1) {
103 std::cerr << "error: apitrace dump-images can accept only a single trace file argument.\n";
108 filename = argv[optind];
110 if (output == NULL) {
112 prefix.trimDirectory();
113 prefix.trimExtension();
114 output = prefix.str();
117 /* FIXME: It would be cleaner to pull the replaying of the trace
118 * in-process here and generate the images directly. But that
119 * pulls in a non-trivial amount of the existing 'retrace' code,
120 * along with dependencies on GL, etc.
122 * It will definitely make sense to do that once all that code has
123 * already been pulled in for the "apitrace retrace" (or "apitrace
124 * replay") command. */
125 std::vector<const char *> command;
126 command.push_back("glretrace");
127 command.push_back("-s");
128 command.push_back(output);
129 command.push_back("-S");
131 command.push_back(calls);
133 command.push_back("*/frame");
134 command.push_back(filename);
135 command.push_back(NULL);
137 return os::execute((char * const *)&command[0]);
140 const Command dump_images_command = {