rubysdl-mswin32-1.8 2.1.0.1 → 2.1.1.1

Sign up to get free protection for your applications and to get access to all the features.
data/NEWS.en CHANGED
@@ -1,3 +1,16 @@
1
+ version 2.1.1
2
+ Fix a compile problem on MacOS X
3
+ Rename sdl.so to sdl_ext
4
+ Add following constants
5
+ * SDL::Mixer::NO_FADING
6
+ * SDL::Mixer::FADING_OUT
7
+ * SDL::Mixer::FADING_IN
8
+ * SDL::TRANSFORM_AA(for compatible with 1.x)
9
+ * SDL::TRANSFORM_TMAP(for compatible with 1.x)
10
+ * SDL::TRANSFORM_SAFE(for compatible with 1.x)
11
+ Fix documents
12
+ Remove obsolete documents
13
+
1
14
  version 2.1.0
2
15
  add following methods
3
16
  * SDL::TTF#close
data/NEWS.ja CHANGED
@@ -1,5 +1,18 @@
1
+ version 2.1.1
2
+ Ruby 1.9とMacOS Xでコンパイルできない問題を修正
3
+ sdl.so を sdl_ext という名前に変更
4
+ 以下の定数を追加
5
+ * SDL::Mixer::NO_FADING
6
+ * SDL::Mixer::FADING_OUT
7
+ * SDL::Mixer::FADING_IN
8
+ * SDL::TRANSFORM_AA(for compatible with 1.x)
9
+ * SDL::TRANSFORM_TMAP(for compatible with 1.x)
10
+ * SDL::TRANSFORM_SAFE(for compatible with 1.x)
11
+ ドキュメントの修正
12
+ 古いドキュメントを削除
13
+
1
14
  version 2.1.0
2
- $B0J2<$N%a%=%C%I$rDI2C(B
15
+ 以下のメソッドを追加
3
16
  * SDL::TTF#close
4
17
  * SDL::TTF#closed?
5
18
  * SDL::BMFont#close
@@ -11,11 +24,11 @@ version 2.1.0
11
24
  * SDL::Mixer::Wave#destroyed?
12
25
  * SDL::Mixer::Music#destroyed?
13
26
  * SDL::Kanji#get_coding_system
14
- $B%I%-%e%a%s%H$N=$@5(B
15
- $B0J2<$N%a%=%C%I$N8F$S$@$7Cf$K(B1.9$B$G%9%l%C%I@Z$jBX$(2DG=$KJQ99(B
27
+ ドキュメントの修正
28
+ 以下のメソッドの呼びだし中に1.9でスレッド切り替え可能に変更
16
29
  * SDL::Event#wait
17
30
  * SDL.delay
18
- $B0J2<$N%a%=%C%I$G(BRuby$B$N(Bm17n$B5!G=$rMxMQ$9$k$h$&$KJQ99(B
31
+ 以下のメソッドでRubyのm17n機能を利用するように変更
19
32
  * SDL::WM.set_caption
20
33
  * SDL::WM.caption
21
34
  * SDL::TTF#draw_solid
@@ -27,32 +40,32 @@ version 2.1.0
27
40
  * SDL::Kanji#put
28
41
  * SDL::Kanji#putTate
29
42
  * SDL::SDLSKK#str
30
- $B0J2<$N%a%=%C%I$N%P%0$r=$@5(B
43
+ 以下のメソッドのバグを修正
31
44
  * SDL::MPEG#move
32
45
 
33
46
  version 2.0.1b
34
- $B%5%s%W%k$N%P%0$r=$@5(B
35
- SDL::MPEG.info$B$r=$@5(B
47
+ サンプルのバグを修正
48
+ SDL::MPEG.infoを修正
36
49
 
37
50
  version 2.0.1
38
- $B%3%s%Q%$%k$G$-$J$$>l9g$,$"$k$N$r=$@5(B
39
- SDL::Surface.blit$B$G%S%G%*%a%b%j$,%m%9%H$7$?>l9g$K(B
40
- $BNc30(BSDL::Surface::VideoMemoryLost$B$rH/@8$5$;$k$h$&$K$7$?!#(B
51
+ コンパイルできない場合があるのを修正
52
+ SDL::Surface.blitでビデオメモリがロストした場合に
53
+ 例外SDL::Surface::VideoMemoryLostを発生させるようにした。
41
54
 
42
55
  version 2.0
43
- ruby 1.9$B$G;H$($k$h$&$KJQ99(B
44
- SDL_RWops$BBP1~$r=$@5$7!"(BSDL::Mixer::Wave.load_from_io$B$,;H$($k$h$&$K$7$?!#(B
45
- $B%I%-%e%a%s%H$N2~A1(B($BFC$K1Q8lHG(B)
46
- $B0J2<$N%a%=%C%I$rDI2C(B
56
+ ruby 1.9で使えるように変更
57
+ SDL_RWops対応を修正し、SDL::Mixer::Wave.load_from_ioが使えるようにした。
58
+ ドキュメントの改善(特に英語版)
59
+ 以下のメソッドを追加
47
60
  * SDL::Surface#load_bmp_from_string
48
61
  * SDL::Surface#load_from_string
49
62
  * SDL::Mixer::Wave#load_from_string
50
63
  * SDL::Mixer.playing_channels
51
64
 
52
65
  version 2.0 alpha 1
53
- $BFbIt9=B$$rBgI}$KJQ99(B
54
- SDL::Event2$B$r(BSDL::Event$B$KJQ99$7!"$+$D$F$N(BSDL::Event$B$OGQ;_(B
55
- $B0J2<$N%a%=%C%I$rGQ;_(B
66
+ 内部構造を大幅に変更
67
+ SDL::Event2をSDL::Eventに変更し、かつてのSDL::Eventは廃止
68
+ 以下のメソッドを廃止
56
69
  * SDL::Surface#draw_ellispe
57
70
  * SDL::Surface#draw_filled_ellispe
58
71
  * SDL::Surface#rotate_surface
@@ -61,22 +74,22 @@ SDL::Event2$B$r(BSDL::Event$B$KJQ99$7!"$+$D$F$N(BSDL::Event$B$OGQ;_(B
61
74
  * SDL.rotate_blit
62
75
  * SDL.rotate_scaled_blit
63
76
  * SDL.rotate_xy_scaled
64
- $B0J2<$N%a%=%C%I$rDI2C(B
77
+ 以下のメソッドを追加
65
78
  * SDL::Surface#destroy
66
79
  * SDL::Joystick#close
67
80
  * SDL::Mixer#close
68
81
  * SDL::Mixer::Wave#destroy
69
82
  * SDL::Mixer::Music#destroy
70
- SDL::GL$B%b%8%e!<%k$rDI2C(B
71
- SDL::PixelFormat(SDL::Surface::Format$B$N$[$&$,NI$$!)(B)$B$N<BAu$rJQ99(B
72
- Surface$B$N%U%)!<%^%C%H$r;XDj$9$k$N$K(BSDL::PixelFormat$B$,;H$($k$h$&$KJQ99(B
73
- $B0J2<$NIA2h%a%=%C%I$N(B(antialias, fill, alpha$B$r$"$i$o$9(B)$B0z?t$rDI2C(B
83
+ SDL::GLモジュールを追加
84
+ SDL::PixelFormat(SDL::Surface::Formatのほうが良い?)の実装を変更
85
+ Surfaceのフォーマットを指定するのにSDL::PixelFormatが使えるように変更
86
+ 以下の描画メソッドの(antialias, fill, alphaをあらわす)引数を追加
74
87
  * SDL::Surface#draw_line
75
88
  * SDL::Surface#draw_circle
76
89
  * SDL::Surface#draw_rect
77
90
  * SDL::Surface#draw_ellipse
78
91
  * SDL::Surface#draw_bezier
79
- $B0J2<$N$h$&$K%a%=%C%I$r0\F0!"5lMh$N$b$N$bMxMQ$O$G$-$^$9(B
92
+ 以下のようにメソッドを移動、旧来のものも利用はできます
80
93
  * SDL.auto_lock? -> SDL::Surface.auto_lock?
81
94
  * SDL.auto_lock_on -> SDL::Surface.auto_lock_on
82
95
  * SDL.auto_lock_off -> SDL::Surface.auto_lock_off
@@ -106,7 +119,7 @@ Surface$B$N%U%)!<%^%C%H$r;XDj$9$k$N$K(BSDL::PixelFormat$B$,;H$($k$h$&$KJQ99(
106
119
  * SDL.get_GL_attr -> SDL::GL.get_attr
107
120
  * SDL.set_GL_attr -> SDL::GL.set_attr
108
121
  * SDL.GL_swap_buffers -> SDL::GL.swap_buffers
109
- $B0J2<$N$h$&$KDj?t$r0\F0!#5lMh$N$b$N$bMxMQ$O$G$-$^$9!#(B
122
+ 以下のように定数を移動。旧来のものも利用はできます。
110
123
  * GL_RED_SIZE -> GL::RED_SIZE
111
124
  * GL_GREEN_SIZE -> GL::GREEN_SIZE
112
125
  * GL_BLUE_SIZE -> GL::BLUE_SIZE
@@ -119,12 +132,12 @@ Surface$B$N%U%)!<%^%C%H$r;XDj$9$k$N$K(BSDL::PixelFormat$B$,;H$($k$h$&$KJQ99(
119
132
  * GL_ACCUM_GREEN_SIZE -> GL::ACCUM_GREEN_SIZE
120
133
  * GL_ACCUM_BLUE_SIZE -> GL::ACCUM_BLUE_SIZE
121
134
  * GL_ACCUM_ALPHA_SIZE -> GL::ACCUM_ALPHA_SIZE
122
- OpenGL$B4XO"$N%I%-%e%a%s%H$rDI2C(B
135
+ OpenGL関連のドキュメントを追加
123
136
 
124
137
 
125
138
  version 1.3.1
126
- SMPEG$BM-!"(BSDL_mixer$BL5$N>l9g$NLdBj$r=$@5(B
127
- $B0J2<$N%a%=%C%I$rDI2C(B
139
+ SMPEG有、SDL_mixer無の場合の問題を修正
140
+ 以下のメソッドを追加
128
141
  SDL::Surface#Rloss
129
142
  SDL::Surface#Gloss
130
143
  SDL::Surface#Bloss
@@ -135,35 +148,35 @@ SMPEG$BM-!"(BSDL_mixer$BL5$N>l9g$NLdBj$r=$@5(B
135
148
  SDL::Surface#Ashift
136
149
  SDL::Surface#pitch
137
150
  SDL::Surface#bytes_per_pixel
138
- $B0J2<$N%a%=%C%I$r=$@5(B
151
+ 以下のメソッドを修正
139
152
  SDL::Surface.pixels
140
153
 
141
154
  version 1.3.0
142
- $B%I%-%e%a%s%H$r=$@5(B/$B2~A1(B
143
- $BDj?t(BSDL::NOFRAME$B$,Dj5A$5$l$F$$$J$+$C$?$N$r=$@5(B
144
- $B0J2<$N%a%=%C%I$rDI2C(B
155
+ ドキュメントを修正/改善
156
+ 定数SDL::NOFRAMEが定義されていなかったのを修正
157
+ 以下のメソッドを追加
145
158
  SDL::Screen#update_rects
146
159
  SDL::Event2.pump
147
160
  SDL::Screen.open
148
161
  SDL::Surface.blit
149
162
  SDL::Mixer.driver_name
150
- $B0J2<$N%a%=%C%I$r=$@5(B
163
+ 以下のメソッドを修正
151
164
  SDL.video_driver_name
152
165
 
153
166
 
154
167
  version 1.2.0
155
- $BF|K\8l$N%j%U%!%l%s%9$N(BMPEG$B$N9`L\$r2CI.(B
156
- $B0J2<$N%a%=%C%I$rDI2C(B
168
+ 日本語のリファレンスのMPEGの項目を加筆
169
+ 以下のメソッドを追加
157
170
  SDL::MPEG#render_final
158
171
  SDL::Surface.load_bmp_from_io
159
172
  SDL::Surface.load_from_io
160
173
  SDL::Mixer::Wave.load_from_io
161
174
  SDL::Mixer::Music.load_from_string
162
- SMPEG$BM-!"(BSDL_mixer$BL5$N>l9g$K%3%s%Q%$%k$G$-$J$$%P%0$r=$@5(B
175
+ SMPEG有、SDL_mixer無の場合にコンパイルできないバグを修正
163
176
 
164
177
  version 1.1.0
165
- $BF|K\8l$N%j%U%!%l%s%9$rA4LL2~D{(B
166
- $B0J2<$N%a%=%C%I$rDI2C(B
178
+ 日本語のリファレンスを全面改訂
179
+ 以下のメソッドを追加
167
180
  SDL::CD.framesToMSF
168
181
  SDL::CD.MSFToFrames
169
182
  SDL::CD#in_drive?
@@ -179,97 +192,97 @@ version 1.1.0
179
192
  SDL::CollisionMap#h
180
193
  SDL::BMFont#textSize
181
194
  SDL::TTF#init?
182
- $B0J2<$N%/%i%9$rDI2C(B
195
+ 以下のクラスを追加
183
196
  SDL::Event2::VideoExpose
184
- $B0J2<$N%a%=%C%I$N%P%0$r=$@5(B
197
+ 以下のメソッドのバグを修正
185
198
  SDL::Key.press?
186
199
  SDL::TTF#familyName
187
200
  SDL::TTF#styleName
188
- $B0J2<$N%/%i%9$N=*N;;~%P%0$r=$@5(B
201
+ 以下のクラスの終了時バグを修正
189
202
  SDL::BMFont
190
- $B%-!<%j%T!<%H4XO"$NDj?t$rDI2C(B
203
+ キーリピート関連の定数を追加
191
204
 
192
205
  version 1.0.0
193
- $B0J2<$N%a%=%C%I$rDI2C(B
206
+ 以下のメソッドを追加
194
207
  SDL::Surface#drawBezier
195
208
  SDL::Surface#drawAABezier
196
209
  SDL::Surface#drawBezierAlpha
197
210
  SDL::Surface#drawAABezierAlpha
198
- $B0J2<$N%a%=%C%I$N%P%0$r=$@5(B
211
+ 以下のメソッドのバグを修正
199
212
  SDL::MPEG#setDisplay
200
213
 
201
214
  version 0.9.5
202
- $B0J2<$N%a%=%C%I$N%P%0$r=$@5(B
215
+ 以下のメソッドのバグを修正
203
216
  SDL::Surface#getPalette
204
217
  SDL::Surface#copyRect
205
- $B0J2<$N%a%=%C%I$rDI2C(B
218
+ 以下のメソッドを追加
206
219
  SDL::WM.grubInput
207
220
  SDL.quit
208
221
  SDL.putenv
209
222
  SDL.getenv
210
- $B$5$5$$$J(Btypo$B$r=$@5(B
211
- $B%I%-%e%a%s%H$r0lIt=$@5(B(SDL::TTF#textSize)
223
+ ささいなtypoを修正
224
+ ドキュメントを一部修正(SDL::TTF#textSize)
212
225
 
213
226
  version 0.9.4
214
- SDL::Surface#pixels, SDL::Surface#[RGBA]mask, SDL::Surface.new_from$B$rDI2C(B
215
- SDL::Surface.new$B$r3HD%(B
216
- OpenGL$B4XO"$N%I%-%e%a%s%H$r:GDc8B$NJ,DI2C(B
227
+ SDL::Surface#pixels, SDL::Surface#[RGBA]mask, SDL::Surface.new_fromを追加
228
+ SDL::Surface.newを拡張
229
+ OpenGL関連のドキュメントを最低限の分追加
217
230
 
218
231
  version 0.9.3
219
- sge$B$N(Bbitmap font$BIA2h5!G=$rDI2C(B
220
- SDL_kanji$B$K$h$k(Bbdf font$BIA2h5!G=$rDI2C(B
221
- SDL::TTF#height, #ascent, #descent, #lineSkip$B$rDI2C(B
222
- SDL::Surface#copyRect$B$rDI2C(B
223
- warning$B$,$G$kE@$r=$@5(B
224
- SDLSKK$B%$%s%?!<%U%'!<%9$NCWL?E*$J%P%0$r=$@5(B
225
- OpenGL$B$r%G%U%)%k%H$GM-8z$K$7$?(B
232
+ sgeのbitmap font描画機能を追加
233
+ SDL_kanjiによるbdf font描画機能を追加
234
+ SDL::TTF#height, #ascent, #descent, #lineSkipを追加
235
+ SDL::Surface#copyRectを追加
236
+ warningがでる点を修正
237
+ SDLSKKインターフェースの致命的なバグを修正
238
+ OpenGLをデフォルトで有効にした
226
239
 
227
240
  version 0.9.2
228
- sge$B$N%"%k%U%!IU$-?^7AIA2h!"%"%s%A%(%$%j%"%:IU$-?^7AIA2h$r%5%]!<%H(B
229
- SDL.transformBlit$B$r(BsetAlpha$B$G$N(Balpha$B$N@_Dj$rM-8z$K$9$k(B
241
+ sgeのアルファ付き図形描画、アンチエイリアズ付き図形描画をサポート
242
+ SDL.transformBlitをsetAlphaでのalphaの設定を有効にする
230
243
 
231
244
  version 0.9.1
232
245
 
233
- SDL::Event$B$H(BSDL::Event2$B$NCWL?E*$J%P%0$r=$@5(B
246
+ SDL::EventとSDL::Event2の致命的なバグを修正
234
247
 
235
248
  version 0.9
236
249
 
237
- SDLSKK 0.4$B$r%5%]!<%H!"(B0.3$B$N%5%]!<%H$rDd;_(B
238
- $B>WFMH=Dj5!G=$rDI2C(B ( thanks to Wayne Conrad )
239
- MPEG$B:F@85!G=$r6/2=!#J#?t$N(BMPEG$B%U%!%$%k$rFI$_$3$a$k$h$&$K$9$k!"(BSDL_Mixer$B$K$h$k(B
240
- $B2;@<:F@85!G=$H$N6&B8$r2DG=$K$9$k$J$I$NJQ99$r$7$?!#(B
241
- $B%5%s%W%k$rDI2C!#(B( thanks to Simon Strandgaard )
250
+ SDLSKK 0.4をサポート、0.3のサポートを停止
251
+ 衝突判定機能を追加 ( thanks to Wayne Conrad )
252
+ MPEG再生機能を強化。複数のMPEGファイルを読みこめるようにする、SDL_Mixerによる
253
+ 音声再生機能との共存を可能にするなどの変更をした。
254
+ サンプルを追加。( thanks to Simon Strandgaard )
242
255
 
243
256
  version 0.8.3
244
257
 
245
- $B0J2<$N%a%=%C%I$rDI2C(B(typo$B$N$?$a(B) ( thanks to Wayne Conrad )
258
+ 以下のメソッドを追加(typoのため) ( thanks to Wayne Conrad )
246
259
  SDL::Surface#drawEllipse
247
260
  SDL::Surface#drawFilledEllipse
248
- $B0J2<$N%a%=%C%I$r=$@5(B( thanks to moumar )
261
+ 以下のメソッドを修正( thanks to moumar )
249
262
  SDL.videoInfo
250
263
 
251
264
  version 0.8.2
252
265
 
253
- SDLSKK 0.3$B$r%5%]!<%H!"(B0.2$B0JA0$O%5%]!<%H$7$J$$$3$H$K$7$?(B
254
- Joystick$B5!G=$N%P%0$r=$@5(B
255
- $B0J2<$N%a%=%C%I$rDI2C(B
266
+ SDLSKK 0.3をサポート、0.2以前はサポートしないことにした
267
+ Joystick機能のバグを修正
268
+ 以下のメソッドを追加
256
269
  SDL::Screen#toggleFullScreen
257
270
  SDL::Key.getKeyName
258
- $B%I%-%e%a%s%H$K(Balias$B$r5-=R(B
271
+ ドキュメントにaliasを記述
259
272
 
260
273
  version 0.8.1
261
274
 
262
- $B%P%0=$@5(B
275
+ バグ修正
263
276
 
264
277
  version 0.8
265
278
 
266
- SDLSKK$B$N%5%]!<%H$r2C$($k!#(B
267
- $B=*N;=hM}$NJQ99(B($B$?$`$i$5$s$N%Q%C%A$J$I$K$h$k(B)
268
- $B%"%s%@!<%P!<6h@Z$j$N%a%=%C%IL>$rMxMQ$G$-$k$h$&$K$7$?(B( blit_surface $B$J$I(B )
269
- $B%a%=%C%IL>$rJQ99(B
279
+ SDLSKKのサポートを加える。
280
+ 終了処理の変更(たむらさんのパッチなどによる)
281
+ アンダーバー区切りのメソッド名を利用できるようにした( blit_surface など )
282
+ メソッド名を変更
270
283
  SDL::CD.name -> SDL::CD.indexName
271
284
  SDL::Joystick.name -> SDL::Joystick.indexName
272
- $B0J2<$N%a%=%C%I$NDI2C(B
285
+ 以下のメソッドの追加
273
286
  SDL::Mixer.allocateChannels
274
287
  SDL::TTF#renderSolidUTF8
275
288
  SDL::TTF#renderBlendedUTF8
@@ -287,5 +300,5 @@ SDLSKK$B$N%5%]!<%H$r2C$($k!#(B
287
300
  SDL.autoLock?
288
301
  SDL.autoLockON
289
302
  SDL.autoLockOFF
290
- $B0J2<$N%a%=%C%I$r3HD%(B
303
+ 以下のメソッドを拡張
291
304
  SDL.blitSurface2
data/README.en CHANGED
@@ -1,5 +1,5 @@
1
1
 
2
- Ruby/SDL 2.1.0
2
+ Ruby/SDL 2.1.1
3
3
  Ohbayashi Ippei
4
4
 
5
5
  1 What's Ruby/SDL
@@ -54,8 +54,16 @@ install on Linux
54
54
  (5)install this extension library,Ruby/SDL
55
55
  Run 'ruby extconf.rb','make' and 'make install'.
56
56
 
57
+ (6) (Mac OS X user only) install rsdl
58
+ Run 'gem install rsdl'.
59
+ rsdl is a wrapper of Ruby interpreter. This wrapper
60
+ prepares Cocoa framework before running the interpreter.
61
+
57
62
  5 USE Ruby/SDL
58
63
  Write "require 'sdl'" in your Ruby script.
64
+ If your system is OS X, you must use rsdl command
65
+ as an interpreter instead of ruby command.
66
+
59
67
  See following documents and samples if you want to know the detail.
60
68
 
61
69
  sample/*.rb
@@ -72,20 +80,13 @@ install on Linux
72
80
  You can use OpenGL with this library.
73
81
 
74
82
  (1) Setup OpenGL and SDL.
75
- (2) Get OpenGL Interface (http://raa.ruby-lang.org/project/opengl/)
76
- (3) Install OpenGL Interface
77
- (4) Run "ruby extconf.rb" with "--enable-opengl".
78
- (5) Run "make" and "make install"
79
- (6) Write "require 'sdl'; require 'opengl'" in your script.
83
+ (2) Install ruby-opengl (http://ruby-opengl.rubyforge.org/)
84
+ (3) Run "ruby extconf.rb", "make", and "make install"
85
+ (4) Write "require 'sdl'; require 'opengl'" in your script.
80
86
 
81
- The interface of OpenGL is same as "OpenGL Interface".
87
+ We use OpenGL through ruby-opengl.
82
88
  Please see SDL's document,OpenGL document and sample/testgl.rb .
83
89
 
84
- Each OpenGL implementation are a little different in API, so
85
- you may fail to compile Ruby's OpenGL Interface. If you can't
86
- compile, but if you want to complile it, you should modify
87
- sources.
88
-
89
90
  7 LICENSE
90
91
  This library is distributed under GNU LGPL version 2.1 or later,
91
92
  which can be found in the file "LICENSE".
data/README.en.win32 CHANGED
@@ -1,4 +1,4 @@
1
- Ruby/SDL 2.1.0 Win32's binary
1
+ Ruby/SDL 2.1.1 Win32's binary
2
2
  Ohbayashi Ippei
3
3
  Cyross Makoto
4
4
 
@@ -15,7 +15,7 @@ This library supports
15
15
  Linux on X,Win32,FreeBSD and BeOS.
16
16
 
17
17
  And this archive contains compiled Ruby/SDL for win32 mingw's Ruby.
18
- This binary is tested on WindowsXP, Ruby 1.8.7-p72 mswin32 and SDL 1.2.11.
18
+ This binary is tested on WindowsXP, Ruby 1.8.7-p174 mswin32 and SDL 1.2.11.
19
19
 
20
20
  3 Install
21
21
 
@@ -57,7 +57,7 @@ Perhaps you cannot use hardware surface.
57
57
  7 Version information
58
58
  Ruby 1.8.7-p72
59
59
  SDL 1.2.13
60
- SDL_image 1.2.6
60
+ SDL_image 1.2.7
61
61
  SDL_ttf 2.0.9
62
62
  SDL_mixer 1.2.8
63
63
  SGE 030809 + patch for overflow error
data/README.ja CHANGED
@@ -1,166 +1,165 @@
1
1
 
2
- Ruby/SDL 2.1.0
3
- ���Ӱ�ʿ
2
+ Ruby/SDL 2.1.1
3
+ 大林一平
4
4
 
5
- 1 ����
5
+ 1 概要
6
6
 
7
- ����ϡ�Ruby����SDL�ε�ǽ��Ȥ�����γ�ĥ�饤�֥��Ǥ���
8
- SDL�Ȥϡ�Win32,Linux,BeOS,MacOS,FreeBSD,Solaris����ư�����������ץ�åȥե�����ʥ����೫ȯ�ѥ饤�֥��Ǥ���
7
+ これは、RubyからSDLの機能を使うための拡張ライブラリです。
8
+ SDLとは、Win32,Linux,BeOS,MacOS,FreeBSD,Solaris等で動く、クロスプラットフォームなゲーム開発用ライブラリです。
9
9
 
10
- 2 ư��Ķ�
11
- Linux��X�塢Win32
12
- �ޤ���FreeBSD��ư���ǧ���졢Ports�����줿�����Ǥ���
13
- BeOS��Ǥ�ư�������Ǥ���
14
- MacOSX�Ǥ�ư���������Ǥ���������Ruby�˼�������ɬ�פ�����褦�Ǥ���
15
- ����ʳ��Ǥϳ�ǧ���Ƥ��ޤ���
10
+ 2 動作環境
11
+ LinuxX上、Win32
12
+ また、FreeBSDで動作が確認され、Portsが作られたそうです。
13
+ BeOS上でも動くそうです。
14
+ MacOSXでも動いたそうです。ただしRubyに手を入れる必要があるようです。
15
+ それ以外では確認していません。
16
16
 
17
- 3 ɬ�פʥ饤�֥��
17
+ 3 必要なライブラリ
18
18
 
19
- ���Υ饤�֥��ϡ�ruby�ν����Ϥ�¾���ʲ��Υ饤�֥���ɬ�פȤ��ޤ���
20
- SDL_mixer,SDL_ttf,SDL_image,SGE,smpeg,SDLSKK�Ϥʤ��Ƥ⤫�ޤ��ޤ���
19
+ このライブラリは、rubyの処理系の他、以下のライブラリを必要とします。
20
+ SDL_mixer,SDL_ttf,SDL_image,SGE,smpeg,SDLSKKはなくてもかまいません。
21
21
 
22
- SDL(ɬ��) http://www.libsdl.org/
22
+ SDL(必須) http://www.libsdl.org/
23
23
 
24
24
 
25
- SDL_mixer(���ץ����) http://www.libsdl.org/projects/SDL_mixer/index.html
26
- SDL_ttf(���ץ����) http://www.libsdl.org/projects/SDL_ttf/index.html
27
- SDL_image(���ץ����) http://www.libsdl.org/projects/SDL_image/index.html
28
- SGE(���ץ����) http://www.etek.chalmers.se/~e8cal1/sge/
29
- SMPEG(���ץ����) http://www.icculus.org/smpeg/
30
- SDLSKK(���ץ����) http://www.kmc.gr.jp/~ohai/sdlskk.html
25
+ SDL_mixer(オプション) http://www.libsdl.org/projects/SDL_mixer/index.html
26
+ SDL_ttf(オプション) http://www.libsdl.org/projects/SDL_ttf/index.html
27
+ SDL_image(オプション) http://www.libsdl.org/projects/SDL_image/index.html
28
+ SGE(オプション) http://www.etek.chalmers.se/~e8cal1/sge/
29
+ SMPEG(オプション) http://www.icculus.org/smpeg/
30
+ SDLSKK(オプション) http://www.kmc.gr.jp/~ohai/sdlskk.html
31
31
 
32
- �ޤ���SDL_kanji�����Ѥ��Ƥ��ޤ���������ϥ��������֤˴ޤ�Ƥ���Τ�
33
- �̤��Ѱդ���ɬ�פϤ���ޤ���
32
+ また、SDL_kanjiを利用していますが、これはアーカイブに含めているので
33
+ 別に用意する必要はありません。
34
34
 
35
- 4 ���󥹥ȡ���
36
- Linux��ǤΥ��󥹥ȡ�����������ޤ���Unix�Ϥ�OS�ʤ�ɤ�Ǥ�Ʊ���褦
37
- �ˤǤ���Ȼפ��ޤ���
38
- Debian��Vine������¾�͡��ʥǥ����ȥ�ӥ塼�����ˤ�Ruby/SDL�Υѥå�����
39
- ������ΤǤ�������Ѥ��Ƥ�褤�Ǥ��礦��
40
- Windows��Ǥ��̤��Ѱդ��Ƥ���Х��ʥ����Ѥ����ۤ����ڤǤ��礦��
41
- FreeBSD�ˤ�Port������ΤǤ�������Ѥ��Ƥ���������
42
- ��Ԥ�Windows�δĶ��Ǥϡ�extconf.rb����Ѥ���Makefile���ǽ񤤤�
43
- ����ѥ��뤷�Ƥ����ꤷ�ޤ���
35
+ 4 インストール
36
+ Linux上でのインストールを説明します。Unix系のOSならどれでも同じよう
37
+ にできると思います。
38
+ DebianVine、その他様々なディストリビューションにはRuby/SDLのパッケージ
39
+ があるのでそれを利用してもよいでしょう。
40
+ Windows上では別に用意しているバイナリを使用したほうが楽でしょう。
41
+ FreeBSDにはPortがあるのでそれを利用してください。
42
+ 作者のWindowsの環境では、extconf.rbを使用せずMakefileを手で書いて
43
+ コンパイルしていたりします。
44
44
 
45
- (1)ruby�Υ��󥹥ȡ���
46
- ruby�Υɥ���������˽��äƥ��󥹥ȡ��뤷�Ƥ���������
45
+ (1)rubyのインストール
46
+ rubyのドキュメント等に従ってインストールしてください。
47
47
 
48
- (2)SDL�Υ��󥹥ȡ���
49
- ��������Ÿ�����ƥ���ѥ��뤹����ϡ��ʲ����̤�ˤ��Ƥ���������
48
+ (2)SDLのインストール
49
+ ソースを展開してコンパイルする場合は、以下の通りにしてください。
50
50
  ./configure --disable-pthreads
51
- (������--disable-pthreads���ץ�����Ĥ��ʤ��Ȥ��ޤ�ư���ޤ���)
52
- (���Υ��ץ�����Ĥ��Ƥ⡢SDL������ǽ�Ȥ���褦�Ǥ�)
53
- (Linux�ʳ��Ǥ�ɬ�פ���ޤ���)
54
- (rubysdl_doc.rd�κǸ��--disable-pthreads���դ��ʤ��Ȥ��ɤ���ˡ��񤤤Ƥ���ޤ�)
51
+ (ここで--disable-pthreadsオプションをつけないとうまく動きません)
52
+ (このオプションをつけても、SDLは全機能使えるようです)
53
+ (Linux以外では必要ありません)
54
+ (rubysdl_doc.rdの最後に--disable-pthreadsを付けなくとも良い方法も書いてあります)
55
55
  make
56
56
  make install
57
57
 
58
- (3)SGE�Υ��󥹥ȡ���
59
- make; make install�ǥ��󥹥ȡ��뤵��ޤ���
58
+ (3)SGEのインストール
59
+ make; make installでインストールされます。
60
60
 
61
- (4)SDL_mixer,SDL_ttf,SDL_image,SMPEG,SDLSKK�Υ��󥹥ȡ���
62
- ��°�Υɥ�����Ȥ˽��äƥ��󥹥ȡ��뤷�Ƥ���������
61
+ (4)SDL_mixer,SDL_ttf,SDL_image,SMPEG,SDLSKKのインストール
62
+ 附属のドキュメントに従ってインストールしてください。
63
63
 
64
- (5)���γ�ĥ�饤�֥��(Ruby/SDL)�Υ��󥹥ȡ���
65
- ���Υ饤�֥��Υ�������Ÿ�������ǥ��쥯�ȥ����
64
+ (5)この拡張ライブラリ(Ruby/SDL)のインストール
65
+ このライブラリのソースを展開したディレクトリ内で
66
66
  ruby extconf.rb
67
67
  make
68
68
  make install
69
- �Ȥ��Ƥ���������
70
-
71
- 5 �Ȥ���
72
- require 'sdl'�ǻȤ��ޤ���
73
- �ܤ����ϡ��ʲ��Υե������ɥ�����Ȥ򸫤Ƥ���������
74
-
75
- sample/*.rb ����ץ�
76
- �ʲ��Υ���ץ뤬����ޤ���
77
- testsprite.rb ����ɽ���Υ���ץ�
78
- playwave.rb PCM�ե�������դΥ���ץ� sample.wav ��ɬ��
79
- movesp.rb �������ϤΥ���ץ�
80
- alpha.rb ����ե��֥��ǥ��󥰤Υ���ץ�
81
- sgetest.rb sge�Υץ�ߥƥ�������Υ���ץ�
82
- font.rb True Type Font�Υ���ץ�
83
- playmod.rb mod�ե�������դΥ���ץ� sample.it ��ɬ��
84
- testgl.rb OpenGL�Υ���ץ�
85
- cursor.rb �ޥ�������������ѹ����륵��ץ�p
86
- transformblit.rb ��ž�̾�����Υ���ץ�
87
- joy2.rb ���祤�ѥå����ϤΥ���ץ�
88
- plaympeg.rb mpegɽ���Υ���ץ� sample.mpg��ɬ��
89
- sdlskk.rb SDLSKK�Υ���ץ롣�ե���Ȥ伭����ɬ��
90
- �ܤ����ϥ���ץ�Υ����Ȥ򸫤Ƥ�������
91
- bfont.rb �ӥåȥޥåץե����ɽ���Υ���ץ�
92
- kanji.rb SDL_Kanji��ǽ�Υ���ץ롣8x16.bdf��jiskan16.bdf
93
- �Ȥ���2�Ĥ�bdf�ե����뤬ɬ��
94
- collision.rb ���͸��е�ǽ�Υ���ץ�
95
- ����¾
96
- rubysdl_ref.rd, rubysdl_ref.html ��ե����
97
- Ruby/SDL�Υ�ե���󥹥ޥ˥奢��Ǥ���
98
- rubysdl_doc_old.rd �Ť���ե����
99
- �Ť���ե���󥹤Ǥ���
100
- SDL�Υɥ������
101
- SDL�Υ��󥹥ȡ���ΤȤ���Ÿ�������ե��������ˤ���Ϥ��Ǥ���
102
- �ޤ��� http://www.tacoworks.jp/software/SDLdoc-jp/index-j.html
103
- �������ܸ�Υɥ�����Ȥ�������ޤ���
104
- ��ե���󥹤˽񤫤�Ƥ��ʤ����ȤϤ���򸫤Ƥ���������
69
+ としてください。
70
+
71
+ (6) (MacOS Xのみ) rsdl のインストール
72
+ gem install rsdl で rsdl をインストールしてください。
73
+
74
+ 5 使い方
75
+ require 'sdl'で使えます。
76
+ MacOS Xの場合のみ、 ruby コマンドでなく rsdl コマンドで
77
+ インタプリタを起動してください。
78
+
79
+ 詳しくは、以下のファイルやドキュメントを見てください。
80
+
81
+ sample/*.rb サンプル
82
+ 以下のサンプルがあります。
83
+ testsprite.rb 画像表示のサンプル
84
+ playwave.rb PCMファイル演奏のサンプル sample.wav が必要
85
+ movesp.rb キー入力のサンプル
86
+ alpha.rb アルファブレンディングのサンプル
87
+ sgetest.rb sgeのプリミティブ描画のサンプル
88
+ font.rb True Type Fontのサンプル
89
+ playmod.rb modファイル演奏のサンプル sample.it が必要
90
+ testgl.rb OpenGLのサンプル
91
+ cursor.rb マウスカーソルを変更するサンプルp
92
+ transformblit.rb 回転縮小拡大のサンプル
93
+ joy2.rb ジョイパッド入力のサンプル
94
+ plaympeg.rb mpeg表示のサンプル sample.mpgが必要
95
+ sdlskk.rb SDLSKKのサンプル。フォントや辞書等必要
96
+ 詳しくはサンプルのコメントを見てください
97
+ bfont.rb ビットマップフォント表示のサンプル
98
+ kanji.rb SDL_Kanji機能のサンプル。8x16.bdfとjiskan16.bdf
99
+ という2つのbdfファイルが必要
100
+ collision.rb 衝突検出機能のサンプル
101
+ その他
102
+ rubysdl_ref.rd, rubysdl_ref.html リファレンス
103
+ Ruby/SDLのリファレンスマニュアルです。
104
+ rubysdl_doc_old.rd 古いリファレンス
105
+ 古いリファレンスです。
106
+ SDLのドキュメント
107
+ SDLのインストールのときに展開したファイルの中にあるはずです。
108
+ また、 http://www.tacoworks.jp/software/SDLdoc-jp/index-j.html
109
+ から日本語のドキュメントも手に入ります。
110
+ リファレンスに書かれていないことはこれを見てください。
105
111
  doc/
106
112
  Makefile
107
113
  rsd.rb
108
114
  *.rsd
109
- ��ե���󥹥ޥ˥奢��θ��ǡ����Ǥ���
110
-
111
- 6 OpenGL�ˤĤ���
112
- ���Υ饤�ե��ˤ�ä�OpenGL�ؤΥ�����������ǽ�ˤʤ�ޤ���
113
-
114
- (1) SDL����OpenGL��Ȥ���褦�����ꤹ�롣
115
- (2) http://raa.ruby-lang.org/project/opengl/ ����Ruby�Ѥ�
116
- OpenGL Interface ���äƤ��ƥ��󥹥ȡ��뤹�롣
117
- (3) ruby extconf.rb �򤹤�Ȥ��ˡ�--enable-opengl ����ꤹ�롣
118
- (4) make ; make install ���롣
119
- ���ξ���Ruby�Υ�����ץ����require 'opengl'�򤹤�ɬ�פ�����ޤ���
120
-
121
- ���󥿡��ե������� OpenGL Interface �Τ�Τ򤽤Τޤ޻ȤäƤ��ޤ���
122
- ����λȤ������ϡ�SDL�Υɥ�����ȡ�OpenGL�Υɥ�����ȡ�
123
- ����� sample/testgl.rb �򸫤�Ĵ�٤Ƥ���������
124
-
125
- ����
126
- OpenGL�Υ��󥿡��ե������ϼ����ˤ�äƾ������İۤʤ�ޤ������Τ���
127
- ���Τޤޤ��Ȥȥ���ѥ���Ǥ��ʤ������ޤ�ư���ʤ��ʤɤθ��ݤ�������
128
- ���Ȥ�����ޤ������ξ�� OpenGL Interface �Υ������˼�������ɬ��
129
- ������ޤ���
130
-
131
- 7 �饤����
132
- GNU LGPL(GNU Lesser General Public License) version 2.1 �ʹߤ˽����ޤ���
133
- �ܤ�����LICENSE�򸫤Ƥ���������
134
- ��������sample/ �ʲ��ˤ��륵��ץ�ץ������Ϥ���ˤϽ��鷺��
135
- ��ͳ�����Ѥ��Ƥ褤�Ǥ���
136
-
137
- 8 �ռ�
138
- �ʲ��ο�ã�˴��դ��ޤ���
139
- * FreeBSD�Ǥ�ư���ǧ�򤷡�Ports���äƤ���������Akinori MUSHA����
140
- * ���ޤ��ޤʰո������äƤ������ꡢ�����Ĥ�Υѥå������äƤ������ä���
141
- ��������餵��
142
- * �����Ƥ⤦�ҤȤĤ�SDL��Ruby��ĥ�饤�֥��"RUDL"�κ�ԤǤ���
143
- Danny van Bruggen ����(�����Ĥ��Υ����ǥ��򤳤Υ饤�֥�꤫�����ޤ���)��
144
- * rubysdl_ttf.c�ε�ǽ��ĥ�ѥå���Vine��Debian�Υѥå����������ʤɤ�
145
- ���Ƥ�����������ޤ������餵��
146
- * �����Ĥ��Υѥå��򲼤��ä� Wayne Conrad ����Christian Neukirchen����
147
- Keffin Barnaby����
148
- * ����ץ���󶡤��Ƥ������ä� Simon Strandgaard ����
149
- * ͭ�Ѥʾ��󡢥Х���ݡ��Ȥ򤯤����ä� Rorien Dunn����Dennis Ranke����
150
- Keita Urashima����
151
- * SDL��¸�ߤ򶵤��Ƥ��졢Ruby/SDL���뤭�ä�����Ϳ���Ƥ��줿��Ȫ����
152
- * SDLdoc ���ܸ������ץ��������Ȥˤ�����ä��ߤʤ���
153
- * ����ץ��ѤΥե���Ȥ��󶡤��Ƥ��줿������
154
- * #sdl-fan-jp@friend chat �Τߤʤ���
155
- * Windows�Ǥδ����򤷤Ƥ������륵����������
156
- 9 ����¾
157
- �ޤ��ƥ��Ȥ���Ƥ��ʤ���ǽ��¿������ޤ�(�ѥ�åȴ�Ϣ
158
- ��MPEG��Ϣ�Υ᥽�åɤ����Ĥ��ʤ�)��
159
-
160
- ��˾���Х���𡢻��Ѥ����������ϡ�ohai@kmc.gr.jp�˥᡼���Ф���
161
- �������������ΤȤ����ޤ��ȿ��������ޤ���Τǡ���ñ�ʴ��ۤǤ����äƤ���
162
- ��ȴ򤷤��Ǥ���
163
- �ޤ���ruby-list��ruby-ext�򸫤Ƥ��ޤ��Τǡ��Х����򤽤�����𤷤Ƥ���Ƥ�
164
- �ɤ��Ǥ���
165
-
166
- �ʾ�
115
+ リファレンスマニュアルの元データです。
116
+
117
+ 6 OpenGLについて
118
+ このライブラリによってOpenGLへのアクセスが可能になります。
119
+
120
+ (1) SDLからOpenGLを使えるように設定する。
121
+ (2) http://ruby-opengl.rubyforge.org/ をインストールする。
122
+ (3) ruby extconf.rb をするときに、--enable-opengl を指定する。
123
+ (4) make ; make install する。
124
+ この場合はRubyのスクリプト内でrequire 'opengl'をする必要があります。
125
+
126
+ インターフェースは ruby-opengl そのものなので、
127
+ これの使いかたは、SDLのドキュメント、OpenGLのドキュメント、
128
+ および sample/testgl.rb を見て調べてください。
129
+
130
+ 7 ライセンス
131
+ GNU LGPL(GNU Lesser General Public License) version 2.1 以降に従います。
132
+ 詳しくはLICENSEを見てください。
133
+ ただし、sample/ 以下にあるサンプルプログラムはこれには従わず、
134
+ 自由に利用してよいです。
135
+
136
+ 8 謝辞
137
+ 以下の人達に感謝します。
138
+ * FreeBSDでの動作確認をし、Portsを作っていただいたAkinori MUSHAさん。
139
+ * さまざまな意見を送ってくださり、いくつものパッチを送ってくださったり
140
+ したたむらさん。
141
+ * そしてもうひとつのSDLのRuby拡張ライブラリ"RUDL"の作者である
142
+ Danny van Bruggen さん(いくつかのアイデアをこのライブラリから得ました)。
143
+ * rubysdl_ttf.cの機能拡張パッチやVine、Debianのパッケージ作成などを
144
+ していただいたやまだあきらさん。
145
+ * いくつかのパッチを下さった Wayne Conrad さん、Christian Neukirchenさん、
146
+ Keffin Barnabyさん。
147
+ * サンプルを提供してくださった Simon Strandgaard さん。
148
+ * 有用な情報、バグレポートをくださった Rorien Dunnさん、Dennis Rankeさん、
149
+ Keita Urashimaさん。
150
+ * SDLの存在を教えてくれ、Ruby/SDLを作るきっかけを与えてくれた田畑さん。
151
+ * SDLdoc 日本語翻訳プロジェクトにかかわったみなさま
152
+ * サンプル用のフォントを提供してくれた原さん。
153
+ * #sdl-fan-jp@friend chat のみなさま
154
+ * Windows版の管理をしてくださるサイロスさん
155
+ 9 その他
156
+ まだテストされていない機能が多くあります(パレット関連
157
+ やMPEG関連のメソッドいくつかなど)。
158
+
159
+ 要望、バグ報告、使用した感想等は、ohai@kmc.gr.jpにメールを出して
160
+ ください。今のところまるで反響がありませんので、簡単な感想でも送ってくれ
161
+ ると嬉しいです。
162
+ また、ruby-list、ruby-extを見ていますので、バグ等をそこに報告してくれても
163
+ 良いです。
164
+
165
+ 以上