panda_canvas 0.2.0 → 0.3.0

data/lib/panda_canvas.rb

@@ -3,34 +3,26 @@ $:.unshift(libdir) unless $:.include?(libdir)
 
 require 'texplay'
 require 'panda_canvas/canvas'
+require 'panda_canvas/clean_room'
 
+# Panda Canvas is an educational 2D drawing canvas.
 module PandaCanvas
 
   class << self
 
+    # Reader for the Canvas instance.
+    # Used to access the underlying TexPlay image.
     attr_reader :canvas
 
+    # Takes a +block+ with drawing code.
+    # The code is then drawn in a window with dimensions +width+ and +height+.
     def draw(width=640, height=480, &block)
-      @canvas = Canvas.new(width, height, Fiber.new(&block))
+      clean_room = CleanRoom.new
+      clean_room.instance_eval(&block)
+      @canvas = Canvas.new(width, height, clean_room.calls)
       @canvas.show
     end
 
   end # class << self
 
-end # PandaCanvas
-
-def method_missing(sym, *args)
-  found = false
-  if PandaCanvas.canvas
-    @panda_canvas_image ||= PandaCanvas.canvas.image
-    if @panda_canvas_image.respond_to? sym
-      pci = @panda_canvas_image
-      self.class.instance_eval do
-        define_method(sym) {|*args| pci.send sym, *args }
-      end
-      self.send sym, *args
-      found = true
-    end
-  end
-  super(sym, *args) unless found
-end
+end # PandaCanvas

data/lib/panda_canvas/canvas.rb

@@ -1,25 +1,35 @@
-require 'texplay'
-require 'fiber'
-
 module PandaCanvas
 
+  # Canvas is a subclassed Gosu::Window that is used for drawing.
   class Canvas < Gosu::Window
 
+    # TexPlay image, which is drawn in the window.
     attr_reader :image
 
-    def initialize(width, height, fiber)
+    # Creates a new canvas window with dimensions +width+ and +height+.
+    # A list of +calls+ in the form
+    #  [:method, *args]
+    # is passed to be executed.
+    def initialize(width, height, calls)
       super(width, height, false)
       self.caption = 'Panda Canvas'
       @image = TexPlay.create_image(self, width, height)
-      @fiber = fiber
+      @calls = calls
     end
 
+    # Draws the image in memory.
     def draw
       @image.draw(0, 0, 0)
     end
 
+    # Runs a range of commands until the next flush.
     def update
-      @fiber.resume if @fiber.alive?
+      unless @calls.empty?
+        @calls.slice!(0...@calls.index(CleanRoom::FLUSH_SIGNATURE)).each do |call|
+          @image.send call[0], *call[1..-1]
+        end
+        @calls.shift
+      end
     end
 
   end # Canvas

data/lib/panda_canvas/clean_room.rb

@@ -0,0 +1,32 @@
+module PandaCanvas
+
+  # CleanRoom is used to capture and store method calls for delayed execution.
+  class CleanRoom
+
+    # Signature for the +flush+ method.
+    # This method is used to stop calculation and draw the frame.
+    FLUSH_SIGNATURE = [:flush].freeze
+
+    # Returns an array of captured method calls.
+    # A +flush+ is appended at the end.
+    def calls
+      @calls + [FLUSH_SIGNATURE]
+    end
+
+    # Initializes the clean object for method call capturing.
+    def initialize
+      @calls = []
+    end
+
+    # Capures and stores all missing method calls in the instance.
+    def method_missing(sym, *args)
+      if sym == :flush
+        @calls << FLUSH_SIGNATURE
+      else
+        @calls << [sym, *args]
+      end
+    end
+
+  end # CleanRoom
+
+end # PandaCanvas

data/lib/panda_canvas/version.rb

@@ -1,6 +1,6 @@
 class PandaCanvas
 
   # PandaCanvas version.
-  VERSION = '0.2.0'
+  VERSION = '0.3.0'
 
 end # end PandaCanvas

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 2
+  - 3
   - 0
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors: 
 - Dimitry Solovyov
@@ -57,6 +57,7 @@ extra_rdoc_files: []
 
 files: 
 - lib/panda_canvas/canvas.rb
+- lib/panda_canvas/clean_room.rb
 - lib/panda_canvas/version.rb
 - lib/panda_canvas.rb
 - LICENSE