source/extension.h

   1 /* $Id$
   2
   3 This file is part of libmspgl
   4 Copyright © 2007  Mikko Rasa, Mikkosoft Productions
   5 Distributed under the LGPL
   6 */
   7
   8 #ifndef MSP_GL_EXTENSION_H_
   9 #define MSP_GL_EXTENSION_H_
  10
  11 #include <msp/core/except.h>
  12
  13 namespace Msp {
  14 namespace GL {
  15
  16 struct Version
  17 {
  18         unsigned short major;
  19         unsigned short minor;
  20 };
  21
  22 typedef void ExtFunc();
  23
  24 /**
  25 Indicates whether an extension is supported.  If this returns true, the
  26 functions of that extension are safe to use.
  27 */
  28 bool is_supported(const std::string &);
  29
  30 /**
  31 Returns the OpenGL version number, as reported by the implementation.
  32 Functions up to the returned version are safe to use.
  33 */
  34 const Version &get_gl_version();
  35
  36 /**
  37 Checks that an extension is supported and throws if it isn't.
  38 */
  39 void require_extension(const std::string &);
  40
  41 /**
  42 RAII version of require_extension.  Useful as a static local variable.
  43 */
  44 struct RequireExtension
  45 {
  46         RequireExtension(const std::string &e) { require_extension(e); }
  47 };
  48
  49 /**
  50 Checks that the OpenGL version is at least a.b and throws if it isn't.
  51 */
  52 void require_version(unsigned a, unsigned b);
  53
  54 /**
  55 RAII version of require_version.  Useful as a static local variable.
  56 */
  57 struct RequireVersion
  58 {
  59         RequireVersion(unsigned a, unsigned b) { require_version(a, b); }
  60 };
  61
  62 /**
  63 Returns the address of an extension function.
  64 */
  65 ExtFunc *get_proc_address(const std::string &);
  66
  67 } // namespace GL
  68 } // namespace Msp
  69
  70 #endif