X-Git-Url: http://git.tdb.fi/?p=libs%2Fgl.git;a=blobdiff_plain;f=source%2Fextension.h;h=cf824e24b0a189b65fc88de30adc6dc862fb5e09;hp=4410cc3c316e244ec7ecd934e4668befffb6126d;hb=e37d3b91500994df3de4fe47bd3d3e75d3104b46;hpb=dc1d1159a61f378bda11e5989ad694a86b9a3c77 diff --git a/source/extension.h b/source/extension.h index 4410cc3c..cf824e24 100644 --- a/source/extension.h +++ b/source/extension.h @@ -1,67 +1,102 @@ -/* $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 +#include 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