sdl2-win93 1.0.0

data/ext/sdl2_ext/gamecontroller.c.m4

@@ -0,0 +1,408 @@
+/* -*- mode: C -*- */
+#include "rubysdl2_internal.h"
+#include <SDL_gamecontroller.h>
+
+static VALUE cGameController;
+static VALUE mAxis;
+static VALUE mButton;
+
+typedef struct GameController {
+    SDL_GameController* controller;
+} GameController;
+
+static void GameController_free(GameController* g)
+{
+    if (rubysdl2_is_active() && g->controller)
+        SDL_GameControllerClose(g->controller);
+    free(g);
+}
+
+/*
+ * Document-class: SDL2::GameController
+ *
+ * This class represents a "Game Controller".
+ *
+ * In SDL2, there is a gamecontroller framework to
+ * hide the details of joystick types. This framework
+ * is built on the existing joystick API.
+ * 
+ * The framework consists of two parts:
+ *
+ * * Mapping joysticks to game controllers
+ * * Aquire input from game controllers
+ *
+ * Mapping information is a string, and described as:
+ *
+ *    GUID,name,mapping
+ *
+ * GUID is a unique ID of a type of joystick and
+ * given by {Joystick#GUID}. name is the human readable
+ * string for the device, and mappings are contorller mappings
+ * to joystick ones.
+ * 
+ * This mappings abstract the details of joysticks, for exmaple,
+ * the number of buttons, the number of axes, and the position
+ * of these buttons a on pad.
+ * You can use unified interface 
+ * with this framework theoretically.
+ * Howerver, we need to prepare the
+ * database of many joysticks that users will use. A database
+ * is available at https://github.com/gabomdq/SDL_GameControllerDB,
+ * but perhaps this is not sufficient for your usage.
+ * In fact, Steam prepares its own database for Steam games,
+ * so if you will create a game for Steam, this framework is
+ * useful. Otherwise, it is a better way to use joystick API
+ * directly.
+ *
+ * @!method destroy?
+ *   Return true if the gamecontroller is already closed.
+ */
+
+static VALUE GameController_new(SDL_GameController* controller)
+{
+    GameController* g = ALLOC(GameController);
+    g->controller = controller;
+    return Data_Wrap_Struct(cGameController, 0, GameController_free, g);
+}
+
+DEFINE_WRAPPER(SDL_GameController, GameController, controller, cGameController,
+               "SDL2::GameController");
+
+
+/*
+ * @overload add_mapping(string)
+ *
+ *   Add suuport for controolers that SDL is unaware of or to cause an
+ *   existing controller to have a different binding.
+ *
+ *   "GUID,name,mapping", where GUID is
+ *   the string value from SDL_JoystickGetGUIDString(), name is the human
+ *   readable string for the device and mappings are controller mappings to
+ *   joystick ones. Under Windows there is a reserved GUID of "xinput" that
+ *   covers all XInput devices. The mapping format for joystick is:
+ * 
+ *   * bX:   a joystick button, index X
+ *   * hX.Y: hat X with value Y
+ *   * aX:   axis X of the joystick
+ *
+ *   Buttons can be used as a controller axes and vice versa.
+ *
+ *   This string shows an example of a valid mapping for a controller:
+ *   "341a3608000000000000504944564944,Afterglow PS3 Controller,a:b1,b:b2,y:b3,x:b0,start:b9,guide:b12,back:b8,dpup:h0.1,dpleft:h0.8,dpdown:h0.4,dpright:h0.2,leftshoulder:b4,,rightshoulder:b5,leftstick:b10,rightstick:b11,leftx:a0,lefty:a1,rightx:a2,righty:a3,lefttrigger:b6,righttrigger:b7"
+ *   
+ *   @param string [String] mapping string
+ *   @return [Integer] 1 if a new mapping, 0 if an existing mapping is updated.
+ */
+static VALUE GameController_s_add_mapping(VALUE self, VALUE string)
+{
+    int ret = HANDLE_ERROR(SDL_GameControllerAddMapping(StringValueCStr(string)));
+    return INT2NUM(ret);
+}
+
+/*
+ * @overload axis_name_of(axis)
+ *
+ *   Get a string representing **axis**.
+ *
+ *   @param axis [Integer] axis constant in {Axis}
+ *   @return [String]
+ */
+static VALUE GameController_s_axis_name_of(VALUE self, VALUE axis)
+{
+    const char* name = SDL_GameControllerGetStringForAxis(NUM2INT(axis));
+    if (!name) {
+        SDL_SetError("Unknown axis %d", NUM2INT(axis));
+        SDL_ERROR();
+    }
+    return utf8str_new_cstr(name);
+}
+
+/*
+ * @overload button_name_of(button)
+ *
+ *   Get a string representing **button**.
+ *
+ *   @param button [Integer] button constant in {Button}
+ *   @return [String]
+ */
+static VALUE GameController_s_button_name_of(VALUE self, VALUE button)
+{
+    const char* name = SDL_GameControllerGetStringForButton(NUM2INT(button));
+    if (!name) {
+        SDL_SetError("Unknown axis %d", NUM2INT(button));
+        SDL_ERROR();
+    }
+    return utf8str_new_cstr(name);
+}
+
+/*
+ * @overload axis_from_name(name)
+ *
+ *   Get a integer representation of the axis
+ *   whose string representation is **name**.
+ *
+ *   The return value is the value of one of the constants in {Axis}
+ *
+ *   @param name [String] a string representing an axis
+ *   @return [Integer]
+ */
+static VALUE GameController_s_axis_from_name(VALUE self, VALUE name)
+{
+    int axis = SDL_GameControllerGetAxisFromString(StringValueCStr(name));
+    if (axis < 0) {
+        SDL_SetError("Unknown axis name \"%s\"", StringValueCStr(name));
+        SDL_ERROR();
+    } 
+    return INT2FIX(axis);
+}
+
+/*
+ * @overload button_from_name(name)
+ *
+ *   Get a integer representation of the button
+ *   whose string representation is **name**.
+ *
+ *   The return value is the value of one of the constants in {Button}
+ *
+ *   @param name [String] a string representing a button
+ *   @return [Integer]
+ */
+static VALUE GameController_s_button_from_name(VALUE self, VALUE name)
+{
+    int button = SDL_GameControllerGetButtonFromString(StringValueCStr(name));
+    if (button < 0) {
+        SDL_SetError("Unknown button name \"%s\"", StringValueCStr(name));
+        SDL_ERROR();
+    }
+    return INT2FIX(button);
+}
+
+/*
+ * Get the implementation dependent name for the game controllers
+ * connected to the machine.
+ * 
+ * The number of elements of returning array is same as
+ * {Joystick.num_connected_joysticks}.
+ * 
+ * @return [Array<String,nil>]
+ */
+static VALUE GameController_s_device_names(VALUE self)
+{
+    int num_joysticks = SDL_NumJoysticks();
+    int i;
+    VALUE device_names = rb_ary_new2(num_joysticks);
+    for (i=0; i<num_joysticks; ++i) {
+        const char* name = SDL_GameControllerNameForIndex(i);
+        if (name)
+            rb_ary_push(device_names, utf8str_new_cstr(name));
+        else
+            rb_ary_push(device_names, Qnil);
+    }
+    return device_names;
+}
+
+/*
+ * @overload mapping_for(guid_string)
+ *   Get the game controller mapping string for a given GUID.
+ *   
+ *   @param guid_string [String] GUID string
+ *   
+ *   @return [String] 
+ */
+static VALUE GameController_s_mapping_for(VALUE self, VALUE guid_string)
+{
+    SDL_JoystickGUID guid = SDL_JoystickGetGUIDFromString(StringValueCStr(guid_string));
+    return utf8str_new_cstr(SDL_GameControllerMappingForGUID(guid));
+}
+
+/*
+ * @overload open(index) 
+ *   Open a game controller and return the opened GameController object.
+ *   
+ *   @param index [Integer] device index, up to the return value of {Joystick.num_connected_joysticks}.
+ *   @return [SDL2::GameController]
+ *   
+ *   @raise [SDL2::Error] raised when device open is failed.
+ *     For exmaple, **index** is out of range.
+ */
+static VALUE GameController_s_open(VALUE self, VALUE index)
+{
+    SDL_GameController* controller = SDL_GameControllerOpen(NUM2INT(index));
+    if (!controller)
+        SDL_ERROR();
+    return GameController_new(controller);
+}
+
+/*
+ * Get the name of an opened game controller.
+ *
+ * @return [String]
+ */
+static VALUE GameController_name(VALUE self)
+{
+    const char* name = SDL_GameControllerName(Get_SDL_GameController(self));
+    if (!name)
+        SDL_ERROR();
+
+    return utf8str_new_cstr(name);
+}
+
+/*
+ * Return true if **self** is opened and attached.
+ */
+static VALUE GameController_attached_p(VALUE self)
+{
+    return INT2BOOL(SDL_GameControllerGetAttached(Get_SDL_GameController(self)));
+}
+
+/*
+ * Close the game controller.
+ * 
+ * @return nil
+ */
+static VALUE GameController_destroy(VALUE self)
+{
+    GameController* g = Get_GameController(self);
+    if (g->controller)
+        SDL_GameControllerClose(g->controller);
+    g->controller = NULL;
+    return Qnil;
+}
+
+/*
+ * Get the mapping string of **self**.
+ *
+ * @return [String]
+ * @see .add_mapping
+ * @see .mapping_for
+ */
+static VALUE GameController_mapping(VALUE self)
+{
+    return utf8str_new_cstr(SDL_GameControllerMapping(Get_SDL_GameController(self)));
+}
+
+/*
+ * @overload axis(axis)
+ *   Get the state of an axis control.
+ *   
+ *   The state is an integer from -32768 to 32767. 
+ *   The state of trigger never returns negative value (from 0 to 32767).
+ *   
+ *   @param axis [Integer] the index of an axis, one of the constants in {Axis}
+ *   @return [Integer]
+ */
+static VALUE GameController_axis(VALUE self, VALUE axis)
+{
+    return INT2FIX(SDL_GameControllerGetAxis(Get_SDL_GameController(self),
+                                             NUM2INT(axis)));
+}
+
+/*
+ * @overload button_pressed?(button) 
+ *   Return true if a button is pressed.
+ *   
+ *   @param button [Integer] the index of a button, one of the constants in {Button}
+ */
+static VALUE GameController_button_pressed_p(VALUE self, VALUE button)
+{
+    return INT2BOOL(SDL_GameControllerGetButton(Get_SDL_GameController(self),
+                                                NUM2INT(button)));
+}
+
+/*
+ * Document-module: SDL2::GameController::Axis
+ *
+ * This module provides constants of gamecontroller's axis indices used by
+ * {SDL2::GameController} class.
+ */
+
+/*
+ * Document-module: SDL2::GameController::Button
+ *
+ * This module provides constants of gamecontroller's button indices used by
+ * {SDL2::GameController} class.
+ */
+void rubysdl2_init_gamecontorller(void)
+{
+    cGameController = rb_define_class_under(mSDL2, "GameController", rb_cObject);
+
+    rb_define_singleton_method(cGameController, "add_mapping",
+                               GameController_s_add_mapping, 1);
+    rb_define_singleton_method(cGameController, "device_names",
+                               GameController_s_device_names, 0);
+    rb_define_singleton_method(cGameController, "axis_name_of",
+                               GameController_s_axis_name_of, 1);
+    rb_define_singleton_method(cGameController, "button_name_of",
+                               GameController_s_button_name_of, 1);
+    rb_define_singleton_method(cGameController, "mapping_for",
+                               GameController_s_mapping_for, 1);
+    rb_define_singleton_method(cGameController, "button_from_name",
+                               GameController_s_button_from_name, 1);
+    rb_define_singleton_method(cGameController, "axis_from_name",
+                               GameController_s_axis_from_name, 1);
+    rb_define_singleton_method(cGameController, "open", GameController_s_open, 1);
+    rb_define_method(cGameController, "destroy?", GameController_destroy_p, 0);
+    rb_define_method(cGameController, "destroy", GameController_destroy, 0);
+    rb_define_method(cGameController, "name", GameController_name, 0);
+    rb_define_method(cGameController, "attached?", GameController_attached_p, 0);
+    rb_define_method(cGameController, "mapping", GameController_mapping, 0);
+    rb_define_method(cGameController, "axis", GameController_axis, 1);
+    rb_define_method(cGameController, "button_pressed?", GameController_button_pressed_p, 1);
+
+    mAxis = rb_define_module_under(cGameController, "Axis");
+    mButton = rb_define_module_under(cGameController, "Button");
+
+    /* define(`DEFINE_CONTROLLER_AXIS_CONST',`rb_define_const(mAxis, "$1", INT2NUM(SDL_CONTROLLER_AXIS_$1))') */
+    /* Invalid axis index */
+    DEFINE_CONTROLLER_AXIS_CONST(INVALID);
+    /* Left X axis */
+    DEFINE_CONTROLLER_AXIS_CONST(LEFTX);
+    /* Left Y axis */
+    DEFINE_CONTROLLER_AXIS_CONST(LEFTY);
+    /* Right X axis */
+    DEFINE_CONTROLLER_AXIS_CONST(RIGHTX);
+    /* Right Y axis */
+    DEFINE_CONTROLLER_AXIS_CONST(RIGHTY);
+    /* Left trigger axis */
+    DEFINE_CONTROLLER_AXIS_CONST(TRIGGERLEFT);
+    /* Right trigger axis */
+    DEFINE_CONTROLLER_AXIS_CONST(TRIGGERRIGHT);
+    /* The max of an axis index */
+    DEFINE_CONTROLLER_AXIS_CONST(MAX);
+
+    /* define(`DEFINE_CONTROLLER_BUTTON_CONST',`rb_define_const(mButton, "$1", INT2NUM(SDL_CONTROLLER_BUTTON_$1))') */
+    /* Invalid button index */
+    DEFINE_CONTROLLER_BUTTON_CONST(INVALID);
+    /* Button A */
+    DEFINE_CONTROLLER_BUTTON_CONST(A);
+    /* Button B */
+    DEFINE_CONTROLLER_BUTTON_CONST(B);
+    /* Button X */
+    DEFINE_CONTROLLER_BUTTON_CONST(X);
+    /* Button Y */
+    DEFINE_CONTROLLER_BUTTON_CONST(Y);
+    /* Back Button */
+    DEFINE_CONTROLLER_BUTTON_CONST(BACK);
+    /* Guide Button */
+    DEFINE_CONTROLLER_BUTTON_CONST(GUIDE);
+    /* Start Button */
+    DEFINE_CONTROLLER_BUTTON_CONST(START);
+    /* Left stick Button */
+    DEFINE_CONTROLLER_BUTTON_CONST(LEFTSTICK);
+    /* Right stick Button */
+    DEFINE_CONTROLLER_BUTTON_CONST(RIGHTSTICK);
+    /* Left shoulder Button */
+    DEFINE_CONTROLLER_BUTTON_CONST(LEFTSHOULDER);
+    /* Right shoulder Button */
+    DEFINE_CONTROLLER_BUTTON_CONST(RIGHTSHOULDER);
+    /* D-pad UP Button */
+    DEFINE_CONTROLLER_BUTTON_CONST(DPAD_UP);
+    /* D-pad DOWN Button */
+    DEFINE_CONTROLLER_BUTTON_CONST(DPAD_DOWN);
+    /* D-pad LEFT Button */
+    DEFINE_CONTROLLER_BUTTON_CONST(DPAD_LEFT);
+    /* D-pad RIGHT Button */
+    DEFINE_CONTROLLER_BUTTON_CONST(DPAD_RIGHT);
+    /* The max of a button index */
+    DEFINE_CONTROLLER_BUTTON_CONST(MAX);
+}

data/ext/sdl2_ext/gl.c

@@ -0,0 +1,351 @@
+/* -*- mode: C -*- */
+#include "rubysdl2_internal.h"
+#include <SDL_video.h>
+#include <SDL_version.h>
+
+static VALUE mGL;
+static VALUE cGLContext;
+
+static VALUE current_context = Qnil;
+
+typedef struct GLContext {
+    SDL_GLContext context;
+} GLContext;
+
+DEFINE_WRAPPER(SDL_GLContext, GLContext, context, cGLContext, "SDL2::GL::Context");
+
+static void GLContext_free(GLContext* c)
+{
+    if (c->context)
+        SDL_GL_DeleteContext(c->context);
+    free(c);
+}
+
+static VALUE GLContext_new(SDL_GLContext context)
+{
+    GLContext* c = ALLOC(GLContext);
+    c->context = context;
+    return Data_Wrap_Struct(cGLContext, 0, GLContext_free, c);
+}
+
+/*
+ * Document-module: SDL2::GL
+ *
+ * This module provides the initialize/shutdown functions of OpenGL.
+ *
+ */
+
+/*
+ * Document-class: SDL2::GL::Context
+ *
+ * This class represents an OpenGL context.
+ *
+ * You must create a new OpenGL context before using
+ * OpenGL functions.
+ *
+ * @!method destroy?
+ *   Return true if the context is {#destroy destroyed}.
+ */
+
+/*
+ * @overload create(window)
+ *   Create an OpenGL context for use with an OpenGL window, and make it
+ *   current.
+ *
+ *   @param window [SDL2::Window] the window associate with a new context
+ *   @return [SDL2::GL::Context]
+ *
+ *   @see #delete
+ *
+ *   @example
+ *
+ *     SDL2.init(SDL2::INIT_EVERYTHING)
+ *     # You need to create a window with `OPENGL' flag
+ *     window = SDL2::Window.create("testgl", 0, 0, WINDOW_W, WINDOW_H,
+ *                                  SDL2::Window::Flags::OPENGL)
+ *                                  
+ *     # Create a OpenGL context attached to the window
+ *     context = SDL2::GL::Context.create(window)
+ *
+ *     # You can use OpenGL functions
+ *          :
+ *          
+ *     # Delete the context after using OpenGL functions
+ *     context.destroy
+ */
+static VALUE GLContext_s_create(VALUE self, VALUE window)
+{
+    SDL_GLContext context = SDL_GL_CreateContext(Get_SDL_Window(window));
+    if (!context)
+        SDL_ERROR();
+
+    return (current_context = GLContext_new(context));
+}
+
+/*
+ * Delete the OpenGL context.
+ *
+ * @return [nil]
+ *
+ * @see #destroy?
+ */
+static VALUE GLContext_destroy(VALUE self)
+{
+    GLContext* c = Get_GLContext(self);
+    if (c->context)
+        SDL_GL_DeleteContext(c->context);
+    c->context = NULL;
+    return Qnil;
+}
+
+/*
+ * @overload make_current(window)
+ *   Set the OpenGL context for rendering into an OpenGL window.
+ *
+ *   @param window [SDL2::Window] the window to associate with the context
+ *   @return [nil]
+ */
+static VALUE GLContext_make_current(VALUE self, VALUE window)
+{
+    HANDLE_ERROR(SDL_GL_MakeCurrent(Get_SDL_Window(window), Get_SDL_GLContext(self)));
+    current_context = self;
+    return Qnil;
+}
+
+/*
+ * Get the current OpenGL context.
+ *
+ * @return [SDL2::GL::Context] the curren context
+ * @return [nil] if there is no current context
+ *
+ * @see #make_current
+ */
+static VALUE GLContext_s_current(VALUE self)
+{
+    return current_context;
+}
+
+/*
+ * @overload extension_supported?(extension) 
+ *   Return true if the current context supports **extension**
+ *
+ *   @param extension [String] the name of an extension
+ *   @example
+ *     SDL2::GL.extension_supported?("GL_EXT_framebuffer_blit")
+ */
+static VALUE GL_s_extension_supported_p(VALUE self, VALUE extension)
+{
+    return INT2BOOL(SDL_GL_ExtensionSupported(StringValueCStr(extension)));
+}
+
+/*
+ * Get the state of swap interval of the current context.
+ *
+ * @return [Integer]
+ *   return 0 when vsync is not used,
+ *   return 1 when vsync is used,
+ *   and return -1 when vsync is not supported by the system (OS).
+ *   
+ */
+static VALUE GL_s_swap_interval(VALUE self)
+{
+    return INT2NUM(SDL_GL_GetSwapInterval());
+}
+
+
+/*
+ * @overload swap_interval=(interval) 
+ *   Set the state of swap interval of the current context.
+ *
+ *   @param interval [Integer]
+ *     0 if you don't want to wait for vsync,
+ *     1 if you want to wait for vsync,
+ *     -1 if you want to use late swap tearing
+ *   @return [nil]
+ *   
+ */
+static VALUE GL_s_set_swap_interval(VALUE self, VALUE interval)
+{
+    HANDLE_ERROR(SDL_GL_SetSwapInterval(NUM2INT(interval)));
+    return Qnil;
+}
+
+/*
+ * @overload get_attribute(attr)
+ *   Get the acutal value for an attribute from current context.
+ *   
+ *   @param attr [Integer] the OpenGL attribute to query
+ *   @return [Integer] 
+ */
+static VALUE GL_s_get_attribute(VALUE self, VALUE attr)
+{
+    int value;
+    HANDLE_ERROR(SDL_GL_GetAttribute(NUM2INT(attr), &value));
+    return INT2NUM(value);
+}
+
+/*
+ * @overload set_attribute(attr, value)
+ *   Set an OpenGL window attribute before window creation.
+ *   
+ *   @param attr [Integer] the OpenGL attribute to set
+ *   @param value [Integer] the desired value for the attribute
+ *   @return [value]
+ */
+static VALUE GL_s_set_attribute(VALUE self, VALUE attr, VALUE value)
+{
+    HANDLE_ERROR(SDL_GL_SetAttribute(NUM2INT(attr), NUM2INT(value)));
+    return value;
+}
+
+void rubysdl2_init_gl(void)
+{
+    mGL = rb_define_module_under(mSDL2, "GL");
+    cGLContext = rb_define_class_under(mGL, "Context", rb_cObject);
+
+    rb_define_singleton_method(cGLContext, "create", GLContext_s_create, 1);
+    rb_define_singleton_method(cGLContext, "current", GLContext_s_current, 0);
+    
+    rb_define_method(cGLContext, "destroy?", GLContext_destroy_p, 0);
+    rb_define_method(cGLContext, "destroy", GLContext_destroy, 0);
+    rb_define_method(cGLContext, "make_current", GLContext_make_current, 1);
+    
+    rb_define_module_function(mGL, "extension_supported?", GL_s_extension_supported_p, 1);
+    rb_define_module_function(mGL, "swap_interval", GL_s_swap_interval, 0);
+    rb_define_module_function(mGL, "swap_interval=", GL_s_set_swap_interval, 1);
+    rb_define_module_function(mGL, "get_attribute", GL_s_get_attribute, 1);
+    rb_define_module_function(mGL, "set_attribute", GL_s_set_attribute, 2);
+
+    /*  */
+    /* OpenGL attribute - minimal bits of red channel in color buffer, default is 3 */
+    rb_define_const(mGL, "RED_SIZE", INT2NUM(SDL_GL_RED_SIZE));
+    /* OpenGL attribute - minimal bits of green channel in color buffer, default is 3 */
+    rb_define_const(mGL, "GREEN_SIZE", INT2NUM(SDL_GL_GREEN_SIZE));
+    /* OpenGL attribute - minimal bits of blue channel in color buffer, default is 2 */
+    rb_define_const(mGL, "BLUE_SIZE", INT2NUM(SDL_GL_BLUE_SIZE));
+    /* OpenGL attribute - minimal bits of alpha channel in color buffer, default is 0 */
+    rb_define_const(mGL, "ALPHA_SIZE", INT2NUM(SDL_GL_ALPHA_SIZE));
+    /* OpenGL attribute - minimal bits of framebufer, default is 0 */
+    rb_define_const(mGL, "BUFFER_SIZE", INT2NUM(SDL_GL_BUFFER_SIZE));
+    /* OpenGL attribute - whether the single buffer (0) or double buffer (1), default
+       is double buffer */
+    rb_define_const(mGL, "DOUBLEBUFFER", INT2NUM(SDL_GL_DOUBLEBUFFER));
+    /* OpenGL attribute - bits of depth buffer, default is 16 */
+    rb_define_const(mGL, "DEPTH_SIZE", INT2NUM(SDL_GL_DEPTH_SIZE));
+    /* OpenGL attribute - bits of stencil buffer, default is 0 */
+    rb_define_const(mGL, "STENCIL_SIZE", INT2NUM(SDL_GL_STENCIL_SIZE));
+    /* OpenGL attribute - minimal bits of red channel in accumlation buffer,
+       default is 0 */
+    rb_define_const(mGL, "ACCUM_RED_SIZE", INT2NUM(SDL_GL_ACCUM_RED_SIZE));
+    /* OpenGL attribute - minimal bits of green channel in accumlation buffer,
+       default is 0 */
+    rb_define_const(mGL, "ACCUM_GREEN_SIZE", INT2NUM(SDL_GL_ACCUM_GREEN_SIZE));
+    /* OpenGL attribute - minimal bits of blue channel in accumlation buffer,
+       default is 0 */
+    rb_define_const(mGL, "ACCUM_BLUE_SIZE", INT2NUM(SDL_GL_ACCUM_BLUE_SIZE));
+    /* OpenGL attribute - minimal bits of alpha channel in accumlation buffer,
+       default is 0 */
+    rb_define_const(mGL, "ACCUM_ALPHA_SIZE", INT2NUM(SDL_GL_ACCUM_ALPHA_SIZE));
+    /* OpenGL attribute - whether output is stereo (1) or not (0), default is 0 */
+    rb_define_const(mGL, "STEREO", INT2NUM(SDL_GL_STEREO));
+    /* OpenGL attribuite - the number of buffers used for multisampe anti-aliasing,
+       default is 0 */
+    rb_define_const(mGL, "MULTISAMPLEBUFFERS", INT2NUM(SDL_GL_MULTISAMPLEBUFFERS));
+    /* OpenGL attribute - the number of samples used around the current pixel
+       use for multisample anti-aliasing, default is 0 */
+    rb_define_const(mGL, "MULTISAMPLESAMPLES", INT2NUM(SDL_GL_MULTISAMPLESAMPLES));
+    /* OpenGL attribute - 1 for requiring hardware acceleration, 0 for software rendering,
+       default is allowing either */
+    rb_define_const(mGL, "ACCELERATED_VISUAL", INT2NUM(SDL_GL_ACCELERATED_VISUAL));
+    /* OpenGL attribute - not used (deprecated) */
+    rb_define_const(mGL, "RETAINED_BACKING", INT2NUM(SDL_GL_RETAINED_BACKING));
+    /* OpenGL attribute - OpenGL context major version */
+    rb_define_const(mGL, "CONTEXT_MAJOR_VERSION", INT2NUM(SDL_GL_CONTEXT_MAJOR_VERSION));
+    /* OpenGL attribute - OpenGL context minor version */
+    rb_define_const(mGL, "CONTEXT_MINOR_VERSION", INT2NUM(SDL_GL_CONTEXT_MINOR_VERSION));
+    /*
+     * INT2NUM(SDL_GL_CONTEXT_FLAGS):
+     * 
+     * OpenGL attribute - the bit combination of following constants, or 0.
+     * default is 0
+     *
+     * * {SDL2::GL::CONTEXT_DEBUG_FLAG}
+     * * {SDL2::GL::CONTEXT_FORWARD_COMPATIBLE_FLAG}
+     * * {SDL2::GL::CONTEXT_ROBUST_ACCESS_FLAG}
+     * * {SDL2::GL::CONTEXT_RESET_ISOLATION_FLAG}
+     *
+     * These flags are mapped to some OpenGL extensions. Please see
+     * the documentation of each constant for more details.
+     *
+     * https://wiki.libsdl.org/SDL_GLcontextFlag
+     */
+    rb_define_const(mGL, "CONTEXT_FLAGS", INT2NUM(SDL_GL_CONTEXT_FLAGS));
+    /* INT2NUM(SDL_GL_CONTEXT_PROFILE_MASK):
+     *
+     * OpenGL attribute - type of GL context, one of the following constants,
+     * defaults depends on platform
+     *
+     * * {CONTEXT_PROFILE_CORE}
+     * * {CONTEXT_PROFILE_COMPATIBILITY}
+     * * {CONTEXT_PROFILE_ES}
+     *
+     * https://wiki.libsdl.org/SDL_GLprofile
+     */
+    rb_define_const(mGL, "CONTEXT_PROFILE_MASK", INT2NUM(SDL_GL_CONTEXT_PROFILE_MASK));
+    /* OpenGL attribute - OpenGL context sharing, default is 0 */
+    rb_define_const(mGL, "SHARE_WITH_CURRENT_CONTEXT", INT2NUM(SDL_GL_SHARE_WITH_CURRENT_CONTEXT));
+#if SDL_VERSION_ATLEAST(2,0,1)
+    /* OpenGL attribute - 1 for requesting sRGB capable visual, default to 0 */
+    rb_define_const(mGL, "FRAMEBUFFER_SRGB_CAPABLE", INT2NUM(SDL_GL_FRAMEBUFFER_SRGB_CAPABLE));
+#endif
+    /* OpenGL attribute - not used (deprecated) */
+    rb_define_const(mGL, "CONTEXT_EGL", INT2NUM(SDL_GL_CONTEXT_EGL));
+
+    /*  */
+
+    /* This flag maps to GLX_CONTEXT_DEBUG_BIT_ARB in
+     * the GLX_ARB_create_context extension for X11
+     * and WGL_CONTEXT_DEBUG_BIT_ARB in the WGL_ARB_create_context
+     * extension for Windows.
+     */
+    rb_define_const(mGL, "CONTEXT_DEBUG_FLAG", INT2NUM(SDL_GL_CONTEXT_DEBUG_FLAG));
+    /*
+     * This flag maps to GLX_CONTEXT_FORWARD_COMPATIBLE_BIT_ARB in the
+     * GLX_ARB_create_context extension for X11 and
+     * WGL_CONTEXT_FORWARD_COMPATIBLE_BIT_ARB in the WGL_ARB_create_context
+     * extension for Windows.
+     */
+    rb_define_const(mGL, "CONTEXT_FORWARD_COMPATIBLE_FLAG", INT2NUM(SDL_GL_CONTEXT_FORWARD_COMPATIBLE_FLAG));
+    /*
+     * This flag maps to GLX_CONTEXT_ROBUST_ACCESS_BIT_ARB in the
+     * GLX_ARB_create_context_robustness extension for X11 and
+     * WGL_CONTEXT_ROBUST_ACCESS_BIT_ARB in the WGL_ARB_create_context_robustness
+     * extension for Windows. 
+     */
+    rb_define_const(mGL, "CONTEXT_ROBUST_ACCESS_FLAG", INT2NUM(SDL_GL_CONTEXT_ROBUST_ACCESS_FLAG));
+    /*
+     * This flag maps to GLX_CONTEXT_RESET_ISOLATION_BIT_ARB in the
+     * GLX_ARB_robustness_isolation extension for X11 and
+     * WGL_CONTEXT_RESET_ISOLATION_BIT_ARB in the WGL_ARB_create_context_robustness
+     * extension for Windows.
+     */
+    rb_define_const(mGL, "CONTEXT_RESET_ISOLATION_FLAG", INT2NUM(SDL_GL_CONTEXT_RESET_ISOLATION_FLAG));
+
+    /*
+     * OpenGL core profile - deprecated
+     * functions are disabled
+     */
+    rb_define_const(mGL, "CONTEXT_PROFILE_CORE", INT2NUM(SDL_GL_CONTEXT_PROFILE_CORE));
+    /*
+     * OpenGL compatibility profile -
+     * deprecated functions are allowed
+     */
+    rb_define_const(mGL, "CONTEXT_PROFILE_COMPATIBILITY", INT2NUM(SDL_GL_CONTEXT_PROFILE_COMPATIBILITY));
+    /*
+     * OpenGL ES profile - only a subset of the
+     * base OpenGL functionality is available
+     */
+    rb_define_const(mGL, "CONTEXT_PROFILE_ES", INT2NUM(SDL_GL_CONTEXT_PROFILE_ES));
+    
+    rb_gc_register_address(&current_context);
+}