#include "precompiled.h"
#include "lib/ogl.h"
#include <stdio.h>
#include <string.h>
#include <stdarg.h>
#include "lib/external_libraries/libsdl.h"
#include "lib/debug.h"
#include "lib/sysdep/gfx.h"
#include "lib/res/h_mgr.h"
#include "lib/external_libraries/glext_funcs.h"

Macros
#define	FUNC(ret, name, params) ret (GL_CALL_CONV *p##name) params;

#define	FUNC2(ret, nameARB, nameCore, version, params) ret (GL_CALL_CONV *p##nameARB) params;

#define	FUNC3(ret, nameARB, nameCore, version, params) ret (GL_CALL_CONV *p##nameCore) params;

#define	MATCH(known_ext)

#define	FUNC(ret, name, params) p##name = (ret (GL_CALL_CONV*) params)SDL_GL_GetProcAddress(#name);

#define	FUNC23(pname, ret, nameARB, nameCore, version, params)

#define	FUNC2(ret, nameARB, nameCore, version, params) FUNC23(p##nameARB, ret, nameARB, nameCore, version, params)

#define	FUNC3(ret, nameARB, nameCore, version, params) FUNC23(p##nameCore, ret, nameARB, nameCore, version, params)

#define	E(e) case e: debug_printf(L"%ls\n", WIDEN(#e)); break;

Functions
const char *	ogl_ExtensionString ()
	get a list of all supported extensions. More...

static bool	isImplementedInCore (const char *ext)

bool	ogl_HaveExtension (const char *ext)
	check if an extension is supported by the OpenGL implementation. More...

bool	ogl_HaveVersion (const char *desired_version)
	make sure the OpenGL implementation version matches or is newer than the given version. More...

const char *	ogl_HaveExtensions (int dummy,...)
	check if a list of extensions are all supported (as determined by ogl_HaveExtension). More...

static void GL_CALL_CONV	dummy_glDrawRangeElementsEXT (GLenum mode, GLuint, GLuint, GLsizei count, GLenum type, GLvoid *indices)

static void GL_CALL_CONV	dummy_glActiveTextureARB (int)

static void GL_CALL_CONV	dummy_glClientActiveTextureARB (int)

static void GL_CALL_CONV	dummy_glMultiTexCoord2fARB (int, float s, float t)

static void GL_CALL_CONV	dummy_glMultiTexCoord3fARB (int, float s, float t, float r)

static void	enableDummyFunctions ()

static void	importExtensionFunctions ()

static void	dump_gl_error (GLenum err)

void	ogl_WarnIfError ()
	raise a warning (break into the debugger) if an OpenGL error is pending. More...

bool	ogl_SquelchError (GLenum err_to_ignore)
	ignore and reset the specified OpenGL error. More...

void	ogl_Init ()
	initialization: import extension function pointers and do feature detect. More...

Variables
static const char *	exts = NULL

static bool	have_30

static bool	have_21

static bool	have_20

static bool	have_15

static bool	have_14

static bool	have_13

static bool	have_12

GLint	ogl_max_tex_size = -1

GLint	ogl_max_tex_units = -1
	[pixels] More...

Macro Definition Documentation

#define E ( e ) case e: debug_printf(L"%ls\n", WIDEN(#e)); break;

#define FUNC	(	ret,
		name,
		params
	)	ret (GL_CALL_CONV *p##name) params;

Definition at line 51 of file ogl.cpp.

#define FUNC	(	ret,
		name,
		params
	)	p##name = (ret (GL_CALL_CONV*) params)SDL_GL_GetProcAddress(#name);

Definition at line 51 of file ogl.cpp.

#define FUNC2	(	ret,
		nameARB,
		nameCore,
		version,
		params
	)	ret (GL_CALL_CONV *p##nameARB) params;

Definition at line 52 of file ogl.cpp.

#define FUNC2	(	ret,
		nameARB,
		nameCore,
		version,
		params
	)	FUNC23(p##nameARB, ret, nameARB, nameCore, version, params)

Definition at line 52 of file ogl.cpp.

#define FUNC23	(	pname,
		ret,
		nameARB,
		nameCore,
		version,
		params
	)

Value:

pname = NULL; \
    if(ogl_HaveVersion(version)) \
        pname = (ret (GL_CALL_CONV*) params)SDL_GL_GetProcAddress(#nameCore); \
    if(!pname) /* use the ARB name if the driver lied about what version it supports */ \
        pname = (ret (GL_CALL_CONV*) params)SDL_GL_GetProcAddress(#nameARB);

#define FUNC3	(	ret,
		nameARB,
		nameCore,
		version,
		params
	)	ret (GL_CALL_CONV *p##nameCore) params;

Definition at line 53 of file ogl.cpp.

#define FUNC3	(	ret,
		nameARB,
		nameCore,
		version,
		params
	)	FUNC23(p##nameCore, ret, nameARB, nameCore, version, params)

Definition at line 53 of file ogl.cpp.

#define MATCH ( known_ext )

Value:

if(!strcmp(ext, #known_ext))\

return true;

Function Documentation

static void GL_CALL_CONV dummy_glActiveTextureARB ( int )

static

Definition at line 307 of file ogl.cpp.

static void GL_CALL_CONV dummy_glClientActiveTextureARB ( int )

static

Definition at line 311 of file ogl.cpp.

static void GL_CALL_CONV dummy_glDrawRangeElementsEXT	(	GLenum	mode,
		GLuint	,
		GLuint	,
		GLsizei	count,
		GLenum	type,
		GLvoid *	indices
	)

static

Definition at line 302 of file ogl.cpp.

static void GL_CALL_CONV dummy_glMultiTexCoord2fARB	(	int	,
		float	s,
		float	t
	)

static

Definition at line 315 of file ogl.cpp.

static void GL_CALL_CONV dummy_glMultiTexCoord3fARB	(	int	,
		float	s,
		float	t,
		float	r
	)

static

Definition at line 320 of file ogl.cpp.

static void dump_gl_error ( GLenum err )

static

Definition at line 376 of file ogl.cpp.

static void enableDummyFunctions ( )

static

Definition at line 325 of file ogl.cpp.

static void importExtensionFunctions ( )

static

Definition at line 345 of file ogl.cpp.

static bool isImplementedInCore ( const char * ext )

static

Definition at line 81 of file ogl.cpp.

const char* ogl_ExtensionString ( )

get a list of all supported extensions.

useful for crash logs / system information.

Returns: read-only C string of unspecified length containing all advertised extension names, separated by space.

Definition at line 68 of file ogl.cpp.

bool ogl_HaveExtension ( const char * ext )

check if an extension is supported by the OpenGL implementation.

takes subsequently added core support for some extensions into account (in case drivers forget to advertise extensions).

Parameters

ext	extension string; exact case.

Returns: bool.

Definition at line 187 of file ogl.cpp.

const char* ogl_HaveExtensions	(	int	dummy,
			...
	)

check if a list of extensions are all supported (as determined by ogl_HaveExtension).

Parameters

dummy value ignored; varargs requires a placeholder. follow it by a list of const char* extension string parameters, terminated by a 0 pointer.

Returns: 0 if all are present; otherwise, the first extension in the list that's not supported (useful for reporting errors).

Definition at line 266 of file ogl.cpp.

bool ogl_HaveVersion ( const char * version )

make sure the OpenGL implementation version matches or is newer than the given version.

Parameters

version version string; format: ("%d.%d", major, minor). example: "1.2".

Definition at line 219 of file ogl.cpp.

void ogl_Init ( )

initialization: import extension function pointers and do feature detect.

call before using any other function, and after each video mode change. fails if OpenGL not ready for use.

Definition at line 473 of file ogl.cpp.

bool ogl_SquelchError ( GLenum err_to_ignore )

ignore and reset the specified OpenGL error.

this is useful for suppressing annoying error messages, e.g. "invalid enum" for GL_CLAMP_TO_EDGE even though we've already warned the user that their OpenGL implementation is too old.

call after the fact, i.e. the error has been raised. if another or different error is pending, those are reported immediately.

Parameters

err_to_ignore,: one of the glGetError enums.

Returns: true if the requested error was seen and ignored

Definition at line 430 of file ogl.cpp.

void ogl_WarnIfError ( )

raise a warning (break into the debugger) if an OpenGL error is pending.

resets the OpenGL error state afterwards.

when an error is reported, insert calls to this in a binary-search scheme to quickly narrow down the actual error location.

reports a bogus invalid_operation error if called before OpenGL is initialized, so don't!

disabled in release mode for efficiency and to avoid annoying errors.

Definition at line 398 of file ogl.cpp.

Variable Documentation

const char* exts = NULL

static

Definition at line 61 of file ogl.cpp.

bool have_12

static