ruby-miyako 2.1.0 → 2.1.1

data/lib/Miyako/API/bitmap.rb

@@ -25,37 +25,34 @@ module Miyako
   #==ビットマップ(画像)管理クラス
   #SDLのSurfaceクラスインスタンスを管理するクラス
   class Bitmap
-    def Bitmap.create(w, h, flag=SDL::HWSURFACE | SDL::SRCCOLORKEY | SDL::SRCALPHA) #:nodoc:
-#      return SDL::Surface.new(flag, w, h, 32,
-#                              Screen.bitmap.Rmask, Screen.bitmap.Gmask,
-#                              Screen.bitmap.Bmask, Screen.bitmap.Amask)
+    #===スプライトの元になる画像を生成する
+    #幅・高さを渡すことにより、SDL::Surfaceクラスのインスタンスを生成する。
+    #_w_:: 画像の幅。単位はピクセル
+    #_h_:: 画像の幅。単位はピクセル
+    #返却値:: 生成したSDL::Surfaceクラスのインスタンス(αチャネル付き)
+    def Bitmap.create(w, h)
+      flag = SDL::HWSURFACE | SDL::SRCCOLORKEY | SDL::SRCALPHA
       # エンディアン判別
       if [1].pack("V*") == [1].pack("L*") # リトルエンディアン？
-        bitmap = SDL::Surface.new(flag, w, h, 32, 0xff0000, 0xff00, 0xff, 0xff000000)
+        bitmap = SDL::Surface.new(flag, w, h, 32, 0xff0000, 0xff00, 0xff, 0xff000000).display_format_alpha
       else # ビッグエンディアン
-        bitmap = SDL::Surface.new(flag, w, h, 32, 0xff00, 0xff0000, 0xff000000, 0xff)
+        bitmap = SDL::Surface.new(flag, w, h, 32, 0xff00, 0xff0000, 0xff000000, 0xff).display_format_alpha
       end
       bitmap
     end
 
-#    def Bitmap.create_from(bitmap) #:nodoc:
-#      bpp = 32
-#      # エンディアン判別
-#      if [1].pack("V*") == [1].pack("L*") # リトルエンディアン？
-#        bitmap = SDL::Surface.new_from(bitmap.pixels, bitmap.w, bitmap.h, 32, (bitmap.w*bpp)>>3,
-#                                       0xff0000, 0xff00, 0xff, 0xff000000)
-#      else # ビッグエンディアン
-#        bitmap = SDL::Surface.new_from(bitmap.pixels, bitmap.w, bitmap.h, 32, (bitmap.w*bpp)>>3,
-#                                       0xff00, 0xff0000, 0xff000000, 0xff)
-#      end
-#      bitmap
-#    end
-
-    def Bitmap.load(filename) #:nodoc:
+    #===指定のファイルから画像を読み込む
+    #指定したファイル名(パス)から画像データを読みこみ、SDL::Surfaceクラスのインスタンスを生成する。
+    #存在しないパスを渡したときはMiyakoIOErrorを発生させる。
+    #ロードに失敗したときは例外MiyakoFileFormatErrorを発生させる。
+    #_filename_:: 画像のファイル名
+    #返却値:: 生成したSDL::Surfaceクラスのインスタンス(αチャネル付き)。
+    def Bitmap.load(filename)
+      raise MiyakoIOError, "can't find file! #{filename}" unless File.exist?(filename)
       begin
-        return SDL::Surface.load(filename)
+        return SDL::Surface.load(filename).display_format_alpha
       rescue SDL::Error
-        raise MiyakoFileFormatError, "Illegal file format! collect? #{name}"
+        raise MiyakoFileFormatError, "Illegal file format! collect? #{filename}"
       end
       return nil
     end

data/lib/Miyako/API/choices.rb

@@ -21,6 +21,109 @@ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 =end
 
 module Miyako
+  require 'delegate'
+
+  class ChoiceStruct < Struct
+    include SpriteBase
+    include Animation
+    include Layout
+
+    attr_accessor :visible #レンダリングの可否(true->描画 false->非描画)
+
+    def initialize(*params)
+      super(*params)
+      init_layout
+      @visible = true
+      tsize = self.broad_rect.size
+      set_layout_size(*tsize)
+    end
+
+    def update_layout_position #:nodoc:
+      self[0].move_to!(*@layout.pos)
+      self[1].move_to!(*@layout.pos) if self[1] && self[0] != self[1]
+      self[2].move_to!(*@layout.pos) if self[2]
+    end
+
+    def process_sprites #:nodoc:
+      yield(self[0])
+      yield(self[1]) if self[1] && self[0] != self[1]
+      yield(self[2]) if self[2]
+    end
+
+    def start
+      return unless self[3].call
+      process_sprites{|spr| spr.start }
+    end
+
+    def stop
+      return unless self[3].call
+      process_sprites{|spr| spr.stop }
+    end
+
+    def reset
+      return unless self[3].call
+      process_sprites{|spr| spr.reset }
+    end
+
+    def update_animation
+      return unless self[3].call
+      process_sprites{|spr| spr.update_animation }
+    end
+
+    def render_src #:nodoc:
+      sprite = self[0]
+      if self[4]
+        sprite = self[1] if (self[5] && self[1])
+      elsif self[2]
+        sprite = self[2]
+      end
+      return sprite
+    end
+
+    def render
+      return unless @visible
+      return unless self[3].call
+      render_src.render
+    end
+
+    def render_to(dst)
+      return unless @visible
+      return unless self[3].call
+      render_src..render_to(dst)
+    end
+
+    #===レイアウト空間の大きさを更新する
+    # 新たにスプライトを登録したときに、全体の大きさをレイアウト空間の大きさとして更新する
+    #返却値:: 自分自身を返す
+    def update_layout_size
+      trect = self.broad_rect
+      set_layout_size(*trect.size)
+      self
+    end
+
+    #===選択肢の最大の大きさを矩形で取得する
+    # 現在登録しているスプライトから最大の矩形(broad_rect)を求める
+    #返却値:: 生成された矩形(Rect構造体のインスタンス)
+    def broad_rect
+      return self[0].rect if (self[1].nil? && self[2].nil?)
+      list = [self[0]]
+      list << self[1] if (self[1] && self[0] != self[1])
+      list << self[2] if self[2]
+      xx = []
+      yy = []
+      list.each{|ch|
+        r = ch.rect
+        xx << r.x
+        yy << r.y
+        xx << r.x + r.w
+        yy << r.y + r.h
+      }
+      min_x, max_x = xx.minmax
+      min_y, max_y = yy.minmax
+      return Rect.new(min_x, min_y, max_x-min_x, max_y-min_y)
+    end
+  end
+
   #==選択肢構造体
   # 選択肢を構成する要素の集合
   #
@@ -28,8 +131,10 @@ module Miyako
   # 選択肢を表示させるときは、body 自体の表示位置を変更させる必要がある
   #
   #_body_:: 選択肢を示す画像
-  #_body_selected_:: 選択肢を示す画像(選択時) 
-  #_condition_:: 選択肢が選択できる条件を記述したブロック
+  #_body_selected_:: 選択肢を示す画像(選択時)
+  #_body_disable_:: 選択肢を示す画像(選択不可時)
+  #_condition_:: 選択肢を表示できる条件を記述したブロック
+  #_enable_:: 選択肢を選択できるときはtrue、不可の時はfalse
   #_selected_:: 選択肢が選択されているときはtrue、選択されていないときはfalse
   #_result_:: 選択した結果を示すインスタンス
   #_left_:: 左方向を選択したときに参照するChoice構造体のインスタンス
@@ -41,32 +146,47 @@ module Miyako
   #_end_select_proc_:: この選択肢を選択したときに優先的に処理するブロック。
   #ブロックは1つの引数を取る(コマンド選択テキストボックス))。
   #デフォルトはnil(何もしない)
-  Choice = Struct.new(:body, :body_selected, :condition, :selected, :result, :left, :right, :up, :down, :base, :attribute, :end_select_proc)
+  #_name_:: 選択肢の名前。名前を明示的に指定しないときは、オブジェクトIDを文字列化したものが入る
+  Choice = ChoiceStruct.new(:body, :body_selected, :body_disable,
+                            :condition, :enable, :selected, :result,
+                            :left, :right, :up, :down,
+                            :base, :attribute, :end_select_proc, :name)
 
   #==選択肢を管理するクラス
   # 選択肢は、Shapeクラスから生成したスプライトもしくは画像で構成される
-  class Choices
-    include Layout
+  class Choices < Delegator
     include SpriteBase
     include Animation
-    include Enumerable
-    extend Forwardable
+    include Layout
 
     attr_accessor :visible #レンダリングの可否(true->描画 false->非描画)
+    attr_reader :choices #選択肢配列の集合
+    attr_reader :name_to_choice #名前と選択肢を関連づけているハッシュ
+    attr_reader :layout_spaces #選択肢の位置決めに使うレイアウト空間をハッシュで管理
 
     # インスタンスを生成する
     # 返却値:: 生成された Choices クラスのインスタンス
     def initialize
       init_layout
       @choices = []
+      @name_to_choice = {}
+      @layout_spaces = {}
       @now = nil
       @non_select = false
       @last_selected = nil
       @result = nil
       @visible = true
+      @org_pos = Point.new(0,0)
       set_layout_size(1, 1)
     end
-    
+
+    def __getobj__
+      @choices
+    end
+
+    def __setobj__(obj)
+    end
+
     def initialize_copy(obj) #:nodoc:
       @choices = @choices.dup
       copy_layout
@@ -75,54 +195,65 @@ module Miyako
     def update_layout_position #:nodoc:
       dx = @layout.pos[0] - rect[0]
       dy = @layout.pos[1] - rect[1]
-      @choices.each{|ch|
-        ch.each{|cc|
-          cc.body.move!(dx, dy)
-          cc.body_selected.move!(dx, dy) if cc.body_selected && cc.body != cc.body_selected
-        }
-      }
+      @choices.each{|ch| ch.each{|cc| cc.move!(dx, dy) } }
     end
 
     # 選択肢を作成する
     # Choice 構造体のインスタンスを作成する
     # 構造体には、引数bodyと、必ず true を返す条件ブロックが登録されている。残りは nil
+    # name引数の省略時にはnilが渡され、内部で、オブジェクトIDを文字列化したものを入れる
     #_body_:: 選択肢を示す画像
     #_body_selected_:: 選択肢を示す画像(選択時)。デフォルトはnil
     #_selected_:: 生成時に選択されているときはtrue、そうでないときはfalseを設定する
+    #_body_disable_:: 選択肢を示す画像(選択不可時)。デフォルトはnil
+    #_enable_:: 生成時に選択可能なときはtrue、不可の時はfalseを設定する
+    #_name_:: 選択肢の名前
     #返却値:: 生成された Choice構造体のインスタンス
-    def Choices.create_choice(body, body_selected = nil, selected = false)
-      choice = Choice.new(body, body_selected, Proc.new{ true }, selected,
-                          nil, nil, nil, nil, nil, nil, {}, nil)
+    def Choices.create_choice(body, body_selected = nil, selected = false, body_disable = nil, enable = true, name = nil)
+      choice = Choice.new(body, body_selected, body_disable, Proc.new{ true }, enable, selected,
+                          nil, nil, nil, nil, nil, nil, {}, nil, nil)
       choice.left = choice
       choice.right = choice
       choice.up = choice
       choice.down = choice
+      choice.name = name || choice.object_id.to_s
       return choice
     end
 
-    # 選択肢集合(Choice 構造体の配列)を選択肢リストに登録する
+    #=== 選択肢を登録する
+    # 選択肢集合(画面に一度に表示する選択肢群、Choice 構造体の配列)を選択肢リストに登録する
+    # またこのとき、対象の選択肢をChoices#[]メソッドで参照できるようになる
+    # _choices_:: 選択肢(Choice構造体)の配列
+    # 返却値:: レシーバ
     def create_choices(choices)
-      choices.each{|v| v.base = choices}
+      choices.each{|v|
+        v.base = choices
+        @name_to_choice[v.name] = v
+      }
       @choices.push(choices)
       @last_selected = @choices[0][0] if (@choices.length == 1 && @last_selcted == nil)
       rect = self.broad_rect
-      set_layout_size(rect.w, rect.h)
+      set_layout_size(*rect.size)
       return self
     end
 
-    # 選択肢データを解放する
+    #=== 名前から選択肢を参照する
+    #create_choicesメソッドで登録した選択肢を、名前からもとめる
+    #登録されていない名前を渡したときはnilを返す
+    #_name_:: 登録されているの名前。文字列
+    #返却値:: 対応する選択肢インスタンス
+    def regist_layout_space(name, layout_space)
+      @layout_spaces[name] = layout_space
+      layout_space.snap(self)
+    end
+
+    #=== 選択肢データを解放する
     def dispose
       @choices.each{|c| c.clear }
       @choices.clear
       @choices = []
     end
 
-    def each #:nodoc:
-      @choices.each{|ch| yield ch }
-    end
-
-    def_delegators(:@choices, :push, :pop, :shift, :unshift, :[], :[]=, :clear, :length)
-
     #===選択を開始しているかどうかを問い合わせる
     # start_choiceメソッドを呼び出して、コマンド選択が始まっているかどうかを問い合わせ、始まっているときはtrueを返す
     #返却値:: 選択を開始しているときはtrueを返す
@@ -226,6 +357,15 @@ module Miyako
       return !@non_select
     end
 
+    #===選択肢が選択可能かどうかを問い合わせる
+    #現在指している選択肢が選択可能か選択不可かを問い合わせる
+    #返却値:: 選択可能ならtrue、選択不可ならfalseを返す
+    def enable?
+      return false if @non_select
+      return false unless @now
+      return @now.enable
+    end
+
     #===選択肢を変更する
     #指定の位置の現在の選択状態を、選択状態にする
     #_x_:: x方向位置
@@ -291,14 +431,10 @@ module Miyako
     #ブロックの引数は、|インスタンスのSpriteUnit, 画面のSpriteUnit|となる。
     #visibleメソッドの値がfalseのとき、選択が開始されていない時は描画されない。
     #返却値:: 自分自身を返す
-    def render(&block)
+    def render
       return unless @visible
       return self unless @now
-      @now.base.each{|c|
-        ((c.body_selected && c.selected) ?
-          c.body_selected.render(&block) :
-          c.body.render(&block)) if c.condition.call
-      }
+      @now.base.each{|c| c.render }
       return self
     end
 
@@ -309,14 +445,10 @@ module Miyako
     #visibleメソッドの値がfalseのとき、選択が開始されていない時は描画されない。
     #_dst_:: 描画対象の画像インスタンス
     #返却値:: 自分自身を返す
-    def render_to(dst, &block)
+    def render_to(dst)
       return self unless @visible
       return self unless @now
-      @now.base.each{|c|
-        ((c.body_selected && c.selected) ?
-          c.body_selected.render_to(dst, &block) :
-          c.body.render_to(dst, &block)) if c.condition.call
-      }
+      @now.base.each{|c| c.render_to(dst) }
       return self
     end
 
@@ -336,6 +468,16 @@ module Miyako
       return sprite
     end
 
+    #===レイアウト空間の大きさを更新する
+    # 生成後、選択肢を追加した後の全体の大きさをレイアウト空間の大きさとして更新する
+    # ただし、create_choicesめそっどを呼び出したときはこのメソッドを自動的に呼び出している
+    #返却値:: 自分自身を返す
+    def update_layout_size
+      trect = self.broad_rect
+      set_layout_size(*trect.size)
+      self
+    end
+
     #===現在登録している選択肢の最大の大きさを矩形で取得する
     # 現在インスタンスが所持している選択肢全てから左上座標、右下座標を取得し、矩形の形式で返す
     # 但し、選択肢が一つも登録されていない時はRect(0,0,1,1)を返す
@@ -346,17 +488,16 @@ module Miyako
       yy = []
       @choices.each{|ch|
         ch.each{|cc|
-          xx << cc.body.x
-          yy << cc.body.y
-          if cc.body_selected
-            xx << cc.body_selected.x
-            yy << cc.body_selected.y
-          end
+          r = cc.broad_rect
+          xx << r.x
+          yy << r.y
+          xx << r.x + r.w
+          yy << r.y + r.h
         }
       }
       min_x, max_x = xx.minmax
       min_y, max_y = yy.minmax
-      return Rect.new(min_x, min_y, max_x-min_x+1, max_y-min_y+1)
+      return Rect.new(min_x, min_y, max_x-min_x, max_y-min_y)
     end
 
     #===現在登録している選択肢の大きさを矩形で取得する
@@ -427,12 +568,7 @@ module Miyako
     # 返却値:: 自分自身を返す
     def start
       return self unless @now
-      @now.base.each{|c|
-        if c.condition.call
-          c.body.start
-          c.body_selected.start if c.body != c.body_selected
-        end
-      }
+      @now.base.each{|c| c.start }
       return self
     end
 
@@ -441,12 +577,7 @@ module Miyako
     # 返却値:: 自分自身を返す
     def stop
       return self unless @now
-      @now.base.each{|c|
-        if c.condition.call
-          c.body.stop
-          c.body_selected.stop if c.body != c.body_selected
-        end
-      }
+      @now.base.each{|c| c.stop }
       return self
     end
 
@@ -455,12 +586,7 @@ module Miyako
     # 返却値:: 自分自身を返す
     def reset
       return self unless @now
-      @now.base.each{|c|
-        if c.condition.call
-          c.body.reset
-          c.body_selected.reset if c.body != c.body_selected
-        end
-      }
+      @now.base.each{|c| c.reset }
       return self
     end
 
@@ -471,11 +597,19 @@ module Miyako
     # ただし、現在選択中の配列リストではないときは[false]を返す
     def update_animation
       return [false] unless @now
-      @now.base.map{|c|
-        ((c.body_selected && c.selected) ?
-         c.body_selected.update_animation :
-         c.body.update_animation) if c.condition.call
-      }
+      @now.base.map{|c| c.update_animation }
+    end
+
+    #=== mixin されたインスタンスの部分矩形幅を取得する
+    #返却値:: インスタンスの幅(デフォルトは0)
+    def ow
+      return self.size[0]
+    end
+
+    #=== mixin されたインスタンスの部分矩形高を取得する
+    #返却値:: インスタンスの高さ(デフォルトは0)
+    def oh
+      return self.size[1]
     end
   end
 end