ruby-miyako 2.1.0

data/lib/Miyako/API/map_event.rb

@@ -0,0 +1,222 @@
+# -*- 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
+
+require 'csv'
+require 'forwardable'
+
+module Miyako
+  #==マップ上のイベント全体を管理するクラス
+  #Map/FixedMapクラス内で使用する
+  #使い方：
+  #
+  #(1)インスタンスを生成する
+  #
+  #em = MapEventManager.new
+  #
+  #(2)MapEventクラスとIDを登録する
+  #
+  #(例)MapEventモジュールをmixinしたクラスXを、ID=0のイベントとして登録
+  #
+  #em.add(0, X)
+  #
+  #(3)Map/FixedMapクラスインスタンス生成時に引数として渡す
+  #
+  #@map = Map.new(...,em)
+  #
+  #(注)登録するIDは、イベントレイヤー上の番号と対応しておくこと
+  class MapEventManager
+    #===インスタンスを生成する
+    #_map_obj_:: Managerが属するMap/FixedMapクラスのインスタンス
+    #返却値:: 生成されたインスタンス
+    def initialize
+      @map = nil
+      @id2event = Hash.new
+    end
+    
+    def initialize_copy(obj) #:nodoc:
+      @map = @map.dup if @map
+      @id2event = @id2event.dup
+    end
+
+    def set(map) #:nodoc:
+      @map = map
+    end
+
+    #===イベントクラスをマップに追加登録する
+    #_id_:: マップ(イベントレイヤ)上の番号。
+    #イベントレイヤ上に存在しない番号を渡してもエラーや警告は発しない
+    #_event_:: イベントクラス。クラスのインスタンスではないことに注意！
+    #返却値:: 自分自身を返す
+    def add(id, event)
+      @id2event[id] = event
+      return self
+    end
+
+    #===イベントが登録されているかを確認する
+    #引数で渡した番号に対応するイベントクラスが登録されているかどうかを確認する
+    #_id_:: イベントクラスに対応した番号
+    #返却値:: イベントクラスが登録されている時はtrueを返す
+    def include?(id)
+      raise MiyakoError, "This MapEventManager instance is not set Map/FixedMap instance!" unless @map
+      return @id2event.has_key?(id)
+    end
+
+    #===イベントのインスタンスを生成する(番号指定)
+    #インスタンス生成と同時に、マップ上の座標を渡して初期位置を設定する
+    #登録していないIDを指定するとエラーになる
+    #
+    #設置は、マップ上の座標に設置する。表示上の座標ではない事に注意。
+    #_id_:: イベントクラスと登録した際の番号
+    #_x_:: イベントを設置する位置(X座標)
+    #_y_:: イベントを設置する位置(Y座標)
+    #返却値:: 生成したインスタンス
+    def create(id, x = 0, y = 0)
+      raise MiyakoError, "This MapEventManager instance is not set Map/FixedMap instance!" unless @map
+      raise MiyakoError, "Unknown Map Event ID! : #{id}" unless include?(id)
+      return @id2event[id].new(@map, x, y)
+    end
+
+    #===すべての登録済みイベントクラスの登録を解除する
+    def clear
+      @id2event.keys.each{|k| @id2event[k] = nil }
+    end
+
+    def dispose
+      @map = nil
+      @id2event.clear
+      @id2event = nil
+    end
+  end
+
+  #==マップ上のイベントを管理するモジュール
+  #実際に使う際にはmix-inして使う
+  module MapEvent
+    include SpriteBase
+    include Animation
+    
+    #===イベントのインスタンスを作成する
+    #引数として渡せるX,Y座標の値は、表示上ではなく理論上の座標位置
+    #_map_obj_:: 関連づけられたMap/FixedMapクラスのインスタンス
+    #_x_:: マップ上のX座標の値。デフォルトは0
+    #_y_:: マップ上のY座標の値。デフォルトは0
+    #返却値:: 生成されたインスタンス
+    def initialize(map_obj, x = 0, y = 0)
+      init(map_obj, x, y)
+    end
+
+    #===イベント生成時のテンプレートメソッド
+    #イベントクラスからインスタンスが生成された時の初期化処理を実装する
+    #_map_obj_:: 関連づけられたMap/FixedMapクラスのインスタンス
+    #_x_:: マップ上のX座標の値
+    #_y_:: マップ上のY座標の値
+    def init(map_obj, x, y)
+    end
+    
+    #===インスタンス内の表示やデータを更新するテンプレートメソッド
+    #マップ画像が更新された時に呼び出される
+    #_map_obj_:: インスタンスが組み込まれているMap/FixedMapクラスのインスタンス
+    #_events_:: マップに登録されているイベントインスタンスの配列
+    #_params_:: 開発者が明示的に用意した引数。内容はハッシュ
+    def update(map_obj, events, params)
+    end
+
+    #===イベントを指定の分量で移動させる(テンプレートメソッド)
+    #_dx_:: 移動量(x座標)。単位はピクセル
+    #_dy_:: 移動量(y座標)。単位はピクセル
+    #返却値:: 自分自身を返す
+    def move!(dx,dy)
+      return self
+    end
+
+    #===イベントを指定の位置へ移動させる(テンプレートメソッド)
+    #_x_:: 移動先の位置(x座標)。単位はピクセル
+    #_y_:: 移動先の位置(y座標)。単位はピクセル
+    #返却値:: 自分自身を返す
+    def move_to!(x,y)
+      return self
+    end
+
+    #===イベントを指定の分量で移動させたときの値を求める(テンプレートメソッド)
+    #_dx_:: 移動量(x座標)。単位はピクセル
+    #_dy_:: 移動量(y座標)。単位はピクセル
+    #返却値:: 移動した位置のインスタンスを返す
+    def move(dx,dy)
+      return Position.new(0,0)
+    end
+
+    #===イベントを指定の位置へ移動させたときの値を求める(テンプレートメソッド)
+    #_x_:: 移動先の位置(x座標)。単位はピクセル
+    #_y_:: 移動先の位置(y座標)。単位はピクセル
+    #返却値:: 移動した位置のインスタンスを返す
+    def move_to(x,y)
+      return Position.new(0,0)
+    end
+
+    #===イベント発生可否問い合わせ(テンプレートメソッド)
+    #イベント発生が可能なときはtrueを返す(その後、startメソッドを呼び出す)処理を実装する
+    #_param_:: 問い合わせに使用するパラメータ群。デフォルトはnil
+    #返却値:: イベント発生可能ならばtrue
+    def met?(*params)
+      return false
+    end
+    
+    #===画面に画像を描画する(テンプレートメソッド)
+    #イベントで所持している画像を描画するメソッドを実装する
+    #(イベント内部で用意している画像の描画用テンプレートメソッド)
+    def render
+    end
+
+    #===イベントを発生させる(テンプレートメソッド)
+    #ここに、イベント発生イベントを実装する。更新はupdateメソッドに実装する
+    #_param_:: イベント発生に必要なパラメータ群。デフォルトはnil
+    #返却値:: 自分自身を返す
+    def start(*params)
+      return self
+    end
+    
+    #===イベントを停止・終了させる(テンプレートメソッド)
+    #ここに、イベント停止・終了イベントを実装する。更新はupdateメソッドに実装する
+    #_param_:: イベント発生に必要なパラメータ群。デフォルトはnil
+    #返却値:: 自分自身を返す
+    def stop(*params)
+      return self
+    end
+    
+    #===イベント発生中問い合わせ(テンプレートメソッド)
+    #ここに、イベント発生中の問い合わせ処理を実装する。
+    #_param_:: あとで書く
+    #返却値:: イベント発生中の時はtrue
+    def executing?
+      return false
+    end
+    
+    #===イベント終了後の後処理(テンプレートメソッド)
+    #ここに、イベント終了後の後処理を実装する。
+    def final
+    end
+
+    #===イベントに使用しているインスタンスを解放する(テンプレートメソッド)
+    #ここに、インスタンス解放処理を実装する。
+    def dispose
+    end
+  end
+end

data/lib/Miyako/API/modules.rb

@@ -0,0 +1,357 @@
+# -*- 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
+=begin rdoc
+==基本スプライトモジュール
+スプライトの基本メソッドで構成されるテンプレートモジュール
+=end
+  module SpriteBase
+    #===スプライトインスタンスを取得するメソッドのテンプレート
+    #_data_:: あとで書く
+    #返却値:: 自分自身を返す
+    def to_sprite(data = nil)
+      return self
+    end
+
+    #===SpriteUnit構造体を取得するメソッドのテンプレート
+    #返却値:: nilを返す
+    def to_unit
+      return nil
+    end
+    
+    #===描画可能・不可状態を返すメソッドのテンプレート
+    #返却値:: falseを返す
+    def visible
+      return false
+    end
+    
+    #===描画可能・不可状態を設定するメソッドのテンプレート
+    #返却値:: falseを返す
+    def visible=(v)
+      return self
+    end
+    
+    #===描画可能状態にするメソッドのテンプレート
+    def show
+      self.visible = true
+    end
+    
+    #===描画不可能状態にするメソッドのテンプレート
+    def hide
+      self.visible = false
+    end
+    
+    #===領域の矩形を取得するメソッドのテンプレート
+    #返却値:: nilを返す
+    def rect
+      return nil
+    end
+    
+    #===領域の最大矩形を取得するメソッドのテンプレート
+    #返却値:: nilを返す
+    def broad_rect
+      return nil
+    end
+    
+    #===画像(Bitmapクラスのインスタンス)を取得するメソッドのテンプレート
+    #返却値:: nilを返す
+    def bitmap
+      return nil
+    end
+    
+    #===画像内での描画開始位置(x座標)を取得するメソッドのテンプレート
+    #返却値:: 0を返す
+    def ox
+      return 0
+    end
+    
+    #===画像内での描画開始位置(y座標)を取得するメソッドのテンプレート
+    #返却値:: 0を返す
+    def oy
+      return 0
+    end
+    
+    #===画面への描画を指示するメソッドのテンプレート
+    #_block_:: 呼び出し時にブロック付き呼び出しが行われたときのブロック本体。呼び先に渡すことが出来る。ブロックがなければnilが入る
+    #返却値:: 自分自身を返す
+    def render(&block)
+      return self
+    end
+    
+    #===画像への描画を指示するメソッドのテンプレート
+    #_dst_:: 対象の画像
+    #_block_:: 呼び出し時にブロック付き呼び出しが行われたときのブロック本体。呼び先に渡すことが出来る。ブロックがなければnilが入る
+    #返却値:: 自分自身を返す
+    def render_to(dst, &block)
+      return self
+    end
+  end
+
+=begin rdoc
+==基本アニメーションモジュール
+アニメーションの基本メソッドで構成されるテンプレートモジュール
+=end
+  module Animation
+    #===アニメーションを開始するメソッドのテンプレート
+    #返却値:: 自分自身を返す
+    def start
+      return self
+    end
+
+    #===アニメーションを停止するメソッドのテンプレート
+    #返却値:: 自分自身を返す
+    def stop
+      return self
+    end
+
+    #===アニメーションパターンを先頭に戻すメソッドのテンプレート
+    #返却値:: 自分自身を返す
+    def reset
+      return self
+    end
+
+    #===アニメーションを更新するメソッドのテンプレート
+    #返却値:: falseを返す(アニメーションパターンが更新されたときにtrueを返す)
+    def update_animation
+      return false
+    end
+  end
+  
+  #==複数スプライト管理(配列)機能を追加するモジュール
+  #配列にスプライトとして最低限の機能を追加する。
+  #また、独自にswapなどのメソッドを追加。
+  #render、render_toを用意し、一気に描画が可能。配列の要素順に描画される。
+  #各要素の位置関係は関与していない(そこがPartsとの違い)
+  module SpriteArray
+    include SpriteBase
+    include Animation
+    include Enumerable
+
+    #===各要素からスプライト以外の要素を取り除いた配列を作成する
+    #SpriteBaseモジュール、もしくはSpriteArrayモジュールをインクルードしていない要素を削除した配列を返す
+    #登録されている名前順の配列になる。
+    #返却値:: 生成したスプライトを返す
+    def sprite_only
+      self.select{|e| e.class.include?(SpriteBase) || e.class.include?(SpriteArray)}
+    end
+
+    #===各要素からスプライト以外の要素を取り除いた配列を破壊的に作成する
+    #SpriteBaseモジュール、もしくはSpriteArrayモジュールをインクルードしていない要素を削除する
+    #登録されている名前順の配列になる。
+    #返却値:: 自分自身を返す
+    def sprite_only!
+      self.delete_if{|e| !e.class.include?(SpriteBase) && !e.class.include?(SpriteArray)}
+    end
+  
+    #===配列要素を複製したコピー配列を取得する
+    #通常、インスタンスの複写に使われるdup,cloneメソッドは、同じ配列要素を見ているが、
+    #このメソッドでは、要素も複製したものが複製される(各要素のdeep_copyメソッドを呼び出す)
+    #返却値:: 複写した配列を返す
+    def deep_copy
+      self.map{|e| e.deep_copy }
+    end
+
+    #===各要素の描画可能状態を取得する
+    #各要素のvisibleメソッドの値を配列で取得する。
+    #登録されている名前順の配列になる。
+    #返却値:: true/falseの配列
+    def visible
+      return self.sprite_only.map{|e| e.visible}
+    end
+  
+    #===各要素の描画可能状態を一気に設定する
+    #すべての要素のvisibleメソッドの値を変更する
+    #登録されている名前順の配列になる。
+    #_v_:: 設定する値(true/false)
+    #返却値:: 自分自身を返す
+    def visible=(v)
+      self.sprite_only.each{|e| e.visible = v}
+      return self
+    end
+  
+    #===各要素の位置を変更する(変化量を指定)
+    #ブロックを渡したとき、戻り値として[更新したdx,更新したdy]とした配列を返すと、
+    #それがその要素での移動量となる。
+    #ブロックの引数は、|要素, インデックス(0,1,2,...), dx, dy|となる。
+    #(例)q=[a, b, c]
+    #    #各スプライトの位置=すべて(10,15)
+    #    q.move!(20,25) => aの位置:(30,40)
+    #                      bの位置:(30,40)
+    #                      cの位置:(30,40)
+    #    q.move!(20,25){|e,i,dx,dy|
+    #      [i*dx, i*dy]
+    #    }
+    #                   => aの位置:(10,15)
+    #                      bの位置:(30,40)
+    #                      cの位置:(50,65)
+    #_dx_:: 移動量(x方向)。単位はピクセル
+    #_dy_:: 移動量(y方向)。単位はピクセル
+    #返却値:: 自分自身を返す
+    def move!(dx, dy)
+      if block_given?
+        self.sprite_only.each_with_index{|e, i| e.move!(*(yield e, i, dx, dy))}
+      else
+        self.sprite_only.each{|e| e.move!(dx, dy)}
+      end
+      self
+    end
+
+    #===各要素の位置を変更する(変化量を指定)
+    #ブロックを渡したとき、戻り値として[更新したdx,更新したdy]とした配列を返すと、
+    #それがその要素での移動量となる。
+    #ブロックの引数は、|要素, インデックス(0,1,2,...), x, y|となる。
+    #(例)q=[a, b, c]
+    #    #各スプライトの位置=すべて(10,15)
+    #    q.move!(20,25) => aの位置:(20,25)
+    #                      bの位置:(20,25)
+    #                      cの位置:(20,25)
+    #    q.move!(20,25){|e,i,dx,dy|
+    #      [i*dx, i*dy]
+    #    }
+    #                   => aの位置:( 0, 0)
+    #                      bの位置:(20,25)
+    #                      cの位置:(40,50)
+    #_x_:: 移動先位置(x方向)。単位はピクセル
+    #_y_:: 移動先位置(y方向)。単位はピクセル
+    #返却値:: 自分自身を返す
+    def move_to!(x, y)
+      if block_given?
+        self.sprite_only.each_with_index{|e, i| e.move_to!(*(yield e, i, x, y))}
+      else
+        self.sprite_only.each{|e| e.move_to!(x, y)}
+      end
+      self
+    end
+
+    #===描く画像のアニメーションを開始する
+    #各要素のstartメソッドを呼び出す
+    #返却値:: 自分自身を返す
+    def start
+      self.sprite_only.each{|sprite| sprite.start }
+      return self
+    end
+    
+    #===描く画像のアニメーションを停止する
+    #各要素のstopメソッドを呼び出す
+    #返却値:: 自分自身を返す
+    def stop
+      self.sprite_only.each{|sprite| sprite.stop }
+      return self
+    end
+    
+    #===描く画像のアニメーションを先頭パターンに戻す
+    #各要素のresetメソッドを呼び出す
+    #返却値:: 自分自身を返す
+    def reset
+      self.sprite_only.each{|sprite| sprite.reset }
+      return self
+    end
+    
+    #===描く画像のアニメーションを更新する
+    #各要素のupdate_animationメソッドを呼び出す
+    #返却値:: 描く画像のupdate_spriteメソッドを呼び出した結果を配列で返す
+    def update_animation
+      self.sprite_only.map{|e|
+        e.update_animation
+      }
+    end
+  
+    #===指定した要素の内容を入れ替える
+    #配列の先頭から順にrenderメソッドを呼び出す。
+    #描画するインスタンスは、引数がゼロのrenderメソッドを持っているもののみ(持っていないときは呼び出さない)
+    #_idx1,idx2_:: 入れ替え対象の配列要素インデックス
+    #返却値:: 自分自身を帰す
+    def swap(idx1, idx2)
+      l = self.length
+      raise MiyakoValueError, "Illegal index range! : idx1:#{idx1}" if (idx1 >= l || idx1 < -l)
+      raise MiyakoValueError, "Illegal index range! : idx2:#{idx2}" if (idx2 >= l || idx2 < -l)
+      self[idx1], self[idx2] = self[idx2], self[idx1]
+      return self
+    end
+    
+    #===配列の要素を画面に描画する
+    #配列の先頭から順にrenderメソッドを呼び出す。
+    #描画するインスタンスは、SpriteBaseモジュールがmixinされているクラスのみ
+    #返却値:: 自分自身を帰す
+    def render
+      self.sprite_only.each{|e| e.render }
+      return self
+    end
+    
+    #===配列の要素を対象の画像に描画する
+    #配列の先頭から順にrender_toメソッドを呼び出す。
+    #_dst_:: 描画対象の画像インスタンス
+    #返却値:: 自分自身を帰す
+    def render_to(dst)
+      self.each{|e| e.render_to(dst) }
+      return self
+    end
+  end
+  
+  #==ディープコピーを実装するモジュール
+  #dup、cloneとは違い、「ディープコピー(配列などの要素も複製するコピー)」を実装するためのモジュール。
+  module DeepCopy
+    #===複製を取得する
+    #ただし、再定義しているクラス(例:Arrayクラス)以外はdupメソッドの結果
+    #返却値:: 複写したインスタンスを返す
+    def deep_dup
+      (self && self.methods.include?(:dup)) ? self.dup : self
+    end
+
+    #===複製を取得する
+    #ただし、再定義しているクラス(例:Arrayクラス)以外はdupメソッドの結果
+    #返却値:: 複写したインスタンスを返す
+    def deep_clone
+      self.deep_dup
+    end
+  end
+end
+
+class Object
+  include Miyako::DeepCopy
+end
+
+class Array
+  include Miyako::SpriteArray
+
+  #===複製を取得する
+  #ただし、配列の要素もdeep_dupメソッドで複製する
+  #返却値:: 複写したインスタンスを返す
+  def deep_dup
+    self.dup.map{|e| (e && e.methods.include?(:deep_dup)) ? e.deep_dup : e }
+  end
+end
+
+class Hash
+  #===複製を取得する
+  #ただし、配列の要素もdeep_dupメソッドで複製する
+  #返却値:: 複写したインスタンスを返す
+  def deep_dup
+    ret = self.dup
+    ret.keys.each{|key|
+      v = ret[key]
+      (v && v.methods.include?(:deep_dup)) ? v.deep_dup : v
+    }
+    ret
+  end
+end