cyross-ruby-miyako 2.0.0

data/lib/Miyako/API/fixedmap.rb

@@ -0,0 +1,315 @@
+# -*- encoding: utf-8 -*-
+=begin
+--
+Miyako v2.0
+Copyright (C) 2007-2008  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
+  #==スクロールしないマップクラス
+  class FixedMap
+    include Layout
+    
+    @@idx_ix = [-1, 2, 4]
+    @@idx_iy = [-1, 0, 6]
+
+    attr_reader :name, :map_layers, :pos, :w, :h
+
+    #==あとで書く
+    class FixedMapLayer #:nodoc: all
+      extend Forwardable
+
+      @@use_chip_list = Hash.new(nil)
+      
+      attr_accessor :mapchip_units
+      attr_reader :pos
+
+      def round(v, max) #:nodoc:
+        v = max + (v % max) if v < 0
+        v %= max if v >= max
+        return v
+      end
+
+      def reSize #:nodoc:
+        @cw = @real_size.w % @ow == 0 ? @real_size.w / @ow : (@real_size.w + @ow - 1)/ @ow + 1
+        @ch = @real_size.h % @oh == 0 ? @real_size.h / @oh : (@real_size.h + @oh - 1)/ @oh + 1
+      end
+
+      def initialize(mapchip, mapdat, layer_size, pos) #:nodoc:
+        @mapchip = mapchip
+        @pos = pos.dup
+        @size = layer_size.dup
+        @ow = @mapchip.chip_size.w
+        @oh = @mapchip.chip_size.h
+        @real_size = Size.new(@size.w * @ow, @size.h * @oh)
+        @mapdat = mapdat
+        @baseimg = nil
+        @baseimg = @mapchip.chip_image
+        @units = nil
+        @visible = false
+        @divpx = get_div_array(0, @real_size.w, @ow)
+        @divpy = get_div_array(0, @real_size.h, @oh)
+        @modpx = get_mod_array(0, @real_size.w, @ow)
+        @modpy = get_mod_array(0, @real_size.h, @oh)
+        @modpx2 = get_mod_array(0, @size.w * 2 + 1, @size.w)
+        @modpy2 = get_mod_array(0, @size.h * 2 + 1, @size.h)
+        @cdivsx = get_div_array(0, @mapchip.chips, @mapchip.size.w)
+        @cmodsx = get_mod_array(0, @mapchip.chips, @mapchip.size.w)
+        @cdivsy = get_div_array(0, @mapchip.chips, @mapchip.size.h)
+        @cmodsy = get_mod_array(0, @mapchip.chips, @mapchip.size.h)
+        @cdivsx = @cdivsx.map{|v| v * @ow }
+        @cdivsy = @cdivsy.map{|v| v * @oh }
+        @cmodsx = @cmodsx.map{|v| v * @ow }
+        @cmodsy = @cmodsy.map{|v| v * @oh }
+        @mapchip_units = Array.new(@mapchip.chips){|idx|
+          SpriteUnitFactory.create(:bitmap=>@baseimg.bitmap,
+                                   :ox => (idx % @mapchip.size.w) * @ow, :oy => (idx / @mapchip.size.w) * @oh,
+                                   :ow => @ow, :oh => @oh)
+        }
+        reSize
+      end
+
+      def get_div_array(s, t, v) #:nodoc:
+        a = Array.new
+        (s..t).each{|i| a.push(i / v)}
+        return a
+      end
+
+      def get_mod_array(s, t, v) #:nodoc:
+        a = Array.new
+        (s..t).each{|i| a.push(i % v)}
+        return a
+      end
+
+      def convert_position(x, y) #:nodoc:
+        return Point.new(@modpx2[round(x, @size.w)],
+                         @modpy2[round(y, @size.h)])
+      end
+
+      def get_code(x, y) #:nodoc:
+        pos = convert_position(x, y)
+        return @mapdat[pos.y][pos.x]
+      end
+
+      def dispose #:nodoc:
+        @mapdat = nil
+        @baseimg = nil
+      end
+
+      def_delegators(:@size, :w, :h)
+    end
+
+    #===あとで書く
+    #_mapchip_:: あとで書く
+    #_layer_csv_:: あとで書く
+    #_event_manager_:: MapEventManagerクラスのインスタンス
+    #_pos_:: あとで書く
+    #返却値:: あとで書く
+    def initialize(mapchip, layer_csv, event_manager, pos = Point.new(0, 0))
+      init_layout
+      @em = event_manager.dup
+      @em.set(self)
+      @mapchip = mapchip
+      @pos = Point.new(*(pos.to_a))
+      @coll = Collision.new(Rect.new(0, 0, 0, 0), Point.new(0, 0))
+      layer_data = CSV.readlines(layer_csv)
+
+      raise MiyakoError, "This file is not Miyako Map Layer file! : #{layer_csv}" unless layer_data.shift[0] == "Miyako Maplayer"
+
+      tmp = layer_data.shift # 空行の空読み込み
+
+      layer_size = Size.new(tmp[0].to_i, tmp[1].to_i)
+      @w = layer_size.w * @mapchip.chip_size.w
+      @h = layer_size.h * @mapchip.chip_size.h
+
+      layers = layer_data.shift[0].to_i
+
+      brlist = {}
+      layers.times{|n|
+        name = layer_data.shift[0]
+        if name == "<event>"
+          name = :event
+        else
+          name = /\<(\d+)\>/.match(name).to_a[1].to_i
+        end
+        values = []
+        layer_size.h.times{|y|
+          values << layer_data.shift.map{|m| m.to_i}
+        }
+        brlist[name] = values
+      }
+
+      @map_layers = Array.new
+      @event_layer = nil
+
+      if brlist.has_key?(:event)
+        @event_layer = Array.new
+        brlist[:event].each_with_index{|ly, y|
+          ly.each_with_index{|code, x|
+            next unless @em.include?(code)
+            @event_layer.push(@em.create(code, x * @mapchip.chip_size.w, y * @mapchip.chip_size.h))
+          }
+        }
+        layers -= 1
+      end
+      @map_layers = []
+      layers.times{|i|
+        br = brlist[i].map{|b| b.map{|bb| bb >= @mapchip.chips ? -1 : bb } }
+        @map_layers.push(FixedMapLayer.new(@mapchip, br, layer_size, pos))
+      }
+      set_layout_size(@w, @h)
+    end
+
+    #===マップにイベントを追加する
+    #_code_:: イベント番号(FixedMap.newメソッドで渡したイベント番号に対応)
+    #_x_:: マップ上の位置(x方向)
+    #_y_:: マップ常温位置(y方向)
+    #返却値:: 自分自身を返す
+    def add_event(code, x, y)
+      return self unless @em.include?(code)
+      @event_layer.push(@em.create(code, x, y))
+      return self
+    end
+
+    def update_layout_position #:nodoc:
+      d = Point.new(@layout.pos[0]-@pos.x, @layout.pos[1]-@pos.y)
+      @pos.move_to(*@layout.pos)
+      @map_layers.each{|ml| ml.pos.move_to(*@pos) }
+    end
+
+    def [](idx) #:nodoc:
+      return @map_layers[idx]
+    end
+
+    #===あとで書く
+    #_idx_:: あとで書く
+    #_x_:: あとで書く
+    #_y_:: あとで書く
+    #返却値:: あとで書く
+    def get_code_real(idx, x, y)
+      code = @map_layers[idx].get_code((x-@pos[0]) / @mapchip.chip_size[0], (y-@pos[1]) / @mapchip.chip_size[1])
+      yield code if block_given?
+      return code
+    end
+
+    #===あとで書く
+    #_idx_:: あとで書く
+    #_x_:: あとで書く
+    #_y_:: あとで書く
+    #返却値:: あとで書く
+    def get_code(idx, x, y)
+      code = @map_layers[idx].get_code(x, y)
+      yield code if block_given?
+      return code
+    end
+
+    #===あとで書く
+    #_idx_:: あとで書く
+    #_code_:: あとで書く
+    #_base_:: あとで書く
+    #返却値:: あとで書く
+    def set_mapchip_base(idx, code, base)
+      @map_layers[idx].mapchip_units[code] = base
+      return self
+    end
+
+    #===あとで書く
+    #_type_:: あとで書く
+    #_rect_:: あとで書く
+    #_collision_:: あとで書く
+    #返却値:: あとで書く
+    def get_amount_by_rect(type, rect, collision)
+      mma = MapMoveAmount.new([], collision.direction.dup)
+      return mma if(mma.amount[0] == 0 && mma.amount[1] == 0)
+      dx, dy = collision.direction[0]*collision.amount[0], collision.direction[1]*collision.amount[1]
+      x, y = rect[0]-@pos[0], rect[1]-@pos[1]
+      collision.pos = Point.new(x, y)
+      px1, px2 = (x+dx) / @mapchip.chip_size[0], (x+rect[2]-1+dx) / @mapchip.chip_size[0]
+      py1, py2 = (y+dy) / @mapchip.chip_size[1], (y+rect[3]-1+dy) / @mapchip.chip_size[1]
+      (py1..py2).each{|py|
+        rpy = py * @mapchip.chip_size[1]
+        (px1..px2).each{|px|
+          rpx = px * @mapchip.chip_size[0]
+          @map_layers.each_with_index{|ml, idx|
+            code = ml.get_code(px, py)
+            next if code == -1 # not use chip
+            @coll = @mapchip.collision_table[type][code].dup
+            @coll.pos  = Point.new(rpx, rpy)
+            atable = @mapchip.access_table[type][code]
+            if @coll.into?(collision)
+              mma.amount[0] = mma.amount[0] & atable[@@idx_ix[collision.direction[0]]]
+              mma.amount[1] = mma.amount[1] & atable[@@idx_iy[collision.direction[1]]]
+              mma.collisions << [idx, code, :into]
+            end
+          }
+        }
+      }
+      mma.amount[0] *= collision.amount[0]
+      mma.amount[1] *= collision.amount[1]
+      yield mma if block_given?
+      return mma
+    end
+
+    #===現在の画面の最大の大きさを矩形で取得する
+    #但し、FixedMapの場合は最大の大きさ=画面の大きさなので、rectと同じ値が得られる
+    #返却値:: 画像の大きさ(Rect構造体のインスタンス)
+    def broad_rect
+      return self.rect
+    end
+
+    #===あとで書く
+    #返却値:: あとで書く
+    def chipSize
+      return @mapchip.chip_size
+    end
+
+    #===あとで書く
+    #返却値:: あとで書く
+    def final
+      @event_layer.each{|e| e.final } if @event_layer
+    end
+
+    #===あとで書く
+    #返却値:: あとで書く
+    def dispose
+      @map_layers.each{|l|
+        l.dispose
+        l = nil
+      }
+      @map_layers = Array.new
+      if @event_layer
+        @event_layer.each{|e| e.dispose }
+        @event_layer = nil
+      end
+    end
+
+    def re_size #:nodoc:
+      @map_layers.each{|l| l.reSize }
+      return self
+    end
+
+    #===マップに登録しているイベントインスタンス(マップイベント)を取得する
+    #返却値:: マップイベントの配列
+    def events
+      return @event_layer || []
+    end
+  end
+end

data/lib/Miyako/API/font.rb

@@ -0,0 +1,384 @@
+# -*- encoding: utf-8 -*-
+=begin
+--
+Miyako v2.0
+Copyright (C) 2007-2008  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
+  class Font
+    extend Forwardable
+
+    attr_reader :size, :line_skip, :height, :ascent, :descent
+    attr_accessor :color, :use_shadow, :shadow_color, :shadow_margin, :vspace, :draw_type
+
+    @@font_cache = {}
+
+    @@name_2_font_path = Hash.new
+
+    @@font_base_path = Hash.new
+    @@font_base_path["win"] = ENV['SystemRoot'] ? ["./", ENV['SystemRoot'].tr("\\", "/") + "/fonts/"] : ["./"]
+    @@font_base_path["linux"] = ["./", "/usr/share/fonts/", "/usr/X11R6/lib/X11/fonts/"]
+    @@font_base_path["mac_osx"] = ["./", "~/Library/Fonts/", "/Library/Fonts/", "/System/Library/Fonts/",
+                                      "/ライブラリ/Fonts/", "/システム/ライブラリ/Fonts/"]
+
+    @@font_base_name = Hash.new
+    @@font_base_name["win"] = [{:serif=>"msmincho.ttc", :sans_serif=>"meiryo.ttc"},
+                               {:serif=>"msmincho.ttc", :sans_serif=>"msgothic.ttc"},
+                               {:serif=>"VL-Gothic-Regular.ttf", :sans_serif=>"VL-Gothic-Regular.ttf"},
+                               {:serif=>"umeplus-gothic.ttf", :sans_serif=>"umeplus-gothic.ttf"}]
+    @@font_base_name["linux"] = [{:serif=>"sazanami-mincho.ttf", :sans_serif=>"sazanami-gothic.ttf"},
+                                    {:serif=>"VL-Gothic-Regular.ttf", :sans_serif=>"VL-Gothic-Regular.ttf"},
+                                    {:serif=>"umeplus-gothic.ttf", :sans_serif=>"umeplus-gothic.ttf"}]
+    @@font_base_name["mac_osx"] = [{:serif=>"Hiragino Mincho Pro W3.otf", :sans_serif=>"Hiragino Kaku Gothic Pro W3.otf"},
+                                      {:serif=>"Hiragino Mincho Pro W6.otf", :sans_serif=>"Hiragino Kaku Gothic Pro W6.otf"},
+                                      {:serif=>"ヒラギノ明朝 Pro W3.otf", :sans_serif=>"ヒラギノ角ゴ Pro W3.otf"},
+                                      {:serif=>"ヒラキ゛ノ明朝 Pro W3.otf", :sans_serif=>"ヒラキ゛ノ角コ゛ Pro W3.otf"},
+                                      {:serif=>"ヒラギノ明朝 Pro W6.otf", :sans_serif=>"ヒラギノ角ゴ Pro W6.otf"},
+                                      {:serif=>"ヒラキ゛ノ明朝 Pro W6.otf", :sans_serif=>"ヒラキ゛ノ角コ゛ Pro W6.otf"},
+                                      {:serif=>"VL-Gothic-Regular.ttf", :sans_serif=>"VL-Gothic-Regular.ttf"},
+                                      {:serif=>"umeplus-gothic.ttf", :sans_serif=>"umeplus-gothic.ttf"}]
+
+    def Font.search_font_path_file(hash, path) #:nodoc:
+      Dir.glob(path+"*"){|d|
+        hash = Font.search_font_path_file(hash, d+"/") if test(?d, d)
+        d = Iconv.conv("UTF-8-MAC", "UTF-8", d.toutf8) if Miyako.getOSName == "mac_osx" # MacOSXはパス名がUTF-8固定のため
+        d = d.tr("\\", "\/")
+        hash[$1] = d if (d =~ /\/([^\/\.]+\.tt[fc])\z/ || d =~ /\/([^\/\.]+\.otf)\z/) # MacOSX対応
+      }
+      return hash
+    end
+
+    def Font.create_font_path #:nodoc:
+      osn = Miyako::getOSName
+      @@font_base_path[osn].each{|path|
+        path = Iconv.conv("UTF-8-MAC", "UTF-8", path.toutf8) if Miyako.getOSName == "mac_osx" # MacOSXはパス名がUTF-8固定のため
+        path = path.tr("\\", "\/")
+        @@name_2_font_path = Font.search_font_path_file(@@name_2_font_path, path)
+      }
+    end
+
+    def Font.findFontPath(fname) #:nodoc:
+      fname = Iconv.conv("UTF-8-MAC", "UTF-8", fname.toutf8) if Miyako.getOSName == "mac_osx" # MacOSXはパス名がUTF-8固定のため
+      return @@name_2_font_path.fetch(fname, nil)
+    end
+
+    def Font.get_font_inner(fname, fpath, size=16) #:nodoc:
+      if Miyako.getOSName == "mac_osx" # MacOSXはパス名がUTF-8固定のため
+        fname = Iconv.conv("UTF-8-MAC", "UTF-8", fname.toutf8)
+        fpath = Iconv.conv("UTF-8-MAC", "UTF-8", fpath.toutf8)
+      end
+      @@font_cache[fname] ||= {}
+      @@font_cache[fname][size] ||= SDL::TTF.open(fpath, size)
+      return @@font_cache[fname][size]
+    end
+
+    def init_height #:nodoc:
+      @line_skip = @font.line_skip
+      @height    = @font.height
+      @ascent    = @font.ascent
+      @descent   = @font.descent
+    end
+
+    private :init_height
+
+    #===インスタンス生成
+    #_fname_:: フォントファイル名(フォントファミリー名不可)。システムフォントのときはディレクトリ指定不要
+    #_size_:: フォントの大きさ。単位はピクセル。デフォルトは 16
+    #返却値:: 生成されたインスタンスを返す
+    def initialize(fname, size=16)
+      @size = size
+      @color = [255, 255, 255]
+      @fname = fname
+      @vspace = 0
+      @bold = false
+      @italic = false
+      @under_line = false
+      @draw_type = :mild
+      @fpath = Font.findFontPath(@fname) or raise MiyakoError, "Cannot Find Font! : #{@fname}"
+      @font = Font.get_font_inner(@fname, @fpath, @size)
+      @font.style = SDL::TTF::STYLE_NORMAL
+      init_height
+      @draw_text = {:solid => self.method(:_draw_text), :mild => self.method(:_draw_text_mild)}
+      @use_shadow = false
+      @shadow_color = [128, 128, 128]
+      @shadow_margin = [2, 2]
+      @unit = SpriteUnitFactory.create
+    end
+
+    #===フォントの大きさを変更する
+    #_sz_:: 変更するフォントの大きさ(単位：ピクセル)
+    #返却値:: 変更されたフォントのインスタンス
+    def size=(sz)
+      @size = sz
+      @font = Font.get_font_inner(@fname, @fpath, @size)
+      @font.style = (@bold ? SDL::TTF::STYLE_BOLD : 0) | (@italic ? SDL::TTF::STYLE_ITALIC : 0) | (@under_line ? SDL::TTF::STYLE_UNDERLINE : 0)
+      init_height
+      return self
+    end
+
+    #===ブロック評価中のみ、フォントの大きさを変更する
+    #_sz_:: 変更するフォントの大きさ(単位：ピクセル)
+    #返却値:: 自分自身を返す
+    def size_during(sz)
+      raise MiyakoError, "not given block!" unless block_given?
+      tsize = @size
+      self.size = sz
+      yield
+      self.size = tsize
+      return self
+    end
+
+    #===ブロック評価中のみ、フォントの文字の色を変更する
+    #_color_:: 変更する色([r,g,b]の3要素の配列(値:0～255))
+    #返却値:: 自分自身を返す
+    def color_during(color)
+      raise MiyakoError, "not given block!" unless block_given?
+      tcolor, self.color = @color, color
+      yield
+      self.color = tcolor
+      return self
+    end
+
+    #===ブロック評価中のみ、影文字文字の色・マージンを変更する
+    #また、ブロック評価中は影文字が強制的に有効になる
+    #_color_:: 変更する色([r,g,b]の3要素の配列(値:0～255))、デフォルトはFont#shadow_colorメソッドの値([128,128,128])
+    #_margin_:: 変更する色(2要素の整数の配列、デフォルトはFont#shadow_marginメソッドの値([2,2])
+    #返却値:: 自分自身を返す
+    def shadow_during(color = @shadow_color, margin = @shadow_margin)
+      raise MiyakoError, "not given block!" unless block_given?
+      tflag, @use_shadow = @use_shadow, true
+      tcolor, @shadow_color = @shadow_color, color
+      tmargin, @shadow_margin = @shadow_margin, margin
+      yield
+      @use_shadow = tflag
+      @shadow_color = tcolor
+      @shadow_margin = tmargin
+      return self
+    end
+
+    #===指定したピクセル数のフォントが十分(欠けることなく)収まるピクセル数を取得する
+    #_size_:: フォントの大きさ(単位：ピクセル)
+    #返却値:: 算出されたピクセル数
+    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 
+    end
+    
+    #===フォントサイズ(yやjなどの下にはみ出る箇所も算出)を取得する
+    #返却値:: 算出されたフォントサイズ
+    def line_height
+      return @line_skip + @vspace + (@use_shadow ? @shadow_margin[1] : 0)
+    end
+
+    #===フォントインスタンスを解放する
+    def dispose
+      @font = nil
+    end
+
+    #===フォントの属性をbold(太文字)に設定する
+    #ブロックを渡したときは、ブロック評価中のみ太字になる
+    #文字が領域外にはみ出る場合があるので注意！
+    #返却値:: 自分自身
+    def bold
+      if block_given?
+        tbold, self.bold = self.bold?, true
+        yield
+        self.bold = tbold
+      else
+        self.bold = true
+      end
+      return self
+    end
+    
+    #===フォントのbold属性の有無を返す
+    #返却値:: bold属性かどうか(true/false)
+    def bold?
+      return @bold
+    end
+    
+    #===フォントのbold属性を設定する
+    #_f_:: bold属性かどうか(true/false)
+    def bold=(f)
+      @bold = f
+      @font.style |= SDL::TTF::STYLE_BOLD
+      @font.style -= SDL::TTF::STYLE_BOLD unless @bold
+      return self
+    end
+    
+    #===フォントの属性をitalic(斜め)に設定する
+    #ブロックを渡したときは、ブロック評価中のみ斜体文字になる
+    #文字が領域外にはみ出る場合があるので注意！
+    #返却値:: 自分自身
+    def italic
+      if block_given?
+        titalic, self.italic = self.italic?, true
+        yield
+        self.italic = titalic
+      else
+        self.italic = true
+      end
+      return self
+    end
+    
+    #===フォントのitalic属性の有無を返す
+    #返却値:: italic属性かどうか(true/false)
+    def italic?
+      return @italic
+    end
+    
+    #===フォントのitalic属性を設定する
+    #_f_:: italic属性かどうか(true/false)
+    def italic=(f)
+      @italic = f
+      @font.style |= SDL::TTF::STYLE_ITALIC
+      @font.style -= SDL::TTF::STYLE_ITALIC unless @italic
+      return self
+    end
+    
+    #===フォントの属性をunder_line(下線)に設定する
+    #ブロックを渡したときは、ブロック評価中のみ下線付き文字になる
+    #返却値:: 自分自身
+    def under_line
+      if block_given?
+        tunder_line, self.under_line = self.under_line?, true
+        yield
+        self.under_line = tunder_line
+      else
+        self.under_line = true
+      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)
+      @under_line = f
+      @font.style |= SDL::TTF::STYLE_UNDERLINE
+      @font.style -= SDL::TTF::STYLE_UNDERLINE unless @under_line
+      return self
+    end
+
+    #===フォントの属性をすべてクリアする
+    #_f_:: 自分自身
+    def normal
+      @font.style = 0
+      return self
+    end
+    
+    #===文字列を描画する
+    #対象のスプライトに文字列を描画する
+    #_dst_:: 描画先スプライト
+    #_str_:: 描画する文字列
+    #_x_:: 描画位置x軸
+    #_y_:: 描画位置Y軸
+    def draw_text(dst, str, x, y)
+      str = str.toutf8
+      str = Iconv.conv("UTF-8-MAC", "UTF-8", str) if Miyako.getOSName == "mac_osx"
+      return @draw_text[@draw_type][dst, str, x, y]
+    end
+    
+    def _draw_text(dst, str, x, y) #:nodoc:
+      @font.drawSolidUTF8(dst.bitmap, str, x + @shadow_margin[0], y + @shadow_margin[1], @shadow_color[0], @shadow_color[1], @shadow_color[2]) if @use_shadow
+      @font.drawSolidUTF8(dst.bitmap, str, x, y, @color[0], @color[1], @color[2])
+      return x + @font.textSize(str)[0]
+    end
+
+    def _draw_text_mild(dst, str, x, y) #:nodoc:
+      src = @font.renderBlendedUTF8(str, @color[0], @color[1], @color[2])
+      if src
+        if @use_shadow
+          src2 = @font.renderBlendedUTF8(str, @shadow_color[0], @shadow_color[1], @shadow_color[2])
+          SpriteUnitFactory.apply(@unit, {:bitmap=>src2, :ow=>src2.w, :oh=>src2.h})
+          Miyako::Bitmap.blit_aa!(@unit, dst.to_unit, x+@shadow_margin[0], y+@shadow_margin[1])
+        end
+        SpriteUnitFactory.apply(@unit, {:bitmap=>src, :ow=>src.w, :oh=>src.h})
+        Miyako::Bitmap.blit_aa!(@unit, dst.to_unit, x, y)
+      else
+        return x
+      end
+      return x + @font.textSize(str)[0]
+    end
+
+    #===文字列描画したときの大きさを取得する
+    #現在のフォントの設定で指定の文字列を描画したとき、予想される描画サイズを返す。実際に描画は行われない。
+    #_txt_:: 算出したい文字列
+    #返却値:: 文字列を描画したときの大きさ([w,h]の配列)
+    def text_size(txt)
+      return [txt.chars.inject(0){|r, c| r += (c.length == 1 ? @size >> 1 : @size) } + (@use_shadow ? @shadow_margin[0] : 0),
+              self.line_height]
+    end
+    
+    #===指定した高さで描画する際のマージンを求める
+    #現在のフォントの設定で指定の文字列を描画したとき、予想される描画サイズを返す。実際に描画は行われない。
+    #第1引数に渡す"align"は、以下の3種類のシンボルのどれかを渡す
+    #:top:: 上側に描画(マージンはゼロ)
+    #:middle:: 中間に描画
+    #:bottom:: 下部に描画
+    #
+    #_align_:: 描画位置
+    #_height_:: 描画する高さ
+    #返却値:: マージンの値
+    def margin_height(align, height)
+      case align
+        when :top
+          return 0
+        when :middle
+          return (height - self.line_height) >> 1
+        when :bottom
+          return height - self.line_height
+      end
+      #else
+      raise MiyakoError, "Illegal margin_height align! : #{align}"
+    end
+
+    Font.create_font_path
+
+    #===Serifフォント(明朝フォント)を取得する
+    #マルチプラットフォームのソフトを作る際、OS間の差異を吸収するため、共通の名称でフォントインスタンスを取得するときに使う(主に明朝フォント)
+    #返却値:: OSごとに設定されたフォントイン寸タンス(フォントサイズは16)
+    def Font::serif
+      filename = @@font_base_name[Miyako::getOSName].detect{|base| Font.findFontPath(base[:serif]) }[:serif]
+      return Font.new(filename)
+    end
+
+    #===Sans Serifフォント(ゴシックフォント)を取得する
+    #マルチプラットフォームのソフトを作る際、OS間の差異を吸収するため、共通の名称でフォントインスタンスを取得するときに使う(主にゴシックフォント)
+    #返却値:: OSごとに設定されたフォントイン寸タンス(フォントサイズは16)
+    def Font::sans_serif
+      filename = @@font_base_name[Miyako::getOSName].detect{|base| Font.findFontPath(base[:sans_serif]) }[:sans_serif]
+      return Font.new(filename)
+    end
+
+    def Font::system_font #:nodoc:
+      return Font.serif
+    end
+  end
+end