4 (in no particular order)
10 * Allow clamping to a GL version or a number of extensions.
12 * Trace multiple threads:
14 * `GetCurrentThreadId()`
18 * Put zlib (de)compression in a separate thread.
22 * Trace window sizes somehow
24 * Allow to distinguish between the calls really done by the program, vs the
25 fakes one necessary to retrace correctly.
27 * Start tracing on demand (e.g., key-press, or by frame no), emitting calls
28 that recreate all current state.
30 * Add option to include call stack frames in the trace.
32 * Trace the internal GL calls done by GLU on Mac OS X & Windows.
38 * Use visuals that best match those used in the trace; specially auto
39 detect single/double buffer visuals.
41 * Respect multiple context sharing of the traces.
43 * Support multiple threads
45 * Leverage `ARB_debug_output` where available.
55 * Visualize meshes in draw commands.
57 * Breakpointing and step-by-step debugging.
62 * Add retrace Replay all the calls in a trace
63 * Add trim Trim a trace by including only the specified calls/frames
64 * Add dump-state Output the OpenGL state in JSON format
65 * Add dump-images Create image files for each frame/drawing operation of a trace
66 * Add diff Identify differences between a trace dump and another trace
67 * Add diff-state Identify differences between a state dump and another trace
68 * Add diff-images Identify differences between images and another trace
70 * Add some common command-line options:
72 Most commands acting on a trace accept the following common options:
74 --calls=[RANGE] Operate only on calls with index numbers within
77 --frames=[RANGE] Operate only on frames with index numbers within
80 --functions=[REGEXP] Operate only on function calls which have a
81 name that matches the given regular expression.
83 A [RANGE] can be any of the following:
87 4 A single number specifying a single call or frame.
89 10-20 Two numbers separated by '-' (FIRST-LAST) specifying a
90 range of consecutive calls/frames from FIRST to LAST. If
91 either of FIRST or LAST is omitted, the first or last
92 call/frame index in the trace will be used.
94 1-100/5 Either of the above range specifications followed by '@'
95 and a number (INTERVAL). This specifies the inclusion of
96 only each INTERVAL call/frame within the range. For
97 example, 1-100@5 species frame 1, frame 5, frame 10,
100 4,10-20/2 A comma separated list of any of the above range
101 specifications, specifying the union of the ranges.
103 * Add some retrace-specific options (-b, -db, -sb, -v)
105 * Add some trime-specific options (--every={draw,framebuffer,frame})
107 * Accept a filename for --calls or --functions (to use the same calls
108 or functions as present in a trace dump).
110 * Add an "apitrace bisect" for trimming down a trace based on user
113 * Add an "apitrace git-bisect-helper" for calling from git-bisect.
119 * Side-by-side trace diffing; either as a separate tool on or the GUI.
121 * Ability to extract just a single frame from a trace, and all previous calls
122 that contributed to it:
124 * via a state tracker (i.e., knowledge of how calls affect the state);
126 * or by leveragine retrace, dumping the calls to emit all state at beginning
132 * open issues on [github](https://github.com/apitrace/apitrace/issues)
134 * _Known issues_ section in BUGS.markdown
136 * FIXME, TODO, and XXX comments on the source code.