cyross-ruby-miyako 2.0.5.1 → 2.1.0

data/lib/Miyako/API/movie.rb

@@ -1,154 +1,166 @@
-# -*- encoding: utf-8 -*-
-=begin
---
-Miyako v2.0
-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
-License as published by the Free Software Foundation; either
-version 2.1 of the License, or (at your option) any later version.
-
-This library is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-Lesser General Public License for more details.
-
-You should have received a copy of the GNU Lesser General Public
-License along with this library; if not, write to the Free Software
-Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-++
-=end
-
-module Miyako
-  #==動画管理クラス
-  #動画ファイル(MPEGファイル限定)をロード・再生するクラス
-  class Movie
-    include SpriteBase
-    include Layout
-    extend Forwardable
-
-    @@movie_list = []
-
-    attr_accessor :visible #レンダリングの可否(true->描画 false->非描画)
-    
-    #===動画のインスタンスを作成する
-    #(但し、現在の所、loopパラメータは利用できない)
-    #_fname_:: 動画ファイル名
-    #_loops_:: ループ再生の可否。ループ再生させるときは true を渡す
-    #返却値:: 生成したインスタンス
-    def initialize(fname, loops = true)
-      init_layout
-
-      @x = 0
-      @y = 0
-      
-      @movie = SDL::MPEG.load(fname)
-      @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)
-      
-      @movie.enable_audio(true) unless $not_use_audio
-      @movie.enable_video(true)
-      @movie.set_loop(loops)
-      
-      @movie.set_display(@sprite.bitmap)
-      @movie.scale(1.0)
-      @@movie_list.push(self)
-    end
-
-    def update_layout_position #:nodoc:
-      @x = @layout.pos[0]
-      @y = @layout.pos[1]
-      @sprite.move_to(*@layout.pos)
-    end
-    
-    #===動画再生時の音量を指定する
-    #_v_:: 指定する音量。(0～100までの整数)
-    def set_volume(v)
-      return if v < 0 || v > 100 || $not_use_audio
-      @movie.set_volume(v)
-    end
-
-    #===動画再生中かを返す
-    #返却値:: 再生中のときは true を返す
-    def playing?
-      return @movie.status == SDL::MPEG::PLAYING
-    end
-
-    #===動画データを解放する
-    def dispose
-      @movie.stop if playing?
-      @sprite.dispose
-      layout_dispose
-      @@movie_list.delete(self)
-      @movie = nil
-    end
-
-    #===再生領域の範囲を設定する
-    #元動画のうち、表示させたい箇所を Rect クラスのインスタンスか4要素の配列で指定する
-    #_rect_:: 再生領域。
-    def region(rect)
-      @movie.set_display_region(*(rect.to_a))
-    end
-
-    #===動画の再生を一時停止する
-    #再生を裁可するには、 Miyako::Movie#rewind メソッドを呼び出す必要がある
-    #_pause_by_input_:: ダミー
-    def pause(pause_by_input)
-      @movie.pause
-    end
-
-    #===動画を再生させる
-    #動画の先頭から再生する。ブロックを渡したときは、ブロックを評価している間動画を再生する
-    #_vol_:: 動画再生時の音量。0～100の整数
-    def start(vol = nil)
-      set_volume(vol) if vol
-      @movie.play
-      if block_given?
-        yield self
-        @movie.stop
-      end
-    end
-
-    #===動画再生を停止する
-    def stop
-      @movie.stop
-    end
-
-    #===再生中の動画の再生位置を返す
-    #位置は秒単位で返す
-    #返却値:: 再生位置
-    def current
-      return @movie.info.current_time
-    end
-
-    #===動画の長さを返す
-    #長さは、秒単位で返す。
-    #返却値:: 動画の長さ
-    def length
-      return @movie.info.total_time
-    end
-
-    #===画面に描画を指示する
-    #現在表示できる選択肢を、現在の状態で描画するよう指示する
-    #visibleメソッドの値がfalseのときは描画されない。
-    #返却値:: 自分自身を返す
-    def render
-      return slef nless @visible
-      @sprite.render
-      return self
-    end
-    
-    #===一時停止中の動画の再生を再開する
-    #Miyako::Movie#pause メソッドを実行した後に呼び出す
-    def_delegators(:@movie, :rewind)
-    #===指定時間ぶん、スキップ再生を行う
-    #size:: スキップ長(秒単位)
-    def_delegators(:@movie, :skip)
-    def_delegators(:@sprite, :rect, :broad_rect, :ox, :oy)
-  end
-end
+# -*- encoding: utf-8 -*-
+=begin
+--
+Miyako v2.1
+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
+License as published by the Free Software Foundation; either
+version 2.1 of the License, or (at your option) any later version.
+
+This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+++
+=end
+
+module Miyako
+  #==動画管理クラス
+  #動画ファイル(MPEGファイル限定)をロード・再生するクラス
+  class Movie
+    include SpriteBase
+    include Animation
+    include Layout
+    extend Forwardable
+
+    @@movie_list = []
+
+    attr_accessor :visible #レンダリングの可否(true->描画 false->非描画)
+    
+    #===動画のインスタンスを作成する
+    #(但し、現在の所、loopパラメータは利用できない)
+    #_fname_:: 動画ファイル名
+    #_loops_:: ループ再生の可否。ループ再生させるときは true を渡す
+    #返却値:: 生成したインスタンス
+    def initialize(fname, loops = true)
+      init_layout
+
+      @x = 0
+      @y = 0
+      
+      raise MiyakoIOError.no_file(fname) unless File.exist?(fname)
+      @movie = SDL::MPEG.load(fname)
+      @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)
+      
+      @movie.enable_audio(true) unless $not_use_audio
+      @movie.enable_video(true)
+      @movie.set_loop(loops)
+      
+      @movie.set_display(@sprite.bitmap)
+      @movie.scale(1.0)
+      @@movie_list.push(self)
+    end
+
+    def update_layout_position #:nodoc:
+      @x = @layout.pos[0]
+      @y = @layout.pos[1]
+      @sprite.move_to!(*@layout.pos)
+    end
+    
+    def initialize_copy(obj) #:nodoc:
+      @sprite = @sprite.dup
+      @size = @size.dup
+      copy_layout
+    end
+    
+    #===動画再生時の音量を指定する
+    #_v_:: 指定する音量。(0～100までの整数)
+    def set_volume(v)
+      return $not_use_audio
+      raise MiyakoValueError.over_range(v, 0, 100) unless (0..100).cover?(v)
+      @movie.set_volume(v)
+    end
+
+    #===動画再生中かを返す
+    #返却値:: 再生中のときは true を返す
+    def playing?
+      return @movie.status == SDL::MPEG::PLAYING
+    end
+
+    #===動画データを解放する
+    def dispose
+      @movie.stop if playing?
+      @sprite.dispose
+      layout_dispose
+      @@movie_list.delete(self)
+      @movie = nil
+    end
+
+    #===再生領域の範囲を設定する
+    #元動画のうち、表示させたい箇所を Rect クラスのインスタンスか4要素の配列で指定する
+    #_rect_:: 再生領域。
+    def region(rect)
+      @movie.set_display_region(*(rect.to_a))
+    end
+
+    #===動画の再生を一時停止する
+    #再生を裁可するには、 Miyako::Movie#rewind メソッドを呼び出す必要がある
+    #_pause_by_input_:: ダミー
+    def pause(pause_by_input)
+      @movie.pause
+    end
+
+    #===動画を再生させる
+    #動画の先頭から再生する。ブロックを渡したときは、ブロックを評価している間動画を再生する
+    #_vol_:: 動画再生時の音量。0～100の整数
+    def start(vol = nil)
+      if vol
+        raise MiyakoValueError.over_range(vol, 0, 100) unless (0..100).cover?(vol)
+        set_volume(vol) if vol
+      end
+      @movie.play
+      if block_given?
+        yield self
+        @movie.stop
+      end
+    end
+
+    #===動画再生を停止する
+    def stop
+      @movie.stop
+    end
+
+    #===再生中の動画の再生位置を返す
+    #位置は秒単位で返す
+    #返却値:: 再生位置
+    def current
+      return @movie.info.current_time
+    end
+
+    #===動画の長さを返す
+    #長さは、秒単位で返す。
+    #返却値:: 動画の長さ
+    def length
+      return @movie.info.total_time
+    end
+
+    #===画面に描画を指示する
+    #現在表示できる選択肢を、現在の状態で描画するよう指示する
+    #visibleメソッドの値がfalseのときは描画されない。
+    #返却値:: 自分自身を返す
+    def render
+      return slef nless @visible
+      @sprite.render
+      return self
+    end
+    
+    #===一時停止中の動画の再生を再開する
+    #Miyako::Movie#pause メソッドを実行した後に呼び出す
+    def_delegators(:@movie, :rewind)
+    #===指定時間ぶん、スキップ再生を行う
+    #size:: スキップ長(秒単位)
+    def_delegators(:@movie, :skip)
+    def_delegators(:@sprite, :rect, :broad_rect, :ox, :oy)
+  end
+end

data/lib/Miyako/API/parts.rb

@@ -1,189 +1,276 @@
-# -*- encoding: utf-8 -*-
-=begin
---
-Miyako v2.0
-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
-License as published by the Free Software Foundation; either
-version 2.1 of the License, or (at your option) any later version.
-
-This library is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-Lesser General Public License for more details.
-
-You should have received a copy of the GNU Lesser General Public
-License along with this library; if not, write to the Free Software
-Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
-++
-=end
-
-module Miyako
-  #==パーツ構成クラス
-  #複数のスプライト・アニメーションをまとめて一つの部品として構成できるクラス
-  #
-  #最初に、基準となる「レイアウト空間(LayoutSpaceクラスのインスタンス)」を登録し、その上にパーツを加える
-  #
-  #すべてのパーツは、すべてレイアウト空間にスナップされる
-  #(登録したパーツのレイアウト情報が変わることに注意)
-  class Parts
-    include Enumerable
-    include Layout
-    extend Forwardable
-
-    attr_accessor :visible #レンダリングの可否(true->描画 false->非描画)
-
-    #===Partsクラスインスタンスを生成
-    #_size_:: パーツ全体の大きさ。Size構造体のインスタンスもしくは要素数が2の配列
-    def initialize(size)
-      @parts = {}
-      @parts_list = []
-      @visible = true
-
-      init_layout
-      set_layout_size(size[0], size[1])
-    end
-
-    #===nameで示した補助パーツを返す
-    #_name_:: 補助パーツに与えた名前(シンボル)
-    #返却値:: 自分自身
-    def [](name)
-      return @parts[name]
-    end
-
-    #===補助パーツvalueをnameに割り当てる
-    #_name_:: 補助パーツに与える名前(シンボル)
-    #_value_:: 補助パーツのインスタンス(スプライト、テキストボックス、アニメーション、レイアウトボックスなど)
-    #返却値:: 自分自身
-    def []=(name, value)
-      @parts_list.push(name)
-      @parts[name] = value
-      @parts[name].snap(self)
-      return self
-    end
-
-    #===すべての補助パーツの一覧を配列で返す
-    #返却値:: パーツ名の配列(登録順)
-    def parts
-      return @parts_list
-    end
-
-    #===指定の補助パーツを除外する
-    #_name_:: 除外するパーツ名(シンボル)
-    #返却値:: 自分自身
-    def remove(name)
-      self.delete_snap_child(@parts[name])
-      @parts.delete(name)
-      return self
-    end
-
-    #===メインパーツと補助パーツに対してブロックを評価する
-    #返却値:: 自分自身
-    def each
-      @parts_list.each{|k| yield @parts[k] }
-      return self
-    end
-
-    #===メインパーツと補助パーツのすべてのアニメーションを開始する
-    #返却値:: 自分自身
-    def start
-      self.each{|parts| parts.start }
-      return self
-    end
-
-    #===メインパーツと補助パーツのすべてのアニメーションを停止する
-    #返却値:: 自分自身
-    def stop
-      self.each{|parts| parts.stop }
-      return self
-    end
-
-    #===メインパーツと補助パーツのすべてのアニメーションを更新する
-    #返却値:: 自分自身
-    def update_animation
-      self.each{|parts| parts.update_animation }
-    end
-
-    #===メインパーツと補助パーツのすべてのアニメーションを、最初のパターンに巻き戻す
-    #返却値:: 自分自身
-    def reset
-      self.each{|parts| parts.reset }
-      return self
-    end
-
-    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
-
-    #===現在の画面の最大の大きさを矩形で取得する
-    #各パーツの位置により、取得できる矩形の大きさが変わる
-    #但し、パーツ未登録の時は、インスタンス生成時の大きさから矩形を生成する
-    #返却値:: 生成された矩形(Rect構造体のインスタンス)
-    def broad_rect
-      rect = self.rect.to_a
-      return self.rect if @parts_list.length == 0
-      rect_list = rect.zip(*(self.map{|parts| parts.broad_rect.to_a}))
-      # width -> right
-      rect_list[2] = rect_list[2].zip(rect_list[0]).map{|xw| xw[0] + xw[1]}
-      # height -> bottom
-      rect_list[3] = rect_list[3].zip(rect_list[1]).map{|xw| xw[0] + xw[1]}
-      x, y = rect_list[0].min, rect_list[1].min
-      return Rect.new(x, y, rect_list[2].max - x, rect_list[3].max - y)
-    end
-
-    #===パーツに登録しているインスタンスを解放する
-    def dispose
-      @parts_list.clear
-      @parts_list = nil
-      @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
+# -*- encoding: utf-8 -*-
+=begin
+--
+Miyako v2.1
+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
+License as published by the Free Software Foundation; either
+version 2.1 of the License, or (at your option) any later version.
+
+This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+++
+=end
+
+module Miyako
+  #==パーツ構成クラス
+  #複数のスプライト・アニメーションをまとめて一つの部品として構成できるクラス
+  #
+  #最初に、基準となる「レイアウト空間(LayoutSpaceクラスのインスタンス)」を登録し、その上にパーツを加える
+  #
+  #すべてのパーツは、すべてレイアウト空間にスナップされる
+  #(登録したパーツのレイアウト情報が変わることに注意)
+  class Parts
+    include SpriteBase
+    include Animation
+    include Enumerable
+    include Layout
+    extend Forwardable
+
+    attr_accessor :visible #レンダリングの可否(true->描画 false->非描画)
+
+    #===Partsクラスインスタンスを生成
+    #_size_:: パーツ全体の大きさ。Size構造体のインスタンスもしくは要素数が2の配列
+    def initialize(size)
+      @parts = {}
+      @parts_list = []
+      @visible = true
+
+      init_layout
+      set_layout_size(size[0], size[1])
+    end
+    
+    def initialize_copy(obj) #:nodoc:
+      copy_layout
+      @parts_list = []
+      @parts = {}
+      obj.names.each{|name| self[name] = obj[name].deep_dup }
+      self
+    end
+
+    #===nameで示した補助パーツを返す
+    #_name_:: 補助パーツに与えた名前(シンボル)
+    #返却値:: 自分自身
+    def [](name)
+      return @parts[name]
+    end
+
+    #===補助パーツvalueをnameに割り当てる
+    #_name_:: 補助パーツに与える名前(シンボル)
+    #_value_:: 補助パーツのインスタンス(スプライト、テキストボックス、アニメーション、レイアウトボックスなど)
+    #返却値:: 自分自身
+    def []=(name, value)
+      if @parts_list.include?(name)
+        @parts_list.delete(name)
+      end
+      @parts_list.push(name)
+      @parts[name] = value
+      @parts[name].snap(self)
+      return self
+    end
+
+    #===すべての補助パーツの一覧を配列で返す
+    #返却値:: パーツ名の配列(登録順)
+    def parts
+      return @parts_list
+    end
+
+    #===すべての補助パーツの一覧を配列で返す
+    #返却値:: パーツ名の配列(登録順)
+    def names
+      return @parts_list
+    end
+
+    #===指定の補助パーツを除外する
+    #_name_:: 除外するパーツ名(シンボル)
+    #返却値:: 自分自身
+    def remove(name)
+      self.delete_snap_child(@parts[name])
+      @parts_list.delete(name)
+      @parts.delete(name)
+      return self
+    end
+
+    #===指定の補助パーツを除外する
+    #_name_:: 除外するパーツ名(シンボル)
+    #返却値:: 自分自身
+    def delete(name)
+      return self.remve(name)
+    end
+
+    #===メインパーツと補助パーツに対してブロックを評価する
+    #返却値:: 自分自身
+    def each
+      @parts_list.each{|k| yield @parts[k] }
+      return self
+    end
+    
+    #===指定の名前の直前に名前を挿入する
+    #配列上で、スプライト名配列の指定の名前の前になるように名前を挿入する
+    #_key_:: 挿入先の名前。この名前の直前に挿入する
+    #_name_:: 挿入するスプライトの名前
+    #_value_:: (名前が未登録の時の)スプライト本体省略時はnil
+    #返却値：自分自身を返す
+    def insert(key, name, value = nil)
+      raise MiyakoValueError, "Illegal key! : #{key}" unless @parts_list.include?(key)
+      return self if key == name
+      if value
+        @parts[name] = value 
+      else
+        raise MiyakoValueError, "name is not regist! : #{name}" unless @parts_list.include?(name)
+      end
+      @parts_list.delete(name) if @parts_list.include?(name)
+      @parts_list.insert(@parts_list.index(key), name)
+      self
+    end
+    
+    #===指定の名前の直後に名前を挿入する
+    #配列上で、スプライト名配列の指定の名前の次の名前になるように名前を挿入する
+    #_key_:: 挿入先の名前。この名前の直後に挿入する
+    #_name_:: 挿入するスプライトの名前
+    #_value_:: (名前が未登録の時の)スプライト本体省略時はnil
+    #返却値：自分自身を返す
+    def insert_after(key, name, value = nil)
+      raise MiyakoValueError, "Illegal key! : #{key}" unless @parts_list.include?(key)
+      return self if key == name
+      if value
+        @parts[name] = value 
+      else
+        raise MiyakoValueError, "name is not regist! : #{name}" unless @parts_list.include?(name)
+      end
+      @parts_list.delete(name) if @parts_list.include?(name)
+      @parts_list.insert(@parts_list.index(key)-@parts_list.length, name)
+      self
+    end
+    
+    #===指定した要素の内容を入れ替える
+    #配列の先頭から順にrenderメソッドを呼び出す。
+    #描画するインスタンスは、SpriteBaseもしくはSpriteArrayモジュールを
+    #mixinしているクラスのインスタンスのみ
+    #_name1,name_:: 入れ替え対象の名前
+    #返却値:: 自分自身を帰す
+    def swap(name1, name2)
+      raise MiyakoValueError, "Illegal name! : idx1:#{name1}" unless @parts_list.include?(name1)
+      raise MiyakoValueError, "Illegal name! : idx2:#{name2}" unless @parts_list.include?(name2)
+      idx1 = @parts_list.index(name1)
+      idx2 = @parts_list.index(name2)
+      @parts_list[idx1], @parts_list[idx2] = @parts_list[idx2], @parts_list[idx1]
+      return self
+    end
+    
+    #===名前の順番を反転する
+    #返却値:: 自分自身を帰す
+    def reverse!
+      @parts_list.reverse!
+      return self
+    end
+
+    #===メインパーツと補助パーツのすべてのアニメーションを開始する
+    #返却値:: 自分自身
+    def start
+      self.each{|parts| parts.start }
+      return self
+    end
+
+    #===メインパーツと補助パーツのすべてのアニメーションを停止する
+    #返却値:: 自分自身
+    def stop
+      self.each{|parts| parts.stop }
+      return self
+    end
+
+    #===メインパーツと補助パーツのすべてのアニメーションを更新する
+    #返却値:: 各パーツのupdate_animationの結果を配列として返す
+    def update_animation
+      self.map{|parts| parts.update_animation }
+    end
+
+    #===メインパーツと補助パーツのすべてのアニメーションを、最初のパターンに巻き戻す
+    #返却値:: 自分自身
+    def reset
+      self.each{|parts| parts.reset }
+      return self
+    end
+
+    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
+
+    #===現在の画面の最大の大きさを矩形で取得する
+    #各パーツの位置により、取得できる矩形の大きさが変わる
+    #但し、パーツ未登録の時は、インスタンス生成時の大きさから矩形を生成する
+    #返却値:: 生成された矩形(Rect構造体のインスタンス)
+    def broad_rect
+      rect = self.rect.to_a
+      return self.rect if @parts_list.length == 0
+      rect_list = rect.zip(*(self.map{|parts| parts.broad_rect.to_a}))
+      # width -> right
+      rect_list[2] = rect_list[2].zip(rect_list[0]).map{|xw| xw[0] + xw[1]}
+      # height -> bottom
+      rect_list[3] = rect_list[3].zip(rect_list[1]).map{|xw| xw[0] + xw[1]}
+      x, y = rect_list[0].min, rect_list[1].min
+      return Rect.new(x, y, rect_list[2].max - x, rect_list[3].max - y)
+    end
+
+    #===パーツに登録しているインスタンスを解放する
+    def dispose
+      @parts_list.clear
+      @parts_list = nil
+      @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