texplay 0.2.0

data/examples/common.rb

@@ -0,0 +1,8 @@
+$LOAD_PATH.push(File.dirname(__FILE__) + '/../lib/')
+
+require 'rubygems'
+require 'texplay'
+
+module Common
+    MEDIA = File.dirname(__FILE__) + '/media'
+end

data/examples/example_alpha_blend.rb

@@ -0,0 +1,31 @@
+require 'rubygems'
+require 'common'
+require 'texplay'
+
+
+class W < Gosu::Window
+    def initialize
+        super(1024, 769, false, 20)
+        @img = Gosu::Image.new(self, "#{Common::MEDIA}/empty2.png")
+        @tp = Gosu::Image.new(self, "#{Common::MEDIA}/texplay.png")
+
+        # put a border on the image
+        @img.rect 0,0, @img.width - 1, @img.height - 1
+
+        @img.rect 1, 1, @img.width - 2, @img.height - 2, :fill => true, :texture => @tp
+
+        # NOTE: the current implementation of alpha blending is a bit tempermental, i need to think it
+        # through a bit more...
+        @img.rect 100, 100, 300, 300, :color => [1, 1, 1, 0.8], :alpha_blend => true, :fill => true
+    end
+    
+    def draw
+        @img.draw 100, 50,1
+    end
+    
+end
+
+
+w = W.new
+w.show
+        

data/examples/example_bezier.rb

@@ -0,0 +1,51 @@
+require 'rubygems'
+require 'common'
+require 'texplay'
+
+
+class W < Gosu::Window
+    def initialize
+        super(1024, 769, false, 20)
+        @img = Gosu::Image.new(self, "#{Common::MEDIA}/empty2.png")
+
+        # put a border on the image
+        @img.rect 0,0, @img.width - 1, @img.height - 1
+
+        points = []
+
+        # NOTE: TexPlay also accepts points. a 'point' is any object that responds to 'x' or 'y'
+        # NOTE: current maximum points for a bezier is 13
+        (0..@img.width + 100).step(50) { |x|
+            p = TexPlay::TPPoint.new
+            p.x = x
+            p.y = @img.height * rand
+
+            points << p
+        }
+
+        @img.move_to(points.first.x, points.first.y)
+
+        # making the bezier more interesting by using turtle graphics :) (a rough bezier)
+        @img.bezier points, :color => :red, :color_control => proc { |c, x, y|
+            if((x % 10) == 0) then
+                @img.line_to(x, y + rand * 20 - 10)
+            end
+            :none
+        }
+
+        #@img.fill 100, 400, :color => :yellow
+        
+        # NOTE: can 'close' a bezier curve too (as with polylines)
+    end
+    
+    def draw
+
+        @img.draw 100, 50,1
+    end
+    
+end
+
+
+w = W.new
+w.show
+        

data/examples/example_color_control.rb

@@ -0,0 +1,68 @@
+require 'rubygems'
+require 'common'
+require 'texplay'
+
+class W < Gosu::Window
+    def initialize
+        super(1024, 769, false, 20)
+        @img = Gosu::Image.new(self, "#{Common::MEDIA}/empty2.png")
+        @tp = Gosu::Image.new(self, "#{Common::MEDIA}/texplay.png")
+        @gosu = Gosu::Image.new(self, "#{Common::MEDIA}/gosu.png")
+
+        # put a border on the image
+        @img.rect 0,0, @img.width - 1, @img.height - 1
+
+        # When using color_control the pixel the draw action is currently manipulating is yielded
+        # to the proc. This gives you pixel-level control over the drawing.
+        # (NOTE: the return value of the proc is used as the pixel color, so it should be a 4 element array or
+        # a valid color symbol)
+        
+        # color_control accepts procs of 4 types:
+        # arity of 1: just the destination pixel color is yielded
+        # arity of 2: both the destination and the source pixel colors are yielded (in that order)
+        # arity of 3: the destination pixel color is yielded along with the x and y coords of the current pixel
+        # arity of 4: both the destination and the source pixel colours are yielded as well as the x and y vals
+
+        # just drawing an area to fill
+        @img.polyline [30, 30, 100, 100, 200, 76, 300, 9, 50, 200], :color => :random, :closed => true
+
+        # below we are 'faking' a texture fill using color_control
+        @img.fill 42, 70, :color_control => proc { |c, x, y|
+            @tp.get_pixel(x % @tp.width, y % @tp.height)
+        }
+
+        # merging two images together
+        @img.rect 100, 200, 400, 300, :fill => true, :texture => @gosu,
+        :color_control => proc { |c1, c2, x, y|
+            c1 = @tp.get_pixel(x % @tp.width, y % @tp.height)
+            c1[0] = (c1[0] + c2[0]) / 2
+            c1[1] = (c1[1] + c2[1]) / 2
+            c1[2] = (c1[2] + c2[2]) / 2
+            c1[3] = 1
+            c1
+        }
+
+        # we can even use color_control just for the use of the (x, y) values.
+        # here we simply use the x, y values to make our own circle with a rough edge
+        @img.circle 200,400, 70,
+        :color_control => proc { |c,x,y|
+            @img.pixel(x + (rand(4) - 2), y + (rand(4) - 2)) 
+            :none   # this ensures that the 'actual' circle isn't drawn, instead its coordinates are
+                    # simply utilized to draw a ragged edge of another circle (using @img.pixel)
+        }
+
+        # this just fills a rect with random colours
+        @img.rect 400, 400, 470, 470, :fill => true, :color_control => proc { |c| :rand }
+    end
+
+    def draw
+
+        @img.draw 100, 50,1
+    end
+    
+end
+
+
+w = W.new
+w.show
+        

data/examples/example_color_transform.rb

@@ -0,0 +1,29 @@
+require 'rubygems'
+require 'common'
+require 'gosu'
+require 'texplay'
+
+
+class W < Gosu::Window
+    def initialize
+        super(1024, 769, false, 20)
+        @img = Gosu::Image.new(self, "#{Common::MEDIA}/sunset.png")
+    end
+    
+    def draw
+        x = (@img.width - 100/2) * rand 
+        y = (@img.height - 100/2) * rand 
+
+        @img.rect x, y, x + 50, y + 50, :fill => true, :color_control => { :mult => [0.9 , 0.3, 0.3, 1] }
+
+        
+
+        @img.draw 100, 50,1
+    end
+    
+end
+
+
+w = W.new
+w.show
+        

data/examples/example_dup.rb

@@ -0,0 +1,52 @@
+require 'rubygems'
+require 'common'
+require 'gosu'
+require 'texplay'
+
+
+class W < Gosu::Window
+    def initialize
+        super(1024, 769, false, 20)
+        @img = Gosu::Image.new(self, "#{Common::MEDIA}/sunset.png")
+        @img.rect 0,0, @img.width - 1, @img.height - 1
+
+        # testing Gosu::Image#dup
+        # adding an ivar
+        @img.instance_variable_set(:@horse, :love)
+
+        # adding a method on the singleton
+        class << @img
+            def little
+                :little
+            end
+        end
+        
+        # clone the image.
+        # NB #clone also copies singleton
+        @bunk = @img.clone
+
+        # should output :love
+        puts @bunk.instance_variable_get(:@horse)
+
+        # should output :little
+        puts @bunk.little
+
+        # add a red line to the copy to identify it
+        @bunk.line 0, 0, 1024, 1024, :color => :red
+
+    end
+    
+    def draw
+        x = @img.width * rand
+        y = @img.height * rand
+
+        @img.draw 100, 50,1
+        @bunk.draw 500, 300,1
+    end
+    
+end
+
+
+w = W.new
+w.show
+        

data/examples/example_each.rb

@@ -0,0 +1,42 @@
+require 'rubygems'
+require 'common'
+require 'gosu'
+require 'texplay'
+
+
+class W < Gosu::Window
+    def initialize
+        super(1024, 769, false, 20)
+        @img = Gosu::Image.new(self, "#{Common::MEDIA}/sunset.png")
+
+        # each can accept a block of two types of arity:
+        # arity 1 - yields just the pixel color
+        # arity 3 - yield the pixel color, and the x and y
+
+        # max out the blue component of every pixel
+        @img.each { |v| v[2] = 1 }
+
+        # a gradient from 0 red to 1 red
+        @img.each(:region => [100, 100, 200, 200]) do |c, x, y|
+            c[0] = (x - 100) / 100.0
+        end
+
+        # another gradient, this time blocking out everything except red (and alpha)
+        @img.each(:region => [100, 250, 200, 350]) do |c, x, y|
+            c[0] = (x - 100) / 100.0
+            c[1] = 0
+            c[2] = 0
+        end
+    end
+    
+    def draw
+    
+        @img.draw 100, 50,1
+    end
+    
+end
+
+
+w = W.new
+w.show
+        

data/examples/example_effect.rb

@@ -0,0 +1,35 @@
+require 'rubygems'
+require 'common'
+require 'texplay'
+
+
+class W < Gosu::Window
+    def initialize
+        super(1024, 769, false, 20)
+        @img = Gosu::Image.new(self, "#{Common::MEDIA}/empty2.png")
+
+        # put a border on the image
+        @img.rect 0,0, @img.width - 1, @img.height - 1
+
+        @length = 0
+    end
+    
+    def draw
+
+        # quite a cool effect, very slow of course, because it's using turtle and fill
+        @img.paint { 
+            forward(@length, true, :color => :red)
+            turn(170)
+            @length += 5
+            fill (@img.width * rand), (@img.height * rand), :color => :random, :glow => true
+        }
+
+        @img.draw 100, 50,1
+    end
+    
+end
+
+
+w = W.new
+w.show
+

data/examples/example_fill.rb

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'common'
+require 'texplay'
+
+
+class W < Gosu::Window
+    def initialize
+        super(1024, 768, false, 20)
+        @img = TexPlay::create_blank_image(self, 1000, 1000)
+        #        @img = Gosu::Image.new(self, "#{Common::MEDIA}/empty2.png")
+        @tp = Gosu::Image.new(self, "#{Common::MEDIA}/maria.png")
+        @gosu = Gosu::Image.new(self, "#{Common::MEDIA}/sand1.png")
+
+        points = []
+
+        # NOTE: TexPlay also accepts points. a 'point' is any object that responds to 'x' or y
+        # NOTE: current maximum points for a bezier is 13
+        (0..@img.width + 90).step(85) { |x|
+            p = TexPlay::TPPoint.new
+            p.x = x
+            p.y = @img.height * rand
+
+            points << p
+        }
+
+        @img.bezier points
+
+
+        # NOTE: the :texture hash argument works on ALL drawing actions; not just fills
+        @img.fill 300, 400, :color => :red, :texture => @gosu
+#        @img.circle 300, 400, 40
+
+        # let's demonstrate by drawing a circle using the gosu.png texture
+        # NOTE: :texture even works on lines, boxes, polylines, beziers etc. 
+        @img.circle 400, 50, 40, :fill => true, :texture => @tp
+        
+    end
+    
+    def draw
+
+        @img.draw 10, 10,1
+    end
+    
+end
+
+
+w = W.new
+w.show
+        

data/examples/example_fill_old.rb

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'common'
+require 'texplay'
+
+class W < Gosu::Window
+    def initialize
+        super(1024, 769, false, 20)
+        @img = Gosu::Image.new(self, "#{Common::MEDIA}/empty2.png")
+        @tp = Gosu::Image.new(self, "#{Common::MEDIA}/texplay.png")
+        @gosu = Gosu::Image.new(self, "#{Common::MEDIA}/gosu.png")
+
+        # put a border on the image
+        @img.rect 0,0, @img.width - 1, @img.height - 1
+
+        points = []
+
+        # NOTE: TexPlay also accepts points. a 'point' is any object that responds to 'x' or 'y'
+        # NOTE: current maximum points for a bezier is 13
+        (0..@img.width).step(50) { |x|
+            p = TexPlay::TPPoint.new
+            p.x = x
+            p.y = @img.height * rand
+
+            points << p
+        }
+
+        @img.bezier points, :color => :white
+
+
+        # NOTE: the :texture hash argument works on ALL drawing actions; not just fills
+        @img.fill 300, 480, :texture => @tp
+
+        # let's demonstrate by drawing a circle using the gosu.png texture
+        # NOTE: :texture even works on lines, boxes, polylines, beziers etc. 
+        @img.circle 400, 50, 40, :fill => true, :texture => @gosu
+        
+    end
+    
+    def draw
+
+        @img.draw 100, 50,1
+    end
+    
+end
+
+
+w = W.new
+w.show
+        

data/examples/example_fluent.rb

@@ -0,0 +1,31 @@
+require 'rubygems'
+require 'common'
+require 'gosu'
+require 'texplay'
+
+class W < Gosu::Window
+    def initialize
+        super(1024, 769, false, 20)
+        @img = Gosu::Image.new(self, "#{Common::MEDIA}/sunset.png")
+        @img.rect 0,0, @img.width - 1, @img.height - 1
+
+        # test the fluent interface
+        @img.
+            line(0, 0, 1024, 1024).
+            circle(20, 20, 50).
+            rect 30, 30, 100, 100
+    end
+    
+    def draw
+        x = @img.width * rand
+        y = @img.height * rand
+        
+        @img.draw 100, 50,1
+    end
+    
+end
+
+
+w = W.new
+w.show
+