You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

92 lines
2.8 KiB

Using Extensions
----------------
To use an OpenGL extension in the code is is necessary to include a refference
to the extensions.hxx header file and add the following to the code (as an
example):
/* global variables */
glPointParameterfProc glPointParameterfPtr = 0;
glPointParameterfvProc glPointParameterfvPtr = 0;
bool glPointParameterIsSupported = false;
To be able to use these extensions the functions pointers have to be initialized
by something like the following examplde code:
if (SGIsOpenGLExtensionSupported("GL_EXT_point_parameters") )
{
glPointParameterIsSupported = true;
glPointParameterfPtr = (glPointParameterfProc)
SGLookupFunction("glPointParameterfEXT");
glPointParameterfvPtr = (glPointParameterfvProc)
SGLookupFunction("glPointParameterfvEXT");
} else if ( SGIsOpenGLExtensionSupported("GL_ARB_point_parameters") ) {
glPointParameterIsSupported = true;
glPointParameterfPtr = (glPointParameterfProc)
SGLookupFunction("glPointParameterfARB");
glPointParameterfvPtr = (glPointParameterfvProc)
SGLookupFunction("glPointParameterfvARB");
} else
glPointParameterIsSupported = false;
If a function is supported the function pointers are now initialized.
When using the functions (note that glPointParameterfvPtr() is used instead of
glPointParameterfvEXT() )it is important to check whether the
glPointParameterIsSupported is set to true:
if ( distance_attenuation && glPointParameterIsSupported )
{
// Enable states for drawing points with GL_extension
glEnable(GL_POINT_SMOOTH);
float quadratic[3] = {1.0, 0.001, 0.0000001};
// makes the points fade as they move away
glPointParameterfvPtr(GL_DISTANCE_ATTENUATION_EXT, quadratic);
glPointParameterfPtr(GL_POINT_SIZE_MIN_EXT, 1.0);
}
Adding Extensions
-----------------
To add an extension to the SimGear extension support code you normally only need
to edit the extensions.hxx header file in the screen directory.
Currently there are two extensions supported:
* glPointParameterf
* glActiveTexture
Adding a new extension involves adding the defines assosiated with the extension
(surrounded by the appropriate extension test):
#ifndef GL_EXT_point_parameters
# define GL_EXT_point_parameters 1
# define GL_POINT_SIZE_MIN_EXT 0x8126
# define GL_DISTANCE_ATTENUATION_EXT 0x8129
#endif
This is needed because not all OpenGL implementations define them correctly.
The following step is to add a typedef for the function pointer:
typedef void (APIENTRY * glPointParameterfProc)(GLenum pname, GLfloat param);
The APIENTRY refference is only used by windows machines but is defined empty
for all other platforms and hence needs to be added for cross platfrom
compatibillity.