ruby-miyako-mswin32 2.1.0 → 2.1.1

data/lib/Miyako/API/fixedmap.rb

@@ -29,12 +29,12 @@ module Miyako
     include SpriteBase
     include Animation
     include Layout
-    
+
     @@idx_ix = [-1, 2, 4]
     @@idx_iy = [-1, 0, 6]
 
     attr_accessor :visible #レンダリングの可否(true->描画 false->非描画)
-    attr_reader :name, :map_layers, :mapchips, :pos, :size, :w, :h
+    attr_reader :name, :map_layers, :mapchips, :map_size, :map_w, :map_h
 
     #==あとで書く
     class FixedMapLayer #:nodoc: all
@@ -43,10 +43,10 @@ module Miyako
       extend Forwardable
 
       @@use_chip_list = Hash.new(nil)
-      
+
       attr_accessor :visible #レンダリングの可否(true->描画 false->非描画)
       attr_accessor :mapchip, :mapchip_units
-      attr_reader :pos
+      attr_reader :pos, :ignore_list
 
       def round(v, max) #:nodoc:
         v = max + (v % max) if v < 0
@@ -90,9 +90,11 @@ module Miyako
                                    :ox => (idx % @mapchip.size.w) * @ow, :oy => (idx / @mapchip.size.w) * @oh,
                                    :ow => @ow, :oh => @oh)
         }
+        @def_ignore = -1
+        @ignore_list = []
         reSize
       end
-    
+
       def initialize_copy(obj) #:nodoc:
         @mapchip = @mapchip.dup
         @size = @size.dup
@@ -130,6 +132,15 @@ module Miyako
                          @modpy2[round(y, @size.h)])
       end
 
+      #===レイヤー配列を取得する
+      #レイヤーを構成している配列を取得する
+      #取得した配列にアクセスするときの書式は、以下のようになる。
+      #layer[y][x]
+      #返却値:: 所持しているレイヤー配列
+      def layer
+        @mapdat
+      end
+
       #===指定の矩形のキャラクタに掛かるマップチップの左上位置の組み合わせを返す
       #但し、引数には、Rect(x,y,w,h)形式のインスタンスを渡す
       #_rect_:: キャラクタの矩形
@@ -159,61 +170,79 @@ module Miyako
       #===キャラクタとマップチップが重なっているかどうか問い合わせる
       #指定の矩形のキャラクタが、指定の位置のマップチップのコリジョンと重なっているかどうか問い合わせる
       #引数は、Rect(x,y,w,h)形式(Rect構造体、[x,y,w,h]の配列)で渡す
-      #指定の位置のマップチップ番号が-1(未定義)のときはfalseを返す
+      #指定の位置のマップチップ番号が以下の時はfalseを返す
+      #1)-1(未定義)のとき
+      #2)FixexMapLayer#ignore_listに含まれているとき
+      #3)引数ignoresに含まれているとき
       #_type_:: 移動形式(0以上の整数)
       #_pos_:: 調査対象のマップチップの位置
       #_collision_:: キャラクタのコリジョン
-      #_rect_:: キャラクタの矩形
+      #_cpos_:: キャラクタの位置
+      #_ignores_:: コリジョンの対象にしないマップチップ番号のリスト
       #返却値:: コリジョンが重なっていればtrueを返す
-      def collision?(type, pos, collision, rect)
+      def collision?(type, pos, collision, cpos, *ignores)
         code = get_code(*pos.to_a)
-        return false if code == -1
-        return @mapchip.collision_table[type][code].collision?(pos, collision, rect)
+        return false if (code == @def_ignore or @ignore_list.include?(code) or ignores.flatten.include?(code))
+        return @mapchip.collision_table[type][code].collision?(pos, collision, cpos)
       end
 
       #===キャラクタとマップチップが隣り合っているかどうか問い合わせる
       #指定の矩形のキャラクタが、指定の位置のマップチップのコリジョンと隣り合っているかどうか問い合わせる
       #引数は、Rect(x,y,w,h)形式(Rect構造体、[x,y,w,h]の配列)で渡す
-      #指定の位置のマップチップ番号が-1(未定義)のときはfalseを返す
+      #指定の位置のマップチップ番号が以下の時はfalseを返す
+      #1)-1(未定義)のとき
+      #2)FixexMapLayer#ignore_listに含まれているとき
+      #3)引数ignoresに含まれているとき
       #_type_:: 移動形式(0以上の整数)
       #_pos_:: 調査対象のマップチップの位置
       #_collision_:: キャラクタのコリジョン
-      #_rect_:: キャラクタの矩形
+      #_cpos_:: キャラクタの位置
+      #_ignores_:: コリジョンの対象にしないマップチップ番号のリスト
       #返却値:: コリジョンが隣り合っていればtrueを返す
-      def meet?(type, pos, collision, rect)
+      def meet?(type, pos, collision, rect, *ignores)
         code = get_code(*pos.to_a)
-        return false if code == -1
-        return @mapchip.collision_table[type][code].meet?(pos, collision, rect)
+        return false if (code == @def_ignore or @ignore_list.include?(code) or ignores.flatten.include?(code))
+        return @mapchip.collision_table[type][code].meet?(pos, collision, cpos)
       end
 
       #===キャラクタとマップチップが覆い被さっているかどうか問い合わせる
       #指定の矩形のキャラクタが、指定の位置のマップチップのコリジョンを覆い被さっているかどうか問い合わせる
       #引数は、Rect(x,y,w,h)形式(Rect構造体、[x,y,w,h]の配列)で渡す
-      #指定の位置のマップチップ番号が-1(未定義)のときはfalseを返す
+      #指定の位置のマップチップ番号が以下の時はfalseを返す
+      #1)-1(未定義)のとき
+      #2)FixexMapLayer#ignore_listに含まれているとき
+      #3)引数ignoresに含まれているとき
       #_type_:: 移動形式(0以上の整数)
       #_pos_:: 調査対象のマップチップの位置
       #_collision_:: キャラクタのコリジョン
-      #_rect_:: キャラクタの矩形
+      #_cpos_:: キャラクタの位置
+      #_ignores_:: コリジョンの対象にしないマップチップ番号のリスト
       #返却値:: どちらかのコリジョンが覆い被さっていればtrueを返す
-      def cover?(type, pos, collision, rect)
+      def cover?(type, pos, collision, rect, *ignores)
         code = get_code(*pos.to_a)
-        return false if code == -1
-        return @mapchip.collision_table[type][code].cover?(pos, collision, rect)
+        return false if (code == @def_ignore or @ignore_list.include?(code) or ignores.flatten.include?(code))
+        return @mapchip.collision_table[type][code].cover?(pos, collision, cpos)
       end
 
       #===キャラクタとマップチップが重なっているかどうか問い合わせる
       #指定の位置と方向で、指定の位置のマップチップ上で移動できるかどうか問い合わせる
-      #指定の位置のマップチップ番号が-1(未定義)のとき、移動していない(dx==0 and dy==0)ときはtrueを返す
+      #指定の位置のマップチップ番号が以下の時はtrueを返す
+      #1)-1(未定義)のとき
+      #2)FixexMapLayer#ignore_listに含まれているとき
+      #3)引数ignoresに含まれているとき
+      #また、dx==0, dy==0のときもtrueを返す
       #_type_:: 移動形式(0以上の整数)
       #_inout_:: 入退形式(:in もしくは :out)
       #_pos_:: 調査対象のマップチップの位置
       #_dx_:: 移動量(x座標)
       #_dy_:: 移動量(y座標)
+      #_ignores_:: チェックの対象にしないマップチップ番号のリスト。番号に含まれているときはtrueを返す
       #返却値:: 移動可能ならばtrueを返す
-      def can_access?(type, inout, pos, dx, dy)
+      def can_access?(type, inout, pos, dx, dy, *ignores)
+        return true if dx == 0 and dy == 0
         code = get_code(pos[0]+dx, pos[1]+dy)
-        return true if code == -1
-        index = AccessIndex.index2(inout, dx, dy)
+        return true if (code == @def_ignore or @ignore_list.include?(code) or ignores.flatten.include?(code))
+        index = MapDir.index2(inout, dx, dy)
         return true if index == -1
         return @mapchip.access_table[type][code][index]
       end
@@ -221,6 +250,8 @@ module Miyako
       def dispose #:nodoc:
         @mapdat = nil
         @baseimg = nil
+        @ignore_list.clear
+        @ignore_list = []
       end
 
       #===マップレイヤーを画面に描画する
@@ -258,88 +289,191 @@ module Miyako
     #先頭に戻って繰り返し渡す仕様になっている
     #各MapChip構造体のマップチップの大きさを同じにしておく必要がある
     #_mapchips_:: マップチップ構造体群(MapChip構造体単体もしくは配列)
-    #_layer_csv_:: レイヤーファイル(CSVファイル)
-    #_event_manager_:: MapEventManagerクラスのインスタンス
+    #_map_struct_:: MapStruct構造体のインスタンス
+    #_event_manager_:: MapEventManagerクラスのインスタンス。省略時（イベントを使わない時）はnil
     #返却値:: 生成したインスタンス
-    def initialize(mapchips, layer_csv, event_manager)
-      raise MiyakoIOError.no_file(layer_csv) unless File.exist?(layer_csv)
+    def initialize(mapchips, map_struct, event_manager=nil)
       init_layout
       @visible = true
-      @event_layers = []
-      @em = event_manager.dup
-      @em.set(self)
+      if event_manager
+        @em = event_manager.dup
+        @em.set(self)
+      else
+        @em = nil
+      end
       @mapchips = mapchips.to_a
-      layer_data = CSV.readlines(layer_csv)
-
-      raise MiyakoFileFormatError, "This file is not Miyako Map Layer file! : #{layer_csv}" unless layer_data.shift[0] == "Miyako Maplayer"
-
-      tmp = layer_data.shift # 空行の空読み込み
-
-      @size = Size.new(tmp[0].to_i, tmp[1].to_i)
-      @w = @size.w * @mapchips.first.chip_size.w
-      @h = @size.h * @mapchips.first.chip_size.h
 
-      layers = layer_data.shift[0].to_i
+      @map_size = map_struct.size
+      @map_w = @map_size.w * @mapchips.first.chip_size.w
+      @map_h = @map_size.h * @mapchips.first.chip_size.h
 
-      evlist = []
-      brlist = []
-      layers.times{|n|
-        name = layer_data.shift[0]
-        values = []
-        @size.h.times{|y|
-          values << layer_data.shift.map{|m| m.to_i}
-        }
-        if name == "<event>"
-          evlist << values
-        else
-          brlist << values
-        end
-      }
-
-      @event_layer = nil
+      @event_layers = []
 
-      evlist.each{|events|
-        event_layer = Array.new
-        events.each_with_index{|ly, y|
-          ly.each_with_index{|code, x|
-            next unless @em.include?(code)
-            event_layer.push(@em.create(code, x * @mapchips.first.chip_size.w, y * @mapchips.first.chip_size.h))
+      if map_struct.elayers
+        raise MiyakoError "Event Manager is not registered!" unless @em
+        map_struct.elayers.each{|events|
+          event_layer = Array.new
+          events.each_with_index{|ly, y|
+            ly.each_with_index{|code, x|
+              next unless @em.include?(code)
+              event_layer.push(@em.create(code, x * @mapchips.first.chip_size.w, y * @mapchips.first.chip_size.h))
+            }
           }
+          @event_layers << event_layer
         }
-        @event_layers << event_layer
-      }
+      end
+
+      @event_layers << [] if @event_layers.empty?
 
       mc = @mapchips.cycle
-      @mapchips = mc.take(layers)
+      @mapchips = mc.take(map_struct.layer_num)
       @map_layers = []
-      brlist.each{|br|
+      map_struct.layers.each{|br|
         br = br.map{|b| b.map{|bb| bb >= @mapchips.first.chips ? -1 : bb } }
-        @map_layers.push(FixedMapLayer.new(mc.next, br, @size))
+        @map_layers.push(FixedMapLayer.new(mc.next, br, @map_size))
       }
-      set_layout_size(@w, @h)
+      set_layout_size(@map_w, @map_h)
     end
-    
+
     def initialize_copy(obj) #:nodoc:
       @map_layers = @map_layers.dup
       @event_layers = @event_layers.dup
-      @em = em.dup
+      @em = @em.dup if @em
       @mapchips = @mapchips.dup
-      @size = @size.dup
+      @map_size = @map_size.dup
       copy_layout
     end
 
     #===マップにイベントを追加する
+    #イベントレイヤーでの番号はイベント番号と一致する
+    #ブロックを渡すと、求めたマップチップ番号をブロック引数として受け取る評価を行える
     #_idx_:: 追加するイベントレイヤの指標
     #_code_:: イベント番号(Map.newメソッドで渡したイベント番号に対応)
     #_x_:: マップ上の位置(x方向)
     #_y_:: マップ常温位置(y方向)
     #返却値:: 自分自身を返す
     def add_event(idx, code, x, y)
-      return self unless @em.include?(code)
+      raise MiyakoError "Event Manager is not registered!" unless @em
+      raise MiyakoError "Unregisted event code! : #{code}" unless @em.include?(code)
       @event_layers[idx].push(@em.create(code, x, y))
       return self
     end
 
+    #===マップに生成済みのイベントを追加する
+    #_idx_:: 追加するイベントレイヤの指標
+    #_event_:: イベント番号(Map.newメソッドで渡したイベント番号に対応)
+    #返却値:: 自分自身を返す
+    def append_event(idx, event)
+      @event_layers[idx].push(event)
+      return self
+    end
+
+
+    #===指定のレイヤーのイベントに対してupdateメソッドを呼び出す
+    #イベントレイヤーidxの全てのイベントに対してupdateメソッドを呼び出す
+    #_idx_:: 更新するイベントレイヤーの番号
+    #_params_:: イベントのupdateメソッドを呼び出すときに渡す引数。可変個数
+    #返却値:: レシーバ
+    def event_update(idx, *params)
+      @event_layers[idx].each{|event| event.update(self, @event_layers[idx], *params) }
+      self
+    end
+
+    #===全てのイベントに対してupdateメソッドを呼び出す
+    #全レイヤーのイベントを呼び出すことに注意
+    #_params_:: イベントのupdateメソッドを呼び出すときに渡す引数。可変個数
+    def all_event_update(*params)
+      @event_layers.each{|el| el.each{|event| event.update(self, el, *params) } }
+      self
+    end
+
+    #===指定のレイヤーのイベントに対してupdate2メソッドを呼び出す
+    #イベントレイヤーidxの全てのイベントに対してupdateメソッドを呼び出す
+    #_idx_:: 更新するイベントレイヤーの番号
+    #_params_:: イベントのupdateメソッドを呼び出すときに渡す引数。可変個数
+    #返却値:: レシーバ
+    def event_update2(idx, *params)
+      @event_layers[idx].each{|event| event.update2(*params) }
+      self
+    end
+
+    #===全てのイベントに対してupdate2メソッドを呼び出す
+    #全レイヤーのイベントを呼び出すことに注意
+    #_params_:: イベントのupdate2メソッドを呼び出すときに渡す引数。可変個数
+    def all_event_update2(*params)
+      @event_layers.each{|el| el.each{|event| event.update2(*params) } }
+      self
+    end
+
+    #===指定のレイヤーのイベントに対してmove!メソッドを呼び出す
+    #イベントレイヤーidxの全てのイベントに対してmove!メソッドを呼び出す
+    #_idx_:: 更新するイベントレイヤーの番号
+    #_dx_:: x座標の移動量
+    #_dy_:: y座標の移動量
+    #_params_:: イベントのmove!メソッドを呼び出すときに渡す引数。可変個数
+    #返却値:: レシーバ
+    def event_move!(idx, dx, dy, *params)
+      @event_layers[idx].each{|event| event.move!(dx, dy, *params) }
+      self
+    end
+
+    #===全てのイベントに対してmove!メソッドを呼び出す
+    #全レイヤーのイベントを呼び出すことに注意
+    #_dx_:: x座標の移動量
+    #_dy_:: y座標の移動量
+    #_params_:: イベントのmove!メソッドを呼び出すときに渡す引数。可変個数
+    #返却値:: レシーバ
+    def all_event_move!(dx, dy, *params)
+      @event_layers.each{|el| el.each{|event| event.move!(dx, dy, *params) } }
+      self
+    end
+
+    #===指定のレイヤーのイベントに対してsprite_move!メソッドを呼び出す
+    #イベントレイヤーidxの全てのイベントに対してsprite_move!メソッドを呼び出す
+    #_idx_:: 更新するイベントレイヤーの番号
+    #_dx_:: x座標の移動量
+    #_dy_:: y座標の移動量
+    #_params_:: イベントのmove!メソッドを呼び出すときに渡す引数。可変個数
+    #返却値:: レシーバ
+    def event_sprite_move!(idx, dx, dy, *params)
+      @event_layers[idx].each{|event| event.sprite_move!(dx, dy, *params) }
+      self
+    end
+
+    #===全てのイベントに対してsprite_move!メソッドを呼び出す
+    #全レイヤーのイベントを呼び出すことに注意
+    #_dx_:: x座標の移動量
+    #_dy_:: y座標の移動量
+    #_params_:: イベントのmove!メソッドを呼び出すときに渡す引数。可変個数
+    #返却値:: レシーバ
+    def all_event_sprite_move!(dx, dy, *params)
+      @event_layers.each{|el| el.each{|event| event.sprite_move!(dx, dy, *params) } }
+      self
+    end
+
+    #===指定のレイヤーのイベントに対してsprite_move!メソッドを呼び出す
+    #イベントレイヤーidxの全てのイベントに対してsprite_move!メソッドを呼び出す
+    #_idx_:: 更新するイベントレイヤーの番号
+    #_dx_:: x座標の移動量
+    #_dy_:: y座標の移動量
+    #_params_:: イベントのmove!メソッドを呼び出すときに渡す引数。可変個数
+    #返却値:: レシーバ
+    def event_pos_move!(idx, dx, dy, *params)
+      @event_layers[idx].each{|event| event.pos_move!(dx, dy, *params) }
+      self
+    end
+
+    #===全てのイベントに対してsprite_move!メソッドを呼び出す
+    #全レイヤーのイベントを呼び出すことに注意
+    #_dx_:: x座標の移動量
+    #_dy_:: y座標の移動量
+    #_params_:: イベントのmove!メソッドを呼び出すときに渡す引数。可変個数
+    #返却値:: レシーバ
+    def all_event_pos_move!(dx, dy, *params)
+      @event_layers.each{|el| el.each{|event| event.pos_move!(dx, dy, *params) } }
+      self
+    end
+
     def update_layout_position #:nodoc:
       @map_layers.each{|ml| ml.pos.move_to!(*@layout.pos) }
     end

data/lib/Miyako/API/font.rb

@@ -28,13 +28,16 @@ module Miyako
 フォントは、等幅フォント奨励(プロポーショナルフォントを選ぶと、文字が正しく描画されない可能性あり）
 =end
   class Font
+    include SpriteBase
+    include Animation
+    include Layout
     extend Forwardable
 
 #    OS_MAC_OS_X = "mac_osx"
 #    ORG_ENC = "UTF-8"
 #    NEW_ENC = "UTF-8-MAC"
-    
-    attr_reader :size, :line_skip, :height, :ascent, :descent
+
+    attr_reader :size, :line_skip, :height, :ascent, :descent, :text
     attr_accessor :color, :use_shadow, :shadow_color, :shadow_margin, :vspace, :hspace
 
     @@font_cache = {}
@@ -132,6 +135,7 @@ module Miyako
     #_size_:: フォントの大きさ。単位はピクセル。デフォルトは 16
     #返却値:: 生成されたインスタンスを返す
     def initialize(fname, size=16)
+      init_layout
       @size = size
       @color = [255, 255, 255]
       @fname = fname
@@ -148,6 +152,9 @@ module Miyako
       @shadow_color = [128, 128, 128]
       @shadow_margin = [2, 2]
       @unit = SpriteUnitFactory.create
+      @text = ""
+      @visible = true
+      set_layout_size(*self.text_size(@text))
     end
 
     def initialize_copy(obj) #:nodoc:
@@ -157,6 +164,32 @@ module Miyako
       @shadow_color = @shadow_color.dup
       @shadow_margin = @shadow_margin.dup
       @unit = @unit.dup
+      @text = @text.dup
+    end
+
+    #===描画可能・不可状態を返す
+    #描画可能の時はtrue、不可能なときはfalseを返す
+    #返却値:: true/falseを返す
+    def visible
+      return @visible
+    end
+
+    #===描画可能・不可状態を設定する
+    #描画可能の時はtrue、不可能なときはfalseを渡す
+    #返却値:: 自分自身を返す
+    def visible=(v)
+      @visible = v
+      return self
+    end
+
+    #===描画する文字列を変更する
+    #_str_:: 描画する文字列。文字列以外でも、to_sメソッドで文字列、endocdeメソッドでUTF-8に変換する
+    #返却値:: 自分自身を返す
+    def text=(str)
+      @text = str.to_s
+      @text = @text.encode(Encoding::UTF_8)
+      set_layout_size(*self.text_size(@text))
+      return self
     end
 
     #===フォントの大きさを変更する
@@ -165,10 +198,11 @@ module Miyako
     def size=(sz)
       @size = sz
       @font = Font.get_font_inner(@fname, @fpath, @size)
-      @font.style = (@bold ? SDL::TTF::STYLE_BOLD : 0) | 
+      @font.style = (@bold ? SDL::TTF::STYLE_BOLD : 0) |
                     (@italic ? SDL::TTF::STYLE_ITALIC : 0) |
                     (@under_line ? SDL::TTF::STYLE_UNDERLINE : 0)
       init_height
+      set_layout_size(*self.text_size(@text))
       return self
     end
 
@@ -218,9 +252,9 @@ module Miyako
     def get_fit_size(size)
       path = Font.findFontPath(@fname)
       font = SDL::TTF.open(path, size)
-      return (size.to_f * (size.to_f / font.line_skip.to_f)).to_i 
+      return (size.to_f * (size.to_f / font.line_skip.to_f)).to_i
     end
-    
+
     #===フォントサイズ(yやjなどの下にはみ出る箇所も算出)を取得する
     #返却値:: 算出されたフォントサイズ
     def line_height
@@ -246,13 +280,13 @@ module Miyako
       end
       return self
     end
-    
+
     #===フォントのbold属性の有無を返す
     #返却値:: bold属性かどうか(true/false)
     def bold?
       return @bold
     end
-    
+
     #===フォントのbold属性を設定する
     #_f_:: bold属性かどうか(true/false)
     def bold=(f)
@@ -261,7 +295,7 @@ module Miyako
       @font.style -= SDL::TTF::STYLE_BOLD unless @bold
       return self
     end
-    
+
     #===フォントの属性をitalic(斜め)に設定する
     #ブロックを渡したときは、ブロック評価中のみ斜体文字になる
     #文字が領域外にはみ出る場合があるので注意！
@@ -276,13 +310,13 @@ module Miyako
       end
       return self
     end
-    
+
     #===フォントのitalic属性の有無を返す
     #返却値:: italic属性かどうか(true/false)
     def italic?
       return @italic
     end
-    
+
     #===フォントのitalic属性を設定する
     #_f_:: italic属性かどうか(true/false)
     def italic=(f)
@@ -291,7 +325,7 @@ module Miyako
       @font.style -= SDL::TTF::STYLE_ITALIC unless @italic
       return self
     end
-    
+
     #===フォントの属性をunder_line(下線)に設定する
     #ブロックを渡したときは、ブロック評価中のみ下線付き文字になる
     #返却値:: 自分自身
@@ -305,13 +339,13 @@ module Miyako
       end
       return self
     end
-    
+
     #===フォントのunder_line属性の有無を返す
     #返却値:: under_line属性かどうか(true/false)
     def under_line?
       return @under_line
     end
-    
+
     #===フォントのunder_line属性を設定する
     #_f_:: under_line属性かどうか(true/false)
     def under_line=(f)
@@ -327,7 +361,7 @@ module Miyako
       @font.style = 0
       return self
     end
-    
+
     #===文字列を描画する
     #対象のスプライトに文字列を描画する
     #_dst_:: 描画先スプライト
@@ -358,6 +392,65 @@ module Miyako
       return x
     end
 
+    #===文字列を画面に描画する
+    #返却値:: 自分自身を返す
+    def render
+      return self unless @visible
+      draw_text(Screen, @text, @layout[:pos][0], @layout[:pos][1])
+      return self
+    end
+
+    #===文字列をスプライトに描画する
+    #_dst_:: 描画先スプライト
+    #返却値:: 自分自身を返す
+    def render_to(dst)
+      return self unless @visible
+      draw_text(dst, @text, @layout[:pos][0], @layout[:pos][1])
+      return self
+    end
+
+    #===文字列を画面の指定の位置に描画する
+    #_x_:: x方向位置
+    #_y_:: y方向位置
+    #返却値:: 自分自身を返す
+    def render_xy(x, y)
+      return self unless @visible
+      draw_text(Screen, @text, x, y)
+      return self
+    end
+
+    #===文字列をスプライトの指定の位置に描画する
+    #_dst_:: 描画先スプライト
+    #_x_:: x方向位置
+    #_y_:: y方向位置
+    #返却値:: 自分自身を返す
+    def render_xy_to(dst, x, y)
+      return self unless @visible
+      draw_text(dst, @text, x, y)
+      return self
+    end
+
+    #===文字列を画面に描画する
+    #引数textは、内部でto_sメソッドを呼び出して文字列化している
+    #_text_:: 描画対象の文字列
+    #返却値:: 自分自身を返す
+    def render_str(text)
+      return self unless @visible
+      draw_text(Screen, text.to_s, @layout[:pos][0], @layout[:pos][1])
+      return self
+    end
+
+    #===文字列をスプライトに描画する
+    #引数textは、内部でto_sメソッドを呼び出して文字列化している
+    #_dst_:: 描画先スプライト
+    #_text_:: 描画対象の文字列
+    #返却値:: 自分自身を返す
+    def render_str_to(dst, text)
+      return self unless @visible
+      draw_text(dst, text.to_s, @layout[:pos][0], @layout[:pos][1])
+      return self
+    end
+
     #===文字列描画したときの大きさを取得する
     #現在のフォントの設定で指定の文字列を描画したとき、予想される描画サイズを返す。実際に描画は行われない。
     #_txt_:: 算出したい文字列
@@ -365,7 +458,7 @@ module Miyako
     def chr_size_inner(char)
       return (char.bytesize == 1 ? @size >> 1 : @size) + (@use_shadow ? @shadow_margin[0] : 0) + @hspace
     end
-    
+
     private :chr_size_inner
 
     #===文字列描画したときの大きさを取得する
@@ -374,11 +467,11 @@ module Miyako
     #返却値:: 文字列を描画したときの大きさ([w,h]の配列)
     def text_size(txt)
       width = txt.chars.inject(0){|r, c|
-        r += (c.bytesize == 1 ? @size >> 1 : @size) } + 
+        r += (c.bytesize == 1 ? @size >> 1 : @size) } +
              ((@use_shadow ? @shadow_margin[0] : 0) + @hspace) * (txt.chars.to_a.length - 1)
       return [width, self.line_height]
     end
-    
+
     #===指定した高さで描画する際のマージンを求める
     #現在のフォントの設定で指定の文字列を描画したとき、予想される描画サイズを返す。実際に描画は行われない。
     #第1引数に渡す"align"は、以下の3種類のシンボルのどれかを渡す
@@ -417,7 +510,7 @@ module Miyako
     #返却値:: OSごとに設定されたフォントイン寸タンス(フォントサイズは16)
     def Font::sans_serif
       filename = @@font_base_name[Miyako::getOSName].
-                   detect{|base| 
+                   detect{|base|
                      Font.findFontPath(base[:sans_serif])
                    }[:sans_serif]
       return Font.new(filename)