Update news for new nomenclature.

cli: Add an alias mechanism and alias "retrace" to "replay"

This allows any existing scripts calling "apitrace retrace" to
continue to work.

cli: Rename "apitrace retrace" to "apitrace replay".

After some debate on the mailing list, the consensus favors the name
"replay" for this operation. Update the documentation in
README.markdown to match.

dxgitrace: Generalize the swapchain size for the entry functions too.

d3dretrace: Force DWM traces to run on a window.

Fullscreen is hard to debug.

Serialize swapchain dimensions.

trace: Unwrap all args before serializing them.

trace: Remove unused Trace::unwrapRet method.

inject: Always output warning messages to debug output.

inject: Add define to use environment var instead of shared memory.

d3dretrace: Cope with _MAP_FLAG_DO_NOT_WAIT flags.

If the map succeeded in the original trace, then we must wait.

d3dretrace: Replay IUnknown::AddRef/Release methods faithfully.

Several D3D APIs (especially recent ones) keep track of reference counts
and will ensure errors if reference counting is not properly done.

For example, IDXGISwapChain::ResizeBuffers will fail if there are
outstanding references to its buffers.

trace_parser: More comprehensive debug output.

It was useful to diagnose issue #110.

replay: Support applications mixing glCreateProgramObjectARB and glUseProgram

As is known to happen with OpenGL, there are many more than one ways
to do the same thing. In this case, one can create a program
(glCreateProgram) or a program object (glCreateProgramObjectARB) along
with many similar pairs of functions.

In fact, a single application might even mix these two approaches,
(for example, calling glCreateProgramObjectARB and then calling
glUseProgram rather than glUseProgramObjectARB).

Historically, glretrace could fail with such mixed usage. The calls
into the ObjectARB function would go through _handleARB_map while the
other calls would go through _program_map, so after mixed calls the
desired object would not be found in the referenced map.

Making mixed usage work requires merging both _program_map and
_shader_map together with _handleARB map. This is correct for any
OpenGL implementation which supports the GL_ARB_shader_objects
extension, since there is no way to implement this extension correctly
without having shaders and programs in the same namespace.

However, we carefully maintain separate _shader_map and _program_map
for an OpenGL implementation not supporting GL_ARB_shader_objects. In
this case, it's not possible for an application to mix usage (since
none of the ObjectARB functions are guaranteed to exist). And it's
also possible for the implementation to provide separate namespaces
for shaders and programs, so they each need their own map.

Get DWM traces working.

Sort-of -- shared resources still don't work correctly.

specs/dxva: Try to define DXVA2_PVP_SETKEY.

trim: Trim swapbuffers calls when --trim-spec=drawing

Previously, the SwapBuffers calls were only getting trimmed if
--trim-spec included "no-side-effects". It was counter-intuitive that
a trim-spec of "drawing" alone would leave all the SwapBuffers calls
in place. So catch them under this trim-spec as well.

trim: Add a new --trim-spec option for fine-grained trimming

This has two benefits:

1. In cases where the dependency analysis goes wrong, using the --trim-spec
   option can help identify which portion of the code is misbehaving, (and
   allows the user to still get some trim benefit by avoiding the broken
   code).

2. The implementation of this change breaks the analysis code up into several
   more fine-grained functions, so it should be easier to review and maintain.

d3dtrace: Fix DXVA2_DecodeExecuteParams::pCompressedBuffers spec.

d3dtrace: Recognize YV12 format.

Update Android instructions.

Not really based from personal experience, but rather on what others wrote,
namely

  https://github.com/kanru/apitrace/commit/5948e72a25b1d2df07299db0d49f91677827478b

glstate: Cleanup the read buffer selection code slightly.

We were calling glReadBuffer(draw_buffer) before reading the GL_READ_BUFFER.

image: make getDrawBufferImage() work for ES or !ARB_draw_buffers

Without this 'apitrace dump-images' was failing for me (GLES, freedreno
gallium driver) because attachment would be GL_NONE.

Signed-off-by: Rob Clark <robdclark@gmail.com>
Reviewed-by: Carl Worth <cworth@cworth.org>
Signed-off-by: José Fonseca <jfonseca@vmware.com>

d3dretrace: Recognize IDirect3DDevice9Ex::PresentEx as frame terminator.

trim: Fix short command-line option -a for "apitrace trim"

This was documented as being equivalent to --auto, but one piece of
the plumbing was not in place.

glretrace: Fix snapshots on GL 3.2 core contexts (issue #106).

glPush/PopClientAttrib() are not available in core contexts. Simply
save/restore the state via glGet and pack API.

glretrace: Ignore a few more CGL calls.

os: Cast pthread_create's arg parameter.

cli: Inject DLL on windows by default.

cli: Update description of windows trace apis.

gltrace: Prevent use of uninitialised variable.

gltrace: Recognize more ES parameters.

We now always use our bundled headers so no need to be conservative any
more.

gltrace: Support GL_(NUM_)PROGRAM_BINARY_FORMATS (issue #104).

gltrace/retrace: Full support for variable length parameters.

Such as GL_COMPRESSED_TEXTURE_FORMATS.

retrace: Split ScopedAllocator into its own header.

It will be useful outside of retrace.

Update downloads link.

cli: Fix MSVC build.

d3dretrace: presents may flip so set CALL_FLAG_SWAP_RENDERTARGET flag.

d3dretrace: Dump D3D8 images too.

scripts: Add some missing code.

scripts: New script to convert to PIX.

d3dretrace: Follow --driver option for d3d8/d3d9 too

d3d9state: Upack D3DFMT_R5G6B5 too.

Quite common.

scripts: Don't install bogus sample.py

scripts: Install all of them.

Install all thirdparty licenses.

Merge branch 'trim-auto'

Conflicts:
cli/CMakeLists.txt

Merge remote-tracking branch 'github/timestamp'

glretrace: Remove the gpu/cpu time syncing code.

No longer necessary now that we use the same clock (GL_TIMESTAMP) for
both GPU and CPU time measurements.

cmake: Move the binary/installs definitions to CLI.

As that's the only place they are used.

qapitrace: Determine binary dir in run-time.

qapitrace: Adjust PATH only once and for all.

qapitrace: Fix histogram tooltip for profiles with small number of calls.

gui/tracedialog: Don't show warning when user cancel to browse.

And add three dots to browse button's label to indicate dialog.

gui/mainwindow: Add functions that toggle actions enables and use it.

Added enabling/disabling of few more actions.
Cleanup .ui file (set actions to default state).

gui: Fix crash on trigger actions without loaded trace-file.
gui/apitrace: findFrameStart(), findFrameEnd(): Do nothing, when passed frame is null-pointer.

gui: Small style/usability fixes.

Add accelerator (F) to Edit->Find.
Add accelerator (N) and shortcut (Ctrl+N) to File->New.
Rename "File->New" to "File->New..." to indicate, that dialog will be showed.

glretrace: Use GL_TIMESTAMP (if available) for CPU profiling.

The prior scheme of trying to continuously re-synchronize separate CPU
and GPU counters is doomed to always be unreliable. Instead, simply prefer
to use the GL_TIMESTAMP values for both GPU and for CPU profiling.

v2: José Fonseca: use glGet(GL_TIMESTAMP)

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.