directxtex: Get it building on MinGW.

directxtex: Fix include filename case.

directxtex: Don't redefine NOMINMAX.

directxtex: Build with cmake.

thirdparty/directxtex: Import DirectXTex library.

Will be useful for converting DirectX image formats.

common: Recognize Create* as DirectX call.

image: Add forgotten CMakeLists.txt

doh..

Drop API_D3D10/11.

cli: Remove dead files.

cli: Move pickle.hpp in.

Only used by cli module.

image: Move image code into its own module.

cli: Merge trace_resource.cpp and trace_tools_trace.cpp in.

It's only used by CLI and it will not change.

tracediff: Fix python differ to not highlight when stdout is not a tty

specs: A few more tweaks to D3D specs.

tracediff: Fix python differ to not highlight when stdout is not a tty

d3dretrace: Fix driver overriding when pAdapter is non-NULL.

d3dretrace: Use debugging when available.

gui: Drop console on Windows.

d3d9state: Dump rendertarget images to JSON.

d3dretrace: Remove left ofer redundant code.

os: Use CLOCK_MONOTONIC

inject: Use DLL injection for D3D10+ tracing.

d3dretrace: Dump D3D11 images/shaders too.

glretrace, dump-images: Accept --call-nos=no to get snapshots with call numbers

It is sometimes inconvenient to have call numbers encoded within the
snapshot filenames. For example, when doing tests of "apitrace trim"
in the test suite the call numbers frequently change even when the
image contents do not.

By accepting the --call-nos=no option, these programs will now
generate filenames with sequential numbers starting from 0 rather than
using call numbers in the filenames.

Merge branch 'master' into trim-auto

specs: A few more tweaks to D3D specs.

d3dstate: Fix MSVC build.

specs: Minor tweaks to d3d7-9 specs.

d3dretrace: Dump d3d10 geometry shaders.

d3d10state: Dump shaders.

d3d10state: Dump rendertargets.

gui: Take all state in consideration when determining it is empty.

retrace: Factor out image json dumping into json.cpp.

retrace: Move JSON write implementation to a .cpp file.

state: Drop several unused json image members.

image: Make PNG writing an Image method.

glstate: Use stringstream for holding the temporary PNG images.

d3dretrace: Release d3d9 shader objects.

d3d10: Ignore D3D10CreateBlob.

Not really interesting, already handled by the stubs.

d3dretrace: Backout temporary debugging code.

d3dtrace,d3dretrace: Remove D3DX9 headers.

No longer needed, and D3DX is deprecated upstream.

d3dtrace,d3dretrace: Move shader disassembly helpers to common location.

specs: Drop d3d10effect and d3d10shader.

Not really used or particularly interesting.

retracediff: Allow passing driver and arbitrary options to retrace.

d3dretrace: Allow to force a driver type.

d3dstate: Fix thinko on stage resource MiscFlags.

ddraw: Fix DDPIXELFORMAT.MultiSampleCaps spec.

d3dtrace: Prevent clashes in method signature IDs.

Methods from base classes had the same ID in all derived classes.

d3dretrace: Prevent ScopedAllocator::alloc<D3DPRESENT_PARAMETERS> clash.

D3D8 and D3D9 have different definitions of the D3DPRESENT_PARAMETERS.
This happens with other types, so the only solution is to stop using
templates here.

cmake: Fix MSVC build.

Ensure that newer DirectX headers are included before old versions.

d3dretrace: Basic d3d8 support.

d3d8trace: Further tweaks to the spec.

d3dretrace: Use consistent filenames.

dxgitrace: Fix build when recent d3d10 versions are not available.

trace: Silence object wrap debug messages.

d3dtrace: Smarter tracking of interface wrappers.

d3dretrace: Try to match the window size in the dxgi traces.

trace: Catch attempts to call unimplemented methods.

dxgitrace: Merge tracing of all DXGI related APIs.

retrace: Dump call number on exceptions.

retrace: Just warn in face of an unexpected non-null object.

d3d11: Set out flag for output object arrays.

trim: Retain exact as default behaviour.

s/UNINTERESTING/VERBOSE/

trim: Avoid trimming textures when referenced by a framebuffer object

We aren't yet tracking FBOs as their own resource, but we do need to
notice when any texture is referenced by an FBO so that we don't omit
it while trimming. So, notice any textrure referenced by
glFramebufferTexture2D and make the render state depend on this
texture.

trim: Move explanatory message from stdout to stderr.

This prevents this message from corrupting the output of:

apitrace trim --print-callset ... > callset-file

trim: Print a warning message when doing dependency analysis.

As requested by José prior to merging this code upstream.

trim: Move TraceAnalyzer out of cli_trim.cpp into its own file.

This class had long since outgrown where it was living at the top of
cli_trim.cpp. Thanks to José for recommending this.

trim: Never trim any glBindTexture calls.

This shouldn't be necessary. I've got a case where trimming out the
glBindTexture of an unused texture changes the behavoir, which
shouldn't be the case.

While I'll still try to track down that bug, this patch provides
conservative behavior that hopefully won't break anything. (The only
real downside is the potential of an implementation getting confused
by a glBindTexture with a value that was not returned by
glGenTextures).

trim: Never trim any textures bound within a display list.

This is conservative. The more efficient approach would create a
resource link from the display list to the texture, but that will wait
for when we actually have display-list resources.

trim: Add support for display lists.

The calls specified between glNewList and glEndList need to have
special treatment. For now we do the simplest thing and
unconditionally include all such calls in the trim output.

Eventually we will want to track display-list resources similar to
textures and trim away unused display lists.

trim: Conservatively make shader programs depend on textures

Some shader programs sample textures, so if the shader is included in
the trimmed output the texture needs to be included as well.

We don't have support inside of "apitrace trim" to parse GLSL to find
names of samplers to find these dependencies. Instead, we provide here
a simple heuristic:

In order to sample a texture, the OpenGL program must associate the
name of a texture unit with a location in the shader by calling
glUniform1i (or glUniform1iv). So we can notice whenever texture-unit
names are being passed and create a dependency from the shader to all
texture targets for that unit.

This is conservative on two fronts:

  1. The value being passed to glUniformi might only be coincidentally
     the same as a texture-unit name and be actually unrelated to
     texture sampling.

  2. The shader likely doesn't depend on all texture targets, but
     again we can't know which without looking inside the shader, so
     we associate all of them.

trim: Perform correct state tracking for glActiveTexture

Not all glBindTexture calls are created equal. With calls to
glActiveTexture intervening, calls to glBindTexture are actually
operating on indenpendent texture units.

It's actually quite easy to simple insert the number of the currently
active texture unit into the name of the texture target resource.

trim: Add a new --print-callset option.

This is useful whenever one has a need to manually tweak the trim operation.

Simply run:

apitrace trim --print-callset --frames=<whatever> --calls=<whatever>

as desired. Then take the resulting callset that is printed and run:

apitrace trim --calls=<callset> --exact

This should yield an identical trimming operation. Then this operation
can be tweaked by appending call ranges to the --calls option,
deleting rangess from the --calls option, or by appending a new
--frames option.

trim: Add a --frames option for selecting frames to trim.

This accepts a "frame set" which has syntax identical to the "call
set" of the existing --calls option. So, one could trim to just the
drawing operations of the first 10 frames of a trace with
--frames=0-9/draw.

trim: Abstract common stringstream idioms into shared functions.

Using the new providef, linkf, and unlinkf functions shrinks the code
a bit. It's tempting to provide <stdargs> functions with full
printf-like formatting, but it's really not necessary as of yet.

trim: Fix bug linking incorrect programs to shaders through samplers.

Previously, the code was mapping locations returned by
glGetUniformLocation and looking in the location map to try ot
determine which program to link in a glUniform1i call. This was
entirely bogus, as distinct programs do not have distinct location
spaces.

The correct answer is to simply track the currently active program and
link it to textures being bound to shaders.

trim: Add support for trimming out unused shaders.

The provide/consume analysis framework is finally starting to show
dividends. This is a fairly significant amount of new functionality
for "apitrace trim" yet it requires relatively little new code.

trim: Drop unused textures while trimming.

We introduce a new dependencies map so that some resources can depend
on other resources, effectively providing a tree of calls that need to
be included when the user requests a particular call be preserved in
the trim.

For example, a SwapBuffers call depends on the "framebuffer".
A rendering operation makes "framebuffer" depend on "render-state".
Enabling texturing makes "render-state" depend on "texture-target-FOO".
Binding a texture makes "texture-target-FOO" depend on "texture-X".
Uploading a texture makes the current call provide "texture-X".
Creating a texture makes the current call provide "texture-X".

This way, if a particular SwapBuffers call is included in the trimmed
output, all of the above will be included. Otherwise, if a SwapBuffers
is trimmed, then the "framebuffer" dependencies will be cleared and
none of the above calls will be included in the trimmed output.

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.