banister-texplay 0.2.0

data/CHANGELOG

@@ -0,0 +1,63 @@
+31/8/09
+version 0.2.0
+* added each iterator
+* added alternative to proc for :color_control proc (allowing static linear transforms to pixels)
+* no longer segfaulting on windows (no idea why not)
+* rewrote EmptyImageStub in ruby, using philomory's code. now alot faster.
+* implemented 'shadow' in terms of static :color_control pixel transform
+* added more example code demonstrating each iterator (example_each.rb) and new color_control behaviour
+  i.e example_color_transform.rb
+* should be relatively stable now! 
+
+28/8/09
+version 0.1.9.1 (still BETA)
+* experimental features: Gosu::Image#dup and Gosu::Image#clone
+* also TexPlay::create_blank_image(window, width, height)
+* I noticed these features SEG FAULT on my setup in windows, so be warned
+* This is a BETA release
+
+14/8/09
+version 0.1.9.0 (BETA)
+* major rewrite. TP now supports beziers, polylines, polygons, and more
+* also supports alpha_blending (though still tempermental)
+* This is a BETA release
+
+1/7/09
+version 0.1.6.2
+* fixed another subtle bug in constrain_local_boundaries(). Function was 
+unable to deal with drawing actions that were 100% outside the image 
+boundaries.
+
+28/6/09
+version 0.1.6
+* gen_eval now working as a replacement for instance_eval in the #paint block. Allows for more user-friendly interface.
+* #paint can now be called without a block; if invoked this way it executes any commands in the action queue, e.g
+  @img.circle 20, 20, 40
+  @img.pixel 30, 30
+  @img.paint
+* above will function as if: @img.paint { circle 20, 20, 40; pixel 30, 30 }
+* collected 1.8.6/1.9.1 compatibility into compat.h
+
+16/6/09
+version 0.1.4.6
+* allowed arity of 0 (as well as -1) for ruby 1.9 compatibility
+
+13/6/09
+version 0.1.4.5
+* major bugfix with TexPlay#splice method (segfaut). Also added new color format parameter: color [1, 1, 0, 1] (e.g purple with full alpha).
+Also fixed subtle edge-case bug in constrain_local_boundaries().
+
+9/6/09
+version 0.1.4
+* improved error checking. should work better with later gosu releases
+
+20/2/09 
+version 0.1.1
+* rerelease of this version fixing the oversized image bug for refresh_cache (i.e images over 500 x 500
+
+version 0.1.1
+* oops, bug in leftshift/rightshift functions, fixed!
+
+version 0.1.0
+* release!
+

data/README

@@ -0,0 +1,21 @@
+INSTRUCTIONS 
+
+TexPlay version 0.2.0
+
+To compile TexPlay, ensure you are in the directory with the Rakefile and type:
+=> rake
+OR
+=> rake19  (assuming this is the name of your 1.9.1 version of rake)
+
+!!NB!! be sure to run the version of rake that corresponds to the ruby version you wish to use! on my system I use rake19 for ruby 1.9.1!!
+
+If all goes well, run the example programs:
+=> cd examples
+=> ruby example_melt.rb
+=> ruby example_simple.rb
+=> ..etc
+
+*like any gosu application, gosu.so must be in the current directory (or the gosu gem installed) when running the examples.
+
+Enjoy!
+(note that TexPlay has only been tested on 32 bit linux systems and WindowsXP using VS 6.0)

data/README1st

@@ -0,0 +1,9 @@
+INSTRUCTIONS
+
+TexPlay version 0.2.0
+
+*Ensure that ctexplay.so and gosu.so, and texplay.rb and texplay-contrib.rb are in the working directory for your project
+*require 'texplay' in your ruby program to access the TexPlay module
+*see example programs, for illustration of use
+
+

data/Rakefile

@@ -0,0 +1,84 @@
+require 'rake/clean'
+require 'rake/gempackagetask'
+
+$dlext = Config::CONFIG['DLEXT']
+
+CLEAN.include("src/*.#{$dlext}", "src/*.log", "src/*.o", "src/*~", "src/*#*", "src/*.obj", "src/*.def", "src/*.pdb")
+CLOBBER.include("**/*.#{$dlext}", "**/*~", "**/*#*", "**/*.log", "**/*.o")
+
+$make_program = if RUBY_PLATFORM =~ /win/ 
+                    "nmake"
+                else
+                    "make"
+                end
+
+task :default => [:build]
+
+desc "Build TexPlay"
+task :build => :clean do
+    puts "(2) building Makefile..."
+    chdir("./src/") do
+        ruby "extconf.rb"
+        puts "(3) building ctexplay.#{$dlext}..."
+        sh "#{$make_program}"
+        puts "(4) copying ctexplay.#{$dlext} to current directory..."
+        cp "ctexplay.#{$dlext}", "../lib" , :verbose => true
+
+        if RUBY_PLATFORM =~ /mswin/
+            if RUBY_VERSION =~ /1.9/
+                File.rename("../lib/ctexplay.#{dlext}", "../lib/ctexplay19.#{$dlext}")
+            else
+                File.rename("../lib/ctexplay.#{dlext}", "../lib/ctexplay18.#{$dlext}")
+            end
+        end
+        puts "(5) ...done!"
+    end
+end
+
+specification = Gem::Specification.new do |s|
+    s.name = "texplay"
+    s.summary = "TexPlay is a light-weight image manipulation framework for Ruby and Gosu"
+    s.version = "0.2.0"
+    s.date = "2009-09-02"
+    s.author = "John Mair (banisterfiend)"
+    s.email = 'jrmair@gmail.com'
+    s.description = s.summary
+    s.require_path = 'lib'
+    s.homepage = "http://banisterfiend.wordpress.com/2008/08/23/texplay-an-image-manipulation-tool-for-ruby-and-gosu/"
+    s.has_rdoc = false
+    s.files =  ["Rakefile", "README", "CHANGELOG", "README1st",
+                "lib/texplay.rb", "lib/texplay-contrib.rb"] +
+        FileList["src/*", "examples/*.rb", "examples/media/*"].to_a 
+
+    if RUBY_PLATFORM =~ /mswin/
+        s.platform = Gem::Platform::WIN32
+        s.files += ["lib/ctexplay18.so", "lib/ctexplay19.so"]
+        
+    else
+        s.platform = Gem::Platform::RUBY
+        s.extensions = ["src/extconf.rb"]
+    end
+end
+Rake::GemPackageTask.new(specification) do |package|
+    package.need_zip = false
+    package.need_tar = false
+end
+
+SELENE = '/home/john/ruby/projects/selene'
+desc "update selene's version of texplay"
+task :selene => ["#{SELENE}/lib/texplay.rb", "#{SELENE}/lib/texplay-contrib.rb",
+              "#{SELENE}/lib/ctexplay.so"] do
+    puts "...done!"
+end
+
+file "#{SELENE}/lib/texplay.rb" => "texplay.rb" do |t|
+    cp t.prerequisites.first, t.name, :verbose => true
+end
+
+file "#{SELENE}/lib/texplay-contrib.rb" => "texplay-contrib.rb" do |t|
+    cp t.prerequisites.first, t.name, :verbose => true
+end
+
+file "#{SELENE}/lib/ctexplay.#{$dlext}" => "ctexplay.#{$dlext}" do |t|
+    cp t.prerequisites.first, t.name, :verbose => true
+end

data/lib/texplay-contrib.rb

@@ -0,0 +1,77 @@
+begin
+    require 'rubygems'
+rescue LoadError
+end
+
+require 'texplay'
+
+# setup will be executed straight after Gosu::Image instantiation
+TexPlay.on_setup do
+    @turtle_pos = TexPlay::TPPoint.new(width / 2, height / 2 )
+    @turtle_angle = 0
+end
+
+TexPlay.create_macro(:move_to) do |x, y|
+    capture { 
+        @turtle_pos.x = x
+        @turtle_pos.y = y
+    }
+end
+
+TexPlay.create_macro(:move_rel) do |dx, dy|
+    capture { 
+        @turtle_pos.x += dx
+        @turtle_pos.y += dy
+    }
+end
+
+TexPlay.create_macro(:line_to) do |x, y, *other|
+    capture { 
+        line(@turtle_pos.x, @turtle_pos.y, x, y, *other)
+
+        @turtle_pos.x, @turtle_pos.y = x, y
+    }
+end
+
+TexPlay.create_macro(:line_rel) do |dx, dy, *other|
+    capture { 
+        x = @turtle_pos.x + dx
+        y = @turtle_pos.y + dy
+
+        line(@turtle_pos.x, @turtle_pos.y, x, y, *other)
+
+        @turtle_pos.x, @turtle_pos.y = x, y
+    }
+end
+
+TexPlay.create_macro(:turn_to) do |a|
+    capture {
+        @turtle_angle = a
+    }
+end
+
+TexPlay.create_macro(:turn) do |da|
+    capture { 
+        @turtle_angle += da
+    }
+end
+
+TexPlay.create_macro(:forward) do |dist, *other|
+    capture {
+        visible = other.shift
+
+        radians_per_degree = 0.0174532925199433
+
+        x = @turtle_pos.x + dist * Math::cos(radians_per_degree * @turtle_angle)
+        y = @turtle_pos.y + dist * Math::sin(radians_per_degree * @turtle_angle)
+
+        if(visible) then
+            line_to(x, y, *other)
+        else
+            move_to(x, y)
+        end
+    }
+end
+
+
+

data/lib/texplay.rb

@@ -0,0 +1,134 @@
+# (C) John Mair 2009, under the MIT licence
+
+begin
+    require 'rubygems'
+rescue LoadError
+end
+
+# include gosu first
+require 'rbconfig'
+require 'gosu'
+
+module TexPlay
+    TEXPLAY_VERSION = "0.2.0"
+
+    def self.on_setup(&block)
+        raise "need a block" if !block
+        
+        @__init_procs__ ||= []
+        @__init_procs__.push(block)
+    end
+
+    def self.setup(receiver)
+        if @__init_procs__ then
+            @__init_procs__.each do |init_proc|
+                receiver.instance_eval(&init_proc)
+            end
+        end
+    end
+
+    def self.create_blank_image(window, width, height)
+        Gosu::Image.new(window, EmptyImageStub.new(width, height))
+    end
+
+    module Colors
+        Red = [1, 0, 0, 1]
+        Green = [0, 1, 0, 1]
+        Blue = [0, 0, 1, 1]
+        Black = [0, 0, 0, 1]
+        White = [1, 1, 1, 1]
+        Grey = [0.5, 0.5, 0.5, 0.5]
+        Alpha = [0, 0, 0, 0]
+        Purple = [1, 0, 1, 1]
+        Yellow = [1, 1, 0, 1]
+        Cyan = [0, 1, 1, 1]
+        Orange = [1, 0.5, 0, 1]
+        Brown = [0.39, 0.26, 0.13, 1]
+        Turquoise = [1, 0.6, 0.8, 1]
+        Tyrian = [0.4, 0.007, 0.235, 1]
+    end
+    include Colors
+end
+
+# credit to philomory for this class
+class EmptyImageStub
+    def initialize(w,h)
+        @w, @h = w, h;
+    end
+    
+    def to_blob
+        "\0" * @w * @h * 4
+    end
+    
+    def rows
+        @h
+    end
+    
+    def columns
+        @w
+    end
+end
+
+# bring in user-defined extensions to TexPlay
+direc = File.dirname(__FILE__)
+dlext = Config::CONFIG['DLEXT']
+begin
+    if RUBY_VERSION && RUBY_VERSION =~ /1.9/
+        require "#{direc}/ctexplay19.#{dlext}"
+    else
+        require "#{direc}/ctexplay18.#{dlext}"
+    end
+rescue LoadError => e
+    require "#{direc}/ctexplay.#{dlext}"
+end
+    
+require "#{direc}/texplay-contrib"
+
+# monkey patching the Gosu::Image class to add image manipulation functionality
+module Gosu
+    class Image
+
+        # bring in the TexPlay image manipulation methods
+        include TexPlay
+        
+        class << self 
+            alias_method :original_new, :new
+            
+            def new(*args, &block)
+
+                # invoke old behaviour
+                obj = original_new(*args, &block)
+
+                # refresh the TexPlay image cache
+                if obj.width <= (TexPlay::TP_MAX_QUAD_SIZE - 2) &&
+                        obj.height <= (TexPlay::TP_MAX_QUAD_SIZE - 2) && obj.quad_cached? then
+                    
+                    obj.refresh_cache
+                end
+
+                # run custom setup
+                TexPlay::setup(obj)
+
+                 obj.instance_variable_set(:@__window__, args.first)
+
+                # return the new image
+                obj
+            end
+        end
+        
+        def __window__
+            @__window__
+        end
+    end
+end
+
+# a bug in ruby 1.8.6 rb_eval_string() means i must define this here (rather than in texplay.c)
+class Proc  
+    def __context__
+        eval('self', self.binding)
+    end
+end
+
+
+
+

data/src/extconf.rb

@@ -0,0 +1,18 @@
+require 'mkmf'
+
+
+# linux
+if RUBY_PLATFORM =~ /linux/ then
+    exit unless have_library("glut")
+    
+# macosx
+elsif RUBY_PLATFORM =~ /darwin/
+    $LDFLAGS +=  " -framework GLUT"
+    $CPPFLAGS += " -I/System/Library/Frameworks/GLUT.framework/Headers"
+
+# windows    
+else
+    exit unless have_library("glut32") 
+end
+
+create_makefile('ctexplay')

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification 
+name: banister-texplay
+version: !ruby/object:Gem::Version 
+  version: 0.2.0
+platform: ruby
+authors: 
+- John Mair (banisterfiend)
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-09-02 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: TexPlay is a light-weight image manipulation framework for Ruby and Gosu
+email: jrmair@gmail.com
+executables: []
+
+extensions: 
+- src/extconf.rb
+extra_rdoc_files: []
+
+files: 
+- Rakefile
+- README
+- CHANGELOG
+- README1st
+- lib/texplay.rb
+- lib/texplay-contrib.rb
+has_rdoc: false
+homepage: http://banisterfiend.wordpress.com/2008/08/23/texplay-an-image-manipulation-tool-for-ruby-and-gosu/
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: TexPlay is a light-weight image manipulation framework for Ruby and Gosu
+test_files: []
+