trim: Close some memory leaks.

The parse_call() function allocates an object and returns a pointer,
so we need to explicitly call delete on that object.

trim: Trim most drawing operations outside of the user-specified range

Care is taken to consider a glBegin/glEnd block as a single drawing
operation, (so that it will enitrely included or entirely trimmed).

We're also careful to avoid trimming any drawing operation when there
are active side effects (other than rendering to the default
framebuffer). For example, if there is an active binding of
GL_FRAMEBUFFER or GL_DRAW_FRAMEBUFFER to any buffer object, or if we
are withing a glBeginTransformFeedback/glEndTransformFeedback block;
in any of these cases the drawing operation will not be trimmed.

trim: Avoid doing any analysis past the end of the user-specified range.

This doesn't actually change any results, (the dependency analysis
already ensures that calls beyond the range won't get included).

But this is a nice optimization to prevent wasted time and memory
analyzing these calls that are really easy to reject.

trim: Add a more condensed usage message for error cases.

When explicitly asking for help, ("apitrace help trim" or "apitrace
trim --help"), the complete help message is still provided.

But when an error case triggers a usage message, (such as an invalid
command-line argument), a more compact usage message is provided so as
to not overwhelm the error message (such as "invalid argument:
--foo").

trim: Prune uninteresting calls while trimming (unless --no-prune is passed)

Examine the CALL_FLAG_UNINTERESTING flag and leave out these calls
when trimming. These calls are generally the calls that have no side
effects, (such as query functions). Some calls without side effects
might be considered interesting, (such as glGetError returning a
non-zero error).

This pruning behavior can be avoided by passing the new --no-prune
option (or the new --exact option which is identical to passing both
--no-prune and -no-deps).

trim: Complain if given extraneous arguments.

Previously additional arguments were silently ignored, (which can lead
to confusion if the user expects to be able to specify a bare callset
on the command line rather than specifying a --calls option).

trim: Add framework for performing dependency analysis while trimming

The current analysis is as brain-dead as possible. All calls are
interpreted as affecting the current "state" resource, and all calls
are also interpreted as depending on the current "state". In other
words, no calls at all will be trimmed. Obviously, this is not useful
analysis, but all the framewok is now present for easily doing more
interesting things.

A new --no-deps option is now made available to "apitrace trim" so
that users can avoid all dependency analysis and still get the prior
behavior where only calls explicitly included in the --calls option
are included in the trim output.

docs: Eliminate most references to glretrace.

cli_retrace: Forward all options to retrace program.

cli: Auto-detect retrace for dump-images too.

cli: Guess the retrace excutable adequate for the trace.

d3d10,d3d11: Take the UpdateSubresource box in full consideration.

Merge branch 'union-type'

dump: Pretty print anonymous structure members.

d3d10/d3d11: Complete union support.

d3d10: Add missing flags.

dxgi: Support tracng DWM process.

d3dretrace: Dump d3d10 snapshots too.

d3d10/d3d10_1: Expose DXGI entrypoints.

specs: Initial attempt to support unions.

d3d10/d3d11: Use consistent members for buffer views.

cli: Rename replay -> retrace.

For consistency with the current terminology.

cli: Rename replay -> retrace.

For consistency with the current terminology.

cli: Add a simple "apitrace replay" sub-command.

This calls out to glretrace in order to replay a trace. Currently it
only supports the -w,--wait option, (and not yet any of the profiling
support).

With this command and the existing "apitrace dump-images", we're quite
close to being able to relegate glretrace to an implementation detail
used by the apitrace program, (such that soon, it won't be necessary
to provide glretrace on the user's PATH).

dump-images: Execute glretrace from source dir when running uninstalled

Previously, we've had code to carefully find wrappers and scripts
relative to an apitrace binary being run from an uninstalled
directory. This is extremely useful while testing an experimental
feature before installing said experimental code.

Similarly, provide a findProgram function to do the same thing for an
executable program and use it within "apitrace dump-images" when
invoking glretrace.

Move trace::findWrapper to trace_resource.cpp

It's not actually used outside of trace_tools_trace.cpp, but it is so
similar to the existing trace::findScript in trace_resource.cpp that
there are benefits to having them defined in the same file.

d3d: And d3dcommonsize.hpp too.

sigh..

d3d8: Add missing d3d8size.hpp file.

d3d8: Update specs to match d3d9.

And vice versa.

pickle: Try to silence clang warnings.

gltrace: Rely on polymorphism for indices instead of special case.

gltrace: Respect length argument in glShaderSource(ARB)

tracediff: Merge tracediff2.py and tracediff.py

doc: Update examples to use call 0.

Call numbers start from 0, but examples gave the impression it started
from call 1.

d3d11: Ensure IDXGIFactory1 interface is not forgotten.

specs: Mark CheckMultisampleQualityLevels as no side effects / verbose.

d3d11: Several spec fixes.

retrace: Use different methods for writing int/floats.

More efficient code, less compiler warnings.

gui: Silence unused var warning.

os: Fix thread copy constructor.

retrace: Fix MSVC build.

d3dretrace: More robust against DXGI missing calls.

parse: More flags.

d3dretrace: Basic D3D11 snap-shooting.

parse: recognize more rendering calls.

retrace: Allow multiple dumpers to co-exist.

d3d11: Fix map swizlling.

Merge branch 'modules'

Update use/mention of options.

glretrace: Use getopt rather than manual parsing of command-line options

This allows for better consistency with other apitrace command-line
interface. It also provids for several new full-name options where
previously only a single-letter option was available,
(--snapshot-prefix for -s, --verbose for -v, et.).

We use getopt_long_only here to maintain compatibility with the older
style of long options with one dash (-core) as well as providing the
double-dash version )--core).

It would now be quite convenient to regularize the command-line
interface to glretrace in several ways. None of these are performed in
this commit to avoid breaking compatibility with existing scripts,
etc.:

  * Give multi-letter, abbreviated options (--pcpu, etc.) proper
    long-form names (--profile-cpu).

  * Combine related options under a single name (--pcpu and --pgpu
    could be something like --profile=cpu,gpu).

  * Combine options with the same meaning that would never be used
    independently. Snapshot generation and snapshot comparison are
    different modes. Meanwhile, prefix selection and call selection
    should apply identically to either mode. So both modes can use a
    single set of options (--prefix and --calls) rather than having
    separate --snapshot-prefix and --snapshot options.

Move static boolOption function to trace::boolOption

Other programs will also want to be able to parse Boolean command-line
options, so we should share this code in order to easily get
consistent behavior.

wrappers: Cleanup .def files formating.

d3d11: Export DXGI entrypoints.

Some apps use them.

d2d: Silence MinGW linker warnings.

retrace: More diagnostic information.

d3dretrace: Handle Software devices.

d2d: Make it actually work.

trace: Fix thinko on error checking.

d3dretrace: Merge d3d9 and d3d10 retracing.

d2d1,dwrite: Trace both APIs together.

d3dretrace: Drop retraceModule helper

d3dretrace: Single retrace for d3d10 and higher

d3dretrace: Eliminate dependencies from d3d9state.

d3dretrace: Allow multiple dispatches in the same file.

os: DLL abstraction.

gl: Handle ClearBufferData blobs.

d3dretrace: Eliminate differences between d3d9/d3d10.

ddraw: Remove custom tracer.

d2d: Eliminate custom tracers.

specs: Allow an API to spread across multiple modules.

d3d1x: Cleanup specs.

specs: Use StdMethod accurately.

Merge branch 'd2d'

gltrace: Don't use struct for Context.

snappy: Always build with NDEBUG define.

gui: Make FrameDataProvider destructor virtual.

d3dretrace: Fix MSVC build.

d3d11: Trace UpdateSubresource blobs.

retrace: More useful warnings for object mismatches.

d3d10,d3d11: Rudimentary retrace support.

Doesn't work often, in practice because dxgi calls are missing from traces.

d3d10/d3d11: Add sideeffects/internal attributes to specs.

Don't defer arguments when functions fail.

d3dretrace: Basic d3d10 support.

d3dretrace: Add d3d9 prefix to d3d9 specific files.

d3d11: Trace initial data blobs.

d3d1x: Rename d3d10shader -> d3dcommonshader.

d3d11: Catch up with d3d10.

d3d10: Fallback to D3D10DisassembleShader.

Should be always present.

dxva: Fix build for older dxsdk

d3d10/d3d11: Correct out pointers.

Merge branch 'master' into d2d

dxva: Eliminate the globals hack.

Merge branch 'master' into dxva

Conflicts:
common/trace_parser_flags.cpp

Fix dxgi specs.

d3d10: Trace UpdateSubResource blobs.

d3d10trace: Fix 1D textures size calculations.

d3d10: Trace blobs for initial data.

d3d10: Take mip level in consideration.

Trace d3d10.x maps.

Rename d3dsize.hpp to d3d9size.hpp