rubysdl 2.0.1 → 2.1.0

data/NEWS.en

@@ -1,3 +1,39 @@
+version 2.1.0
+add following methods
+* SDL::TTF#close
+* SDL::TTF#closed?
+* SDL::BMFont#close
+* SDL::BMFont#closed?
+* SDL::Kanji#close
+* SDL::Kanji#closed?
+* SDL::Surface#destroyed?
+* SDL::Joystick#closed?
+* SDL::Mixer::Wave#destroyed?
+* SDL::Mixer::Music#destroyed?
+* SDL::Kanji#get_coding_system
+modify documents
+Async following methods on Ruby 1.9
+* SDL::Event#wait
+* SDL.delay
+Ruby m17n support on Ruby 1.9
+* SDL::WM.set_caption
+* SDL::WM.caption
+* SDL::TTF#draw_solid 
+* SDL::TTF#draw_blended 
+* SDL::TTF#draw_shaded
+* SDL::TTF#render_solid
+* SDL::TTF#render_blended
+* SDL::TTF#render_shaded
+* SDL::Kanji#put
+* SDL::Kanji#putTate
+* SDL::SDLSKK#str
+Fix the bug of following methods
+* SDL::MPEG#move
+
+version 2.0.1b
+fix sample bug
+fix SDL::MPEG.info
+
 version 2.0.1
 fix some compile errors/warnings
 raise SDL::Surface::VideoMemoryLost when video memory is lost when calling SDL::Surface.blit

data/NEWS.ja

@@ -1,3 +1,39 @@
+version 2.1.0
+$B0J2<$N%a%=%C%I$rDI2C(B
+* SDL::TTF#close
+* SDL::TTF#closed?
+* SDL::BMFont#close
+* SDL::BMFont#closed?
+* SDL::Kanji#close
+* SDL::Kanji#closed?
+* SDL::Surface#destroyed?
+* SDL::Joystick#closed?
+* SDL::Mixer::Wave#destroyed?
+* SDL::Mixer::Music#destroyed?
+* SDL::Kanji#get_coding_system
+$B%I%-%e%a%s%H$N=$@5(B
+$B0J2<$N%a%=%C%I$N8F$S$@$7Cf$K(B1.9$B$G%9%l%C%I@Z$jBX$(2DG=$KJQ99(B
+* SDL::Event#wait
+* SDL.delay
+$B0J2<$N%a%=%C%I$G(BRuby$B$N(Bm17n$B5!G=$rMxMQ$9$k$h$&$KJQ99(B
+* SDL::WM.set_caption
+* SDL::WM.caption
+* SDL::TTF#draw_solid 
+* SDL::TTF#draw_blended 
+* SDL::TTF#draw_shaded
+* SDL::TTF#render_solid
+* SDL::TTF#render_blended
+* SDL::TTF#render_shaded
+* SDL::Kanji#put
+* SDL::Kanji#putTate
+* SDL::SDLSKK#str
+$B0J2<$N%a%=%C%I$N%P%0$r=$@5(B
+* SDL::MPEG#move
+
+version 2.0.1b
+$B%5%s%W%k$N%P%0$r=$@5(B
+SDL::MPEG.info$B$r=$@5(B
+
 version 2.0.1
 $B%3%s%Q%$%k$G$-$J$$>l9g$,$"$k$N$r=$@5(B
 SDL::Surface.blit$B$G%S%G%*%a%b%j$,%m%9%H$7$?>l9g$K(B

data/README.en

@@ -1,5 +1,5 @@
 
-Ruby/SDL 2.0.1
+Ruby/SDL 2.1.0
 Ohbayashi Ippei
 
 1 What's Ruby/SDL

data/README.ja

@@ -1,5 +1,5 @@
 
-Ruby/SDL 2.0.1
+Ruby/SDL 2.1.0
 ���Ӱ�ʿ
 
 1 ����

data/doc-en/Makefile

@@ -2,7 +2,7 @@
 RSD = ruby ../doc/rsd.rb -e
 RDFILES = general.rd init.rd video.rd opengl.rd wm.rd event.rd joystick.rd cdrom.rd mixer.rd time.rd font.rd collision.rd sdlskk.rd mpeg.rd
 RD2 = rd2
-RD2OPT = -r rd/rd2html-lib.rb --html-lang=ja --html-charset=EUC-JP
+RD2OPT = -r rd/rd2html-lib.rb --html-lang=en --html-charset=UTF-8
 
 
 rubysdl_ref.en.html: rubysdl_ref.en.rd

data/doc-en/cdrom.rsd

@@ -413,5 +413,36 @@ Convert minitus/seconds/frames into frames and returns frames.
 SEEALSO
 CD.frames_to_msf
 
+%%
+NAME close
+MOD CD
+TYPE #
+PURPOSE Closes a CD handle
+
+PROTO
+close
+
+DESC 
+Closes $[self].
+
+SEEALSO
+CD.open
+CD#closed?
+
+%%
+NAME closed?
+MOD CD
+TYPE #
+PURPOSE Returns whether CD is closed
+
+PROTO
+closed?
+
+DESC 
+Returns whether CD handle is closed by
+@[CD#close]
+
+SEEALSO
+CD#close
 
 

data/doc-en/event.rsd

@@ -451,8 +451,12 @@ Raise @[Error] if there was an error while waiting
 for events.
 
 NOTES
-All Ruby's threads stop while waiting next event because Ruby's thread 
-is not native thread.
+In Ruby 1.9 and above, this method releases the global VM lock (GVL) prior to
+calling the underlying SDL_WaitEvent function.  This allows other Ruby threads to
+continue executing while waiting for an event.
+
+In Ruby 1.8 and below, there is no way to release the GVL, so all Ruby threads
+suspend execution until this method finishes.
 
 SEEALSO
 Event.poll

data/doc-en/font.rsd

@@ -120,6 +120,40 @@ EXAMPLE
 SDL::TTF.init
 font = SDL::TTF.open("font.ttf", 32, 0)
 
+%%
+NAME close
+MOD TTF
+TYPE #
+DEP SDL_ttf
+PURPOSE Closes a font
+
+PROTO
+close
+
+DESC
+Closes a font and free related resources.
+
+SEEALSO
+TTF#closed?
+
+%%
+NAME closed?
+MOD TTF
+TYPE #
+DEP SDL_ttf
+PURPOSE Returns whether a font is closed or not
+RVAL true/false
+
+PROTO
+closed?
+
+DESC
+Returns whether a font is closed by @[TTF#close]
+
+SEEALSO
+TTF#close
+
+
 %%
 NAME style
 MOD TTF
@@ -354,7 +388,7 @@ NAME text_size
 MOD TTF
 TYPE #
 DEP SDL_ttf
-PURPOSE Get size of UTF8 text string as would be rendered
+PURPOSE Get size of text string as would be rendered
 RVAL [Integer, Integer]
 
 PROTO
@@ -366,6 +400,10 @@ Calculate the resulting surface size of the UTF8 encoded text rendered using fon
 No actual rendering is done, however correct kerning is done to get the actual
 width. The height returned in h is the same as you can get using @[TTF#height].
 
+NOTES
+If Ruby/SDL m17n support is enabled, 
+$[text] will be converted to suitable encoding.
+
 RET
 Returns a 2 element array as [w, h].
 
@@ -587,6 +625,40 @@ $[flags] is OR'd combination of following values:
   font surface will be a bit slower but @[BMFont#set_color]
   will be faster (O(1) instead of O(n^2)).
 
+%%
+NAME close
+MOD BMFont
+TYPE #
+DEP SGE
+PURPOSE Closes a font.
+
+PROTO
+close
+
+DESC
+Closes a font and release the resources.
+
+SEEALSO
+BMFont.open
+BMFont#closed?
+
+%%
+NAME closed?
+MOD BMFont
+TYPE #
+DEP SGE
+PURPOSE Returns whether a font is closed.
+RVAL true/false
+
+PROTO
+closed?
+
+DESC
+Returns whether a font is closed by @[BMFont#close].
+
+SEEALSO
+BMFont#close
+
 %%
 NAME set_color
 MOD BMFont
@@ -696,6 +768,39 @@ $[size] is the height of one character.
 SEEALSO
 Kanji#add
 
+%%
+NAME close
+MOD Kanji
+TYPE #
+PURPOSE Closes bdf font data
+
+PROTO
+close
+
+DESC
+Closes bdf font data and release
+the resouces and memories.
+
+SEEALSO
+Kanji.open
+Kanji#closed?
+
+%%
+NAME closed?
+MOD Kanji
+TYPE #
+PURPOSE Returns whether bdf font is closed
+
+PROTO
+closed?
+
+DESC
+Returns whether bdf font is closed by @[Kanji#close]
+
+SEEALSO
+Kanji#close
+
+
 %%
 NAME add
 MOD Kanji
@@ -710,7 +815,7 @@ Add font data fromt $[filename] into already loaded font $[self].
 This method combines two or more font files into one.
 
 SEEALSO
-Kanji#open
+Kanji.open
 
 %%
 NAME set_coding_system
@@ -729,6 +834,29 @@ Set encoding. $[sys] is one of following:
 * SDL::Kanji::JIS
 Default is SDL::Kanji::JIS.
 
+SEEALSO
+Kanji#get_coding_system
+
+%%
+NAME get_coding_system
+MOD Kanji
+TYPE #
+PURPOSE Get character encoding
+
+PROTO
+get_coding_system
+getCodingSystem
+
+DESC
+Get encoding. A return value is one of following:
+* SDL::Kanji::SJIS
+* SDL::Kanji::EUC
+* SDL::Kanji::JIS
+Default is SDL::Kanji::JIS.
+
+SEEALSO
+Kanji#set_coding_system
+
 %%
 NAME height
 MOD Kanji
@@ -771,7 +899,7 @@ DESC
 Returns the width of one character.
 
 SEEALSO
-textwidth
+Kanji#textwidth
 
 %%
 NAME put
@@ -786,8 +914,13 @@ DESC
 Renders $[text] at ($[x], $[y]) in $[surface]
 with ($[r], $[g], $[b]) color.
 
+NOTES
+If Ruby/SDL m17n support is enabled, $[text] 
+will be converted to suitable encoding.
+
 SEEALSO
 Kanji#put_tate
+Kanji#set_coding_system
 
 %%
 NAME put_tate
@@ -805,7 +938,11 @@ with ($[r], $[g], $[b]) color.
 
 `Half-width' character is not rendered.
 
+NOTES
+If Ruby/SDL m17n support is enabled, $[text] 
+will be converted to suitable encoding.
+
 SEEALSO
 Kanji#put
-
+Kanji#set_coding_system
 

data/doc-en/general.rsd

@@ -33,6 +33,20 @@ Ruby/SDL has following functions.
 * ((<MPEG playback>)) with ((<SMPGE|URL:http://www.icculus.org/smpeg/>))
 * ((<Window Management>)) and ((<Collision Detection>))
 
+= m17n on Ruby 1.9
+On ruby 1.9, strings have encoding information
+but many methods of Ruby/SDL ignore this information
+since SDL doesn't define the treatment of multibyte 
+encodings. 
+Only some methods use encoding information such as
+@[WM.set_caption] and @[Kanji#put].
+
+Please see items in this reference for more details.
+
+You can enable/disable Ruby/SDL m17n support 
+to use --enable-m17n/--disable-m17n when you
+run extconf.rb.
+
 == SDL::Error
 A Exception class for SDL specific errors.
 This class is subclass of StandardError.

data/doc-en/init.rsd

@@ -21,11 +21,11 @@ Ruby/SDL methods. The $[flags] parameter specifies what
 :SDL::INIT_AUDIO
   Initialize autio subsystems.
 :SDL::INIT_VIDEO
-  Initialize @[Video] subsystem.
+  Initialize ((<Video>)) subsystem.
 :SDL::INIT_CDROM
-  Initialize @[CDROM] subsystem.
+  Initialize ((<CD-ROM>)) subsystem.
 :SDL::INIT_JOYSTICK
-  Initialize @[Joystick] subsystem.
+  Initialize ((<Joystick>)) subsystem.
 :SDL::INIT_EVERYTHING
   Initialize all of the avobe.
 

data/doc-en/mixer.rsd

@@ -215,6 +215,39 @@ this conversion at load time. Therefore you should pay attention to memory consu
 
 EXCEPTION *
 
+%%
+NAME destroy
+MOD Mixer::Wave
+TYPE #
+PURPOSE Frees an audio chunk.
+
+PROTO
+destroy
+
+DESC
+Frees an audio chunk previously loaded.
+If this method is called, all operations are forbidden.
+
+SEEALSO
+Mixer::Wave#destroyed?
+
+%%
+NAME destroyed?
+MOD Mixer::Wave
+TYPE #
+PURPOSE Returns whether an audio chunk is destroyed.
+RVAL true/false
+
+PROTO
+destroyed?
+
+DESC
+Returns whether au audio chunk is destroyed by
+@[Mixer::Wave#destroy]
+
+SEEALSO
+Mixer::Wave#destroy
+
 %%
 NAME load
 MOD Mixer::Music
@@ -259,6 +292,41 @@ On Windows, it may be impossible to use this method.
 
 EXCEPTION *
 
+%%
+NAME destroy
+MOD Mixer::Music
+TYPE #
+PURPOSE Frees an music data.
+
+PROTO
+destroy
+
+DESC
+Frees an music data previously loaded.
+If this method is called, all operations are forbidden.
+
+SEEALSO
+Mixer::Music#destroyed?
+Mixer::Wave#destroy
+
+%%
+NAME destroyed?
+MOD Mixer::Music
+TYPE #
+PURPOSE Returns whether an music data is destroyed.
+RVAL true/false
+
+PROTO
+destroyed?
+
+DESC
+Returns whether a music data is destroyed by
+@[Mixer::Music#destroy]
+
+SEEALSO
+Mixer::Music#destroy
+Mixer::Wave#destroyed?
+
 %%
 NAME set_volume
 MOD Mixer::Wave