-/* $Id$
-
-This file is part of libmspgl
-Copyright © 2007 Mikko Rasa, Mikkosoft Productions
-Distributed under the LGPL
-*/
-
#ifndef MSP_GL_EXTENSION_H_
#define MSP_GL_EXTENSION_H_
-#include <msp/core/except.h>
+#include <string>
namespace Msp {
namespace GL {
+enum GLApi
+{
+ OPENGL,
+ OPENGL_ES2
+};
+
+enum GLProfile
+{
+ CORE_PROFILE,
+ COMPATIBILITY_PROFILE
+};
+
+
struct Version
{
unsigned short major;
unsigned short minor;
+
+ Version();
+ Version(unsigned short, unsigned short);
+ Version(const std::string &);
+
+ bool operator>=(const Version &) const;
+ bool operator<(const Version &o) const { return !(*this>=o); }
+ operator bool() const { return major || minor; }
};
-typedef void ExtFunc();
/**
-Indicates whether an extension is supported. If this returns true, the
-functions of that extension are safe to use.
+Holds metadata about an extension. Evaluates to true if the extension is
+supported.
*/
-bool is_supported(const std::string &);
+class Extension
+{
+public:
+ enum SupportLevel
+ {
+ UNSUPPORTED,
+ EXTENSION,
+ CORE
+ };
-/**
-Returns the OpenGL version number, as reported by the implementation.
-Functions up to the returned version are safe to use.
-*/
-const Version &get_gl_version();
+ typedef SupportLevel (*InitFunc)();
-/**
-Checks that an extension is supported and throws if it isn't.
-*/
-void require_extension(const std::string &);
+private:
+ const char *name;
+ InitFunc init_func;
+ mutable bool init_done;
+ mutable SupportLevel support;
-/**
-RAII version of require_extension. Useful as a static local variable.
-*/
-struct RequireExtension
-{
- RequireExtension(const std::string &e) { require_extension(e); }
+public:
+ Extension(const char *, InitFunc);
+
+ const char *get_name() const { return name; }
+ operator bool() const;
};
-/**
-Checks that the OpenGL version is at least a.b and throws if it isn't.
-*/
-void require_version(unsigned a, unsigned b);
-/**
-RAII version of require_version. Useful as a static local variable.
-*/
-struct RequireVersion
+struct Require
{
- RequireVersion(unsigned a, unsigned b) { require_version(a, b); }
+ Require(const Extension &);
};
-/**
-Returns the address of an extension function.
-*/
+
+typedef void ExtFunc();
+
+/** Checks for extension support. Only intended for internal use. */
+bool is_supported(const std::string &);
+
+/** Checks for OpenGL version support. Only intended for internal use. */
+bool is_supported(const Version &, const Version & = Version());
+
+/** Indicates whether an extension has been disabled, either explicitly through
+the MSPGL_DISABLE_EXTENSIONS environment variable or implicitly as a workaround
+for a driver bug. Only intended for internal use. */
+bool is_disabled(const std::string &);
+
+/** Returns the API for which the library was compiled. */
+GLApi get_gl_api();
+
+/** Returns the OpenGL profile for the active context. */
+GLProfile get_gl_profile();
+
+/** Returns the OpenGL version number, as reported by the implementation. */
+const Version &get_gl_version();
+
+/** Returns the GLSL version number, as reported by the implementation. */
+const Version &get_glsl_version();
+
+/** Returns the address of an extension function. Only indended for internal
+use. */
ExtFunc *get_proc_address(const std::string &);
} // namespace GL