RubyGems - sgl - Versions diffs - 0.3.1 → 0.4.0 - Mend

sgl 0.3.1 → 0.4.0

Files changed (103) hide show

data/ChangeLog +234 -0
data/Manifest.txt +94 -0
data/Rakefile +16 -5
data/examples/cocoa1-basic.rb +14 -0
data/examples/cocoa10-transparent.rb +26 -0
data/examples/cocoa11-application.rb +13 -0
data/examples/cocoa2-draw.rb +23 -0
data/examples/cocoa3-affine.rb +29 -0
data/examples/cocoa4-font.rb +24 -0
data/examples/cocoa5-image.rb +22 -0
data/examples/cocoa6-sound.rb +24 -0
data/examples/cocoa7-movie.rb +40 -0
data/examples/cocoa8-movieoverlay.rb +42 -0
data/examples/cocoa9-streaming.rb +40 -0
data/examples/opengl1-basic.rb +14 -0
data/examples/opengl11-application.rb +13 -0
data/examples/opengl2-draw.rb +23 -0
data/examples/opengl3-affine.rb +29 -0
data/examples/sample1.rb +11 -0
data/examples/sample10.rb +16 -0
data/examples/sample11.rb +22 -0
data/examples/sample11a.rb +33 -0
data/examples/sample12.rb +30 -0
data/examples/sample12a.rb +35 -0
data/examples/sample13.rb +116 -0
data/examples/sample15.rb +24 -0
data/examples/sample16.rb +31 -0
data/examples/sample16a.rb +35 -0
data/examples/sample6.rb +18 -0
data/examples/sample7.rb +16 -0
data/examples/sample9.rb +20 -0
data/examples/sgl-sound1.rb +6 -0
data/examples/sgl-sound2.rb +19 -0
data/examples/sine.ogg +0 -0
data/examples/testgl.rb +169 -0
data/lib/sgl/bass-api.rb +202 -0
data/lib/sgl/bass-sample.rb +106 -0
data/lib/sgl/bass.rb +46 -0
data/lib/sgl/cocoa-app.rb +43 -0
data/lib/sgl/cocoa-color.rb +65 -0
data/lib/sgl/cocoa-draw.rb +72 -0
data/lib/sgl/cocoa-event.rb +229 -0
data/lib/sgl/cocoa-media.rb +144 -0
data/lib/sgl/cocoa-notuse.rb +493 -0
data/lib/sgl/cocoa-window.rb +203 -0
data/lib/sgl/cocoa.rb +8 -0
data/lib/sgl/notuse-objs.rb +358 -0
data/lib/sgl/opengl-app.rb +38 -0
data/lib/sgl/opengl-color.rb +44 -0
data/lib/sgl/opengl-draw.rb +260 -0
data/lib/sgl/opengl-event.rb +325 -0
data/lib/sgl/opengl-modules.rb +22 -0
data/lib/sgl/opengl-window.rb +224 -0
data/lib/sgl/opengl.rb +7 -0
data/lib/sgl/sgl-basic.rb +61 -0
data/lib/sgl/sgl-button.rb +135 -0
data/lib/sgl/sgl-client.rb +21 -0
data/lib/sgl/sgl-color.rb +82 -0
data/lib/sgl/sgl-connect.rb +9 -0
data/lib/sgl/sgl-objlib.rb +0 -0
data/lib/sgl/sgl-objs.rb +0 -0
data/lib/sgl/sgl-server.rb +58 -0
data/lib/sgl/sgl-sound.rb +24 -0
data/lib/sgl/sgl-spring.rb +216 -0
data/lib/sgl/sgl-timer.rb +72 -0
data/lib/sgl/sgl.rb +5 -0
data/lib/sgl/version.rb +2 -2
data/scripts/makemanifest.rb +20 -0
data/test/test_bass.rb +27 -0
data/test/test_cocoa_app.rb +5 -5
data/test/test_helper.rb +9 -1
data/test/test_module_ruby16.rb +22 -21
data/test/test_opengl_app.rb +4 -5
data/test/test_opengl_basic.rb +3 -4
data/test/test_opengl_fullscreen.rb +4 -6
data/test/test_opengl_novice.rb +3 -6
data/test/test_sgl.rb +4 -27
data/test/test_sound.rb +15 -0
data/website/challenge1.html +91 -0
data/website/challenge1.txt +30 -0
data/website/challenge2.html +144 -0
data/website/challenge2.txt +73 -0
data/website/challenge3.html +63 -0
data/website/challenge3.txt +15 -0
data/website/cocoa.html +88 -0
data/website/cocoa.txt +35 -0
data/website/description.html +138 -0
data/website/description.txt +90 -0
data/website/exercise1.html +264 -0
data/website/exercise1.txt +192 -0
data/website/exercise2.html +683 -0
data/website/exercise2.txt +597 -0
data/website/exhibition.html +84 -0
data/website/exhibition.txt +24 -0
data/website/howto.html +134 -0
data/website/howto.txt +56 -0
data/website/index.html +17 -9
data/website/index.txt +13 -4
data/website/sound.html +141 -0
data/website/sound.txt +87 -0
data/website/stylesheets/grade.png +0 -0
data/website/stylesheets/screen.css +21 -20
metadata +109 -3

data/website/cocoa.html ADDED Viewed

@@ -0,0 +1,88 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <link rel="stylesheet" href="stylesheets/screen.css" type="text/css" media="screen" />
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <title>
+      sgl-cocoa &#x2192; sgl with Ruby/Cocoa
+  </title>
+  <script src="javascripts/rounded_corners_lite.inc.js" type="text/javascript"></script>
+<style>
+</style>
+  <script type="text/javascript">
+    window.onload = function() {
+      settings = {
+          tl: { radius: 10 },
+          tr: { radius: 10 },
+          bl: { radius: 10 },
+          br: { radius: 10 },
+          antiAlias: true,
+          autoPad: true,
+          validTags: ["div"]
+      }
+      var versionBox = new curvyCorners(settings, document.getElementById("version"));
+      versionBox.applyCornersToAll();
+    }
+  </script>
+</head>
+<body>
+<div id="main">
+    <h1>sgl-cocoa &#x2192; sgl with Ruby/Cocoa</h1>
+    <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/sgl"; return false'>
+      <p>Get Version</p>
+      <a href="http://rubyforge.org/projects/sgl" class="numbers">0.4.0</a>
+    </div>
+    <h2>What</h2>
+	<p>&#8216;sgl-cocoa&#8217; is a cocoa version of sgl.
+You can use sgl functions with Ruby/Cocoa.</p>
+	<h2>Requirement</h2>
+	<p>You can use this only on Mac <span class="caps">OS X</span>.</p>
+	<h3>Mac <span class="caps">OS X</span></h3>
+	<ul>
+	<li>Mac <span class="caps">OS X 10</span>.3 or later</li>
+		<li>ruby 1.8.5 or later</li>
+		<li>RubyCocoa 0.4.1 or later</li>
+	</ul>
+	<h2>The basics</h2>
+Save this progarm as <code>test1.rb</code>.
+<pre syntax="ruby">
+require "sgl/cocoa"
+def setup
+  window 100, 100
+end
+def display
+  line 0, 0, 100, 100
+end
+mainloop
+</pre>
+	<p>Run the program with <code>ruby test1.rb</code>.</p>
+    <p class="coda">
+      19th June 2007<br>
+    </p>
+</div>
+<!-- insert site tracking codes here, like Google Urchin -->
+</body>
+</html>

data/website/cocoa.txt ADDED Viewed

@@ -0,0 +1,35 @@
+h1. sgl-cocoa &#x2192; sgl with Ruby/Cocoa
+h2. What
+'sgl-cocoa' is a cocoa version of sgl.
+You can use sgl functions with Ruby/Cocoa.
+h2. Requirement
+You can use this only on Mac OS X.
+h3. Mac OS X
+* Mac OS X 10.3 or later
+* ruby 1.8.5 or later
+* RubyCocoa 0.4.1 or later
+h2. The basics
+Save this progarm as @test1.rb@.
+<pre syntax="ruby">
+require "sgl/cocoa"
+def setup
+  window 100, 100
+end
+def display
+  line 0, 0, 100, 100
+end
+mainloop
+</pre>
+Run the program with @ruby test1.rb@.

data/website/description.html ADDED Viewed

@@ -0,0 +1,138 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <link rel="stylesheet" href="stylesheets/screen.css" type="text/css" media="screen" />
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <title>
+      sglの説明
+  </title>
+  <script src="javascripts/rounded_corners_lite.inc.js" type="text/javascript"></script>
+<style>
+</style>
+  <script type="text/javascript">
+    window.onload = function() {
+      settings = {
+          tl: { radius: 10 },
+          tr: { radius: 10 },
+          bl: { radius: 10 },
+          br: { radius: 10 },
+          antiAlias: true,
+          autoPad: true,
+          validTags: ["div"]
+      }
+      var versionBox = new curvyCorners(settings, document.getElementById("version"));
+      versionBox.applyCornersToAll();
+    }
+  </script>
+</head>
+<body>
+<div id="main">
+    <h1>sglの説明</h1>
+    <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/sgl"; return false'>
+      <p>Get Version</p>
+      <a href="http://rubyforge.org/projects/sgl" class="numbers">0.4.0</a>
+    </div>
+    <h2>What is sgl?</h2>
+	<p>sglは，Rubyからグラフィックやサウンドを簡単に扱えるようにしたライブラ
+リである．できるだけ優しくプログラミングを初められるように，シンプルな
+記述で必要最小限の動作するプログラムを作成できるようになっている．</p>
+	<p><a href="http://dbn.media.mit.edu/"><span class="caps">DBN</span></a> というプログラミング環境が提供していた
+理念を継承し，可能な限り簡単にプログラミングに取り組めるように工夫して
+いる．DBNの理念を継承した環境として，
+<a href="http://www.processing.org/">Processing</a> とは兄弟関係にあると言える．</p>
+	<p>グラフィックスはOpenGL，Window表示，マウス入力，キー入力などにはSDLを
+用いている．またMIDIの入出力なども組み合せて使えるようになっている．ラ
+イブラリーの構造はGLUTを参考にしている．</p>
+<pre syntax="ruby">
+# 基本的なプログラムの例
+reuire 'sgl'        # 最初に必ず必要
+window 100,100      # 100x100のウィンドウを生成
+background 0        # 背景は黒にします
+color 100           # 白を指定します
+line 20,20,80,80    # 線を引きます
+rect 20,20,80,80    # 四角を描きます
+wait                # プログラムが終了しないように待つ．ESCキーで終了する．
+# 色空間
+color 100,0,0          # 赤になる．r,g,bで色が使える
+color 100,0,0,50       # 半透明の赤．100が不透明(デフォルト)．0が完全に透明．
+colorHSV 50,0,100      # hsv方式での色指定もできる．
+backgroundHSV 70,0,100 # 背景の指定もhsvでできる．
+colorHSV 50,0,100,50   # もちろんhsv方式でもアルファ値は指定できる．
+# 3Dも使える
+useFov(60)             # field of view．画角を指定
+useDepth               # depth bufferを使う
+line 20,20,20,80,80,80 # とりあえず線
+color 0,100,0,50       # とりあえず半透明
+box 20,20,20,80,80,80  # 箱．半透明になっている
+useSmooth              # 線にanti aliasがかかる．
+# MIDI関係
+useMidi              # midiを使うということ宣言
+note 1, 60, 90, 100  # ch, note, vel, msec．
+# 詳細な描画について
+beginObj(QUADS)
+vertex 20,20
+vertex 80,20
+vertex 80,80
+vertex 20,80
+endObj
+# 同様に，vertexにz軸の情報を加えれば，3Dとなる．
+オブジェクトの種類は，
+LINES POINTS LINE_STRIP LINE_LOOP TRIANGLES TRIANGLE_STRIP
+TRIANGLE_FAN QUADS QUAD_STRIP POLYGON
+が使える．OpenGLと同じ．
+# 基本的なループ構造
+window 100,100
+def display
+  line 0,0,100,100
+end
+mainloop
+とすると，ループして，描画しつづける．
+# マウス入力
+ループした状態で，
+def onMouseDown(x,y)
+  line 0,0,x,y
+end
+などとすると，callbackがかかる．
+同様に，onMouseUp, onKeyDown, onKeyUpなど．
+# MIDI input関係
+useMidiIn            # midi inを使うということ宣言
+def onNoteOn(ch, note, vel)
+  p [ch, note, vel]
+end
+などとできる．
+同様に，onNoteOff(ch, note)もある．
+# ソフトサンプラー機能
+useSound
+sound = loadSound('sine.wav')
+sound.play(60, 100, -100) # note, vel, pan
+</pre>
+    <p class="coda">
+      25th June 2007<br>
+    </p>
+</div>
+<!-- insert site tracking codes here, like Google Urchin -->
+</body>
+</html>

data/website/description.txt ADDED Viewed

@@ -0,0 +1,90 @@
+h1. sglの説明
+h2. What is sgl?
+sglは，Rubyからグラフィックやサウンドを簡単に扱えるようにしたライブラ
+リである．できるだけ優しくプログラミングを初められるように，シンプルな
+記述で必要最小限の動作するプログラムを作成できるようになっている．
+"DBN":http://dbn.media.mit.edu/ というプログラミング環境が提供していた
+理念を継承し，可能な限り簡単にプログラミングに取り組めるように工夫して
+いる．DBNの理念を継承した環境として，
+"Processing":http://www.processing.org/ とは兄弟関係にあると言える．
+グラフィックスはOpenGL，Window表示，マウス入力，キー入力などにはSDLを
+用いている．またMIDIの入出力なども組み合せて使えるようになっている．ラ
+イブラリーの構造はGLUTを参考にしている．
+<pre syntax="ruby">
+# 基本的なプログラムの例
+reuire 'sgl'        # 最初に必ず必要
+window 100,100      # 100x100のウィンドウを生成
+background 0        # 背景は黒にします
+color 100           # 白を指定します
+line 20,20,80,80    # 線を引きます
+rect 20,20,80,80    # 四角を描きます
+wait                # プログラムが終了しないように待つ．ESCキーで終了する．
+# 色空間
+color 100,0,0          # 赤になる．r,g,bで色が使える
+color 100,0,0,50       # 半透明の赤．100が不透明(デフォルト)．0が完全に透明．
+colorHSV 50,0,100      # hsv方式での色指定もできる．
+backgroundHSV 70,0,100 # 背景の指定もhsvでできる．
+colorHSV 50,0,100,50   # もちろんhsv方式でもアルファ値は指定できる．
+# 3Dも使える
+useFov(60)             # field of view．画角を指定
+useDepth               # depth bufferを使う
+line 20,20,20,80,80,80 # とりあえず線
+color 0,100,0,50       # とりあえず半透明
+box 20,20,20,80,80,80  # 箱．半透明になっている
+useSmooth              # 線にanti aliasがかかる．
+# MIDI関係
+useMidi              # midiを使うということ宣言
+note 1, 60, 90, 100  # ch, note, vel, msec．
+# 詳細な描画について
+beginObj(QUADS)
+vertex 20,20
+vertex 80,20
+vertex 80,80
+vertex 20,80
+endObj
+# 同様に，vertexにz軸の情報を加えれば，3Dとなる．
+オブジェクトの種類は，
+LINES POINTS LINE_STRIP LINE_LOOP TRIANGLES TRIANGLE_STRIP
+TRIANGLE_FAN QUADS QUAD_STRIP POLYGON
+が使える．OpenGLと同じ．
+# 基本的なループ構造
+window 100,100
+def display
+  line 0,0,100,100
+end
+mainloop
+とすると，ループして，描画しつづける．
+# マウス入力
+ループした状態で，
+def onMouseDown(x,y)
+  line 0,0,x,y
+end
+などとすると，callbackがかかる．
+同様に，onMouseUp, onKeyDown, onKeyUpなど．
+# MIDI input関係
+useMidiIn            # midi inを使うということ宣言
+def onNoteOn(ch, note, vel)
+  p [ch, note, vel]
+end
+などとできる．
+同様に，onNoteOff(ch, note)もある．
+# ソフトサンプラー機能
+useSound
+sound = loadSound('sine.wav')
+sound.play(60, 100, -100) # note, vel, pan
+</pre>

data/website/exercise1.html ADDED Viewed

@@ -0,0 +1,264 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <link rel="stylesheet" href="stylesheets/screen.css" type="text/css" media="screen" />
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <title>
+      練習問題 1〜10
+  </title>
+  <script src="javascripts/rounded_corners_lite.inc.js" type="text/javascript"></script>
+<style>
+</style>
+  <script type="text/javascript">
+    window.onload = function() {
+      settings = {
+          tl: { radius: 10 },
+          tr: { radius: 10 },
+          bl: { radius: 10 },
+          br: { radius: 10 },
+          antiAlias: true,
+          autoPad: true,
+          validTags: ["div"]
+      }
+      var versionBox = new curvyCorners(settings, document.getElementById("version"));
+      versionBox.applyCornersToAll();
+    }
+  </script>
+</head>
+<body>
+<div id="main">
+    <h1>練習問題 1〜10</h1>
+    <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/sgl"; return false'>
+      <p>Get Version</p>
+      <a href="http://rubyforge.org/projects/sgl" class="numbers">0.4.0</a>
+    </div>
+    <h2>課題1 基本 (window, background, color, line)</h2>
+	<h3>課題1A 一本の線を描くプログラムを作る</h3>
+	<h3>課題1B ある考えの元に3本の線を描くプログラムを作る</h3>
+	<h3>課題1C 5本以下の直線で「変化」を表現するプログラムを作る</h3>
+	<h3>課題1D 10本以下の直線で「ハーモニー（調和）」を表現するプログラムを作る</h3>
+<pre syntax="ruby">
+require 'sgl'         # プログラムの最初に必ず書く必要がある
+window 100, 100       # windowを開く
+background 0          # 背景を黒にする
+color 100             # 描画する色を白にする
+line 0, 0, 100, 100   # 左下から右上に線を描く
+wait                  # そのまま待つ
+</pre>
+	<h3>半透明色の使い方</h3>
+<pre syntax="ruby">
+require 'sgl'
+window 100,100
+color 100, 0, 0       # 赤
+rect 10,10,70,70      # 四角
+color 0,0,100,50      # 半透明の青
+rect 30,30,90,90      # 四角を重ねてかく
+wait
+</pre>
+	<h2>課題2A</h2>
+一つの変数を使って2本の直線の構成をコントロールするプログラムを作る．
+<pre syntax="ruby">
+require 'sgl'
+window 100, 100
+a = 50
+line   0, 0, 50, a
+line 100, 0, 50, a
+wait
+</pre>
+	<h2>課題3A 繰り返し (for a in 0..100; end)</h2>
+繰り返しを使った形態を描く．
+<pre syntax="ruby">
+require 'sgl'
+window 100, 100
+for a in 20..80
+  color a
+  line a, 0, a, 100
+end
+wait
+</pre>
+	<h2>課題4A 計算 (+ &#8211; * /)</h2>
+計算を使った形態をかくプログラムを作る．
+<pre syntax="ruby">
+require 'sgl'
+window 100, 100
+for a in 20..40
+  color a
+  line(a, 0, a*2, 100)
+end
+wait
+</pre>
+	<h2>課題6A kadai6a.rb</h2>
+h3. 入れ子構造 6A 格子状にひろがる形態を作る．
+<pre syntax="ruby">
+# kadai6a.rb
+require 'sgl'
+window 200,200
+for a in 0..10
+  for b in 0..10
+    color a*10, b*10, b*10
+    rect a*20+5, b*20+5, a*20+15, b*20+15
+  end
+end
+wait
+</pre>
+	<h2>課題7A kadai7a.rb</h2>
+h3. 質問 (if 50 &lt; a; end) 7A 画面の左右で違う形態を描く．
+<pre syntax="ruby">
+# kadai7a.rb
+require 'sgl'
+window 200,200
+for a in 0..200
+  color a/2, 50, 50
+  if a &lt; 100
+    line a, 50, a, 100
+  else
+    line a, 100, a, 150
+  end
+end
+wait
+</pre>
+	<h2>課題8A</h2>
+	<h3>defを使って自分なりのコマンドを作り，それを用いた形態を描く．</h3>
+ファイル名 kadai8a.rb
+<pre syntax="ruby">
+require 'sgl'
+window 100,100
+background 100
+def my_rect(x1, y1, x2, y2, outline, fill)
+  color fill
+  rect x1, y1, x2, y2
+  color outline
+  line x1, y1, x2, y1
+  line x2, y1, x2, y2
+  line x2, y2, x1, y2
+  line x1, y2, x1, y1
+end
+my_rect(20, 20, 40, 30, 20, 50)
+my_rect(60, 60, 80, 90, 70, 90)
+wait
+</pre>
+	<p>defというコマンドで関数を定義する．自分がよく使う形，例えば枠付きの塗
+りつぶされた四角形を定義する．defの後に続くのが関数名である．アルファ
+ベットの小文字から始まっている必要がある．</p>
+	<h2>課題9A</h2>
+	<h3>flipを使ってアニメーションを作る．</h3>
+ファイル名 kadai9a.rb
+<pre syntax="ruby">
+require 'sgl'
+window 100,100
+loop do
+  for a in 0..100
+    line 20,a,80,a
+    flip
+  end
+end
+wait
+</pre>
+	<p>flipというところで、ちょうど紙をめくるように次の画面を表示させている。
+<code>loop do 〜〜〜 end</code> で，その間を無限に繰り返す．</p>
+	<h2>課題10A</h2>
+	<h3><span class="caps">HSV</span>による色指定を使って，自分なりの色グラデーションを作る。</h3>
+	<p>静止画でもアニメーションでもよい．(colorHSV, backgroundHSV)</p>
+ファイル名 kadai10a.rb
+<pre syntax="ruby">
+require 'sgl'
+window 100,100
+background 100
+loop do
+  for h in 0..100
+    colorHSV h, 50, 100
+    rect 0, h, 100, h+5
+    flip
+  end
+end
+wait
+</pre>
+	<ul>
+	<li>colorHSV(h, s, v) → hue, saturation, value</li>
+		<li>hue → 色調</li>
+		<li>saturation → どれだけ原色に近いか</li>
+		<li>value → 明るさ</li>
+	</ul>
+	<ul>
+	<li>4番目のパラメーターを使って，透明度を設定することもできる．</li>
+		<li>backgroundHSVというコマンドもある．</li>
+	</ul>
+	<h2>課題の注意点</h2>
+	<p>課題はいずれもwindowサイズなどは自由．課題例は100,100のサイズになって
+いるが，より大きいwindowサイズを選択してもよい。</p>
+	<p>ファイル名は必ず指定のものにし，Z:に保存する．指定のファイル名のファイ
+ルが保存されているかどうかで課題提出を判定する．ファイル名が違う場合は
+提出してないことになってしまうので，注意する．</p>
+    <p class="coda">
+      19th June 2007<br>
+    </p>
+</div>
+<!-- insert site tracking codes here, like Google Urchin -->
+</body>
+</html>