color-tools 1.2.0 → 1.3.0

data/lib/color/rgb/metallic.rb

@@ -0,0 +1,28 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: metallic.rb,v 1.1 2005/08/05 23:07:20 austin Exp $
+#++
+
+  # This namespace contains some RGB metallic colours suggested by Jim Freeze.
+module Color::RGB::Metallic
+  Aluminum    = Color::RGB.new(0x99, 0x99, 0x99)
+  CoolCopper  = Color::RGB.new(0xd9, 0x87, 0x19)
+  Copper      = Color::RGB.new(0xb8, 0x73, 0x33)
+  Iron        = Color::RGB.new(0x4c, 0x4c, 0x4c)
+  Lead        = Color::RGB.new(0x19, 0x19, 0x19)
+  Magnesium   = Color::RGB.new(0xb3, 0xb3, 0xb3)
+  Mercury     = Color::RGB.new(0xe6, 0xe6, 0xe6)
+  Nickel      = Color::RGB.new(0x80, 0x80, 0x80)
+  PolySilicon = Color::RGB.new(0x60, 0x00, 0x00)
+  Poly        = PolySilicon
+  Silver      = Color::RGB.new(0xcc, 0xcc, 0xcc)
+  Steel       = Color::RGB.new(0x66, 0x66, 0x66)
+  Tin         = Color::RGB.new(0x7f, 0x7f, 0x7f)
+  Tungsten    = Color::RGB.new(0x33, 0x33, 0x33)
+end

data/lib/color/yiq.rb

@@ -3,11 +3,17 @@
 #
 # Copyright 2005 Austin Ziegler
 #   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: yiq.rb,v 1.3 2005/08/08 02:44:17 austin Exp $
 #++
 
   # A colour object representing YIQ (NTSC) colour encoding.
 class Color::YIQ
     # Creates a YIQ colour object from fractional values 0 .. 1.
+    #
+    #   Color::YIQ.new(0.3, 0.2, 0.1)
   def self.from_fraction(y = 0, i = 0, q = 0)
     color = Color::YIQ.new
     color.y = y
@@ -17,6 +23,8 @@ class Color::YIQ
   end
 
     # Creates a YIQ colour object from percentages 0 .. 100.
+    #
+    #   Color::YIQ.new(10, 20, 30)
   def initialize(y = 0, i = 0, q = 0)
     @y = y / 100.0
     @i = i / 100.0
@@ -27,13 +35,15 @@ class Color::YIQ
     # converted to YIQ before comparison, so the comparison between a YIQ
     # colour and a non-YIQ colour will be approximate and based on the other
     # colour's #to_yiq conversion. If there is no #to_yiq conversion, this
-    # will raise an exception.
+    # will raise an exception. This will report that two YIQ values are
+    # equivalent if all component colours are within 1e-4 (0.0001) of each
+    # other.
   def ==(other)
     other = other.to_yiq
     other.kind_of?(Color::YIQ) and
-    (@y == other.y) and
-    (@i == other.i) and
-    (@q == other.q)
+    ((@y - other.y).abs <= 1e-4) and
+    ((@i - other.i).abs <= 1e-4) and
+    ((@q - other.q).abs <= 1e-4) 
   end
 
   def to_yiq
@@ -41,12 +51,28 @@ class Color::YIQ
   end
 
   def brightness
-    @g
+    @y
+  end
+  def to_grayscale
+    Color::GrayScale.new(@y)
   end
-  alias to_grayscale brightness
   alias to_greyscale to_grayscale
 
-  attr_accessor :y
-  attr_accessor :i
-  attr_accessor :q
+  attr_accessor :y, :i, :q
+  remove_method :y=, :i=, :q=
+  def y=(yy) #:nodoc:
+    yy = 1.0 if yy > 1
+    yy = 0.0 if yy < 0
+    @y = yy
+  end
+  def i=(ii) #:nodoc:
+    ii = 1.0 if ii > 1
+    ii = 0.0 if ii < 0
+    @i = ii
+  end
+  def q=(qq) #:nodoc:
+    qq = 1.0 if qq > 1
+    qq = 0.0 if qq < 0
+    @q = qq
+  end
 end

data/metaconfig

@@ -1,4 +1,13 @@
 #!/usr/bin/env ruby
-# $Id: metaconfig,v 1.1 2005/05/11 19:08:58 austin Exp $
-# vim: sts=2 sw=2 ts=4 et ai tw=77
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
 #
+#   Licensed under a MIT-style licence.
+#
+# $Id: metaconfig,v 1.2 2005/08/05 23:07:20 austin Exp $
+#++
+# vim: sts=2 sw=2 ts=4 et ai tw=77
+

data/pre-setup.rb

@@ -1,4 +1,13 @@
-# $Id: pre-setup.rb,v 1.2 2005/07/01 15:54:18 austin Exp $
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: pre-setup.rb,v 1.5 2005/08/08 02:53:16 austin Exp $
+#++
 # vim: sts=2 sw=2 ts=4 et ai tw=77
 
 require 'rdoc/rdoc'
@@ -12,7 +21,7 @@ rescue Exception => e
 end
 
 def build_ri(files)
-  RDoc::RDoc.new.document(["--ri-site", "--merge"] + files)
+  RDoc::RDoc.new.document(files)
 rescue RDoc::RDocError => e
   $stderr.puts e.message
 rescue Exception => e
@@ -43,4 +52,4 @@ ri    = %w(--ri-site --merge)
 dox   = %w(README Changelog lib)
 build_rdoc rdoc + dox
 build_ri ri + dox
-#run_tests []
+run_tests Dir["tests/test_*.rb"]

data/tests/test_cmyk.rb

@@ -0,0 +1,116 @@
+#!/usr/bin/env ruby
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: test_cmyk.rb,v 1.1 2005/08/08 02:44:17 austin Exp $
+#++
+
+$LOAD_PATH.unshift("#{File.dirname(__FILE__)}/../lib") if __FILE__ == $0
+require 'test/unit' unless defined? $ZENTEST and $ZENTEST
+require 'color'
+
+module TestColor
+  class TestCMYK < Test::Unit::TestCase
+    def setup
+      @cmyk = Color::CMYK.new(10, 20, 30, 40)
+    end
+
+    def test_c
+      assert_in_delta(0.1, @cmyk.c, 1e-4)
+    end
+
+    def test_c_equals
+      assert_in_delta(0.1, @cmyk.c, 1e-4)
+      assert_nothing_raised { @cmyk.c = 0.2 }
+      assert_in_delta(0.2, @cmyk.c, 1e-4)
+      assert_nothing_raised { @cmyk.c = 2.0 }
+      assert_in_delta(1.0, @cmyk.c, 1e-4)
+      assert_nothing_raised { @cmyk.c = -1.0 }
+      assert_in_delta(0.0, @cmyk.c, 1e-4)
+    end
+
+    def test_html
+      assert(@cmyk.html =~ /^#[0-9a-fA-F]{6}/)
+    end
+
+    def test_k
+      assert_in_delta(0.4, @cmyk.k, 1e-4)
+    end
+
+    def test_k_equals
+      assert_in_delta(0.4, @cmyk.k, 1e-4)
+      assert_nothing_raised { @cmyk.k = 0.2 }
+      assert_in_delta(0.2, @cmyk.k, 1e-4)
+      assert_nothing_raised { @cmyk.k = 2.0 }
+      assert_in_delta(1.0, @cmyk.k, 1e-4)
+      assert_nothing_raised { @cmyk.k = -1.0 }
+      assert_in_delta(0.0, @cmyk.k, 1e-4)
+    end
+
+    def test_m
+      assert_in_delta(0.2, @cmyk.m, 1e-4)
+    end
+
+    def test_m_equals
+      assert_in_delta(0.2, @cmyk.m, 1e-4)
+      assert_nothing_raised { @cmyk.m = 0.3 }
+      assert_in_delta(0.3, @cmyk.m, 1e-4)
+      assert_nothing_raised { @cmyk.m = 2.0 }
+      assert_in_delta(1.0, @cmyk.m, 1e-4)
+      assert_nothing_raised { @cmyk.m = -1.0 }
+      assert_in_delta(0.0, @cmyk.m, 1e-4)
+    end
+
+    def test_pdf_fill
+      assert_equal("0.100 0.200 0.300 0.400 k", @cmyk.pdf_fill)
+    end
+
+    def test_pdf_stroke
+      assert_equal("0.100 0.200 0.300 0.400 K", @cmyk.pdf_stroke)
+    end
+
+    def test_to_cmyk
+      assert(@cmyk.to_cmyk == @cmyk)
+    end
+
+    def test_to_grayscale
+      assert_kind_of(Color::GrayScale, @cmyk.to_grayscale)
+    end
+
+    def test_to_greyscale
+      assert_kind_of(Color::GreyScale, @cmyk.to_grayscale)
+    end
+
+    def test_to_hsl
+      assert_kind_of(Color::HSL, @cmyk.to_hsl)
+    end
+
+    def test_to_rgb
+      assert_kind_of(Color::RGB, @cmyk.to_rgb(true))
+      assert_kind_of(Color::RGB, @cmyk.to_rgb)
+    end
+
+    def test_to_yiq
+      assert_kind_of(Color::YIQ, @cmyk.to_yiq)
+    end
+
+    def test_y
+      assert_in_delta(0.3, @cmyk.y, 1e-4)
+    end
+
+    def test_y_equals
+      assert_in_delta(0.3, @cmyk.y, 1e-4)
+      assert_nothing_raised { @cmyk.y = 0.2 }
+      assert_in_delta(0.2, @cmyk.y, 1e-4)
+      assert_nothing_raised { @cmyk.y = 2.0 }
+      assert_in_delta(1.0, @cmyk.y, 1e-4)
+      assert_nothing_raised { @cmyk.y = -1.0 }
+      assert_in_delta(0.0, @cmyk.y, 1e-4)
+    end
+  end
+end

data/tests/test_css.rb

@@ -0,0 +1,28 @@
+#!/usr/bin/env ruby
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: test_css.rb,v 1.1 2005/08/08 02:44:17 austin Exp $
+#++
+
+$LOAD_PATH.unshift("#{File.dirname(__FILE__)}/../lib") if __FILE__ == $0
+require 'test/unit' unless defined? $ZENTEST and $ZENTEST
+require 'color'
+require 'color/css'
+
+module TestColor
+  class TestCSS < Test::Unit::TestCase
+    def test_index
+      assert_equal(Color::RGB::AliceBlue, Color::CSS[:aliceblue])
+      assert_equal(Color::RGB::AliceBlue, Color::CSS["AliceBlue"])
+      assert_equal(Color::RGB::AliceBlue, Color::CSS["aliceBlue"])
+      assert_equal(Color::RGB::AliceBlue, Color::CSS["aliceblue"])
+      assert_equal(Color::RGB::AliceBlue, Color::CSS[:AliceBlue])
+    end
+  end
+end

data/tests/test_gimp.rb

@@ -0,0 +1,79 @@
+#!/usr/bin/env ruby
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: test_gimp.rb,v 1.1 2005/08/08 02:44:17 austin Exp $
+#++
+
+$LOAD_PATH.unshift("#{File.dirname(__FILE__)}/../lib") if __FILE__ == $0
+require 'test/unit' unless defined? $ZENTEST and $ZENTEST
+require 'color'
+require 'color/palette/gimp'
+
+module TestColor
+  module TestPalette
+    class TestGimp < Test::Unit::TestCase
+      def setup
+        wsc = <<-EOS
+GIMP Palette
+Name: W3C Named Colors
+Columns: 2
+#
+# ColorZilla W3C Named Colors
+#
+255 255 255 	White
+255 255 0 	Yellow	
+255 0 255 	Fuchsia
+255 0 0		Red
+192 192 192	Silver
+128 128 128 	Gray
+128 128 0	Olive	
+128 0 128	Purple
+128 0 0		Maroon
+0 255 255	Aqua
+0 255 0		Lime
+0 128 128	Teal
+0 128 0		Green
+0 0 255		Blue
+0 0 128		Navy
+0 0 0 		Black 
+        EOS
+        @gimp = Color::Palette::Gimp.new(wsc)
+      end
+
+      def test_each
+        assert_equal(16, @gimp.instance_variable_get(:@colors).size)
+        @gimp.each { |el| assert_kind_of(Color::RGB, el) }
+      end
+
+      def test_each_name
+        assert_equal(16, @gimp.instance_variable_get(:@names).size)
+        
+        @gimp.each_name { |color_name, color_set|
+          assert_kind_of(Array, color_set)
+          color_set.each { |el|
+            assert_kind_of(Color::RGB, el)
+          }
+        }
+      end
+
+      def test_index
+        assert_equal(Color::RGB::White, @gimp[0])
+        assert_equal(Color::RGB::White, @gimp["White"][0])
+      end
+
+      def test_valid_eh
+        assert(@gimp.valid?)
+      end
+
+      def test_name
+        assert_equal("W3C Named Colors", @gimp.name)
+      end
+    end
+  end
+end

data/tests/test_grayscale.rb

@@ -0,0 +1,87 @@
+#!/usr/bin/env ruby
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: test_grayscale.rb,v 1.1 2005/08/08 02:44:17 austin Exp $
+#++
+
+$LOAD_PATH.unshift("#{File.dirname(__FILE__)}/../lib") if __FILE__ == $0
+require 'test/unit' unless defined? $ZENTEST and $ZENTEST
+require 'color'
+
+module TestColor
+  class TestGrayScale < Test::Unit::TestCase
+    def setup
+      @gs = Color::GrayScale.new(33)
+    end
+
+    def test_brightness
+      assert_in_delta(0.33, @gs.brightness, 1e-4)
+    end
+
+    def test_darken_by
+      assert_in_delta(0.297, @gs.darken_by(10).g, 1e-4)
+    end
+
+    def test_g
+      assert_in_delta(0.33, @gs.g, 1e-4)
+    end
+
+    def test_g_equals
+      assert_in_delta(0.33, @gs.g, 1e-4)
+      assert_nothing_raised { @gs.g = 0.4 }
+      assert_in_delta(0.4, @gs.g, 1e-4)
+      assert_nothing_raised { @gs.g = 2.0 }
+      assert_in_delta(1.0, @gs.g, 1e-4)
+      assert_nothing_raised { @gs.g = -2.0 }
+      assert_in_delta(0.0, @gs.g, 1e-4)
+    end
+
+    def test_html
+      assert_equal("#545454", @gs.html)
+    end
+
+    def test_lighten_by
+      assert_in_delta(0.363, @gs.lighten_by(10).g, 1e-4)
+    end
+
+    def test_pdf_fill
+      assert_equal("0.330 g", @gs.pdf_fill)
+    end
+
+    def test_pdf_stroke
+      assert_equal("0.330 G", @gs.pdf_stroke)
+    end
+
+    def test_to_cmyk
+      assert_kind_of(Color::CMYK, @gs.to_cmyk)
+    end
+
+    def test_to_grayscale
+      assert_equal(@gs, @gs.to_grayscale)
+    end
+
+    def test_to_greyscale
+      assert_equal(@gs, @gs.to_greyscale)
+    end
+
+    def test_to_hsl
+      assert_kind_of(Color::HSL, @gs.to_hsl)
+    end
+
+    def test_to_rgb
+      assert_kind_of(Color::RGB, @gs.to_rgb)
+    end
+
+    def test_to_yiq
+      assert_kind_of(Color::YIQ, @gs.to_yiq)
+    end
+  end
+end
+
+# Number of errors detected: 2