ruby-miyako 2.1.0 → 2.1.1

data/lib/Miyako/API/sprite.rb

@@ -32,11 +32,25 @@ module Miyako
     include SingleEnumerable
     extend Forwardable
 
-    attr_accessor :visible #レンダリングの可否(true->描画 false->非描画)
-    attr_reader :tr_color  #カラーキーが有向になっている場合のRGB値。[R,G,B]の配列(各要素は0～255の整数)
-    attr_reader :type      #画像の透明度・透過タイプを取得する(詳細はSprite.newメソッドを参照)
+    attr_accessor :visible   #レンダリングの可否(true->描画 false->非描画)
+    attr_accessor :collision #Collision#bindで関連づけられた当たり判定
+    attr_reader :tr_color    #カラーキーが有向になっている場合のRGB値。[R,G,B]の配列(各要素は0～255の整数)
+    attr_reader :type        #画像の透明度・透過タイプを取得する(詳細はSprite.newメソッドを参照)
 
     @@abb = {:ck => :color_key, :as => :alpha_surface, :ac => :alpha_channel}
+    @@sprites = SpriteList.new
+
+    def Sprite.sprites
+      @@sprites
+    end
+
+    def Sprite.[](name)
+      @@sprites[name]
+    end
+
+    def Sprite.[]=(name, sprite)
+      @@sprites[name] = sprite
+    end
 
     def setup #:nodoc:
       @unit = SpriteUnitFactory.create
@@ -47,6 +61,7 @@ module Miyako
       @h = 0
       @draw_list = nil
       @visible = true
+      @collision = nil
     end
 
     private :setup
@@ -84,6 +99,16 @@ module Miyako
     #      　(例2):type=>:ck, :tr_color=>:red # 赤色を透明色に)
     #    * デフォルト：画像の[0,0]の位置にあるピクセルの色
     #* 3. αチャネル付き画像を使用(設定変更不可)　(書式):type=>:alpha_channel(:ac)
+    #* 4.背景塗りつぶし。必要ならば、色を指定してその色で塗りつぶす
+    #　(書式):fill=>[255,255,255] #=> 白で塗りつぶす
+    #　省略時は塗りつぶさない
+    #* 5.半透明設定。必要ならば、指定した割合で透明度を変える
+    #　値の範囲は0.0 <= alpha <= 1.0。範囲外の値を渡すとMiyakoValueErrorが発生
+    #　(書式):alpha=>0.5 #=> 半透明
+    #　(書式):alpha=>0.1 #=> 1割残っている程度
+    #　(書式):alpha=>0.0 #=> 完全透明
+    #　(書式):alpha=>1.0 #=> 完全不透明
+    #　省略時は生成時そのままの画像
     def initialize(param)
       raise MiyakoError, "Sprite instance cannot create uninitialized yet!" unless Screen.initialized?
       raise MiyakoTypeError, "Sprite parameter is not Hash!" unless param.kind_of?(Hash)
@@ -98,22 +123,24 @@ module Miyako
       param[:point]  ||= Point.new(0, 0)
       param[:tr_color]  ||= Color[:black]
       param[:is_fill] ||= false
-      
+      param[:fill] ||= nil
+      param[:alpha] ||= nil
+
       if param.has_key?(:bitmap) || param.has_key?(:bmp)
-        bitmap = param[:bitmap] || param[:bmp]
+        self.bitmap = param[:bitmap] || param[:bmp]
       elsif param.has_key?(:size)
-        bitmap = Bitmap.create(*(param[:size].to_a))
+        self.bitmap = Bitmap.create(*(param[:size].to_a))
         param[:is_fill] = true
       elsif param.has_key?(:filename) || param.has_key?(:file)
         name = param[:filename] || param[:file]
         raise MiyakoIOError.no_file(name) unless File.exist?(name)
         begin
-          bitmap = Bitmap.load(name)
+          self.bitmap = Bitmap.load(name)
         rescue SDL::Error
           raise MiyakoFileFormatError, "Illegal file format! collect? #{name}"
         end
       elsif param.has_key?(:unit)
-        bitmap = param[:unit].bitmap
+        self.bitmap = param[:unit].bitmap
       else
         raise MiyakoError, "Illegal Sprite parameter!"
       end
@@ -121,13 +148,11 @@ module Miyako
       case param[:type]
       when :color_key
         if param.has_key?(:point)
-          @tr_color = Color.to_rgb(bitmap.get_rgb(bitmap.getPixel(*(param[:point].to_a))))
+          @tr_color = Color.to_rgb(@unit.bitmap.get_rgb(@unit.bitmap.getPixel(*(param[:point].to_a))))
         else
           @tr_color = Color.to_rgb(param[:tr_color])
         end
         # カラーキーのα値を0にしたビットマップを作成
-#        self.bitmap = Bitmap.create_from(bitmap)
-        self.bitmap = bitmap.display_format_alpha
         if param[:is_fill]
           @unit.bitmap.fill_rect(0,0,@unit.bitmap.w,@unit.bitmap.h,[0, 0, 0])
           Bitmap.ck_to_ac!(@unit, [0,0,0])
@@ -136,23 +161,18 @@ module Miyako
         end
       when :alpha_surface
         # カラーキーのα値を0にしたビットマップを作成
-#        self.bitmap = Bitmap.create_from(bitmap)
-        self.bitmap = bitmap.display_format_alpha
         Bitmap.normal_to_ac!(@unit)
         if param[:is_fill]
           @unit.bitmap.fill_rect(0,0,@unit.bitmap.w,@unit.bitmap.h,[0, 0, 0])
           Bitmap.ck_to_ac!(@unit, [0,0,0])
         end
       when :alpha_channel
-#        self.bitmap = Bitmap.create_from(bitmap)
-        self.bitmap = bitmap.display_format_alpha
         if param[:is_fill]
           @unit.bitmap.fill_rect(0,0,@unit.bitmap.w,@unit.bitmap.h,[0, 0, 0])
           Bitmap.ck_to_ac!(@unit, [0,0,0])
         end
-      when :movie
-#        self.bitmap = Bitmap.create_from(bitmap)
-        self.bitmap = bitmap.display_format_alpha
+      else
+        # 何もしない
       end
       @type = param[:type]
 
@@ -161,10 +181,20 @@ module Miyako
                                        :cx => param[:unit].cx, :cy => param[:unit].cy)
         self.move_to!(param[:unit].x, param[:unit].y)
       end
+
+      if param[:fill]
+        self.fill(param[:fill])
+      end
+
+      if param[:alpha]
+        alpha = param[:alpha]
+        raise MiyakoValueError, "alpha is 0<=alpha<=1. value=#{param[:alpha]}" unless (alpha >= 0.0 and alpha <= 1.0)
+        Bitmap.dec_alpha!(self, alpha)
+      end
     end
 
     def_delegators(:@unit, :ox, :oy, :ow, :oh, :x, :y)
-    
+
     #===複写時に呼び出されるメソッド
     #複写と同時に、本インスタンスに対するスナップの関係を解消
     def initialize_copy(obj)
@@ -175,7 +205,7 @@ module Miyako
     def unit=(unit) #:nodoc:
       @unit = unit
     end
-    
+
     def update_layout_position #:nodoc:
       @unit.move_to!(*@layout.pos)
     end
@@ -221,7 +251,7 @@ module Miyako
       raise MiyakoValueError, "Illegal ox parameter! : #{v} (range: 0..#{@w-@unit.ow})" if (v < 0 || (v+@unit.ow) > @w)
       @unit.ox = v
     end
-    
+
     #===画像の表示開始位置(Y座標)を指定する
     #oyを指定すると、表示の左上位置が変更される。
     #値が画像の高さの範囲外(値がマイナス、画像の高さを超える値)のときは例外が発生する
@@ -230,7 +260,7 @@ module Miyako
       raise MiyakoValueError, "Illegal oy parameter! : #{v} (range: 0..#{@h-@unit.oh})" if (v < 0 || (v+@unit.oh) > @h)
       @unit.oy = v
     end
-    
+
     #===画像の表示幅を指定する
     #owを指定すると、横方向の一部のみ表示される。
     #値が画像の幅の範囲外(値がマイナス、画像の幅を超える値)のときは例外が発生する
@@ -251,6 +281,155 @@ module Miyako
       set_layout_size(@unit.ow, v)
     end
 
+    #=== スプライトの部分描画矩形を返す
+    #返却値:: Rect構造体インスタンス
+    def part_rect
+      return Rect.new(self.ox,self.oy,self.ow,self.oh)
+    end
+
+    def adjust_part(ox, oy, ow, oh)
+      if ox < 0
+        ow += ox
+        ox = 0
+      end
+      if oy < 0
+        oh += oy
+        oy = 0
+      end
+      ow = 1 if ow <= 0
+      oh = 1 if oh <= 0
+      if ox + ow > w
+        ow = w - ox
+        if ow == 0
+          ox -= 1
+          ow = 1
+        end
+      end
+      if oy + oh > h
+        oh = h - oy
+        if oh == 0
+          oy -= 1
+          oh = 1
+        end
+      end
+      Rect.new(ox,oy,ow,oh)
+    end
+
+    private :adjust_part
+
+    #=== 範囲を画像の大きさに合わせながら、部分描画開始位置を移動させる
+    #
+    #返却値:: 自分自身
+    def part_move!(dx, dy)
+      @unit.ox, @unit.oy, @unit.ow, @unit.oh =
+        adjust_part(
+          dx ? @unit.ox+dx : @unit.ox,
+          dy ? @unit.oy+dy : @unit.oy,
+          @unit.ow,
+          @unit.oh
+        )
+      return self
+    end
+
+    #=== 範囲を画像の大きさに合わせながら、部分描画開始位置を移動させる
+    #返却値:: 自分自身
+    def part_move_to!(x, y)
+      @unit.ox, @unit.oy, @unit.ow, @unit.oh =
+        adjust_part(
+          x ? x : @unit.ox,
+          y ? y : @unit.oy,
+          @unit.ow,
+          @unit.oh
+        )
+      return self
+    end
+
+    #=== 範囲を画像の大きさに合わせながら、部分描画の大きさを変える
+    #返却値:: 自分自身
+    def part_resize!(dw, dh)
+      @unit.ox, @unit.oy, @unit.ow, @unit.oh =
+        adjust_part(
+          @unit.ox,
+          @unit.oy,
+          dw ? @unit.ow+dw : @unit.ow,
+          dh ? @unit.oh+dh : @unit.oh
+        )
+      return self
+    end
+
+    #=== 範囲を画像の大きさに合わせながら、部分描画の大きさを変える
+    #返却値:: 自分自身
+    def part_resize_to!(w, h)
+      @unit.ox, @unit.oy, @unit.ow, @unit.oh =
+        adjust_part(
+          @unit.ox,
+          @unit.oy,
+          w ? w : @unit.ow,
+          h ? h : @unit.oh
+        )
+      return self
+    end
+
+    #=== 範囲を画像の大きさに合わせながら、部分描画開始位置を移動させる
+    #ただし、移動した後の矩形を得られるだけで、内部を変更しない
+    #返却値:: 変更後の部分描画矩形(Rect構造体)
+    def part_move(dx, dy)
+      return adjust_part(
+               dx ? self.ox+dx : self.ox,
+               dy ? self.oy+dy : self.oy,
+               self.ow,
+               self.oh
+             )
+    end
+
+    #=== 範囲を画像の大きさに合わせながら、部分描画開始位置を移動させる
+    #ただし、移動した後の矩形を得られるだけで、内部を変更しない
+    #返却値:: 変更後の部分描画矩形(Rect構造体)
+    def part_move_to(x, y)
+      return adjust_part(
+               x ? x : self.ox,
+               y ? y : self.oy,
+               self.ow,
+               self.oh
+             )
+    end
+
+    #=== 範囲を画像の大きさに合わせながら、部分描画の大きさを変える
+    #ただし、移動した後の矩形を得られるだけで、内部を変更しない
+    #返却値:: 変更後の部分描画矩形(Rect構造体)
+    def part_resize(dw, dh)
+      return adjust_part(
+               self.ox,
+               self.oy,
+               dw ? self.ow+dw : self.ow,
+               dh ? self.oh+dh : self.oh
+             )
+    end
+
+    #=== 範囲を画像の大きさに合わせながら、部分描画の大きさを変える
+    #ただし、移動した後の矩形を得られるだけで、内部を変更しない
+    #返却値:: 変更後の部分描画矩形(Rect構造体)
+    def part_resize_to(w, h)
+      return adjust_part(
+               self.ox,
+               self.oy,
+               w ? w : self.ow,
+               h ? h : self.oh
+             )
+    end
+
+    #=== スプライトの元画像の大きさを返す
+    #返却値:: Size構造体インスタンス
+    def image_size
+      return Size.new(self.bitmap.w,self.bitmap.h)
+    end
+
+    #=== スプライトの元画像の矩形を返す
+    #返却値:: Rect構造体インスタンス
+    def image_rect
+      return Rect.new(0,0,self.bitmap.w, self.bitmap.h)
+    end
+
     #===画像の回転・拡大・縮小の中心座標を取得する
     #x方向の中心座標を取得する
     #返却値:: 中心座標。
@@ -328,7 +507,7 @@ module Miyako
     def to_sprite
       unit = @unit.dup
       unit.bitmap = Bitmap.create(unit.bitmap.w, unit.bitmap.h)
-      sprite = Sprite.new(size: [unit.bitmap.w, unit.bitmap.h], type: :ac)
+      sprite = Sprite.new(:size => [unit.bitmap.w, unit.bitmap.h], :type => :ac)
       Drawing.fill(sprite, [0,0,0])
       Bitmap.ck_to_ac!(sprite, [0,0,0])
       Bitmap.blit_aa(self, sprite, 0, 0)
@@ -383,6 +562,94 @@ module Miyako
     def render_to(dst)
     end
 
+    #===インスタンスの内容を画面に描画する
+    #現在の画像を、現在の状態で描画するよう指示する
+    #ブロック付きで呼び出し可能(レシーバに対応したSpriteUnit構造体が引数として得られるので、補正をかけることが出来る)
+    #(ブロック引数のインスタンスは複写しているので、メソッドの引数として渡した値が持つSpriteUnitには影響しない)
+    #ブロックの引数は、|インスタンスのSpriteUnit, 画面のSpriteUnit|となる。
+    #visibleメソッドの値がfalseのときは描画されない。
+    #返却値:: 自分自身を返す
+    def render_xy(x,y)
+    end
+
+    #===インスタンスの内容を別のインスタンスに描画する
+    #転送元の描画範囲は、src側SpriteUnitの(ox,oy)を起点に、src側(ow,oh)の範囲で転送する。
+    #画面の描画範囲は、src側SpriteUnitの(x,y)を起点に設定にする。
+    #ブロック付きで呼び出し可能(レシーバに対応したSpriteUnit構造体が引数として得られるので、補正をかけることが出来る)
+    #(ブロック引数のインスタンスは複写しているので、メソッドの引数として渡した値が持つSpriteUnitには影響しない)
+    #ブロックの引数は、|インスタンスのSpriteUnit,転送先のSpriteUnit|となる。
+    #visibleメソッドの値がfalseのときは描画されない。
+    #_dst_:: 転送先ビットマップ(to_unitメソッドを呼び出すことが出来る/値がnilではないインスタンス)
+    #返却値:: 自分自身を返す
+    def render_xy_to(dst,x,y)
+    end
+
+    #===インスタンスの内容を画面に描画する
+    #現在の画像を、現在の状態で描画するよう指示する
+    #ブロック付きで呼び出し可能(レシーバに対応したSpriteUnit構造体が引数として得られるので、補正をかけることが出来る)
+    #(ブロック引数のインスタンスは複写しているので、メソッドの引数として渡した値が持つSpriteUnitには影響しない)
+    #ブロックの引数は、|インスタンスのSpriteUnit, 画面のSpriteUnit|となる。
+    #visibleメソッドの値がfalseのときは描画されない。
+    #返却値:: 自分自身を返す
+    def render_rect(rect)
+    end
+
+    #===インスタンスの内容を別のインスタンスに描画する
+    #転送元の描画範囲は、src側SpriteUnitの(ox,oy)を起点に、src側(ow,oh)の範囲で転送する。
+    #画面の描画範囲は、src側SpriteUnitの(x,y)を起点に設定にする。
+    #ブロック付きで呼び出し可能(レシーバに対応したSpriteUnit構造体が引数として得られるので、補正をかけることが出来る)
+    #(ブロック引数のインスタンスは複写しているので、メソッドの引数として渡した値が持つSpriteUnitには影響しない)
+    #ブロックの引数は、|インスタンスのSpriteUnit,転送先のSpriteUnit|となる。
+    #visibleメソッドの値がfalseのときは描画されない。
+    #_dst_:: 転送先ビットマップ(to_unitメソッドを呼び出すことが出来る/値がnilではないインスタンス)
+    #返却値:: 自分自身を返す
+    def render_rect_to(dst,rect)
+    end
+
+    #===インスタンスの内容を画面に描画する
+    #現在の画像を、現在の状態で描画するよう指示する
+    #ブロック付きで呼び出し可能(レシーバに対応したSpriteUnit構造体が引数として得られるので、補正をかけることが出来る)
+    #(ブロック引数のインスタンスは複写しているので、メソッドの引数として渡した値が持つSpriteUnitには影響しない)
+    #ブロックの引数は、|インスタンスのSpriteUnit, 画面のSpriteUnit|となる。
+    #visibleメソッドの値がfalseのときは描画されない。
+    #返却値:: 自分自身を返す
+    def render_rect2(rect)
+    end
+
+    #===インスタンスの内容を別のインスタンスに描画する
+    #転送元の描画範囲は、src側SpriteUnitの(ox,oy)を起点に、src側(ow,oh)の範囲で転送する。
+    #画面の描画範囲は、src側SpriteUnitの(x,y)を起点に設定にする。
+    #ブロック付きで呼び出し可能(レシーバに対応したSpriteUnit構造体が引数として得られるので、補正をかけることが出来る)
+    #(ブロック引数のインスタンスは複写しているので、メソッドの引数として渡した値が持つSpriteUnitには影響しない)
+    #ブロックの引数は、|インスタンスのSpriteUnit,転送先のSpriteUnit|となる。
+    #visibleメソッドの値がfalseのときは描画されない。
+    #_dst_:: 転送先ビットマップ(to_unitメソッドを呼び出すことが出来る/値がnilではないインスタンス)
+    #返却値:: 自分自身を返す
+    def render_rect2_to(dst,rect)
+    end
+
+    #===インスタンスの内容を画面に描画する
+    #現在の画像を、現在の状態で描画するよう指示する
+    #ブロック付きで呼び出し可能(レシーバに対応したSpriteUnit構造体が引数として得られるので、補正をかけることが出来る)
+    #(ブロック引数のインスタンスは複写しているので、メソッドの引数として渡した値が持つSpriteUnitには影響しない)
+    #ブロックの引数は、|インスタンスのSpriteUnit, 画面のSpriteUnit|となる。
+    #visibleメソッドの値がfalseのときは描画されない。
+    #返却値:: 自分自身を返す
+    def render_rect_xy(rect,x,y)
+    end
+
+    #===インスタンスの内容を別のインスタンスに描画する
+    #転送元の描画範囲は、src側SpriteUnitの(ox,oy)を起点に、src側(ow,oh)の範囲で転送する。
+    #画面の描画範囲は、src側SpriteUnitの(x,y)を起点に設定にする。
+    #ブロック付きで呼び出し可能(レシーバに対応したSpriteUnit構造体が引数として得られるので、補正をかけることが出来る)
+    #(ブロック引数のインスタンスは複写しているので、メソッドの引数として渡した値が持つSpriteUnitには影響しない)
+    #ブロックの引数は、|インスタンスのSpriteUnit,転送先のSpriteUnit|となる。
+    #visibleメソッドの値がfalseのときは描画されない。
+    #_dst_:: 転送先ビットマップ(to_unitメソッドを呼び出すことが出来る/値がnilではないインスタンス)
+    #返却値:: 自分自身を返す
+    def render_rect_xy_to(dst,rect,x,y)
+    end
+
     #===インスタンスの内容を画面に描画する(回転/拡大/縮小/鏡像付き)
     #転送元の描画範囲は、src側SpriteUnitの(ox,oy)を起点に、src側(ow,oh)の範囲で転送する。回転の中心はsrc側(ox,oy)を起点に、src側(cx,cy)が中心になるように設定する。
     #画面の描画範囲は、src側SpriteUnitの(x,y)を起点に、画面側SpriteUnitの(cx,cy)が中心になるように設定にする。

data/lib/Miyako/API/sprite_animation.rb

@@ -30,7 +30,7 @@ module Miyako
     include SingleEnumerable
 
     attr_accessor :visible #レンダリングの可否(true->描画 false->非描画)
-    
+
     #===インスタンスの作成
     #アニメーションを行うための初期設定を行う。
     #アニメーションは２種類の方法があり、
@@ -219,7 +219,7 @@ module Miyako
       @now.move_to!(@slist[@plist[@pnum]].x + @move_offset[@pnum][0],
                     @slist[@plist[@pnum]].y + @move_offset[@pnum][1])
     end
-    
+
     #===複写時に呼び出されるメソッド
     #複写と同時に、本インスタンスに対するスナップの関係を解消するが、
     #新しいパターンスプライトとスナップをやり直す
@@ -235,25 +235,25 @@ module Miyako
     end
 
     attr_accessor :visible
- 
+
     #=== 現在表示しているスプライトの x 座標の値を取得する
     #返却値:: x 座標の値
     def x
       return @now.x
     end
- 
+
     #=== 現在表示しているスプライトの y 座標の値を取得する
     #返却値:: y 座標の値
     def y
       return @now.y
     end
- 
+
     #=== 現在表示しているスプライトの幅を取得する
     #返却値:: 現在表示しているスプライトの幅(ピクセル単位)
     def w
       return @now.ow
     end
- 
+
     #=== 現在表示しているスプライトの高さを取得する
     #返却値:: 現在表示しているスプライトの高さ(ピクセル単位)
     def h
@@ -291,6 +291,12 @@ module Miyako
       return @plist[@pnum]
     end
 
+    #===アニメーションのパターン数を取得する
+    #返却値:: パターン数(0以上の整数)
+    def patterns
+      return @pats
+    end
+
     #===キャラクター番号を設定する
 		#キャラクター番号(アニメーションさせるときに表示させるパターン群インデックス)
 		#を設定する。範囲外のキャラクター番号が設定された時は何も行わない
@@ -316,7 +322,13 @@ module Miyako
     def character
       return @cnum
     end
-    
+
+    #===キャラクター数を取得する
+    #返却値:: キャラクター数（0以上の整数）
+    def characters
+      return @chrs
+    end
+
     #===アニメーションを開始する
     #パターンがリセットされていないときは、一時停止から復帰した時と同じ動作をする
     #返却値:: 自分自身
@@ -382,7 +394,7 @@ module Miyako
       @cnt = @waits[@plist[@pnum]]
       return true
     end
-    
+
     def update_wait_counter #:nodoc:
       return false if @cnt.waiting?
       @pnum = (@pnum + 1) % @pats
@@ -430,13 +442,13 @@ module Miyako
     def to_unit
       return @now.dup
     end
-    
+
     #=== 現在実行中のパターンの画像を返す
     #返却値:: 現在表示している画像(bitmap)
     def bitmap
       return @now.bitmap
     end
-    
+
     #===現在実行中のパターンの元になったインスタンスを返す
     #取得するパターンは、元になったインスタンスのto_spriteメソッドを呼び出した時の値となる
     #引数1個のブロックを渡せば、スプライトに補正をかけることが出来る
@@ -450,7 +462,7 @@ module Miyako
     def rect
       return Rect.new(@now.x, @now.y, @now.ow, @now.oh)
     end
- 
+
     #===現在表示しているスプライトの最大の大きさを矩形で取得する
     #現在のパターンの大きさと同じため、rectメソッドの値と同一となる
     #返却値:: 生成された矩形(Rect構造体のインスタンス)