opengl-bindings 1.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: aaf34ba647a0d10f96d95005bb9f7c9c5ce0e298
+  data.tar.gz: d705a711712e7ca59de0217300af197bd3803f84
+SHA512:
+  metadata.gz: 8573d09a2d0d120fed63d15b33d8557c715f811dc457b86e0ffff1516ad058457ec69681ca8cc43a10474444528ef057c145404acd453a914c3593d103260613
+  data.tar.gz: 8ee82b84e8b5dea0cad1e4b8327e41f0fe6dee43100cfaa6feafd318602c3e062a609ff16c2a69f058ed60a87e063453ab18d2938a1b933e26c57b6b0a32193d

data/ChangeLog

@@ -0,0 +1,41 @@
+2013-09-15  vaiorabbit  <https://twitter.com/vaiorabbit>
+
+	* opengl-bindings.gemspec: Added to make RubyGems package.
+	* Changed directory structure more RubyGems-compliant.
+
+2013-09-14  vaiorabbit  <https://twitter.com/vaiorabbit>
+
+	* generator/aux_generate_typemap.rb: Fixed to handle signed/unsinged correctly.
+	* sample/GLExcess: Added.
+	* opengl_ext_enum.rb, generator/generate_ext_enum.rb: Now checks if same constant is already defined before cosnt_set.
+
+2013-09-08  vaiorabbit  <https://twitter.com/vaiorabbit>
+
+	* opengl_ext_command.rb, opengl_ext_enum.rb, opengl_ext.rb: Added for OpenGL extension support.
+	* sample/report_env.rb: Reports the names of supported extensions.
+	* sample/Extension/nvpr_hello_world.rb: Added.
+
+2013-09-07  vaiorabbit  <https://twitter.com/vaiorabbit>
+
+	* opengl_command.rb: Updated using latest gl.xml.
+	* opengl_command.rb: Fixed some bugs.
+	* opengl_command.rb, glu.rb (load_dll): Updated platform detection.
+	* sample/report_env.rb : Added.
+	* opengl_common.rb (check_extension): Added.
+
+2013-09-05  vaiorabbit  <https://twitter.com/vaiorabbit>
+
+	* sample/ComputeShader: Added.
+
+2013-09-03  vaiorabbit  <https://twitter.com/vaiorabbit>
+
+	* opengl_platform.rb, opengl_windows.rb: Added.
+
+2013-08-28  vaiorabbit  <https://twitter.com/vaiorabbit>
+
+	* glu.rb: Added.
+
+2013-08-28  vaiorabbit  <https://twitter.com/vaiorabbit>
+
+	* (Announce) First release.
+

data/LICENSE.txt

@@ -0,0 +1,21 @@
+Ruby-OpenGL : Yet another OpenGL wrapper for Ruby (and wrapper code generator)
+Copyright (c) 2013- vaiorabbit <http://twitter.com/vaiorabbit>
+
+This software is provided 'as-is', without any express or implied
+warranty. In no event will the authors be held liable for any damages
+arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose,
+including commercial applications, and to alter it and redistribute it
+freely, subject to the following restrictions:
+
+    1. The origin of this software must not be misrepresented; you must not
+    claim that you wrote the original software. If you use this software
+    in a product, an acknowledgment in the product documentation would be
+    appreciated but is not required.
+
+    2. Altered source versions must be plainly marked as such, and must not be
+    misrepresented as being the original software.
+
+    3. This notice may not be removed or altered from any source
+    distribution.

data/README.md

@@ -0,0 +1,299 @@
+<!-- -*- mode:markdown; coding:utf-8; -*- -->
+
+# Yet another OpenGL wrapper for Ruby #
+
+...and wrapper code generator.
+
+*   Created : 2013-08-28
+*   Last modified : 2013-09-15
+
+
+## Features ##
+
+*   Uses Fiddle (One of the Ruby standard libraries that wraps libffi)
+	*   No need to build C extension library
+
+*   Uses Khronos XML API registry
+	*   The command/enum wrapper codes are generated via 'gl.xml'
+	*   Supports OpenGL 1.0 - 4.4, and all OpenGL extensions.
+
+
+## How to use ##
+
+See sample/simple.rb.
+
+To get more samples and generator scripts, please visit:
+https://github.com/vaiorabbit/ruby-opengl
+
+
+## Contents ##
+
+*   'opengl.rb' includes these scripts:
+    *   'opengl_command.rb'      : OpenGL command wrapper (glDrawRangeElements, etc.). Generated via generator/generate_command.rb.
+    *   'opengl_enum.rb'         : OpenGL enum wrapper (GL_TRIANGLE_STRIP, etc.). Generated via generator/generate_enum.rb.
+    *   'opengl_common.rb'       : Provies utilitiy funcitions.
+    *   'opengl_platform.rb'     : Provies platform check funcitions (OpneGL.get_platform).
+    *   'opengl_windows.rb'      : Provies funcitions for Windows platform (wglGetProcAddress).
+
+*   'opengl_ext.rb' includes these scripts:
+    *   'opengl_ext_command.rb'      : OpenGL extension command wrapper. Generated via generator/generate_ext_command.rb.
+    *   'opengl_ext_enum.rb'         : OpenGL extension enum wrapper Generated via generator/generate_ext_enum.rb.
+
+* 'glfw.rb'
+    * My handwirtten GLFW wrapper (https://github.com/vaiorabbit/ruby-glfw).
+
+* 'glu.rb'
+    * My handwirtten GLU wrapper.
+
+*   'generator/gl.xml'
+    *   Khronos' official XML API registry for OpenGL.
+
+*   'generator/Rakefile'
+    *   Type 'rake' to generate wrapper codes / fetch gl.xml.
+    *   You can get the latest one by 'get_gl_xml.rb'.
+
+*   'sample/simple.rb'
+    *   Simple example.
+    *   You need to get glfw3.dll (Windows) or libglfw.dylib (Mac OS X). See sample/README.md.
+
+*   'sample/data', 'sample/util'
+    *   Data and utilities for sample programs.
+
+## Prerequisites ##
+
+*   Fiddle
+	*   A libffi wrapper
+	*   Standard library since Ruby 2.0.0
+
+### For sample ###
+
+*   GLFW
+    *   http://www.glfw.org/
+    *   http://www.glfw.org/download.html
+
+### For generator ###
+
+*   nokogiri XML parser
+    *   http://nokogiri.org
+    *   http://nokogiri.org/tutorials/installing_nokogiri.html
+
+
+## Tested Environment ##
+
+*   Ruby
+    *   ruby 2.0.0p247 (2013-06-27 revision 41674) [x86_64-darwin12.4.0]
+    *   ruby 2.0.0p247 (2013-06-27) [i386-mingw32]
+
+*   Windows 7 Home Premium, 64-bit (Service Pack 1)
+    *   NVIDIA GeForce GTX 560
+        *   OpenGL 4.3
+
+                > ruby report_env.rb
+                4.3.0
+
+*   Mac OS X 10.8.4, 64-bit
+    *   NVIDIA GeForce 320M on Mac mini (Mid 2010)
+        *   OpenGL 2.1
+
+                $ ruby report_env.rb
+                2.1 NVIDIA-8.12.47 310.40.00.05f01
+
+*   Though I have not tested on Linux yet, it should work with proper 'OpenGL.load_dll' settings like:
+	*   OpenGL.load_dll( 'libGL.so', '/usr/lib' )
+	*   GLFW.load_dll( 'libGLFW.so', '.' )
+
+
+## Note ##
+
+*   No Ruby-Style handy interfaces are available (like one in the ruby-opengl2 (http://ruby-opengl.rubyforge.org/))
+	*   Example:
+		*   (Original C API)
+
+				GLuint tex_names_buf[2];
+				glGenTextures( 2, tex_names_buf );
+				GLuint tex_name = tex_names_buf[0];
+
+		*   (This library)
+
+				tex_names_buf = '    ' # String instance that is enough to catch texture names (integer).
+				glGenTextures( 2, tex_names_buf )
+				tex_name = tex_names_buf.unpack('L2')[0]
+
+		*   (ruby-opengl2)
+
+				tex_name = glGenTextures( 2 )[0]
+
+	*   Because:
+		*   I don't want to maintain this feature, which makes difficult to auto-generate.
+		*   I don't like to modify original OpenGL API.
+		*   Thanks to Fiddle, all these C-pointer issue can be simply handled with Array#pack and String#unpack.
+
+*   Reference : Other approaches after ruby-opengl2
+	*   OpenGL (opengl3) by davll (https://github.com/davll/ruby-opengl)
+		*   Built on Ruby-FFI, which is useful for JRuby users.
+	*   opengl-core by nilium (https://github.com/nilium/ruby-opengl)
+		*   Build on Fiddle.
+		*   Provides more customize points and handy utilities.
+
+
+## License ##
+
+The zlib/libpng License (http://opensource.org/licenses/Zlib).
+
+    Copyright (c) 2013 vaiorabbit@twitter.com
+
+    This software is provided 'as-is', without any express or implied
+    warranty. In no event will the authors be held liable for any damages
+    arising from the use of this software.
+
+    Permission is granted to anyone to use this software for any purpose,
+    including commercial applications, and to alter it and redistribute it
+    freely, subject to the following restrictions:
+
+    1. The origin of this software must not be misrepresented; you must not
+       claim that you wrote the original software. If you use this software in a
+       product, an acknowledgment in the product documentation would be
+       appreciated but is not required.
+
+    2. Altered source versions must be plainly marked as such, and must not be
+       misrepresented as being the original software.
+
+    3. This notice may not be removed or altered from any source distribution.
+
+Sample codes/resources under sample/GLExcess are provided under the GNU General
+Public License version 2. See sample/GLExcess/GPL2.txt .
+
+-------------------------------------------------------------------------------
+
+# 自前 Ruby-OpenGL と自動生成スクリプト #
+
+## 特徴 ##
+
+*   標準ライブラリ Fiddle を使っています ⇒ 拡張ライブラリをビルドする必要がありません
+*   関数とenumのラッパーコードは Khronos の XML API registry (gl.xml) から自動生成しています
+
+
+## 使い方 ##
+
+sample/simple.rb を参照してください。
+
+その他のサンプルと自動生成スクリプトはこちらで開発しています:
+https://github.com/vaiorabbit/ruby-opengl
+
+
+## 内容 ##
+
+*   'opengl.rb' を require することで下記のスクリプトを取り込みます:
+    *   'opengl_command.rb'      : OpenGL 関数のラッパーコード (glDrawRangeElements, etc.)。 generator/generate_command.rb で自動生成されたものです。
+    *   'opengl_enum.rb'         : OpenGL enum のラッパーコード (GL_TRIANGLE_STRIP, etc.)。 generator/generate_enum.rb で自動生成されたものです。
+    *   'opengl_common.rb'       : 共通のユーティリティ関数を提供しています。
+    *   'opengl_platform.rb'     : 動作プラットフォームの判別機能を提供しています (OpneGL.get_platform)。
+    *   'opengl_windows.rb'      : Windows用の機能を提供しています (wglGetProcAddress)。
+
+*   'opengl_ext.rb' を require することで下記のスクリプトを取り込みます:
+    *   'opengl_ext_command.rb'      : OpenGL 拡張関数のラッパーコード。 generator/generate_ext_command.rb で自動生成されたものです。
+    *   'opengl_ext_enum.rb'         : OpenGL 拡張enumのラッパーコード。 generator/generate_ext_enum.rb で自動生成されたものです。
+
+* 'glfw.rb'
+    * GLFW のラッパーコードです(自動生成ではありません) (https://github.com/vaiorabbit/ruby-glfw)。
+
+* 'glu.rb'
+    * GLU のラッパーコードです(自動生成ではありません)。
+
+*   'generator/gl.xml'
+    *   Khronos 公式の XML API registry です。
+
+*   'generator/Rakefile'
+    *   自動生成関連のタスクを自動化するためのものです。'rake' と打てば gl.xml の取得とラッパーコードの生成を実行します。
+    *   gl.xml の取得だけなど、単体のタスクなら 'get_gl_xml.rb' などの個別Rubyスクリプトでも実行できます。
+
+*   'sample/simple.rb'
+    *   一番簡単なサンプルです。
+    *   同じ場所に glfw3.dll (Windows) もしくは libglfw.dylib (Mac OS X) を置いてください。詳細は sample/README.md に記載されています。
+
+*   'sample/data', 'sample/util'
+    *   サンプルで共有する機能・データの配置場所です。
+
+
+## 必要なもの ##
+
+*   Fiddle
+	*   libffi のラッパーです
+	*   Ruby 2.0.0 以降で標準ライブラリになりました
+
+### サンプル用 ###
+
+*   GLFW
+    *   http://www.glfw.org/
+    *   http://www.glfw.org/download.html
+
+### 自動生成スクリプト用 ###
+
+*   nokogiri XML パーサー
+    *   http://nokogiri.org
+    *   http://nokogiri.org/tutorials/installing_nokogiri.html
+
+## テストした環境 ##
+
+*   Ruby
+    *   ruby 2.0.0p247 (2013-06-27 revision 41674) [x86_64-darwin12.4.0]
+    *   ruby 2.0.0p247 (2013-06-27) [i386-mingw32]
+
+*   Windows 7 Home Premium, 64-bit (Service Pack 1)
+    *   NVIDIA GeForce GTX 560
+        *   OpenGL 4.3
+
+                > ruby report_env.rb
+                4.3.0
+
+*   Mac OS X 10.8.4, 64-bit
+    *   NVIDIA GeForce 320M on Mac mini (Mid 2010)
+        *   OpenGL 2.1
+
+                $ ruby report_env.rb
+                2.1 NVIDIA-8.12.47 310.40.00.05f01
+
+*   まだ Linux では動作確認していませんが、'OpenGL.load_dll' などの引数が正しければ動くはず…
+	*   OpenGL.load_dll( 'libGL.so', '/usr/lib' )
+	*   GLFW.load_dll( 'libGLFW.so', '.' )
+
+
+## メモ ##
+
+*   Rubyスタイルの便利なインターフェースはサポートしていません (ruby-opengl2 (http://ruby-opengl.rubyforge.org/) にあったような感じのもの)
+	*   例:
+		*   (OpenGLオリジナルの C API)
+
+				GLuint tex_names_buf[2];
+				glGenTextures( 2, tex_names_buf );
+				GLuint tex_name = tex_names_buf[0];
+
+		*   (このライブラリの場合)
+
+				tex_names_buf = '    ' # テクスチャ名(GLuint)を受け取るのに十分なサイズ String インスタンスであればOK
+				glGenTextures( 2, tex_names_buf )
+				tex_name = tex_names_buf.unpack('L2')[0]
+
+		*   (ruby-opengl2 の場合)
+
+				tex_name = glGenTextures( 2 )[0] # glGenTextures が配列を返すように修正されています
+
+	*   なぜサポートしないのか:
+		*   面倒。自動生成になじまない。
+		*   OpenGL オリジナルの API を変更するのは個人的に嫌。
+		*   この手の C ポインタ関連の問題はすべて Array#pack と String#unpack だけで簡単に解決できます (Fiddleのおかげ)。
+
+*   参考 : ruby-opengl2 以降に出てきたその他のアプローチ
+	*   OpenGL (opengl3) by davll (https://github.com/davll/ruby-opengl)
+		*   Ruby-FFI を利用 ⇒ JRuby でも使えるようです
+	*   opengl-core by nilium (https://github.com/nilium/ruby-opengl)
+		*   Fiddle を利用
+		*   カスタマイズポイント・ユーティリティがこのライブラリよりも揃ってます
+
+
+## ライセンス ##
+
+*   zlib/libpng ライセンスです (http://opensource.org/licenses/Zlib)。
+
+*   sample/GLExcess 以下にあるものについては GNU General Public License version 2 です。
+    sample/GLExcess/GPL2.txt を参照してください。

data/lib/glfw.rb

@@ -0,0 +1,390 @@
+# -*- coding: utf-8 -*-
+require 'fiddle/import'
+
+module GLFW
+
+  extend Fiddle::Importer
+
+  #
+  # Fiddle's default 'extern' stores all methods into local variable '@func_map', that makes difficult to 'include GLFW'.
+  # So I override it and replace '@func_map' into 'GLFW_FUNCTIONS_MAP'.
+  # Ref.: /lib/ruby/2.0.0/fiddle/import.rb
+  #
+  GLFW_FUNCTIONS_MAP = {}
+  def self.extern(signature, *opts)
+    symname, ctype, argtype = parse_signature(signature, @type_alias)
+    opt = parse_bind_options(opts)
+    f = import_function(symname, ctype, argtype, opt[:call_type])
+    name = symname.gsub(/@.+/,'')
+    GLFW_FUNCTIONS_MAP[name] = f
+    begin
+      /^(.+?):(\d+)/ =~ caller.first
+      file, line = $1, $2.to_i
+    rescue
+      file, line = __FILE__, __LINE__+3
+    end
+    args_str="*args"
+    module_eval(<<-EOS, file, line)
+      def #{name}(*args, &block)
+        GLFW_FUNCTIONS_MAP['#{name}'].call(*args,&block)
+      end
+    EOS
+    module_function(name)
+    f
+  end
+
+  # defines
+  GLFW_VERSION_MAJOR     = 3
+  GLFW_VERSION_MINOR     = 0
+  GLFW_VERSION_REVISION  = 1
+
+  GLFW_RELEASE  = 0
+  GLFW_PRESS    = 1
+  GLFW_REPEAT   = 2
+
+  GLFW_KEY_UNKNOWN = -1
+
+  GLFW_KEY_SPACE          = 32
+  GLFW_KEY_APOSTROPHE     = 39  #  '
+  GLFW_KEY_COMMA          = 44  #  ,
+  GLFW_KEY_MINUS          = 45  #  -
+  GLFW_KEY_PERIOD         = 46  #  .
+  GLFW_KEY_SLASH          = 47  #  /
+  GLFW_KEY_0              = 48
+  GLFW_KEY_1              = 49
+  GLFW_KEY_2              = 50
+  GLFW_KEY_3              = 51
+  GLFW_KEY_4              = 52
+  GLFW_KEY_5              = 53
+  GLFW_KEY_6              = 54
+  GLFW_KEY_7              = 55
+  GLFW_KEY_8              = 56
+  GLFW_KEY_9              = 57
+  GLFW_KEY_SEMICOLON      = 59  #  ;
+  GLFW_KEY_EQUAL          = 61  #  =
+  GLFW_KEY_A              = 65
+  GLFW_KEY_B              = 66
+  GLFW_KEY_C              = 67
+  GLFW_KEY_D              = 68
+  GLFW_KEY_E              = 69
+  GLFW_KEY_F              = 70
+  GLFW_KEY_G              = 71
+  GLFW_KEY_H              = 72
+  GLFW_KEY_I              = 73
+  GLFW_KEY_J              = 74
+  GLFW_KEY_K              = 75
+  GLFW_KEY_L              = 76
+  GLFW_KEY_M              = 77
+  GLFW_KEY_N              = 78
+  GLFW_KEY_O              = 79
+  GLFW_KEY_P              = 80
+  GLFW_KEY_Q              = 81
+  GLFW_KEY_R              = 82
+  GLFW_KEY_S              = 83
+  GLFW_KEY_T              = 84
+  GLFW_KEY_U              = 85
+  GLFW_KEY_V              = 86
+  GLFW_KEY_W              = 87
+  GLFW_KEY_X              = 88
+  GLFW_KEY_Y              = 89
+  GLFW_KEY_Z              = 90
+  GLFW_KEY_LEFT_BRACKET   = 91  #  [
+  GLFW_KEY_BACKSLASH      = 92  #  \
+  GLFW_KEY_RIGHT_BRACKET  = 93  #  ]
+  GLFW_KEY_GRAVE_ACCENT   = 96  #  `
+  GLFW_KEY_WORLD_1        = 161 #  non-US #1
+  GLFW_KEY_WORLD_2        = 162 #  non-US #2
+
+  GLFW_KEY_ESCAPE         = 256
+  GLFW_KEY_ENTER          = 257
+  GLFW_KEY_TAB            = 258
+  GLFW_KEY_BACKSPACE      = 259
+  GLFW_KEY_INSERT         = 260
+  GLFW_KEY_DELETE         = 261
+  GLFW_KEY_RIGHT          = 262
+  GLFW_KEY_LEFT           = 263
+  GLFW_KEY_DOWN           = 264
+  GLFW_KEY_UP             = 265
+  GLFW_KEY_PAGE_UP        = 266
+  GLFW_KEY_PAGE_DOWN      = 267
+  GLFW_KEY_HOME           = 268
+  GLFW_KEY_END            = 269
+  GLFW_KEY_CAPS_LOCK      = 280
+  GLFW_KEY_SCROLL_LOCK    = 281
+  GLFW_KEY_NUM_LOCK       = 282
+  GLFW_KEY_PRINT_SCREEN   = 283
+  GLFW_KEY_PAUSE          = 284
+  GLFW_KEY_F1             = 290
+  GLFW_KEY_F2             = 291
+  GLFW_KEY_F3             = 292
+  GLFW_KEY_F4             = 293
+  GLFW_KEY_F5             = 294
+  GLFW_KEY_F6             = 295
+  GLFW_KEY_F7             = 296
+  GLFW_KEY_F8             = 297
+  GLFW_KEY_F9             = 298
+  GLFW_KEY_F10            = 299
+  GLFW_KEY_F11            = 300
+  GLFW_KEY_F12            = 301
+  GLFW_KEY_F13            = 302
+  GLFW_KEY_F14            = 303
+  GLFW_KEY_F15            = 304
+  GLFW_KEY_F16            = 305
+  GLFW_KEY_F17            = 306
+  GLFW_KEY_F18            = 307
+  GLFW_KEY_F19            = 308
+  GLFW_KEY_F20            = 309
+  GLFW_KEY_F21            = 310
+  GLFW_KEY_F22            = 311
+  GLFW_KEY_F23            = 312
+  GLFW_KEY_F24            = 313
+  GLFW_KEY_F25            = 314
+  GLFW_KEY_KP_0           = 320
+  GLFW_KEY_KP_1           = 321
+  GLFW_KEY_KP_2           = 322
+  GLFW_KEY_KP_3           = 323
+  GLFW_KEY_KP_4           = 324
+  GLFW_KEY_KP_5           = 325
+  GLFW_KEY_KP_6           = 326
+  GLFW_KEY_KP_7           = 327
+  GLFW_KEY_KP_8           = 328
+  GLFW_KEY_KP_9           = 329
+  GLFW_KEY_KP_DECIMAL     = 330
+  GLFW_KEY_KP_DIVIDE      = 331
+  GLFW_KEY_KP_MULTIPLY    = 332
+  GLFW_KEY_KP_SUBTRACT    = 333
+  GLFW_KEY_KP_ADD         = 334
+  GLFW_KEY_KP_ENTER       = 335
+  GLFW_KEY_KP_EQUAL       = 336
+  GLFW_KEY_LEFT_SHIFT     = 340
+  GLFW_KEY_LEFT_CONTROL   = 341
+  GLFW_KEY_LEFT_ALT       = 342
+  GLFW_KEY_LEFT_SUPER     = 343
+  GLFW_KEY_RIGHT_SHIFT    = 344
+  GLFW_KEY_RIGHT_CONTROL  = 345
+  GLFW_KEY_RIGHT_ALT      = 346
+  GLFW_KEY_RIGHT_SUPER    = 347
+  GLFW_KEY_MENU           = 348
+  GLFW_KEY_LAST           = GLFW_KEY_MENU
+
+  GLFW_MOD_SHIFT    = 0x0001
+  GLFW_MOD_CONTROL  = 0x0002
+  GLFW_MOD_ALT      = 0x0004
+  GLFW_MOD_SUPER    = 0x0008
+
+  GLFW_MOUSE_BUTTON_1       = 0
+  GLFW_MOUSE_BUTTON_2       = 1
+  GLFW_MOUSE_BUTTON_3       = 2
+  GLFW_MOUSE_BUTTON_4       = 3
+  GLFW_MOUSE_BUTTON_5       = 4
+  GLFW_MOUSE_BUTTON_6       = 5
+  GLFW_MOUSE_BUTTON_7       = 6
+  GLFW_MOUSE_BUTTON_8       = 7
+  GLFW_MOUSE_BUTTON_LAST    = GLFW_MOUSE_BUTTON_8
+  GLFW_MOUSE_BUTTON_LEFT    = GLFW_MOUSE_BUTTON_1
+  GLFW_MOUSE_BUTTON_RIGHT   = GLFW_MOUSE_BUTTON_2
+  GLFW_MOUSE_BUTTON_MIDDLE  = GLFW_MOUSE_BUTTON_3
+
+  GLFW_JOYSTICK_1     = 0
+  GLFW_JOYSTICK_2     = 1
+  GLFW_JOYSTICK_3     = 2
+  GLFW_JOYSTICK_4     = 3
+  GLFW_JOYSTICK_5     = 4
+  GLFW_JOYSTICK_6     = 5
+  GLFW_JOYSTICK_7     = 6
+  GLFW_JOYSTICK_8     = 7
+  GLFW_JOYSTICK_9     = 8
+  GLFW_JOYSTICK_10    = 9
+  GLFW_JOYSTICK_11    = 10
+  GLFW_JOYSTICK_12    = 11
+  GLFW_JOYSTICK_13    = 12
+  GLFW_JOYSTICK_14    = 13
+  GLFW_JOYSTICK_15    = 14
+  GLFW_JOYSTICK_16    = 15
+  GLFW_JOYSTICK_LAST  = GLFW_JOYSTICK_16
+
+  GLFW_NOT_INITIALIZED      = 0x00010001
+  GLFW_NO_CURRENT_CONTEXT   = 0x00010002
+  GLFW_INVALID_ENUM         = 0x00010003
+  GLFW_INVALID_VALUE        = 0x00010004
+  GLFW_OUT_OF_MEMORY        = 0x00010005
+  GLFW_API_UNAVAILABLE      = 0x00010006
+  GLFW_VERSION_UNAVAILABLE  = 0x00010007
+  GLFW_PLATFORM_ERROR       = 0x00010008
+  GLFW_FORMAT_UNAVAILABLE   = 0x00010009
+
+  GLFW_FOCUSED    = 0x00020001
+  GLFW_ICONIFIED  = 0x00020002
+  GLFW_RESIZABLE  = 0x00020003
+  GLFW_VISIBLE    = 0x00020004
+  GLFW_DECORATED  = 0x00020005
+
+  GLFW_RED_BITS          = 0x00021001
+  GLFW_GREEN_BITS        = 0x00021002
+  GLFW_BLUE_BITS         = 0x00021003
+  GLFW_ALPHA_BITS        = 0x00021004
+  GLFW_DEPTH_BITS        = 0x00021005
+  GLFW_STENCIL_BITS      = 0x00021006
+  GLFW_ACCUM_RED_BITS    = 0x00021007
+  GLFW_ACCUM_GREEN_BITS  = 0x00021008
+  GLFW_ACCUM_BLUE_BITS   = 0x00021009
+  GLFW_ACCUM_ALPHA_BITS  = 0x0002100A
+  GLFW_AUX_BUFFERS       = 0x0002100B
+  GLFW_STEREO            = 0x0002100C
+  GLFW_SAMPLES           = 0x0002100D
+  GLFW_SRGB_CAPABLE      = 0x0002100E
+  GLFW_REFRESH_RATE      = 0x0002100F
+
+  GLFW_CLIENT_API             = 0x00022001
+  GLFW_CONTEXT_VERSION_MAJOR  = 0x00022002
+  GLFW_CONTEXT_VERSION_MINOR  = 0x00022003
+  GLFW_CONTEXT_REVISION       = 0x00022004
+  GLFW_CONTEXT_ROBUSTNESS     = 0x00022005
+  GLFW_OPENGL_FORWARD_COMPAT  = 0x00022006
+  GLFW_OPENGL_DEBUG_CONTEXT   = 0x00022007
+  GLFW_OPENGL_PROFILE         = 0x00022008
+
+  GLFW_OPENGL_API     = 0x00030001
+  GLFW_OPENGL_ES_API  = 0x00030002
+
+  GLFW_NO_ROBUSTNESS          = 0
+  GLFW_NO_RESET_NOTIFICATION  = 0x00031001
+  GLFW_LOSE_CONTEXT_ON_RESET  = 0x00031002
+
+  GLFW_OPENGL_ANY_PROFILE     = 0
+  GLFW_OPENGL_CORE_PROFILE    = 0x00032001
+  GLFW_OPENGL_COMPAT_PROFILE  = 0x00032002
+
+  GLFW_CURSOR                = 0x00033001
+  GLFW_STICKY_KEYS           = 0x00033002
+  GLFW_STICKY_MOUSE_BUTTONS  = 0x00033003
+
+  GLFW_CURSOR_NORMAL    = 0x00034001
+  GLFW_CURSOR_HIDDEN    = 0x00034002
+  GLFW_CURSOR_DISABLED  = 0x00034003
+
+  GLFW_CONNECTED     = 0x00040001
+  GLFW_DISCONNECTED  = 0x00040002
+
+  # typedefs
+  @@glfw_cb_signature = {
+    :GLFWglproc => "void GLFWglproc()",
+    :GLFWerrorfun => "void GLFWerrorfun(int,const char*)",
+    :GLFWwindowposfun => "void GLFWwindowposfun(void*,int,int)",
+    :GLFWwindowsizefun => "void GLFWwindowsizefun(void*,int,int)",
+    :GLFWwindowclosefun => "void GLFWwindowclosefun(void*)",
+    :GLFWwindowrefreshfun => "void GLFWwindowrefreshfun(void*)",
+    :GLFWwindowfocusfun => "void GLFWwindowfocusfun(void*,int)",
+    :GLFWwindowiconifyfun => "void GLFWwindowiconifyfun(void*,int)",
+    :GLFWframebuffersizefun => "void GLFWframebuffersizefun(void*,int,int)",
+    :GLFWmousebuttonfun => "void GLFWmousebuttonfun(void*,int,int,int)",
+    :GLFWcursorposfun => "void GLFWcursorposfun(void*,double,double)",
+    :GLFWcursorenterfun => "void GLFWcursorenterfun(void*,int)",
+    :GLFWscrollfun => "void GLFWscrollfun(void*,double,double)",
+    :GLFWkeyfun => "void GLFWkeyfun(void*,int,int,int,int)",
+    :GLFWcharfun => "void GLFWcharfun(void*,unsigned int)",
+    :GLFWmonitorfun => "void GLFWmonitorfun(void*,int)",
+  }
+  def self.create_callback( sym, *opts, &blk )
+    return bind( @@glfw_cb_signature[sym], opts, &blk )
+  end
+
+  # struct
+  GLFWvidmode = struct(["int width",
+                        "int height",
+                        "int redBits",
+                        "int greenBits",
+                        "int blueBits",
+                        "int refreshRate"])
+
+  GLFWgammaramp = struct(["unsigned short* red",
+                          "unsigned short* green",
+                          "unsigned short* blue",
+                          "unsigned int size"])
+
+  @@glfw_import_done = false
+
+  # Load native library.
+  def self.load_dll(lib = 'libglfw.dylib', path = '.')
+    dlload (path + '/' + lib)
+    import_symbols() unless @@glfw_import_done
+  end
+
+  def self.import_symbols
+    # function
+    extern 'int glfwInit()'
+    extern 'void glfwTerminate()'
+    extern 'void glfwGetVersion(int*, int*, int*)'
+    extern 'const char* glfwGetVersionString()'
+    extern 'void* glfwSetErrorCallback(void*)'
+    extern 'void** glfwGetMonitors(int*)'
+    extern 'void* glfwGetPrimaryMonitor()'
+    extern 'void glfwGetMonitorPos(void*, int*, int*)'
+    extern 'void glfwGetMonitorPhysicalSize(void*, int*, int*)'
+    extern 'const char* glfwGetMonitorName(void*)'
+    extern 'void* glfwSetMonitorCallback(void*)'
+    extern 'const void* glfwGetVideoModes(void*, int*)'
+    extern 'const void* glfwGetVideoMode(void*)'
+    extern 'void glfwSetGamma(void*, float)'
+    extern 'const void* glfwGetGammaRamp(void*)'
+    extern 'void glfwSetGammaRamp(void*, const void*)'
+    extern 'void glfwDefaultWindowHints()'
+    extern 'void glfwWindowHint(int, int)'
+    extern 'void* glfwCreateWindow(int, int, const char*, void*, void*)'
+    extern 'void glfwDestroyWindow(void*)'
+    extern 'int glfwWindowShouldClose(void*)'
+    extern 'void glfwSetWindowShouldClose(void* window, int)'
+    extern 'void glfwSetWindowTitle(void*, const char*)'
+    extern 'void glfwGetWindowPos(void*, int*, int*)'
+    extern 'void glfwSetWindowPos(void*, int, int)'
+    extern 'void glfwGetWindowSize(void*, int*, int*)'
+    extern 'void glfwSetWindowSize(void*, int, int)'
+    extern 'void glfwGetFramebufferSize(void*, int*, int*)'
+    extern 'void glfwIconifyWindow(void*)'
+    extern 'void glfwRestoreWindow(void*)'
+    extern 'void glfwShowWindow(void*)'
+    extern 'void glfwHideWindow(void*)'
+    extern 'void* glfwGetWindowMonitor(void*)'
+    extern 'int glfwGetWindowAttrib(void*, int)'
+    extern 'void glfwSetWindowUserPointer(void*, void*)'
+    extern 'void* glfwGetWindowUserPointer(void*)'
+    extern 'void* glfwSetWindowPosCallback(void*, void*)'
+    extern 'void* glfwSetWindowSizeCallback(void*, void*)'
+    extern 'void* glfwSetWindowCloseCallback(void*, void*)'
+    extern 'void* glfwSetWindowRefreshCallback(void*, void*)'
+    extern 'void* glfwSetWindowFocusCallback(void*, void*)'
+    extern 'void* glfwSetWindowIconifyCallback(void*, void*)'
+    extern 'void* glfwSetFramebufferSizeCallback(void*, void*)'
+    extern 'void glfwPollEvents()'
+    extern 'void glfwWaitEvents()'
+    extern 'int glfwGetInputMode(void*, int)'
+    extern 'void glfwSetInputMode(void*, int, int)'
+    extern 'int glfwGetKey(void*, int)'
+    extern 'int glfwGetMouseButton(void*, int)'
+    extern 'void glfwGetCursorPos(void*, void*, void*)'
+    extern 'void glfwSetCursorPos(void*, double, double)'
+    extern 'void* glfwSetKeyCallback(void*, void*)'
+    extern 'void* glfwSetCharCallback(void*, void*)'
+    extern 'void* glfwSetMouseButtonCallback(void*, void*)'
+    extern 'void* glfwSetCursorPosCallback(void*, void*)'
+    extern 'void* glfwSetCursorEnterCallback(void*, void*)'
+    extern 'void* glfwSetScrollCallback(void*, void*)'
+    extern 'int glfwJoystickPresent(int)'
+    extern 'const float* glfwGetJoystickAxes(int, int*)'
+    extern 'const unsigned char* glfwGetJoystickButtons(int, int*)'
+    extern 'const char* glfwGetJoystickName(int)'
+    extern 'void glfwSetClipboardString(void*, const char*)'
+    extern 'const char* glfwGetClipboardString(void*)'
+    extern 'double glfwGetTime()'
+    extern 'void glfwSetTime(double)'
+    extern 'void glfwMakeContextCurrent(void*)'
+    extern 'void* glfwGetCurrentContext()'
+    extern 'void glfwSwapBuffers(void*)'
+    extern 'void glfwSwapInterval(int)'
+    extern 'int glfwExtensionSupported(const char*)'
+    extern 'void* glfwGetProcAddress(const char*)'
+
+    @@glfw_import_done = true
+  end
+
+end