root/lang/ruby/starframe/lib/starframe/sprite/collection.rb @ 27855

require "starframe/eventable"
require "starframe/updatable"

module StarFrame #:nodoc:
  class Sprite
    # = コレクション所属モジュール
    # コレクションに所属できるようにするモジュール。
    # 
    # Sprite::Collectionをロードした場合、Spriteに自動的にインクルードされる。
    module Collectable
      # 現在所属しているコレクション。
      attr_reader :collection
      # 新たなコレクションに所属させる。
      # 
      # 所属していたコレクションからは自動的に削除される。
      def collection= collection
        collection.add self
      end
      
      # 所属しているコレクションから自分を削除する。
      def vanish
        return unless @collection
        @collection.delete self
        @collection = nil
      ensure
        return self
      end
    end
    include Collectable
    
    # = コレクション
    # 複数のスプライトをまとめて管理することができるようになるコレクションクラス。
    # 
    # このクラスをロードした場合、SpriteクラスにSprite::Collectableが自動的にインクルードされる。
    class Collection
      include Enumerable
      include Eventable
      
      #:stopdoc:
      protected
      attr_reader :sprites
      
      def initialize #:nodoc:
        @sprites = []
      end
      #:startdoc:
      
      public
      # スプライトを所属させる。
      # 
      # そのスプライトが所属していたコレクションからは自動的に削除される。
      def add sprite
        defect_collection = sprite.collection
        defect_collection.sprites.delete sprite if defect_collection
        
        @sprites << sprite
        sprite.instance_variable_set :@collection, self
        self
      end
      alias << add
      
      # スプライトを所属から外す。
      def delete sprite
        @sprites.delete sprite
        sprite.instance_variable_set :@collection, nil
        self
      end
      
      # 所属している全てのスプライトに対してブロックを評価する。
      def each &block
        @sprites.each &block
        self
      end
      
      # 所属しているスプライトの数を取得する。
      def size
        @sprites.size
      end
      
      # 所属している全てのスプライトの更新時イベントをコールする。
      def update
        @sprites.each &:update
        self
      end
      # 所属している全てのスプライトの更新時イベントをコールする。
      def render
        @sprites.each &:call_render
        self
      end
      
      # 所属している全てのスプライトをtextureに描画する。
      def render_to texture
        @sprites.each{ |sprite| sprite.render_to texture }
        self
      end
    end
  end
end