ruby-opengl 0.60.1 → 0.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (127) hide show
  1. metadata +36 -186
  2. data/Rakefile +0 -168
  3. data/doc/build_install.txt +0 -122
  4. data/doc/extensions.txt +0 -556
  5. data/doc/extensions.txt.in +0 -348
  6. data/doc/history.txt +0 -66
  7. data/doc/requirements_and_design.txt +0 -117
  8. data/doc/roadmap.txt +0 -28
  9. data/doc/scientific_use.txt +0 -35
  10. data/doc/supplies/page_template.html +0 -71
  11. data/doc/thanks.txt +0 -29
  12. data/doc/tutorial.txt +0 -469
  13. data/examples/NeHe/nehe_lesson02.rb +0 -117
  14. data/examples/NeHe/nehe_lesson03.rb +0 -122
  15. data/examples/NeHe/nehe_lesson04.rb +0 -133
  16. data/examples/NeHe/nehe_lesson05.rb +0 -186
  17. data/examples/NeHe/nehe_lesson36.rb +0 -303
  18. data/examples/OrangeBook/3Dlabs-License.txt +0 -33
  19. data/examples/OrangeBook/brick.frag +0 -36
  20. data/examples/OrangeBook/brick.rb +0 -376
  21. data/examples/OrangeBook/brick.vert +0 -41
  22. data/examples/OrangeBook/particle.frag +0 -17
  23. data/examples/OrangeBook/particle.rb +0 -406
  24. data/examples/OrangeBook/particle.vert +0 -38
  25. data/examples/README +0 -16
  26. data/examples/RedBook/aapoly.rb +0 -142
  27. data/examples/RedBook/aargb.rb +0 -119
  28. data/examples/RedBook/accanti.rb +0 -162
  29. data/examples/RedBook/accpersp.rb +0 -215
  30. data/examples/RedBook/alpha.rb +0 -123
  31. data/examples/RedBook/alpha3D.rb +0 -158
  32. data/examples/RedBook/bezcurve.rb +0 -105
  33. data/examples/RedBook/bezmesh.rb +0 -137
  34. data/examples/RedBook/checker.rb +0 -124
  35. data/examples/RedBook/clip.rb +0 -95
  36. data/examples/RedBook/colormat.rb +0 -135
  37. data/examples/RedBook/cube.rb +0 -69
  38. data/examples/RedBook/depthcue.rb +0 -99
  39. data/examples/RedBook/dof.rb +0 -205
  40. data/examples/RedBook/double.rb +0 -105
  41. data/examples/RedBook/drawf.rb +0 -91
  42. data/examples/RedBook/feedback.rb +0 -145
  43. data/examples/RedBook/fog.rb +0 -167
  44. data/examples/RedBook/font.rb +0 -151
  45. data/examples/RedBook/hello.rb +0 -79
  46. data/examples/RedBook/image.rb +0 -137
  47. data/examples/RedBook/jitter.rb +0 -207
  48. data/examples/RedBook/lines.rb +0 -128
  49. data/examples/RedBook/list.rb +0 -111
  50. data/examples/RedBook/material.rb +0 -275
  51. data/examples/RedBook/mipmap.rb +0 -156
  52. data/examples/RedBook/model.rb +0 -113
  53. data/examples/RedBook/movelight.rb +0 -132
  54. data/examples/RedBook/pickdepth.rb +0 -179
  55. data/examples/RedBook/planet.rb +0 -108
  56. data/examples/RedBook/quadric.rb +0 -158
  57. data/examples/RedBook/robot.rb +0 -115
  58. data/examples/RedBook/select.rb +0 -196
  59. data/examples/RedBook/smooth.rb +0 -95
  60. data/examples/RedBook/stencil.rb +0 -163
  61. data/examples/RedBook/stroke.rb +0 -167
  62. data/examples/RedBook/surface.rb +0 -166
  63. data/examples/RedBook/teaambient.rb +0 -132
  64. data/examples/RedBook/teapots.rb +0 -182
  65. data/examples/RedBook/tess.rb +0 -183
  66. data/examples/RedBook/texbind.rb +0 -147
  67. data/examples/RedBook/texgen.rb +0 -169
  68. data/examples/RedBook/texturesurf.rb +0 -128
  69. data/examples/RedBook/varray.rb +0 -159
  70. data/examples/RedBook/wrap.rb +0 -148
  71. data/examples/misc/OGLBench.rb +0 -337
  72. data/examples/misc/anisotropic.rb +0 -194
  73. data/examples/misc/fbo_test.rb +0 -356
  74. data/examples/misc/font-glut.rb +0 -46
  75. data/examples/misc/glfwtest.rb +0 -30
  76. data/examples/misc/plane.rb +0 -161
  77. data/examples/misc/readpixel.rb +0 -65
  78. data/examples/misc/sdltest.rb +0 -34
  79. data/examples/misc/trislam.rb +0 -828
  80. data/ext/common/common.h +0 -423
  81. data/ext/common/conv.h +0 -244
  82. data/ext/common/funcdef.h +0 -280
  83. data/ext/common/gl-enums.h +0 -10031
  84. data/ext/common/gl-error.h +0 -23
  85. data/ext/common/gl-types.h +0 -61
  86. data/ext/common/glu-enums.h +0 -463
  87. data/ext/gl/gl-1.0-1.1.c +0 -2817
  88. data/ext/gl/gl-1.2.c +0 -814
  89. data/ext/gl/gl-1.3.c +0 -444
  90. data/ext/gl/gl-1.4.c +0 -349
  91. data/ext/gl/gl-1.5.c +0 -225
  92. data/ext/gl/gl-2.0.c +0 -657
  93. data/ext/gl/gl-2.1.c +0 -57
  94. data/ext/gl/gl-enums.c +0 -3354
  95. data/ext/gl/gl-error.c +0 -104
  96. data/ext/gl/gl-ext-3dfx.c +0 -27
  97. data/ext/gl/gl-ext-arb.c +0 -866
  98. data/ext/gl/gl-ext-ati.c +0 -41
  99. data/ext/gl/gl-ext-ext.c +0 -890
  100. data/ext/gl/gl-ext-gremedy.c +0 -41
  101. data/ext/gl/gl-ext-nv.c +0 -679
  102. data/ext/gl/gl.c +0 -214
  103. data/ext/gl/mkrf_conf.rb +0 -34
  104. data/ext/glu/glu-enums.c +0 -164
  105. data/ext/glu/glu.c +0 -1530
  106. data/ext/glu/mkrf_conf.rb +0 -35
  107. data/ext/glut/glut.c +0 -1623
  108. data/ext/glut/mkrf_conf.rb +0 -37
  109. data/lib/opengl.rb +0 -84
  110. data/test/README +0 -10
  111. data/test/tc_common.rb +0 -98
  112. data/test/tc_ext_arb.rb +0 -467
  113. data/test/tc_ext_ati.rb +0 -33
  114. data/test/tc_ext_ext.rb +0 -551
  115. data/test/tc_ext_gremedy.rb +0 -36
  116. data/test/tc_ext_nv.rb +0 -357
  117. data/test/tc_func_10_11.rb +0 -1281
  118. data/test/tc_func_12.rb +0 -186
  119. data/test/tc_func_13.rb +0 -229
  120. data/test/tc_func_14.rb +0 -197
  121. data/test/tc_func_15.rb +0 -270
  122. data/test/tc_func_20.rb +0 -346
  123. data/test/tc_func_21.rb +0 -541
  124. data/test/tc_glu.rb +0 -310
  125. data/test/tc_include_gl.rb +0 -35
  126. data/test/tc_misc.rb +0 -54
  127. data/test/tc_require_gl.rb +0 -34
metadata CHANGED
@@ -1,208 +1,58 @@
1
- --- !ruby/object:Gem::Specification
1
+ --- !ruby/object:Gem::Specification
2
2
  name: ruby-opengl
3
- version: !ruby/object:Gem::Version
4
- version: 0.60.1
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.61.0
5
+ prerelease:
5
6
  platform: ruby
6
- authors:
7
+ authors:
7
8
  - Alain Hoang
8
9
  - Jan Dvorak
9
10
  - Minh Thu Vo
10
11
  - James Adam
11
- autorequire: gl
12
+ autorequire:
12
13
  bindir: bin
13
14
  cert_chain: []
14
-
15
- date: 2009-02-16 00:00:00 +01:00
16
- default_executable:
17
- dependencies:
18
- - !ruby/object:Gem::Dependency
19
- name: mkrf
15
+ date: 2013-02-04 00:00:00.000000000 Z
16
+ dependencies:
17
+ - !ruby/object:Gem::Dependency
18
+ name: opengl
19
+ requirement: &6170700 !ruby/object:Gem::Requirement
20
+ none: false
21
+ requirements:
22
+ - - ! '>='
23
+ - !ruby/object:Gem::Version
24
+ version: '0'
20
25
  type: :runtime
21
- version_requirement:
22
- version_requirements: !ruby/object:Gem::Requirement
23
- requirements:
24
- - - ">="
25
- - !ruby/object:Gem::Version
26
- version: 0.2.0
27
- version:
28
- - !ruby/object:Gem::Dependency
29
- name: rake
30
- type: :runtime
31
- version_requirement:
32
- version_requirements: !ruby/object:Gem::Requirement
33
- requirements:
34
- - - ">="
35
- - !ruby/object:Gem::Version
36
- version: "0"
37
- version:
26
+ prerelease: false
27
+ version_requirements: *6170700
38
28
  description:
39
29
  email: [email protected]
40
30
  executables: []
41
-
42
- extensions:
43
- - Rakefile
31
+ extensions: []
44
32
  extra_rdoc_files: []
45
-
46
- files:
47
- - lib/opengl.rb
48
- - ext/glut
49
- - ext/glut/glut.c
50
- - ext/glut/mkrf_conf.rb
51
- - ext/gl
52
- - ext/gl/gl-1.5.c
53
- - ext/gl/gl-ext-ext.c
54
- - ext/gl/gl-ext-ati.c
55
- - ext/gl/gl-ext-nv.c
56
- - ext/gl/gl-2.1.c
57
- - ext/gl/gl-1.4.c
58
- - ext/gl/gl-ext-gremedy.c
59
- - ext/gl/gl-1.3.c
60
- - ext/gl/gl-enums.c
61
- - ext/gl/gl-error.c
62
- - ext/gl/gl.c
63
- - ext/gl/gl-ext-3dfx.c
64
- - ext/gl/gl-ext-arb.c
65
- - ext/gl/gl-2.0.c
66
- - ext/gl/mkrf_conf.rb
67
- - ext/gl/gl-1.2.c
68
- - ext/gl/gl-1.0-1.1.c
69
- - ext/common
70
- - ext/common/funcdef.h
71
- - ext/common/common.h
72
- - ext/common/conv.h
73
- - ext/common/gl-types.h
74
- - ext/common/gl-enums.h
75
- - ext/common/glu-enums.h
76
- - ext/common/gl-error.h
77
- - ext/glu
78
- - ext/glu/glu.c
79
- - ext/glu/glu-enums.c
80
- - ext/glu/mkrf_conf.rb
81
- - doc/extensions.txt
82
- - doc/supplies
83
- - doc/supplies/page_template.html
84
- - doc/scientific_use.txt
85
- - doc/tutorial.txt
86
- - doc/build_install.txt
87
- - doc/extensions.txt.in
88
- - doc/thanks.txt
89
- - doc/history.txt
90
- - doc/roadmap.txt
91
- - doc/requirements_and_design.txt
92
- - examples/NeHe
93
- - examples/NeHe/nehe_lesson04.rb
94
- - examples/NeHe/nehe_lesson36.rb
95
- - examples/NeHe/nehe_lesson03.rb
96
- - examples/NeHe/nehe_lesson02.rb
97
- - examples/NeHe/nehe_lesson05.rb
98
- - examples/README
99
- - examples/OrangeBook
100
- - examples/OrangeBook/brick.frag
101
- - examples/OrangeBook/particle.vert
102
- - examples/OrangeBook/3Dlabs-License.txt
103
- - examples/OrangeBook/brick.rb
104
- - examples/OrangeBook/particle.rb
105
- - examples/OrangeBook/particle.frag
106
- - examples/OrangeBook/brick.vert
107
- - examples/RedBook
108
- - examples/RedBook/checker.rb
109
- - examples/RedBook/texbind.rb
110
- - examples/RedBook/texgen.rb
111
- - examples/RedBook/teapots.rb
112
- - examples/RedBook/bezmesh.rb
113
- - examples/RedBook/clip.rb
114
- - examples/RedBook/aargb.rb
115
- - examples/RedBook/double.rb
116
- - examples/RedBook/alpha.rb
117
- - examples/RedBook/jitter.rb
118
- - examples/RedBook/dof.rb
119
- - examples/RedBook/colormat.rb
120
- - examples/RedBook/smooth.rb
121
- - examples/RedBook/pickdepth.rb
122
- - examples/RedBook/varray.rb
123
- - examples/RedBook/accanti.rb
124
- - examples/RedBook/cube.rb
125
- - examples/RedBook/wrap.rb
126
- - examples/RedBook/lines.rb
127
- - examples/RedBook/bezcurve.rb
128
- - examples/RedBook/robot.rb
129
- - examples/RedBook/hello.rb
130
- - examples/RedBook/aapoly.rb
131
- - examples/RedBook/movelight.rb
132
- - examples/RedBook/model.rb
133
- - examples/RedBook/accpersp.rb
134
- - examples/RedBook/depthcue.rb
135
- - examples/RedBook/drawf.rb
136
- - examples/RedBook/list.rb
137
- - examples/RedBook/surface.rb
138
- - examples/RedBook/material.rb
139
- - examples/RedBook/planet.rb
140
- - examples/RedBook/quadric.rb
141
- - examples/RedBook/image.rb
142
- - examples/RedBook/stroke.rb
143
- - examples/RedBook/texturesurf.rb
144
- - examples/RedBook/feedback.rb
145
- - examples/RedBook/teaambient.rb
146
- - examples/RedBook/select.rb
147
- - examples/RedBook/font.rb
148
- - examples/RedBook/stencil.rb
149
- - examples/RedBook/tess.rb
150
- - examples/RedBook/fog.rb
151
- - examples/RedBook/mipmap.rb
152
- - examples/RedBook/alpha3D.rb
153
- - examples/misc
154
- - examples/misc/sdltest.rb
155
- - examples/misc/readpixel.rb
156
- - examples/misc/plane.rb
157
- - examples/misc/fbo_test.rb
158
- - examples/misc/anisotropic.rb
159
- - examples/misc/glfwtest.rb
160
- - examples/misc/OGLBench.rb
161
- - examples/misc/font-glut.rb
162
- - examples/misc/trislam.rb
163
- - test/tc_include_gl.rb
164
- - test/tc_ext_ati.rb
165
- - test/tc_func_10_11.rb
166
- - test/tc_func_14.rb
167
- - test/tc_ext_arb.rb
168
- - test/tc_func_13.rb
169
- - test/tc_func_20.rb
170
- - test/tc_glu.rb
171
- - test/tc_require_gl.rb
172
- - test/tc_ext_gremedy.rb
173
- - test/README
174
- - test/tc_func_15.rb
175
- - test/tc_ext_ext.rb
176
- - test/tc_ext_nv.rb
177
- - test/tc_misc.rb
178
- - test/tc_func_12.rb
179
- - test/tc_func_21.rb
180
- - test/tc_common.rb
181
- has_rdoc: false
33
+ files: []
182
34
  homepage: http://ruby-opengl.rubyforge.org
35
+ licenses: []
183
36
  post_install_message:
184
37
  rdoc_options: []
185
-
186
- require_paths:
38
+ require_paths:
187
39
  - lib
188
- required_ruby_version: !ruby/object:Gem::Requirement
189
- requirements:
190
- - - ">="
191
- - !ruby/object:Gem::Version
192
- version: "0"
193
- version:
194
- required_rubygems_version: !ruby/object:Gem::Requirement
195
- requirements:
196
- - - ">="
197
- - !ruby/object:Gem::Version
198
- version: "0"
199
- version:
40
+ required_ruby_version: !ruby/object:Gem::Requirement
41
+ none: false
42
+ requirements:
43
+ - - ! '>='
44
+ - !ruby/object:Gem::Version
45
+ version: '0'
46
+ required_rubygems_version: !ruby/object:Gem::Requirement
47
+ none: false
48
+ requirements:
49
+ - - ! '>='
50
+ - !ruby/object:Gem::Version
51
+ version: '0'
200
52
  requirements: []
201
-
202
53
  rubyforge_project: ruby-opengl
203
- rubygems_version: 1.2.0
54
+ rubygems_version: 1.8.17
204
55
  signing_key:
205
- specification_version: 2
56
+ specification_version: 3
206
57
  summary: OpenGL Interface for Ruby
207
58
  test_files: []
208
-
data/Rakefile DELETED
@@ -1,168 +0,0 @@
1
- #-*-ruby-*-
2
- #
3
- # Copyright (C) 2006 John M. Gabriele <[email protected]>
4
- #
5
- # This program is distributed under the terms of the MIT license.
6
- # See the included MIT-LICENSE file for the terms of this license.
7
- #
8
- # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
9
- # OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
10
- # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
11
- # IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
12
- # CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
13
- # TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
14
- # SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
15
-
16
- begin
17
- require 'rubygems'
18
- rescue LoadError
19
- nil
20
- end
21
-
22
- require 'rake'
23
- require 'rake/clean'
24
- require 'rake/gempackagetask'
25
- require 'rake/testtask'
26
-
27
- require 'mkrf/rakehelper'
28
-
29
- # Generate html docs from the markdown source and upload to the site.
30
- # All doc files that are destined for the website have filenames that
31
- # end in .txt.
32
-
33
- WEBSITE_MKDN = FileList['./doc/*.txt'] << 'README.txt'
34
- NICE_HTML_DOCS = WEBSITE_MKDN.ext('html')
35
-
36
- # defines columns in the HTML extension list
37
- GLEXT_VERSIONS = ["svn","0.60","0.50"]
38
-
39
- CLEAN.include("ext/gl*/Rakefile", "ext/*/mkrf.log", "ext/*/*.so",
40
- "ext/**/*.bundle", "lib/*.so", "lib/*.bundle", "ext/*/*.o{,bj}",
41
- "ext/*/*.lib", "ext/*/*.exp", "ext/*/*.pdb",
42
- "pkg")
43
- CLOBBER.include("*.plain", "doc/*.plain", "doc/*.snip", "*.html",
44
- "doc/*.html", "website/*.html", "website/images/*")
45
- # Make sure these files aren't deleted in a clobber op
46
- CLOBBER.exclude("website/images/tab_bottom.gif")
47
- CLOBBER.exclude("website/images/*.jpg")
48
-
49
- setup_extension('gl', 'gl')
50
- setup_extension('glu', 'glu')
51
- setup_extension('glut', 'glut')
52
-
53
- case RUBY_PLATFORM
54
- when /(:?mswin|mingw)/
55
- desc 'Does a full win32 compile'
56
- task :default do
57
- exts = ["gl","glu","glut"]
58
- exts.each do |ext|
59
- Dir.chdir("ext\\#{ext}") do
60
- sh "ruby mkrf_conf.rb"
61
- sh "call rake --nosearch"
62
- sh "copy #{ext}.so ..\\..\\lib"
63
- end
64
- end
65
- end
66
- else
67
- desc 'Does a full compile'
68
- task :default => [:gl, :glu, :glut, :fixpermissions]
69
- end
70
-
71
- task :fixpermissions do
72
- # fix wrong lib permissions (mkrf bug ?)
73
- Dir["lib/*.so","lib/*.bundle"].each do |fname|
74
- File.chmod(0755,fname)
75
- end
76
- end
77
-
78
- task :extension => :default
79
-
80
- desc 'Show contents of some variables related to website doc generation.'
81
- task :explain_website do
82
- puts "WEBSITE_MKDN:"
83
- WEBSITE_MKDN.each do |doc|
84
- puts "\t#{doc}"
85
- end
86
- puts "NICE_HTML_DOCS:"
87
- NICE_HTML_DOCS.each do |doc|
88
- puts "\t#{doc}"
89
- end
90
- end
91
-
92
- desc 'Generate supported extension list.'
93
- task :gen_glext_list do
94
- sh "./utils/extlistgen.rb doc/extensions.txt.in doc/extensions.txt " + GLEXT_VERSIONS.join(" ")
95
- end
96
-
97
- desc 'Generate website html.'
98
- task :gen_website => [:gen_glext_list] + NICE_HTML_DOCS do
99
- # Now that the website docs have been generated, copy them to ./website.
100
- puts
101
- sh "cp README.html website/index.html"
102
- sh "cp doc/*.html website"
103
- end
104
-
105
- # You'll see some intermediate .plain files get generated. These are html,
106
- # but don't yet have their code snippets syntax highlighted.
107
- rule '.html' => '.plain' do |t|
108
- puts "Turning #{t.source} into #{t.name} ..."
109
- sh "./utils/post-mkdn2html.rb #{t.source} #{t.name}"
110
- end
111
-
112
- # Process the markdown docs into plain html.
113
- rule '.plain' => '.txt' do |t|
114
- puts
115
- puts "Turning #{t.source} into #{t.name} ..."
116
- sh "./utils/mkdn2html.rb #{t.source} #{t.name}"
117
- end
118
-
119
- desc 'Upload the newly-built site to RubyForge.'
120
- task :upload_website => [:gen_website] do
121
- sh "scp website/*.html [email protected]:/var/www/gforge-projects/ruby-opengl"
122
- sh "scp website/images/* [email protected]:/var/www/gforge-projects/ruby-opengl/images/"
123
- end
124
-
125
- desc 'Upload entire site, including stylesheet and the images directory.'
126
- task :upload_entire_website => [:gen_website] do
127
- sh "scp website/*.html [email protected]:/var/www/gforge-projects/ruby-opengl"
128
- sh "scp website/*.css [email protected]:/var/www/gforge-projects/ruby-opengl"
129
- sh "scp -r website/images [email protected]:/var/www/gforge-projects/ruby-opengl"
130
- end
131
-
132
- desc 'Runs unit tests.'
133
- Rake::TestTask.new do |t|
134
- t.libs << "test"
135
- t.test_files = FileList['test/tc_*.rb']
136
- t.verbose = true
137
- end
138
-
139
- desc 'Runs unit tests.'
140
- task :test_all => [:test]
141
-
142
- # Define the files that will go into the gem
143
- gem_files = FileList["{lib,ext,doc,examples,test}/**/*"]
144
- gem_files = gem_files.exclude("**/*.so", "**/*.o{,bj}", "ext/**/*.log", "ext/gl*/Rakefile")
145
-
146
- spec = Gem::Specification.new do |s|
147
- s.name = "ruby-opengl"
148
- s.version = "0.60.1"
149
- s.authors = [ "Alain Hoang", "Jan Dvorak", "Minh Thu Vo", "James Adam" ]
150
- s.homepage = "http://ruby-opengl.rubyforge.org"
151
- s.email = "[email protected]"
152
- s.rubyforge_project = 'ruby-opengl'
153
- s.platform = Gem::Platform::RUBY
154
- s.summary = "OpenGL Interface for Ruby"
155
- s.files = gem_files
156
- s.extensions << 'Rakefile'
157
- s.require_path = "lib"
158
- s.autorequire = "gl"
159
- s.has_rdoc = false
160
- s.add_dependency("mkrf", ">=0.2.0")
161
- s.add_dependency("rake")
162
- end
163
-
164
- # Create a task for creating a ruby gem
165
- Rake::GemPackageTask.new(spec) do |pkg|
166
- pkg.gem_spec = spec
167
- pkg.need_tar = true
168
- end
@@ -1,122 +0,0 @@
1
- Building ruby-opengl
2
- ====================
3
-
4
- Pre-requisites
5
- --------------
6
-
7
- General
8
- --------------
9
- * C compiler (not needed for binary install on Windows)
10
- * ruby 1.8.5+ or ruby 1.9.0+
11
- * rake
12
- * mkrf 0.2.0+ (0.2.3+ for ruby 1.9)
13
- * rubygems 0.9.1+
14
- * OpenGL headers for OpenGL version 1.1 or later (not needed for binary install on Windows)
15
- * GLUT 3.7+ or API-compatible implementation (freeglut,OpenGLUT)
16
-
17
- Linux
18
- --------------
19
- On Ubuntu or Debian systems, aside from Ruby you'll need ruby and
20
- some extra ruby related packages:
21
-
22
- * `ruby rdoc ri ruby1.8-dev`
23
-
24
- For OpenGL related headers you'll need the following packages:
25
-
26
- * `libgl1-mesa-dri libglu1-mesa freeglut3`
27
- * `libgl1-mesa-dev libglu1-mesa-dev freeglut3-dev`
28
-
29
- On older Gentoo, Debian and Ubuntu, rubygems 0.9.0 will be installed by default
30
- in the packages. This version of rubygems is INCOMPATIBLE with ruby-opengl.
31
- You'll need to install rubygems 0.9.1+ from source.
32
-
33
- On some distributions you may need 'xorg-dev' developer package.
34
-
35
- Mac OS X
36
- --------------
37
- On OS X, you will need to install your own version of Ruby as the
38
- version that ships with OS X has known problems with properly building
39
- ruby-opengl bindings. You'll also need XCode for gcc and tools. Macports
40
- or fink should handle this cleanly.
41
-
42
- * To compile under Mac OS X you MUST install your own version of Ruby
43
- as the version included with Tiger (1.8.2) has a broken rbconfig
44
- and will fail to build the project properly. Try either [MacPorts][],
45
- [Fink][], or [building your own from source][].
46
-
47
- [Macports]: http://www.macports.org/
48
- [Fink]: http://finkproject.org/
49
- [building your own from source]: http://www.ruby-lang.org/en/downloads/
50
-
51
- Windows
52
- --------------
53
- For manual build on Windows you need to have platform SDK and compiler that *must* match the one which was used for compiling ruby binary (for One-click ruby installer it is MSVC 6.0).
54
- You may also need 'glut.h' in SDK include directory, as the One-click ruby
55
- installer is missing it. You can copy the file from glut package at [glut homepage][].
56
- Alternatively, you can install the precompiled binary gem (see bellow).
57
-
58
- <b>Important note:</b> If you are using the One-click installer version 1.8.6-25 or earlier,
59
- you must delete or rename files 'opengl.so' and 'glut.so' in
60
- C:/ruby/lib/ruby/site_ruby/1.8/i386-msvcrt
61
-
62
- [glut homepage]: http://www.xmission.com/~nate/glut.html
63
-
64
- Build and installation
65
- --------------
66
-
67
- Installing from rubygems
68
- -------------------
69
-
70
- ruby-opengl should support being installed via gems now. Just
71
- try 'gem install -y ruby-opengl' and it should pull down the gem
72
- and try to build the bindings for you automatically.
73
-
74
- For windows there is also pre-built binary windows gem available
75
- (i386-mswin32) which is compatible with the ruby one-click installer and does not need
76
- compiler or other mentioned tools installed.
77
-
78
- Manual Build instructions for all platforms (see above for platform-specific notes)
79
- ------------------
80
- 1. Make sure you have working ruby with rubygems installed
81
- and (if needed) appropriate developer packages (ruby-dev,ruby1.8-dev,...).
82
- 2. Make sure you have working C compiler
83
- 3. Install rake either from package or by running 'gem install rake'
84
- 4. Install mkrf (0.2.0+) either from package or by running 'gem install mkrf'
85
- 5. Make sure you have working OpenGL installation, this includes libGL,libGLU,
86
- glut and (if needed) appropriate -dev or -devel packages.
87
- 6. Run 'rake' at the top level of the project
88
- 7. (OPTIONAL) Run 'rake test' to run unit tests to verify it works properly
89
-
90
- Installing manually built extensions
91
- ------------------
92
- 1. Run 'rake clean' to clean out the project
93
- 2. Run 'rake gem' to create source gem from project
94
- 3. Run 'gem install pkg/ruby-opengl-(version).gem' to compile and install the gem
95
- 4. Done.
96
-
97
- Building binary gem (useful only for binary distribution of the project)
98
- ------------------
99
- 1. Run 'gem install gembuilder' to install the gembuilder package
100
- 2. Run 'rake clean' to clean out the project
101
- 3. Run 'rake gem' to build source gem
102
- 4. Run 'gembuilder pkg/ruby-opengl-(version).gem' to compile the binary gem
103
-
104
-
105
- Testing
106
- -----------------
107
-
108
- To run unit tests:
109
-
110
- $ rake test
111
-
112
- Note that the tests have the adverse effect of testing the underlying OpenGL
113
- implementation, so depending on your GL provider,drivers or OS, the tests may
114
- fail, crash, or not run at all, without affecting your ability to use the
115
- bindings.
116
-
117
- Running programs and examples
118
- -----------------
119
- To run a sample file, make sure the ruby-opengl gem is installed then:
120
-
121
- $ cd examples
122
- $ ruby -rubygems plane.rb
OSZAR »