that are currently obtained via glXGetProcAddress and all of the XF86DRI
functions are replaced with a funciton table. This table will be passed to
__driCreateNewScreen.
One of the functions in the table is getProcAddress. This allows some
loaders to expose functionality not in all loaders. This will be immediatly
used for glxEnableExtension (formerly known to drivers as
__glXScrEnableExtension). libGL (and in the future libglx) expose this
function so that drivers can enable GLX extensions. libEGL should exposed
eglEnableExtension to enable EGL extensions. The same function cannot be
used for both because the extensions have different names and (possibly)
different semantics. Drivers can optionally use one, both, or neither.
The key parts are in the __DRIinterfaceMethodsRec structure in
dri_interface.h. A pointer to one of these structures is passed into
__driCreateNewScreen. Because of this, the version of the API is bumped to
20050725. Since the previous version(s) were never in a release, their
existance is erased.
I was actually a little surprised by how much code this cuts from the
drivers. A lot of glXGetProcAddress calls disappear, and a lot of
version checks go with them. Nice.
The one thing I'm not sure of is removing __glXInitialize. For some
reason that function was in the glXGetProcAddress table, but *nothing*
in the Mesa tree used it. Did something with DRI conf. use this
function? It seems odd...
(from glxclient.h) with PFNCREATENEWSCREEN (from dri_interface.h).
Remove the prototype for __driCreateScreen and fix the prototype for
__driCreateNewScreen (append the API version) in dri_interface.h.
1,402 lines of code to be removed from Mesa (drivers and libGL). The
big winner is dri_util.c.
Primary changes are:
1. Remove all "deprecated" entry-points from the various structures in
dri_interface.h.
2. Rename the remaining fields to removed "version numbers." So,
bindContext3 becomes bindContext. Functions with "New" in the name
(e.g., CreateNewContext) were *not* changed, but that is an option.
Having "New" in the name is less annoying to me than having "3" in the name.
3. Remove all compatibility code that handles cases where the driver or
the loader is too old to support the latest interfaces.
4. Append the API version to the __driCreateNewScreen function name.
This is currently done by hand. In the future (i.e., the next time we
make an incompatible change to the interface) we'll want to come up with
a better way to do this. This prevents old loaders from being able to load
new (incompatible) drivers.
5. Bump the API version to 20050722. All drivers (by way of dri_util.c)
require this version.
6. All drivers are *required* to expose GLX_SGIX_fbconfig and
GLX_OML_swap_method (or the moral equivalents). Support for these
functions in implicit in the use of the "new" interface.
7. Some cases still exist that need to be compiled differently in a loader
or core Mesa versus in a driver. These are identified by the define
IN_DRI_DRIVER.
I shouldn't:
Official BeOS GLView.h defines a virtual ErrorCallback(GLenum) method, assuming
a unsigned long GLenum.
But under Mesa, GLenum is unsigned int.
To keep binary compatibility, BeOS apps including Mesa GL/gl.h MUST include *our*
GLView.h, or linker will report a missing ErrorCallback(unsigned int) symbol. Glup.
XF86DRIDestroyDrawable are all called directly from DRI drivers using
the new interface. Therefore, prototypes, using available datatypes,
must be available in dri_interface.h. Since the prototypes are
available there, xf86dri.h is no longer needed for
DRI_NEW_INTERFACE_ONLY builds.
interface that are not *strictly* part of the old interface were
changed. Replace GetDrawableInfo type (dri_util.h) with
PFNGLXGETDRAWABLEINFOPROC (dri_interface.h). Wrap __driCreateScreen
(in drivers that use the new interface) with '#ifndef
DRI_NEW_INTERFACE_ONLY'.
Most of the changes were to get rid of warnings, but many of the warnings could
not be removed in the code so I also added #pragma's to disable the warnings.
Someone really should clean up this code, but I didn't want to mess with it
that much (and potentially break it).
1. Changes to the main header files to exclude some stuff is __SCITECH_SNAP__
is defined. The main GL/gl.h header file in SciTech SNAP is actually a wrapper
that defines a bunch of necessary stuff and then included GL/gl_mesa.h which
is the normal Mesa GL/gl.h header file renamed.
2. Changed APIENTRY * to APIENTRYP macros in the GL/gl.h and GL/glext.h header
files. This will better support other compilers like IBM VisualAge C++. I
added a basic macro for APIENTRYP to GL/gl.h (inside the !SNAP block), so
existing code will compile the same, but when the SNAP version is being
built we will use the correc definitions for the target compiler.
3. Changed a few more void * declarations to GLvoid *'s to avoid Open Watcom
compiler complaints.
4. Updates the OPENGL_VERSION macro to include a patch number (set to 0 for
now). Probably not necessary, but the original macro was wrong and we use
that macro in our code.
5. Changed _tnl_end() to _tnl_end_ctx() to avoid conflicts with _tnl_End when
using a compiler that has a case insensitive link.
Move the inclusion of windows.h from glext.h to gl.h. There are a few
good reasons for this:
- Including it in gl.h is more strightforward and makes it easier to
troubleshoot include file problems. It was sometimes hard to find it
in glext.h.
- Needed to define APIENTRY correctly. APIENTRY is used in gl.h.
- glut.h needs windows.h but does not include it, expecting the app to
include it. Including it in gl.h if not already included by the app
makes glut.h happy. This allows one to write a gl/glut app without
explictly including windows.h, which may only be really important for
toy apps like our samples and demos. But a "real" app can still
include windows.h if it wants.
Ian Romanick
Brian Paul
Jon Smirl
Karl Schultz
Adam Jackson
Dave Airlie
Daniel Borca
Alan Hourihane
Philippe Houdoin
Keith Whitwell
Kendall Bennett