cyross-ruby-miyako 2.0.0

data/lib/Miyako/API/shape.rb

@@ -0,0 +1,362 @@
+# -*- 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
+	@@modes = [:text, :txt_calc, :takahashi, :tk_calc]
+		
+  #==テキストや図形を描画するクラス
+  #図形は、長方形・丸み付き長方形・円・楕円が描画可能
+  #文字列は、通常の文字列と高橋メソッド形式文字列が描画可能
+  class Shape
+    def init_parameter(parameter)
+      @text = parameter[:text]
+      @size = parameter[:size] ||= Size.new(100,100)
+      @color = parameter[:color] ||= Color[:white]
+      @font = parameter[:font] ||= Font.sans_serif
+      @ray = parameter[:ray] ||= 0
+      @edge = parameter[:edge] ||= nil
+      @align = parameter[:align] ||= :left
+			@lines = parameter[:lines] ||= 2
+    end
+
+    @@shape_executer = Shape.new
+
+    #===テキストを描画した画像を作成
+    #_param_:: 設定パラメータ。ハッシュ形式。
+    #(:font => 描画するフォントのインスタンス(デフォルトはFont.sans_serif),
+    #(:align => 複数行描画するときの文字列のアライン(:left,:center,:rightの三種。デフォルトは:left))
+    #_&block_:: 描画するテキスト(Ｙｕｋｉ形式)
+    #返却値:: テキストを描画したスプライト
+    def Shape.text(param, &block)
+      raise MiyakoError, "Cannot find any text(:text parameter)!" unless (param[:text] || block)
+      @@shape_executer.create_text(param, block)
+    end
+
+    #===テキストを高橋メソッド形式で描画した画像を作成
+		#指定した大きさの矩形・行数で文字を描画する。
+		#指定した行数で描画を基準に文字サイズを算出する。
+    #但し、文字列が長すぎる時は、その文字数を基準に文字サイズを算出する。
+    #ブロックに渡した行数が指定数より多くなると文字列がはみ出るため、注意すること。
+    #_param_:: 設定パラメータ。ハッシュ形式。
+    #(:font => 描画するフォントのインスタンス(デフォルトはFont.sans_serif),
+    #(:align => 複数行描画するときの文字列のアライン(:left,:center,:rightの三種。デフォルトは:left),
+    #(:size => 描画するサイズ(ピクセル単位、Size構造体のインスタンス、デフォルトは[100,100]))
+    #(:lines => 描画する行数(デフォルトは2))
+    #_&block_:: 描画するテキスト(Ｙｕｋｉ形式)
+    #返却値:: テキストを描画したスプライト
+    def Shape.takahashi(param, &block)
+      @@shape_executer.takahashi(param, block)
+    end
+
+    #===長方形を描画する(エッジ付きも可。そのとき、エッジは指定したサイズより内側に描画する)
+    #_param_:: 設定パラメータ。ハッシュ形式。
+    #(:size => 描画するサイズ(ピクセル単位、Size構造体のインスタンス、デフォルトは[100,100]),
+    #:color => 長方形の色[r,g,b(,a)]、デフォルトはColor[:white],
+    #:edge] => エッジを設定する。値は{:color=>色, :width=>幅}のハッシュを割り付ける)
+    #返却値:: 描画したスプライト
+    def Shape.box(param)
+      @@shape_executer.box(param)
+    end
+
+    #===丸み付き長方形を描画する(エッジ付きも可。そのとき、エッジは指定したサイズより内側に描画する)
+    #_param_:: 設定パラメータ。ハッシュ形式。
+    #(:size => 描画するサイズ(ピクセル単位、Size構造体のインスタンス、デフォルトは[100,100]),
+    #:ray => 丸みの半径の大きさ(ピクセル単位。デフォルトは0),
+    #:color => 長方形の色[r,g,b(,a)]、デフォルトはColor[:white],
+    #:edge => エッジを設定する。値は{:color=>色, :width=>幅}のハッシュを割り付ける)
+    #返却値:: 描画したスプライト
+    def Shape.roundbox(param)
+      @@shape_executer.roundbox(param)
+    end
+
+    #===円を描画する(エッジ付きも可。そのとき、エッジは指定したサイズより内側に描画する)
+    #_param_:: 設定パラメータ。ハッシュ形式。
+    #(:ray => 円の半径の大きさ(ピクセル単位。デフォルトは0),
+    #:color => 円の色[r,g,b(,a)]、デフォルトはColor[:white],
+    #:edge => エッジを設定する。値は{:color=>色, :width=>幅}のハッシュを割り付ける)
+    #返却値:: 描画したスプライト
+    def Shape.circle(param)
+      @@shape_executer.circle(param)
+    end
+
+    #===楕円を描画する(エッジ付きも可。そのとき、エッジは指定したサイズより内側に描画する)
+    #_param_:: 設定パラメータ。ハッシュ形式。
+    #(:size => 楕円の半径の横・縦の大きさ(ピクセル単位。デフォルトは0),
+    #:color => 円の色[r,g,b(,a)]、デフォルトはColor[:white],
+    #:edge => エッジを設定する。値は{:color=>色, :width=>幅}のハッシュを割り付ける)
+    #返却値:: 描画したスプライト
+    def Shape.ellipse(param)
+      @@shape_executer.ellipse(param)
+    end
+
+    def create_text(param, text_block) #:nodoc:
+      init_parameter(param)
+      text_block = lambda{ @text } if @text
+      org_size = @font.size
+      org_color = @font.color
+      @margins = []
+      area_size = calc(text_block)
+      @sprite = Sprite.new({:size => area_size, :type => :alpha_channel, :is_fill => true})
+      case @align
+        when :left
+        @margins = @margins.map{|v| 0 }
+        when :center
+        @margins = @margins.map{|v| (area_size.w - v) >> 1 }
+        when :right
+        @margins = @margins.map{|v| area_size.w - v }
+      end
+			@lines = @margins.length
+      @locate = Point.new(@margins.shift, 0)
+      text instance_eval(&text_block)
+      @font.size = org_size
+      @font.color = org_color
+      return @sprite
+    end
+
+    def takahashi(param, text_block) #:nodoc:
+      init_parameter(param)
+      org_size = @font.size
+      org_color = @font.color
+			# calc font size
+      @font.size = @size[1] / @lines
+			# calc font size incldue line_height
+      @font.size = @font.size * @font.size / @font.line_height
+      set_font_size_inner(text_block)
+      # over width?
+      if @img_size.w > @size[0]
+        @font.size = @font.size * @size[0] / @img_size.w
+        set_font_size_inner(text_block)
+      end
+      case @align
+        when :left
+        @margins = @margins.map{|v| 0 }
+        when :center
+        @margins = @margins.map{|v| (@size.w - v) / 2 }
+        when :right
+        @margins = @margins.map{|v| @size.w - v }
+      end
+      @sprite = Sprite.new({:size => @size, :type => :alpha_channel, :is_fill => true})
+      @locate = Point.new(@margins.shift, 0)
+      text instance_eval(&text_block)
+      @font.size = org_size
+      @font.color = org_color
+      return @sprite
+    end
+    
+    def set_font_size_inner(text_block) #:nodoc:
+      @max_height = @font.line_height
+      @margins = []
+      tcalc(text_block)
+    end
+
+    def calc(block) #:nodoc:
+      @locate = Point.new(0, 0)
+      @img_size = Size.new(0, 0)
+      @max_height = @font.line_height
+      @calc_mode = true
+      text instance_eval(&block)
+      @calc_mode = false
+      if @locate.x != 0
+        @margins << @locate.x
+        @img_size.w = [@locate.x, @img_size.w].max
+        @img_size.h += @max_height
+      end
+      return @img_size
+    end
+
+    def tcalc(block) #:nodoc:
+      @locate = Point.new(0, 0)
+      @img_size = Size.new(0, 0)
+      @calc_mode = true
+      text instance_eval(&block)
+      @calc_mode = false
+      @margins << @locate.x if @locate.x != 0
+    end
+		
+    #===Shape.textメソッドのブロック内で使用する、文字描画指示メソッド
+    #(例)Shape.text(){ text "abc" }
+    #(例)Shape.takahashi(:size=>[200,200]){ text "名前重要" }
+    #_text_:: 描画するテキスト
+    #返却値:: 自分自身
+    def text(txt)
+      return self if txt.eql?(self)
+      txt = txt.gsub(/[\n\r\t\f]/,"")
+      @font.draw_text(@sprite, txt, @locate.x, @locate.y) unless @calc_mode
+      @locate.x += @font.text_size(txt)[0]
+      return self
+    end
+    
+    #===Shape.text/takahashiメソッドのブロック内で使用する、文字色指示メソッド
+    #ブロック内で指定した範囲でのみ色が変更される
+    #(例)Shape.text(){ text "abc"; cr; color(:red){"def"} }
+    #_color_:: 変更する色([r,g,b])もしくはColor[]メソッドの引数
+    #返却値:: 自分自身
+    def color(color, &block)
+      @font.color_during(Color.to_rgb(color)){ text instance_eval(&block) }
+      return self
+    end
+
+    #===Shape.textメソッドのブロック内で使用する、文字サイズ指示メソッド
+    #ブロック内で指定した範囲でのみサイズが変更される
+    #(例)Shape.text(){ text "abc"; cr; size(16){"def"} }
+    #_size_:: 変更するサイズ(整数)
+    #返却値:: 自分自身
+    def size(size, &block)
+      @font.size_during(size){
+        @max_height = [@max_height, @font.line_height].max
+        size_inner(@font.margin_height(:middle, @max_height)){ text instance_eval(&block) }
+      }
+      return self
+    end
+  
+    def size_inner(margin, &block) #:nodoc:
+      @locate.y += margin
+      text instance_eval(&block)
+      @locate.y -= margin
+    end
+
+    #===Shape.textメソッドのブロック内で使用する、太文字指示メソッド
+    #ブロック内で指定した範囲でのみ太文字になる
+    #(使用すると文字の端が切れてしまう場合あり！)
+    #(例)Shape.text(){ text "abc"; cr; bold{"def"} }
+    #返却値:: 自分自身
+    def bold(&block)
+      @font.bold{ text instance_eval(&block) }
+      return self
+    end
+  
+    #===Shape.textメソッドのブロック内で使用する、斜体指示メソッド
+    #ブロック内で指定した範囲でのみ斜体文字になる
+    #(使用すると文字の端が切れてしまう場合あり！)
+    #(例)Shape.text(){ text "abc"; cr; italic{"def"} }
+    #返却値:: 自分自身
+    def italic(&block)
+      @font.italic{ text instance_eval(&block) }
+      return self
+    end
+  
+    #===Shape.textメソッドのブロック内で使用する、下線指示メソッド
+    #ブロック内で指定した範囲でのみ文字に下線が付く
+    #(例)Shape.text(){ text "abc"; cr; bold{"def"} }
+    #返却値:: 自分自身
+    def under_line(&block)
+      @font.under_line{ text instance_eval(&block) }
+      return self
+    end
+
+    #===Shape.text/takahashiメソッドのブロック内で使用する、改行指示メソッド
+    #(例)Shape.text(){ text "abc"; cr; bold{"def"} }
+    #返却値:: 自分自身
+    def cr
+      if @calc_mode
+        @margins << @locate.x
+        @img_size.w = [@locate.x, @img_size.w].max
+        @img_size.h += @max_height
+        @locate.x = 0
+      else
+        @locate.x = @margins.shift || 0
+      end
+      @locate.y += @max_height
+      return self
+    end
+    
+    def box(param) #:nodoc:
+      init_parameter(param)
+      s = Sprite.new({:size => [w, h], :type => :alpha_channel, :is_fill => true})
+      w = @size[0]
+      h = @size[1]
+      if @edge
+        width = @edge[:width]
+        s.bitmap.fill_rect(0, 0, w-1, h-1, Color.to_rgb(@edge[:color]))
+        s.bitmap.fill_rect(width, width, w-width*2-1, h-width*2-1, Color.to_rgb(@color))
+      else
+        s.bitmap.fill_rect(0, 0, w-1, h-1, Color.to_rgb(@color))
+      end
+      return s
+    end
+
+    def roundbox_basic(s, x, y, w, h, r, c) #:nodoc:
+      color = Color.to_rgb(c)
+      s.bitmap.draw_aa_filled_circle(r+x, r+y, r, color)
+      s.bitmap.draw_aa_filled_circle(w-r-x-1, r+y, r, color)
+      s.bitmap.draw_aa_filled_circle(r+x, h-r-y-1, r, color)
+      s.bitmap.draw_aa_filled_circle(w-r-x-1, h-r-y-1, r, color)
+      s.bitmap.fill_rect(x, y+r, w-x*2, h-y*2-r*2, color)
+      s.bitmap.fill_rect(x+r, y, w-x*2-r*2, h-x*2, color)
+    end
+
+    def roundbox(param) #:nodoc:
+      init_parameter(param)
+      w = @size[0]
+      h = @size[1]
+      s = Sprite.new(@size, nil, nil)
+      s.fill([0, 0, 0, 0])
+      if @edge
+        roundbox_basic(s, 0, 0, w, h, @ray, Color.to_rgb(@edge[:color]))
+        roundbox_basic(s, @edge[:width], @edge[:width], w, h, @ray, Color.to_rgb(@color))
+      else
+        roundbox_basic(s, 0, 0, w, h, @ray, Color.to_rgb(@color))
+      end
+      return s
+    end
+
+    def circle(param) #:nodoc:
+      init_parameter(param)
+      s = Sprite.new({:size => [@ray*2+1, @ray*2+1], :type => :alpha_channel, :is_fill => true})
+      if @edge
+        et, ec = sp.get_param(:edge)[0..1]
+        s.bitmap.draw_aa_filled_circle(@ray, @ray, @ray, Color.to_rgb(@edge[:color]))
+        s.bitmap.draw_aa_filled_circle(@ray, @ray, @ray-@edge[:width], Color.to_rgb(@color))
+      else
+        s.bitmap.draw_aa_filled_circle(@ray, @ray, @ray, Color.to_rgb(@color))
+      end
+      return s
+    end
+
+    def ellipse(param) #:nodoc:
+      init_parameter(param)
+      w = @size[0]
+      w2 = w * 2 + 1
+      h = @size[1]
+      h2 = h * 2 + 1
+      s = Sprite.new({:size => [w2, h2], :type => :alpha_channel, :is_fill => true})
+      if @edge
+        s.bitmap.drawAAFilledEllipse(w, h, w, h, Color.to_rgb(@edge[:color]))
+        s.bitmap.drawAAFilledEllipse(w, h, w-@edge[:width], h-@edge[:width], Color.to_rgb(@color))
+      else
+        s.bitmap.drawAAFilledEllipse(w, h, w, h, Color.to_rgb(@color))
+      end
+      return s
+    end
+
+    private :roundbox_basic
+  end
+end
+
+class String
+  #===文字列から、その文字を描画したスプライトを作成する
+  #自分自身が持つ文字列をShape.textメソッドを使用して画像を作成する
+  #_data_:: 描画するフォント(Fontクラスのインスタンス)
+  def to_sprite(data)
+    return Miyako::Shape.text({:text => self, :font => data})
+  end
+end

data/lib/Miyako/API/sprite.rb

@@ -0,0 +1,338 @@
+# -*- 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
+  #==スプライト管理クラス
+  class Sprite
+    include SpriteBase
+    include Animation
+    include Layout
+    include SingleEnumerable
+    extend Forwardable
+
+    attr_reader :tr_color  #カラーキーが有向になっている場合のRGB値。[R,G,B]の配列(各要素は0～255の整数)
+    attr_reader :type      #画像の透明度・透過タイプを取得する(詳細はSprite.newメソッドを参照)
+
+    @@abb = {:ck => :color_key, :as => :alpha_surface, :ac => :alpha_channel}
+
+    def setup #:nodoc:
+      @unit = SpriteUnitFactory.create
+      @aa = false
+      @tr_color = Color[:black]
+      @update = nil
+      @w = 0
+      @h = 0
+      @draw_list = nil
+    end
+
+    private :setup
+
+    #===インスタンス生成
+    #スプライトをファイルや画像サイズから生成します。
+    #
+    #v1.5以前は、ファイルからスプライトを生成するときは、ファイル名で画像が共有されていましたが、
+    #v2.0では廃止されました。
+    #
+    #_param_:: 各種設定(ハッシュ引数。詳細は後述)
+    #返却値:: 生成したインスタンス
+    #
+    #<引数の内容>
+    #* 1.画像の元データ(括弧内は省略形)。以下の３種類のどれかを必ず指定する。
+    #  * 画像ファイル(ファイル名)から生成。　(書式):filename(:file)=>画像ファイル名　(例):file=>"image.png"
+    #  * 画像サイズ(2要素の整数の配列もしくはSize構造体)から生成。　(書式1):size=>２要素の配列((例):size=>[100,100])　(書式2):size=>Size構造体((例):size=>Size.new(100,100))
+    #  * SDL::Surfaceクラスのインスタンスから生成。　(書式):bitmap(:bmp)=>SDL::Surfaceクラスのインスタンス((例):bmp=>@surface)
+    #  * SpriteUnit構造体のインスタンスから生成(ビットマップ以外のUnitの値は引き継がれる。しかし、snapの親子関係は引き継がれない)。
+    #　(書式):unit=>SpriteUnit構造体のインスタンス((例):unit=>@spr.to_unit)
+    #* 2.透過設定(括弧内は省略形)。以下の３種類のどれかを必ず指定する。
+    #  * カラーキーによる透過は行わない方式(デフォルトの方式)　(書式):type=>:alpha_surface(:as)
+    #  * カラーキーの指定。　(書式):type=>:color_key(:ck)　カラーキー指定の方法は以下のとおり
+    #    * 透明色にするピクセルの位置(2要素の整数の配列、Point構造体)　(書式1):point=>２要素の配列((例):type=>:ck, :point=>[20,20])　(書式2):point=>Point構造体((例):type=>:ck, :point=>Point.new(20,20))
+    #    * 色を直接指定　(書式):tr_color=>色情報(Color.to_rgbメソッドで生成できるパラメータ)((例1):type=>:ck, :tr_color=>[255,0,255] # 紫色を透明色に　(例2):type=>:ck, :tr_color=>:red # 赤色を透明色に)
+    #    * デフォルト：画像の[0,0]の位置にあるピクセルの色
+    #* 3. αチャネル付き画像を使用(設定変更不可)　(書式):type=>:alpha_channel(:ac)
+    def initialize(param)
+      raise MiyakoError, "Sprite parameter is not Hash!" unless param.kind_of?(Hash)
+      setup
+      init_layout
+
+      bitmap = nil
+      @tr_color = nil
+
+      param[:type] ||= :color_key
+      param[:type] = @@abb[param[:type]] if @@abb.has_key?(param[:type])
+      param[:point]  ||= Point.new(0, 0)
+      param[:tr_color]  ||= Color[:black]
+      param[:is_fill] ||= false
+      
+      if param.has_key?(:bitmap) || param.has_key?(:bmp)
+        bitmap = param[:bitmap] || param[:bmp]
+      elsif param.has_key?(:size)
+        bitmap = Bitmap.create(*(param[:size].to_a))
+        param[:is_fill] = true
+      elsif param.has_key?(:filename) || param.has_key?(:file)
+        bitmap = Bitmap.load(param[:filename] || param[:file])
+      elsif param.has_key?(:unit)
+        bitmap = param[:unit].bitmap
+      else
+        raise MiyakoError, "Illegal Sprite parameter!"
+      end
+
+      case param[:type]
+      when :color_key
+        if param.has_key?(:point)
+          @tr_color = Color.to_rgb(bitmap.get_rgb(bitmap.getPixel(*(param[:point].to_a))))
+        else
+          @tr_color = Color.to_rgb(param[:tr_color])
+        end
+        # カラーキーのα値を0にしたビットマップを作成
+        tbitmap = bitmap.display_format
+        tunit   = SpriteUnitFactory.create(:bitmap => tbitmap)
+        bitmap  = Bitmap.create(bitmap.w, bitmap.h, SDL::HWSURFACE)
+        bitmap  = bitmap.display_format_alpha
+        nunit = SpriteUnitFactory.create(:bitmap => bitmap)
+        Bitmap.ck_to_ac!(tunit, nunit, @tr_color)
+        self.bitmap = bitmap
+        @unit.bitmap.fill_rect(0,0,@unit.bitmap.w,@unit.bitmap.h,[0, 0, 0, 0]) if param[:is_fill]
+        tbitmap = nil
+      when :alpha_surface
+        # カラーキーのα値を0にしたビットマップを作成
+        tbitmap = bitmap.display_format
+        tunit   = SpriteUnitFactory.create(:bitmap => tbitmap)
+        bitmap  = Bitmap.create(bitmap.w, bitmap.h, SDL::HWSURFACE)
+        bitmap  = bitmap.display_format_alpha
+        nunit = SpriteUnitFactory.create(:bitmap => bitmap)
+        Bitmap.normal_to_ac!(tunit, nunit)
+        self.bitmap = bitmap
+        @unit.bitmap.fill_rect(0,0,@unit.bitmap.w,@unit.bitmap.h,[0, 0, 0, 0]) if param[:is_fill]
+        tbitmap = nil
+      when :alpha_channel
+        self.bitmap = bitmap.display_format_alpha
+        @unit.bitmap.fill_rect(0,0,@unit.bitmap.w,@unit.bitmap.h,[0, 0, 0, 0]) if param[:is_fill]
+      when :movie
+        self.bitmap = bitmap.display_format
+      end
+      @type = param[:type]
+
+      if param.has_key?(:unit)
+        SpriteUnitFactory.apply(@unit, :ow=>param[:unit].ow, :oh=>param[:unit].oh,
+                                       :angle => param[:unit].angle,
+                                       :xscale => param[:unit].xscale, :yscale => param[:unit].yscale,
+                                       :cx => param[:unit].cx, :cy => param[:unit].cy)
+        self.move_to(param[:unit].x, param[:unit].y)
+      end
+    end
+
+    def_delegators(:@unit, :ox, :oy, :ow, :oh, :x, :y)
+
+    def update_layout_position #:nodoc:
+      @unit.move_to(*@layout.pos)
+    end
+
+    #===画像の幅を取得する
+    #返却値:: 画像の幅(ピクセル)
+    def w
+      return @unit.bitmap.w
+    end
+
+    #===画像の高さを取得する
+    #返却値:: 画像の高さ(ピクセル)
+    def h
+      return @unit.bitmap.h
+    end
+
+    def bitmap #:nodoc:
+      return @unit.bitmap
+    end
+
+    def bitmap=(bmp) #:nodoc:
+      @unit.bitmap = bmp
+      @unit.ow = @unit.bitmap.w
+      @unit.oh = @unit.bitmap.h
+      @w = @unit.bitmap.w
+      @h = @unit.bitmap.h
+      set_layout_size(@unit.ow, @unit.oh)
+    end
+
+    #===画像全体を指定の色で塗りつぶす
+    #_color_:: 塗りつぶす色。Color.to_rgbメソッドのパラメータでの指定が可能
+    #返却値:: 自分自身を返す
+    def fill(color)
+      @unit.bitmap.fill_rect(0,0,self.w,self.h,Color.to_rgb(color))
+      return self
+    end
+
+    #===画像の表示開始位置(X座標)を指定する
+    #oxを指定すると、表示の左上位置が変更される。
+    #_v_:: 表示開始位置。整数で指定
+    def ox=(v)
+      @unit.ox = v
+    end
+    
+    #===画像の表示開始位置(Y座標)を指定する
+    #oyを指定すると、表示の左上位置が変更される。
+    #_v_:: 表示開始位置。整数で指定
+    def oy=(v)
+      @unit.oy = v
+    end
+    
+    #===画像の表示幅を指定する
+    #owを指定すると、横方向の一部のみ表示される。
+    #_v_:: 表示幅。整数で指定
+    def ow=(v)
+      @unit.ow = v
+      set_layout_size(v, @unit.oh)
+    end
+
+    #===画像の表示高を指定する
+    #ohを指定すると、縦方向の一部のみ表示される。
+    #_v_:: 表示高。整数で指定
+    def oh=(v)
+      @unit.oh = v
+      set_layout_size(@unit.ow, v)
+    end
+
+    #===画像の回転角度を取得する
+    #値はラジアン。範囲は0<=angle<PI*2
+    #値が正の時は右回りに回転する。
+    #返却値:: 回転角度。ラジアン(実数)
+    def angle
+      return @unit.angle
+    end
+
+    #===画像の回転角度を設定する
+    #値はラジアン。範囲は0<=angle<PI*2
+    #値が正の時は右回りに回転する。
+    #_radian_:: 回転角度。ラジアン(実数)を指定
+    def angle=(radian)
+      raise MiyakoError, "Illegal radian! : #{radian}" if (radian < 0.0 || radian > Math::PI * 2)
+      @unit.angle = radian
+    end
+
+    #===画像の拡大縮小度を取得する
+    #x方向の拡大縮小度を取得する
+    #返却値:: 拡大縮小度。1.0で等倍。-1.0でミラー反転
+    def xscale
+      return @unit.xscale
+    end
+
+    #===画像の拡大縮小度を設定する
+    #x方向の拡大縮小度を設定する
+    #_scale_:: 拡大縮小度。1.0で等倍。-1.0でミラー反転
+    def xscale=(scale)
+      @unit.xscale = scale
+    end
+
+    #===画像の拡大縮小度を取得する
+    #y方向の拡大縮小度を取得する
+    #返却値:: 拡大縮小度。1.0で等倍。-1.0でミラー反転
+    def yscale
+      return @unit.yscale
+    end
+
+    #===画像の拡大縮小度を設定する
+    #y方向の拡大縮小度を設定する
+    #_scale_:: 拡大縮小度。1.0で等倍。-1.0でミラー反転
+    def yscale=(scale)
+      @unit.yscale = scale
+    end
+
+    #===画像の回転・拡大・縮小の中心座標を取得する
+    #x方向の中心座標を取得する
+    #返却値:: 中心座標。
+    def center_x
+      return @unit.cx
+    end
+
+    #===画像の回転・拡大・縮小の中心座標を取得する
+    #x方向の中心座標を取得する
+    #_pos_:: 中心座標
+    def center_x=(pos)
+      @unit.cx = pos
+    end
+
+    #===画像の回転・拡大・縮小の中心座標を取得する
+    #y方向の中心座標を取得する
+    #返却値:: 中心座標。
+    def center_y
+      return @unit.cy
+    end
+
+    #===画像の回転・拡大・縮小の中心座標を取得する
+    #y方向の中心座標を取得する
+    #_pos_:: 中心座標
+    def center_y=(pos)
+      @unit.cy = pos
+    end
+
+    #===画像の表示矩形を取得する
+    #画像が表示されているときの矩形を取得する。矩形は、[x,y,ow,oh]で取得する。
+    #返却値:: 生成された矩形
+    def rect
+      return Rect.new(@unit.x, @unit.y, @unit.ow, @unit.oh)
+    end
+
+    #===現在の画面の最大の大きさを矩形で取得する
+    #但し、Spriteの場合は最大の大きさ=スプライトの大きさなので、rectと同じ値が得られる
+    #返却値:: 画像の大きさ(Rect構造体のインスタンス)
+    def broad_rect
+      return self.rect
+    end
+
+    def update  #:nodoc:
+      @update.call(self) if @update
+      yield self if block_given?
+      return self
+    end
+
+    def update=(u) #:nodoc:
+      @update = u
+    end
+
+    #===画像を解放する
+    #内部で使用しているデータをインスタンスから解放する
+    def dispose
+      layout_dispose
+      @unit.bitmap = nil
+      @unit = nil
+    end
+
+    #===インスタンスをSpriteUnit構造体に変換して取得する
+    #返却値:: SpriteUnit化したスプライト
+    def to_unit
+      return @unit.dup
+    end
+
+    #===インスタンスをスプライト化して返す
+    #インスタンスの複製を行う(画像インスタンスも複製)
+    #注意事項：
+    #１．複製のため、呼び出していくとメモリ使用量が著しく上がる
+    #２．レイアウト情報がリセットされる(snapの親子関係が解消される)
+    #返却値:: 自分自身を返す
+    def to_sprite
+      unit = @unit.dup
+      unit.bitmap = Bitmap.create(unit.bitmap.w, unit.bitmap.h)
+      Bitmap.blit_aa!(@unit, unit, 0, 0)
+      return Sprite.new(:unit=>unit, :type=>:ac)
+    end
+  end
+end