gles: Add support for GLES retracing

GLES entrypoings are added to glretrace.py, as if GLES is just an extension to
GL.

glws: Add EGL/Xlib-based implementation

This is based on glws_glx, with GLX replaced by EGL.  This is also the only
glws implementation that supports GLESv1 and GLESv2 profiles.

glws: Add support for profiles

The valid profiles are PROFILE_COMPAT, PROFILE_ES1, and PROFILE_ES2.  They
stand for desktop GL with compatibility profile, GLESv1, and GLESv2
respectively.  Update createContext to take profile as the last parameter.

glws: Allow the attribute terminator to be specified

This is needed to support EGL attribute lists.  They have EGL_NONE, instead of
zero, as the list terminator.

gles: Add support for GLES tracing to egltrace

Override GLES entrypoints and set the tracer context's profile when
eglMakeCurrent is called.  This allows egltrace to trace GLES apps.

gles: Prepare __gl_image_size for GLES

__gl_image_size queries several GL states that are not available in GLES
contexts.  The defaults work for GLES so those queries can be safely skipped.

gles: Add ES1 and ES2 profiles to glretrace.py

Some of the internal GL calls we make generate GL_INVALID_ENUM or other errors
when tracing an GLES app.  We need to know the profile of the current context
to adapt the calls made.

gles: Update glproc.py

Generate dispatch functions for GLES API.

gles: add GLES API spec

Only entrypoints found in OpenGL ES 1.1 and OpenGL ES 2.0 are added.  No
extension support yet.  This could limit the usefulness a lot.

gles: Include GLES headers in eglimports.hpp

They are always included to make sure we have GLES types and enums defined.
This allows us to treat GLES effectively as an extension to GL, without having
to put #ifdef's at multiple places.

gles: Add Khronos GLES headers

Add profile to tracer_context

The profile of the context, which is always PROFILE_COMPAT for now.

Add tracer_context as the tracer's context

For now, it is just a static struct replacing __user_arrays*.  Later, we can
add more fields to cache more GL states (e.g. is there a PBO bound?), support
multiple contexts, and etc.

Add GL_FIXED to __gl_type_size

It is needed for GL_ARB_ES2_compatibility (and GLES).

Make the details view a bit clearer.

most importantly show the frame number

Return format info for both textures and framebuffers.

Incredibly useful, especially that we don't encode anything
but 32bpp rgba correctly.

Add depth info to the surfaces.

Fix fetching of the data for uniform arrays.

The initial array element is usually returned as arrayName[0] not
arrayName which means that we were usually creating two-dimensional
arrays for those elements which in turned always returned garbage.

Warn for QueryInterface with unknown IIDs.

Abstract execv().

Add missing terminator.

Add an "--api" option to "apitrace trace" allowing to choose egl.

Build egltrace.so into the wrapper dir.

egl: add retracing support for EGL

As the glws abstraction supports desktop GL, EGL retrace will abort with a
warning when the trace file tries to create a GLES context.

egl: add EGL tracer

This tracer supports EGL/OpenGL applications for now.  Support for GLES is
missing, but can be added later.  There are two new macros defined.  HAVE_EGL
indicates that the system has EGL available.  It will make eglimports.h
include EGL headers.

There is also TRACE_EGL.  It indicates that EGL, instead of the OS-dependent
GLX/CGL/WGL, is the winsys API to trace,

cmake: include FindPkgConfig.

add support for (key, val) attribute list

A (key, val) attribute list has this format

  { key1, val1, ..., keyN, valN, terminator }

and the size is 2*N + 1

egl: Update glproc.py

Generate dispatch functions for EGL API.

egl: Add EGL API spec

Only those defined by EGL 1.4, no extensions yet.  This limits the usefulness
a lot.

egl: Add eglimports.hpp

This header file is included by glimports.hpp.  It is made a separate file
file so that we can add the (messy) GLES includes to it later without
complicating glimports.hpp.

egl: Add Khronos EGL headers

Use our own egl.h and eglext.h, but system's platform headers (eglplatform.h
and khrplatform.h).

Add new "apitrace diff-state" command

Which is simply a convenient way to invoke the existing jsondiff.py script,
(which is now installed by "make install" to support this command).

doc: Prefer `apitrace diff` over tracediff.sh.

cli: Pass apitrace path to tracediff.sh.

So that it works automatically from the build directory too.

cli: Add a new "apitrace diff" command.

This command simply provides a more consistent way of getting access
to the existing tracediff.sh command, (which is now installed to
<prefix>/lib/apitrace/scripts for the "apitrace diff" command to
invoke, but not necessarily for users to invoke directly).

Separate wrappers/ and scripts/ under <prefix>/lib/apitrace

We now define a new APITRACE_SCRIPTS_INSTALL_DIR:

<prefix>/lib/apitrace/scripts

where scripts will soon be installed (as needed).

Meanwhile, APITRACE_WRAPPER_INSTALL_DIR is updated to:

<prefix>/lib/apitrace/$arch/wrappers

(where before it didn't have the final "wrappers" directory).

Fix "apitrace trace" when running from installed location.

A missing path separator was causing the wrapper library to fail to be found.

gui: Handle incomplete calls.

Should fix issue 48.

Only re-allocate if the snappy cache buffer when it is not big enough.

Update glxtrace.so path in docs.

Fix typo.

Make findFile non-static, given it will be necessary for other commands.

Split common functionality out of cli.

Make file_exists as os::Path method.

Keep info on how to manually retrace in a separate section.

Add a new "apitrace trace" command to the command-line interface.

There is no code to support Windows yet, but there is specific code
for both Linux and Mac OS X. The documentation is also updated to
reflect the new command.

Signed-off-by: José Fonseca <jose.r.fonseca@gmail.com>

Put glxtrace.so also in the wrappers directory.

For consistency among all platforms, per Carl Worth's suggestion,
but the wrappers DLLs must remain in a directory of their own to
avoid interfering with other executables.

Give CLI command names a _command prefix

This is just to set things up for a trace_command command, (which
cannot be named "trace" since that would conflict with "namespace
trace").

Add os::Path.trimFilename function.

This is the counterpart to trimDirectory. This function trims the
final filename component from the path leaving just the containing
directory.

TODO: Add some notes on additions we want to the command-line interface

These come from some recent dicussion on the mailing list.

Minor typo correction of code comment

Without this, the sentence is not gramatically well-formed.

Mac OS X: Fix getProcessName() to avoid assertion failure in truncate

Apparently _NSGetExecutablePath doesn't actually set the len field in
the case of successfully copying a value to buf. In this case, the
value in buf is properly terminated, so we can just use strlen to find
a legal value to use when calling truncate.

Expose build/install dirs as a define.

Also, pick a wrapper install dir that varies with architecture, to allow
tracing of multiple binaries on multiarch.

Fix typos in _vscprintf comment.

Change non-executable install directories to include an "apitrace" component

It's just more polite to put documentation into
<prefix>/share/doc/apitrace rather than just dumping it into the
top-level <prefix>/doc.

Similarly, since glxtrace.so is not a conventional library, it doesn't
belong in <prefix>/lib but is well-suited for <prefix>/lib/apitrace.

Merge branch 'os-path'

More os::Path fixes.

Fix os::Path::format on MinwGW.

Include sys/syslimits.h for PATH_MAX on MacOSX.

Update docs / scripts for tracedump -> apitrace dump change.

Drop first_arg_command.

Unnecessary.

Better isolation of CLI source files.

Tweak help output.

* accept "apitrace dump --help" as help.
* list commands in "apitrace help" too.
* tweak whitespace.

Use a slightly different naming convention for cli source files.

Cleanup headers.

Eliminate unused & unix specific headers.

apitrace: Replace tracedump program with new "apitrace dump" command

The code just copies right over so should work exactly as before, but
with our nice, new, unified command-line syntax.

Add a top-level apitrace program.

This is intended to eventually be a program which will provide access
to all apitrace functionality (tracing, trimming, replaying,
analyzing, launch the gui, etc.).

To start with it implements only the stub "apitrace help" command so
there's not any real functionality here yet.

Move os::Path to a separate header.

Much less re-compiles.

Also eliminate wide-spread use of PATH_MAX.

Have selected call always match the current call.

The current call (highlighted with single-click or keyboard navigation)
was serving no purpose, and this make navigation much more effective.

Only jump to errors when the error item is activated.

Because currentItemChanged signal is too frequent/random, happening even
at times where errors window is invisible, when switching between tabs of
the current state pane, causing the current call to go out of focus.

Many fixes to os::Path.

Add a path manipulating class.

More tweaks/cleanups to D3D9 spec.

Minor tweaks to d3d9 spec.

Some state is a mixture of enum/flags

Define GLhandleARB as unsigned long on MacOSX.

Retrace applications with mix ARB and core uniform calls correctly.

A bit of an hack.

Fix buffer overflow when manipulating extensions string.

Switch os functions to camelcase.

Lower case namespaces.

Rename trace writer files to group nicely.

Re-organize the Trace::File code.

This should allow stop linking the zlib code from the wrappers.

Document coding syntax, and other development practices.

Add --color option when pipeing traceoutput to less.

Cleanup X11 event handling.

Fixes an infinite loop on GlxDrawable::show() in certain traces.

Improve the indention in emacs just a bit.

By default emacs offsets both the inline and in-namespaces, lets
fix that.

Replace .emacs-dirvars with .dir-locals.el

Just basic whitespace formatting settings for all file types for now.
(And let the emacs pros do the rest later)

Document known issues.

Issue 47.

Emit a warning when the window size cannot be inferred.

Issue 47.

tracedump: Add tri-state --color option (auto, always, or never)

This follows a pattern similar to that provided by other tools, (such
as grep). The default auto mode colorizes if stdout is a tty. The always
and never modes explicit enable or disable colorizing.

The old --no-color and --no-colour options are deprecated, (no longer
documented but still supported to avoid any regressions of scripts).

Signed-off-by: José Fonseca <jose.r.fonseca@gmail.com>

Be more concise about DXSDK requirements.

retracediff: More helpful error message when glretrace is not found.

Trace glXCreateGLXPixmapMESA.

Generated code formatting improvements.

Cleanup Literal class.

Distinguish between tags and ids.

Remove dead base parameter to literal types.

Unnecessary given we encode it in binary form anyway.

Specify constant array lengths as integers.

Bring some of the virtual-memory-regions

Tracking user memory by querying virtual memory subsystem is not reboust
enough for master, but works in many cases, yielding much smaller and
efficient traces.

This change brings the ability of retracing traces generated by the
virtual-memory-regions branch.

It also brings more efficient tracing of glFlushMappedBufferRange calls.

The trace file version is bumped as a result.

Factor out polymorphic type generated code into functions.

Generate more compact switch statements for polymorphic types.