Merge branch 'glproc-cleanup'

Cast native types to EGL types when calling EGL functions.

This is needed to resolve build failures on some platforms that support
various EGL backends and, therefore, native types.  Note that we can't
use reinterpret_cast<>() as the types involved are not necessarily
pointers or integers e.g. they can be typedef-ed types.

Use libGLESv2.so.2 as the OpenGL ES 2.0 library SONAME.

Although the spec doesn't propose a SONAME, this seems to be the most
widely adopted name in the Linux world.

Fix typo in previous commit.

Fix build on certain mingw versions.

Introduce call flags.

A central place for metainfo such as whether a call terminates a frame
or not, etc.

No trace format changes yet.  Will introduce them later after more
careful thought.

Make the GLenum_int hack for MacOS robust against include order.

Try to do the right thing with EGL symbols.

Fix glretrace on MacOSX.

Make the GLenum_int hack for MacOS robust against include order.

Cleanup glproc.

Based on some of Alexandros Frantzis code/ideas.

Don't call GLX functions when compiling the EGL retracer.

This is a temporary fix, until we implement a dedicated EGL-based,
GL/GLES1/GLES2 state dumping mechanism.

Produce dispatchers for all functions, even in retrace mode.

Don't free fbconfig.

It doesn't belong to us.

Fixes segfault on exiting glretrace.

Replace dynamic casts with static on glws.

We know as a fact that the type matches.

Make gltxt.py obbey prefix option for types too.

Minor cleanups and better documentation for the spec generation scripts.

Update docs.

Support 'apitrace diff-images' on Windows.

Update glws Cocoa bindings too.

Refactor the code to find scripts.

Hopefully fixes scripts on Windows too, but untested yet.

Install snapdiff.py as well.

Cache context profile in glws::Context.

Allow to retrace with EGL too.

Allow to specify an initial call no in the qapitrace command line.

Add "apitrace repack" command.

Return read bytes in File::read().

Don't call overridden virtual methods from the base destructor.

It causes the program to terminate with "pure virtual method called"
error, as the derived class members are no longer accessible.

Always try dlsym before get eglGetProcAddress

Some implementation could return garbage from eglGetProcAddress

Add hyperlinks for non-ARB extensions too.

Require gles1 and gles2 modules for EGL support (fixes issue #58).

Fix GUI visualization of floating point values.

According to http://doc.qt.nokia.com/stable/qvariant.html#type ,
variant types are actually QMetaType::Type, which includes floats.

So handle the QMetaType::Float case everywhere.

Trace via "apitrace trace" command.

It could be done via the library directly, but this allows to use
QProcess as before, and therefore run asynchronously without extra effort.

Remove unused includes from trace_file.cpp

Add links to EXT_framebuffer_object spec.

Fix internalformat determination for renderbuffers.

glGetRenderbufferParameteriv takes a target.

Cleanup and generalize os string class.

Kill glsnapshot.

The ability of taking snaphshots while tracing was meant for test
automation of apitrace itself, but even so, it was not very robust
-- apps that used glXCreateWindow would not find be able to determine
window id --, so remove this now that a custom made test suite is
being developed.

Parse doubles to a new Double class rather than to the Float class.

This is simply a case of not discarding information. Without this, it would
not be possible to parse a trace and re-create the identical trace.

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

TODO: Fix typo in the description of the range specification.

The syntax example was updated from using '@' to '/' some time ago,
but the description still had the old '@' symbol.

Prevent segfault on glretrace crash (fixes issue #52).

On glretrace crash, both error and finished QProcess events are emitted, by
this order. Members were reset on error, causing null pointer dereference
on replayFinished.

Fix this by handling abnormal termination on replayFinished too.

replayError should probably removed/merged into replayFinished.

Abort on failure to open trace (fixes issue #50).

snapdiff: Drop the --version option

This isn't currently giving any actual information, and it doesn't fit
well with the new top-level apitrace command, (which should presumably
take care of any --version option itself).

Add "apitrace diff-images" command

Which simply calls out to the existing snapdiff.py script, (notably,
it also passes "apitrace diff-images --help" to snapdiff.py as well).

Encode format as a member and not part of the label.

Fix MinGW-w64 build without DXSDK.

Allow to enable/disable EGL support.

As done with GUI, to avoid automagic dependencies.

Ignore generated files.

Fix whitespace in CMakeLists.txt.

Keep Copyright lines together.

Drop glPointSizePointerOES from eglimports.hpp.

MinGW doesn't like it for some reason and it doesn't seem to be needed.

gles: Fix retrace of eglCreateContext for GLES contexts

Check the current API and the attribute list to determine the profile of the
context.

gles: Add eglretrace

It works like glretrace, except that an EGL-based glws implementation is used.

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.