cyross-ruby-miyako 2.0.0 → 2.0.5.1.0

data/lib/Miyako/API/map_event.rb

@@ -2,7 +2,7 @@
 =begin
 --
 Miyako v2.0
-Copyright (C) 2007-2008  Cyross Makoto
+Copyright (C) 2007-2009  Cyross Makoto
 
 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
@@ -151,7 +151,7 @@ module Miyako
     #イベント発生が可能なときはtrueを返す(その後、startメソッドを呼び出す)処理を実装する
     #_param_:: 問い合わせに使用するパラメータ群。デフォルトはnil
     #返却値:: イベント発生可能ならばtrue
-    def met?(params = nil)
+    def met?(*params)
       return false
     end
     
@@ -165,7 +165,7 @@ module Miyako
     #ここに、イベント発生イベントを実装する。更新はupdateメソッドに実装する
     #_param_:: イベント発生に必要なパラメータ群。デフォルトはnil
     #返却値:: 自分自身を返す
-    def start(params = nil)
+    def start(*params)
       return self
     end
     
@@ -173,7 +173,7 @@ module Miyako
     #ここに、イベント停止・終了イベントを実装する。更新はupdateメソッドに実装する
     #_param_:: イベント発生に必要なパラメータ群。デフォルトはnil
     #返却値:: 自分自身を返す
-    def stop(params = nil)
+    def stop(*params)
       return self
     end
     

data/lib/Miyako/API/modules.rb

@@ -2,7 +2,7 @@
 =begin
 --
 Miyako v2.0
-Copyright (C) 2007-2008  Cyross Makoto
+Copyright (C) 2007-2009  Cyross Makoto
 
 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public

data/lib/Miyako/API/movie.rb

@@ -2,7 +2,7 @@
 =begin
 --
 Miyako v2.0
-Copyright (C) 2007-2008  Cyross Makoto
+Copyright (C) 2007-2009  Cyross Makoto
 
 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
@@ -29,6 +29,8 @@ module Miyako
     extend Forwardable
 
     @@movie_list = []
+
+    attr_accessor :visible #レンダリングの可否(true->描画 false->非描画)
     
     #===動画のインスタンスを作成する
     #(但し、現在の所、loopパラメータは利用できない)
@@ -45,6 +47,7 @@ module Miyako
       @size = Size.new(@movie.info.width, @movie.info.height)
       set_layout_size(*(@size.to_a))
 
+      @visible = true
       @sprite = Sprite.new({:size=>@size , :type=>:movie})
       @sprite.snap(self)
       
@@ -60,6 +63,7 @@ module Miyako
     def update_layout_position #:nodoc:
       @x = @layout.pos[0]
       @y = @layout.pos[1]
+      @sprite.move_to(*@layout.pos)
     end
     
     #===動画再生時の音量を指定する
@@ -101,7 +105,7 @@ module Miyako
     #===動画を再生させる
     #動画の先頭から再生する。ブロックを渡したときは、ブロックを評価している間動画を再生する
     #_vol_:: 動画再生時の音量。0～100の整数
-    def play(vol = nil)
+    def start(vol = nil)
       set_volume(vol) if vol
       @movie.play
       if block_given?
@@ -131,11 +135,10 @@ module Miyako
 
     #===画面に描画を指示する
     #現在表示できる選択肢を、現在の状態で描画するよう指示する
-    #--
-    #(但し、実際に描画されるのはScreen.renderメソッドが呼び出された時)
-    #++
+    #visibleメソッドの値がfalseのときは描画されない。
     #返却値:: 自分自身を返す
     def render
+      return slef nless @visible
       @sprite.render
       return self
     end

data/lib/Miyako/API/parts.rb

@@ -2,7 +2,7 @@
 =begin
 --
 Miyako v2.0
-Copyright (C) 2007-2008  Cyross Makoto
+Copyright (C) 2007-2009  Cyross Makoto
 
 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
@@ -33,14 +33,17 @@ module Miyako
     include Layout
     extend Forwardable
 
+    attr_accessor :visible #レンダリングの可否(true->描画 false->非描画)
+
     #===Partsクラスインスタンスを生成
     #_size_:: パーツ全体の大きさ。Size構造体のインスタンスもしくは要素数が2の配列
     def initialize(size)
-      init_layout
-      set_layout_size(size[0], size[1])
-
       @parts = {}
       @parts_list = []
+      @visible = true
+
+      init_layout
+      set_layout_size(size[0], size[1])
     end
 
     #===nameで示した補助パーツを返す
@@ -97,7 +100,7 @@ module Miyako
       return self
     end
 
-    #===メインパーツと補助パーツのすべてのアニメーションを更新する(自動実行)
+    #===メインパーツと補助パーツのすべてのアニメーションを更新する
     #返却値:: 自分自身
     def update_animation
       self.each{|parts| parts.update_animation }
@@ -110,23 +113,32 @@ module Miyako
       return self
     end
 
-    #===メインパーツと補助パーツのすべてのアニメーションを更新する(自動実行)
-    #返却値:: 自分自身
-    def update
-      self.update_animation
+    def update #:nodoc:
+      self.each{|parts| parts.update }
       return self
     end
 
     #===スプライトに変換した画像を表示する
     #すべてのパーツを貼り付けた、１枚のスプライトを返す
+    #引数1個のブロックを渡せば、スプライトに補正をかけることが出来る
     #返却値:: 描画したスプライト
     def to_sprite
       rect = self.broad_rect
       sprite = Sprite.new(:size=>rect.to_a[2,2], :type=>:ac)
+      Drawing.fill(sprite, [0,0,0])
+      Bitmap.ck_to_ac!(sprite, [0,0,0])
       self.render_to(sprite){|sunit, dunit| sunit.x -= rect.x; sunit.y -= rect.y }
+      yield sprite if block_given?
       return sprite
     end
 
+    #===SpriteUnit構造体を生成する
+    #いったんSpriteインスタンスを作成し、それをもとにSpriteUnit構造体を生成する。
+    #返却値:: 生成したSpriteUnit構造体
+    def to_unit
+      return self.to_sprite.to_unit
+    end
+
     #===現在の画面の最大の大きさを矩形で取得する
     #各パーツの位置により、取得できる矩形の大きさが変わる
     #但し、パーツ未登録の時は、インスタンス生成時の大きさから矩形を生成する
@@ -150,5 +162,28 @@ module Miyako
       @parts.clear
       @parts = nil
     end
+
+    #===パーツを画面に描画する
+    #各パーツの描画範囲は、それぞれのSpriteUnitの(ox,oy)を起点にする。
+    #画面の描画範囲は、src側SpriteUnitの(x,y)を起点に、各パーツを貼り付ける。
+    #ブロック付きで呼び出し可能(レシーバに対応したSpriteUnit構造体が引数として得られるので、補正をかけることが出来る)
+    #(ブロック引数のインスタンスは複写しているので、メソッドの引数として渡した値が持つSpriteUnitには影響しない)
+    #ブロックの引数は、|パーツのSpriteUnit|となる。
+    #デフォルトでは、描画順は登録順となる。順番を変更したいときは、renderメソッドをオーバーライドする必要がある
+    #visibleメソッドの値がfalseのときは描画されない。
+    def render
+    end
+
+    #===パーツを画面に描画する
+    #各パーツの描画範囲は、それぞれのSpriteUnitの(ox,oy)を起点にする。
+    #転送先の描画範囲は、src側SpriteUnitの(x,y)を起点に、タイリングを行いながら貼り付ける。
+    #ブロック付きで呼び出し可能(レシーバに対応したSpriteUnit構造体が引数として得られるので、補正をかけることが出来る)
+    #(ブロック引数のインスタンスは複写しているので、メソッドの引数として渡した値が持つSpriteUnitには影響しない)
+    #ブロックの引数は、|パーツのSpriteUnit|となる。
+    #デフォルトでは、描画順は登録順となる。順番を変更したいときは、render_toメソッドをオーバーライドする必要がある
+    #visibleメソッドの値がfalseのときは描画されない。
+    #_dst_:: 転送先ビットマップ(to_unitメソッドを呼び出すことが出来る/値がnilではないインスタンス)
+    def render_to(dst)
+    end
   end
 end

data/lib/Miyako/API/plane.rb

@@ -2,7 +2,7 @@
 =begin
 --
 Miyako v2.0
-Copyright (C) 2007-2008  Cyross Makoto
+Copyright (C) 2007-2009  Cyross Makoto
 
 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
@@ -45,6 +45,7 @@ module Miyako
       end
       resize
       @pos = Point.new(0, 0)
+      @visible = true
     end
 
     #===プレーン画像左上の x 座標の値を取得する
@@ -115,17 +116,51 @@ module Miyako
         @size.w.times{|x|
           u = @sprite.to_unit
           u.move_to(x * @sprite.ow + @pos.x, y * @sprite.oh + @pos.y)
-          Screen.render_screen(u) if u.x >= 0 && u.y >= 0 && u.x + u.ow <= Screen.screen.w && u.y + u.oh <= Screen.screen.h
+          Screen.render_screen(u) if u.x >= 0 && u.y >= 0 && u.x + u.ow <= Screen.bitmap.w && u.y + u.oh <= Screen.bitmap.h
         }
       }
       return self
     end
     
+    #===現在表示されているプレーンをSpriteクラスのインスタンスとして取得
+    #引数1個のブロックを渡せば、スプライトに補正をかけることが出来る
+    #返却値:: 取り込んだ画像を含むSpriteクラスのインスタンス
+    def to_sprite
+      sprite = Sprite.new(:size=>self.rect.to_a[2..3], :type=>:ac)
+      Drawing.fill(sprite, [0,0,0])
+      Bitmap.ck_to_ac!(sprite, [0,0,0])
+      self.render_to(sprite)
+      yield sprite if block_given?
+      return sprite
+    end
+
+    #===SpriteUnit構造体を生成する
+    #いったんSpriteインスタンスを作成し、それをもとにSpriteUnit構造体を生成する。
+    #返却値:: 生成したSpriteUnit構造体
+    def to_unit
+      return self.to_sprite.to_unit
+    end
+
     def Plane::resize #:nodoc:
       @@planes.each{|p| p.resize }
       return nil
     end
 
+    #===プレーンを画面に描画する
+    #転送元の描画範囲は、src側SpriteUnitの(ox,oy)を起点にする。
+    #画面の描画範囲は、src側SpriteUnitの(x,y)を起点に、タイリングを行いながら貼り付ける。
+    #visibleメソッドの値がfalseのときは描画されない。
+    def render
+    end
+
+    #===プレーンを画像に描画する
+    #転送元の描画範囲は、src側SpriteUnitの(ox,oy)を起点にする。
+    #転送先の描画範囲は、src側SpriteUnitの(x,y)を起点に、タイリングを行いながら貼り付ける。
+    #visibleメソッドの値がfalseのときは描画されない。
+    #_dst_:: 転送先ビットマップ(to_unitメソッドを呼び出すことが出来る/値がnilではないインスタンス)
+    def render_to(dst)
+    end
+
     def_delegators(:sprite)
   end
 end

data/lib/Miyako/API/screen.rb

@@ -2,7 +2,7 @@
 =begin
 --
 Miyako v2.0
-Copyright (C) 2007-2008  Cyross Makoto
+Copyright (C) 2007-2009  Cyross Makoto
 
 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
@@ -46,9 +46,17 @@ module Miyako
     FULLSCREEN_MODE = 1
 
     #ウインドウモード・フルスクリーンモードを切り替える際のフラグを示す配列
-    ScreenFlag = Array.new
-    ScreenFlag.push(SDL::HWSURFACE | SDL::DOUBLEBUF | SDL::ANYFORMAT)
-    ScreenFlag.push(SDL::ANYFORMAT | SDL::FULLSCREEN)
+    ScreenFlag = $miyako_use_opengl ? [SDL::OPENGL, SDL::OPENGL | SDL::FULLSCREEN] : [SDL::HWSURFACE | SDL::DOUBLEBUF | SDL::ANYFORMAT, SDL::ANYFORMAT | SDL::FULLSCREEN]
+    
+    if $miyako_use_opengl
+      SDL::GL.set_attr(SDL::GL::RED_SIZE, 8)
+      SDL::GL.set_attr(SDL::GL::GREEN_SIZE, 8)
+      SDL::GL.set_attr(SDL::GL::BLUE_SIZE, 8)
+      SDL::GL.set_attr(SDL::GL::ALPHA_SIZE, 8)
+      SDL::GL.set_attr(SDL::GL::DEPTH_SIZE, 32)
+      SDL::GL.set_attr(SDL::GL::STENCIL_SIZE, 32)
+      SDL::GL.set_attr(SDL::GL::DOUBLEBUFFER, 1)
+    end
     
     def Screen::get_fps_count
       return @@fps == 0 ? 0 : FpsMax / @@fps
@@ -71,6 +79,9 @@ module Miyako
     @@screen = nil
     @@viewport = nil
     
+    @@pre_render_array = []
+    @@auto_render_array = []
+    
     #===画面の状態(ウインドウモードとフルスクリーンモード)を設定する
     #_v_:: ウィンドウモードのときは、Screen::WINDOW_MODE、 フルスクリーンモードのときはScreen::FULLSCREEN_MODE
     def Screen::set_mode(v)
@@ -80,6 +91,27 @@ module Miyako
       end
     end
 
+    #=== 事前描画インスタンス配列を取得する
+    #Screenモジュールに属している事前レンダー(プリレンダー)配列にアクセス可能
+    #この配列に取り込んだインスタンスは、配列インデックスの順に描画される
+    #また、配列の要素は、必ずrenderメソッドを実装していなければならない(renderメソッドで描画するため)
+    #但し、配列の要素が配列のときは、再帰的に描画が可能
+    #描画は、Screen.pre_renderメソッドの明示的呼び出しで実行される
+    #返却値:: 自動描画配列
+    def Screen::pre_render_array
+      @@pre_render_array
+    end
+
+    #=== 自動描画インスタンス配列を取得する
+    #Screenモジュールに属しているオートレンダー(自動描画)配列にアクセス可能
+    #この配列に取り込んだインスタンスは、配列インデックスの順に描画される
+    #また、配列の要素は、必ずrenderメソッドを実装していなければならない(renderメソッドで描画するため)
+    #但し、配列の要素が配列のときは、再帰的に描画が可能
+    #返却値:: 自動描画配列
+    def Screen::auto_render_array
+      @@auto_render_array
+    end
+
     #===ウインドウモードとフルスクリーンモードを切り替える
     def Screen::toggle_mode
       @@mode = (@@mode + 1) % WINMODES
@@ -105,7 +137,7 @@ module Miyako
 
     #===画面を管理するインスタンスを取得する
     #返却値:: 画面インスタンス(SDL::Screenクラスのインスタンス)
-    def Screen::screen
+    def Screen::bitmap
       return @@screen
     end
 
@@ -122,9 +154,10 @@ module Miyako
     end
 
     #===画面を管理するSpriteUnitを取得する
+    #得られるインスタンスは複写していないので、インスタンスの値を調整するには、dupメソッドで複製する必要がある
     #返却値:: SpriteUnitインスタンス
     def Screen::to_unit
-      return @@unit.dup
+      return @@unit
     end
 
     #===画像の回転・拡大・縮小の中心座標を取得する
@@ -181,11 +214,26 @@ module Miyako
       return @@size.dup
     end
 
-    def Screen::set_screen(f) #:nodoc:
-      return false unless SDL.checkVideoMode(*(@@size.to_a << BPP << f))
-      @@screen = SDL.setVideoMode(*(@@size.to_a << BPP << f))
+    #===Segment構造体を生成する
+    # 生成される線分は、x方向が[0,w-1]、y方向が[0,h-1]となる
+    #返却値:: 生成したSegment構造体インスタンス
+    def Screen::segment
+			return Segment.new([0, @@size[0]-1], [0, @@size[1]-1])
+    end
+
+    #===画面のサーフェスを生成する
+    #グローバル変数$miyako_open_screen==falseの時に有効
+    #画面サーフェスを生成し、表示させる
+    #require 'Miyako/miyako'を記述する前に、"$miyako_open_screen=false"と記述すると
+    def Screen::open
+      @@screen = SDL::Screen.open(*(@@size.to_a << BPP << ScreenFlag[@@mode]))
       SpriteUnitFactory.apply(@@unit, {:bitmap=>@@screen, :ow=>@@screen.w, :oh=>@@screen.h})
       @@viewport = Viewport.new(0, 0, @@screen.w, @@screen.h)
+    end
+
+    def Screen::set_screen #:nodoc:
+      return false unless SDL.checkVideoMode(*(@@size.to_a << BPP << ScreenFlag[@@mode]))
+      self.open
       return true
     end
 
@@ -195,16 +243,15 @@ module Miyako
     #_h_:: 画面の高さ
     #返却値:: 変更に成功したときは trueを返す
     def Screen::set_size(w, h)
+      return unless @@screen
       return false unless SDL.checkVideoMode(w, h, BPP, ScreenFlag[@@mode])
       @@size = Size.new(w, h)
-      @@screen = SDL.setVideoMode(*(@@size.to_a << BPP << ScreenFlag[@@mode]))
-      SpriteUnitFactory.apply(@@unit, {:bitmap=>@@screen, :ow=>@@screen.w, :oh=>@@screen.h})
-      @@viewport = Viewport.new(0, 0, @@screen.w, @@screen.h)
+      self.open
       return true
     end
 
     def Screen::check_mode_error #:nodoc:
-      unless Screen::set_screen(ScreenFlag[@@mode])
+      unless Screen::set_screen
         print "Sorry, this system not supported display...\n";
         exit(1)
       end
@@ -227,31 +274,52 @@ module Miyako
 
     #===現在表示されている画面を複製し、Spriteクラスのインスタンスとして取得
     #Screen.captureとの違いは、パラメータ・サイズは不変(画面の大きさで複製)で取り扱う。
-    #
-    #_param_:: Spriteインスタンスを生成するときに渡すパラメータ(但し、:sizeと:typeのみ使用する)
-    #_rect_:: 取り込む画像の矩形(4要素の配列もしくはRect構造体のインスタンス)
-    #デフォルトは画面の大きさ
+    #引数1個のブロックを渡せば、スプライトに補正をかけることが出来る
     #返却値:: 取り込んだ画像を含むSpriteクラスのインスタンス
     def Screen::to_sprite
-      param[:size] = Size.new(*(rect[2..3]))
-      dst = Sprite.new(param)
-      Bitmap.screen_to_ac!(Screen, dst)
+      dst = Sprite.new(:size => Size.new(*(rect[2..3])), :type => :ac)
+      Bitmap.screen_to_ac(Screen, dst)
+      yield dst if block_given?
       return dst
     end
 
     #===画像を消去する
     #画像を黒色([0,0,0,0])で塗りつぶす
     def Screen::clear
+      return unless @@screen
       @@screen.fillRect(0, 0, @@screen.w, @@screen.h, [0, 0, 0, 0])
     end
     
+    #===プリレンダー配列に登録されたインスタンスを画面に描画する
+    #Screen.pre_render_arrayに登録したインスタンスを描画する
+    def Screen::pre_render
+    end
+    
     #===画面を更新する
     #描画した画面を、実際にミニ見える形に反映させる
-    #呼び出し時に画面の消去は行われないため、明示的にScreen.clearメソッドを呼び出す必要がある
+    #呼び出し時に画面の消去は行われないため、消去が必要なときは明示的にScreen.clearメソッドを呼び出す必要がある
+    #また、自動描画配列にインスタンスを入れているときは、このメソッドを呼び出した時に描画されるため
+    #(つまり、表示の最後に描画される)、描画の順番に注意して配列を利用すること
     def Screen::render
-      Shape.text({:text => (FpsMax/(@@interval == 0 ? 1 : @@interval)).to_s() + " fps", :font => Font.sans_serif}).render  if @@fpsView
+      Shape.text(
+        {
+          :text => (FpsMax/(@@interval == 0 ? 1 : @@interval)).to_s() + " fps",
+          :font => Font.sans_serif
+        }
+      ).render if @@fpsView
       Screen::update_tick
       @@screen.flip
     end
+
+    #===インスタンスの内容を画面に描画する
+    #転送元の描画範囲は、src側SpriteUnitの(ox,oy)を起点に、src側(ow,oh)の範囲で転送する。
+    #画面の描画範囲は、src側SpriteUnitの(x,y)を起点に設定にする。
+    #ブロック付きで呼び出し可能(レシーバに対応したSpriteUnit構造体が引数として得られるので、補正をかけることが出来る)
+    #(ブロック引数のインスタンスは複写しているので、メソッドの引数として渡した値が持つSpriteUnitには影響しない)
+    #ブロックの引数は、|インスタンスのSpriteUnit,画面のSpriteUnit|となる。
+    #_src_:: 転送元ビットマップ(to_unitメソッドを呼び出すことが出来る/値がnilではないインスタンス)
+    #返却値:: 自分自身を返す
+    def Screen::render_screen(src)
+    end
   end
 end