color 0.1.0 → 1.4.0

data/test/test_color.rb

@@ -1,131 +1,134 @@
-$:.unshift(File.dirname(__FILE__) + "/../lib/")
+#!/usr/bin/env ruby
+#--
+# Color
+# Colour management with Ruby
+# http://rubyforge.org/projects/color
+#   Version 1.4.0
+#
+# Licensed under a MIT-style licence. See Licence.txt in the main
+# distribution for full licensing information.
+#
+# Copyright (c) 2005 - 2007 Austin Ziegler and Matt Lyon
+#
+# $Id: test_all.rb 55 2007-02-03 23:29:34Z austin $
+#++
 
+$LOAD_PATH.unshift("#{File.dirname(__FILE__)}/../lib") if __FILE__ == $0
 require 'test/unit'
 require 'color'
+require 'color/css'
 
-class TestColor < Test::Unit::TestCase
-  
-  COLORS = {
-    :red =>       {:html => '#ff0000', :rgb => [255,0,0],     :hsl => [0,100,50] },
-    :yellow =>    {:html => '#ffff00', :rgb => [255,255,0],   :hsl => [60,100,50] },
-    :blue =>      {:html => '#0000ff', :rgb => [0,0,255],     :hsl => [240,100,50] },
-    :brown =>     {:html => '#a16328', :rgb => [161,99,40],   :hsl => [29,60,39] },
-    :carnation => {:html => '#ff5ed0', :rgb => [255,94,208],  :hsl => [318,100,68] },
-    :cayenne =>   {:html => '#8d0000', :rgb => [141,0,0],     :hsl => [0,100,28] }
-  }
-  
-  ## eigenclass conversion methods
-  
-  def test_rgb_to_hex
-    COLORS.each_value do |color|
-      assert_equal color[:html], Color.rgb_to_rgbhex(color[:rgb])
+module TestColor
+  class TestColor < Test::Unit::TestCase
+    def setup
+      Kernel.module_eval do
+        alias old_warn warn
+
+        def warn(message)
+          $last_warn = message
+        end
+      end
     end
-  end
-  
-  def test_hex_to_rgb
-    COLORS.each_value do |color|
-      assert_equal color[:rgb], Color.rgbhex_to_rgb(color[:html])
+
+    def teardown
+      Kernel.module_eval do
+        undef warn
+        alias warn old_warn
+        undef old_warn
+      end
     end
-  end
-  
-  def test_rgb_to_hsl
-    COLORS.each_value do |color|
-      assert_equivalent color[:hsl], Color.rgb_to_hsl_human(color[:rgb])
+
+    def test_const
+      $last_warn = nil
+      assert_equal(Color::RGB::AliceBlue, Color::AliceBlue)
+      assert_equal("Color::AliceBlue has been deprecated. Use Color::RGB::AliceBlue instead.", $last_warn)
+
+      $last_warn = nil # Do this twice to make sure it always happens...
+      assert(Color::AliceBlue)
+      assert_equal("Color::AliceBlue has been deprecated. Use Color::RGB::AliceBlue instead.", $last_warn)
+
+      $last_warn = nil
+      assert_equal(Color::COLOR_VERSION, Color::VERSION)
+      assert_equal("Color::VERSION has been deprecated. Use Color::COLOR_VERSION instead.", $last_warn)
+
+      $last_warn = nil
+      assert_equal(Color::COLOR_VERSION, Color::COLOR_TOOLS_VERSION)
+      assert_equal("Color::COLOR_TOOLS_VERSION has been deprecated. Use Color::COLOR_VERSION instead.", $last_warn)
+
+      $last_warn = nil
+      assert(Color::COLOR_VERSION)
+      assert_nil($last_warn)
+      assert(Color::COLOR_EPSILON)
+      assert_nil($last_warn)
+
+      assert_raises(NameError) { assert(Color::MISSING_VALUE) }
     end
-  end
-  
-  def test_hsl_to_rgb
-    COLORS.each_value do |color|
-      assert_equivalent color[:rgb], Color.hsl_to_rgb(color[:hsl])
+
+    def test_normalize
+      (1..10).each do |i|
+        assert_equal(0.0, Color.normalize(-7 * i))
+        assert_equal(0.0, Color.normalize(-7 / i))
+        assert_equal(0.0, Color.normalize(0 - i))
+        assert_equal(1.0, Color.normalize(255 + i))
+        assert_equal(1.0, Color.normalize(256 * i))
+        assert_equal(1.0, Color.normalize(65536 / i))
+      end
+      (0..255).each do |i|
+        assert_in_delta(i / 255.0, Color.normalize(i / 255.0),
+                        1e-2)
+      end
     end
-  end
-  
-  def test_hsl_to_rgb_with_floats
-    COLORS.each_value do |color|
-      assert_equivalent color[:rgb], Color.hsl_to_rgb([(color[:hsl][0]/360.0), (color[:hsl][1]/100.0), (color[:hsl][2]/100.0)])
+
+    def test_normalize_range
+      assert_equal(0, Color.normalize_8bit(-1))
+      assert_equal(0, Color.normalize_8bit(0))
+      assert_equal(127, Color.normalize_8bit(127))
+      assert_equal(172, Color.normalize_8bit(172))
+      assert_equal(255, Color.normalize_8bit(255))
+      assert_equal(255, Color.normalize_8bit(256))
+
+      assert_equal(-100, Color.normalize_to_range(-101, -100..100))
+      assert_equal(-100, Color.normalize_to_range(-100.5, -100..100))
+      assert_equal(-100, Color.normalize_to_range(-100, -100..100))
+      assert_equal(-100, Color.normalize_to_range(-100.0, -100..100))
+      assert_equal(-99.5, Color.normalize_to_range(-99.5, -100..100))
+      assert_equal(-50, Color.normalize_to_range(-50, -100..100))
+      assert_equal(-50.5, Color.normalize_to_range(-50.5, -100..100))
+      assert_equal(0, Color.normalize_to_range(0, -100..100))
+      assert_equal(50, Color.normalize_to_range(50, -100..100))
+      assert_equal(50.5, Color.normalize_to_range(50.5, -100..100))
+      assert_equal(99, Color.normalize_to_range(99, -100..100))
+      assert_equal(99.5, Color.normalize_to_range(99.5, -100..100))
+      assert_equal(100, Color.normalize_to_range(100, -100..100))
+      assert_equal(100, Color.normalize_to_range(100.0, -100..100))
+      assert_equal(100, Color.normalize_to_range(100.5, -100..100))
+      assert_equal(100, Color.normalize_to_range(101, -100..100))
     end
-  end
-  
-  # instance methods
-  
-  def test_intialize_from_hex
-    COLORS.each_value do |color|
-      instance = Color.new(color[:html])
-      assert_equal color[:hsl], instance.to_hsl
+
+    def test_new
+      $last_warn = nil
+      c = Color.new("#fff")
+      assert_kind_of(Color::HSL, c)
+      assert_equal(Color::RGB::White.to_hsl, c)
+      assert_equal("Color.new has been deprecated. Use Color::RGB.new instead.", $last_warn)
+
+      $last_warn = nil
+      c = Color.new([0, 0, 0])
+      assert_kind_of(Color::HSL, c)
+      assert_equal(Color::RGB::Black.to_hsl, c)
+      assert_equal("Color.new has been deprecated. Use Color::RGB.new instead.", $last_warn)
+
+      $last_warn = nil
+      c = Color.new([10, 20, 30], :hsl)
+      assert_kind_of(Color::HSL, c)
+      assert_equal(Color::HSL.new(10, 20, 30), c)
+      assert_equal("Color.new has been deprecated. Use Color::HSL.new instead.", $last_warn)
+
+      $last_warn = nil
+      c = Color.new([10, 20, 30, 40], :cmyk)
+      assert_kind_of(Color::HSL, c)
+      assert_equal(Color::CMYK.new(10, 20, 30, 40).to_hsl, c)
+      assert_equal("Color.new has been deprecated. Use Color::CMYK.new instead.", $last_warn)
     end
   end
-  
-  def test_hue
-    assert_equal 60, Color.new(COLORS[:yellow][:html]).hue
-  end
-  
-  def test_hue_is
-    assert_equal 0.1, Color.new('000000').hue = 0.1
-    assert_equal 100, Color.new('000000').hue = 100
-    assert_equal 80, Color.new(COLORS[:yellow][:html]).hue += 20
-    # TODO: is there a way to have -= return 340 instead of -20 ?
-    red = Color.new(COLORS[:red][:html])
-    red.hue -= 20
-    assert_equal 340, red.hue
-  end
-  
-  def test_saturation
-    assert_equal 60, Color.new(COLORS[:brown][:html]).saturation
-  end
-  
-  def test_saturation_is
-    assert_equal 0.1, Color.new('000000').saturation = 0.1
-    assert_equal 10, Color.new('000000').saturation = 10
-    assert_equal 80, Color.new(COLORS[:red][:html]).saturation -= 20
-    assert_equal 70, Color.new(COLORS[:brown][:html]).saturation += 10
-  end
-  
-  def test_saturation_is_lower_limit
-    brown = Color.new(COLORS[:brown][:html])
-    brown.saturation -= 80
-    assert_equal 0, brown.saturation
-  end
-  
-  def test_saturation_is_upper_limit
-    brown = Color.new(COLORS[:brown][:html])
-    brown.saturation += 80
-    assert_equal 100, brown.saturation
-  end
-  
-  def test_lightness
-    assert_equal 50, Color.new(COLORS[:red][:html]).lightness
-  end
-  
-  def test_lightness_is
-    assert_equal 0.1, Color.new('000000').lightness = 0.1
-    assert_equal 10, Color.new('000000').lightness = 10
-    assert_equal 30, Color.new(COLORS[:red][:html]).lightness -= 20
-    assert_equal 70, Color.new(COLORS[:red][:html]).lightness += 20
-  end
-  
-  def test_lightness_is_lower_limit
-    red = Color.new(COLORS[:red][:html])
-    red.lightness -= 80
-    assert_equal 0, red.lightness
-  end
-  
-  def test_saturation_is_upper_limit
-    red = Color.new(COLORS[:red][:html])
-    red.lightness += 80
-    assert_equal 100, red.lightness
-  end
-  
-  def test_mix_with
-    red, yellow = Color.new(COLORS[:red][:html]), Color.new(COLORS[:yellow][:html])
-    assert_equal 30, red.mix_with(yellow, 0.5).hue
-  end
-  
-  #helpers
-  
-  def assert_equivalent(target=[], input=[])
-    difference = 0
-    target.each_with_index {|value, index| difference += (value - input[index]).abs }
-    assert difference <= 5, "[#{input.join(',')}] is not close enough to [#{target.join(',')}]"
-  end
-  
-end
+end

data/test/test_css.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+#--
+# Color
+# Colour management with Ruby
+# http://rubyforge.org/projects/color
+#   Version 1.4.0
+#
+# Licensed under a MIT-style licence. See Licence.txt in the main
+# distribution for full licensing information.
+#
+# Copyright (c) 2005 - 2007 Austin Ziegler and Matt Lyon
+#
+# $Id: test_all.rb 55 2007-02-03 23:29:34Z austin $
+#++
+
+$LOAD_PATH.unshift("#{File.dirname(__FILE__)}/../lib") if __FILE__ == $0
+require 'test/unit'
+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/test/test_gimp.rb

@@ -0,0 +1,103 @@
+#!/usr/bin/env ruby
+#--
+# Color
+# Colour management with Ruby
+# http://rubyforge.org/projects/color
+#   Version 1.4.0
+#
+# Licensed under a MIT-style licence. See Licence.txt in the main
+# distribution for full licensing information.
+#
+# Copyright (c) 2005 - 2007 Austin Ziegler and Matt Lyon
+#
+# $Id: test_all.rb 55 2007-02-03 23:29:34Z austin $
+#++
+
+$LOAD_PATH.unshift("#{File.dirname(__FILE__)}/../lib") if __FILE__ == $0
+require 'test/unit'
+require 'color'
+require 'color/palette/gimp'
+
+module TestColor
+  module TestPalette
+    class TestGimp < Test::Unit::TestCase
+      include Color::Palette
+
+      GIMP_W3C = <<-EOS
+GIMP Palette
+Name: W3C Named Colors
+Columns: 2
+#
+# ColorZilla W3C Named Colors
+#
+255 255 255 	White
+255 255 0 	Yclow	
+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
+
+      def setup
+        @filename = "test#{Process.pid}.gimp"
+      end
+
+      def teardown
+        require 'fileutils'
+        FileUtils.rm_f @filename if File.exist? @filename
+      end
+
+      def test_each
+        @gimp = Gimp.new(GIMP_W3C)
+        assert_equal(16, @gimp.instance_variable_get(:@colors).size)
+        @gimp.each { |c| assert_kind_of(Color::RGB, c) }
+      end
+
+      def test_each_name
+        @gimp = Gimp.new(GIMP_W3C)
+        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 { |c|
+            assert_kind_of(Color::RGB, c)
+          }
+        }
+      end
+
+      def test_index
+        assert_nothing_raised do
+          File.open(@filename, "wb") do |f|
+            f.write GIMP_W3C
+          end
+        end
+        assert_nothing_raised { @gimp = Gimp.from_file(@filename) }
+        assert_equal(Color::RGB::White, @gimp[0])
+        assert_equal(Color::RGB::White, @gimp["White"][0])
+        assert_equal([Color::RGB::White, Color::RGB::Black],
+                     @gimp.values_at(0, -1))
+        assert_equal(16, @gimp.size)
+      end
+
+      def test_valid_eh
+        @gimp = Gimp.new(GIMP_W3C)
+        assert(@gimp.valid?)
+      end
+
+      def test_name
+        @gimp = Gimp.new(GIMP_W3C)
+        assert_equal("W3C Named Colors", @gimp.name)
+      end
+    end
+  end
+end

data/test/test_grayscale.rb

@@ -0,0 +1,123 @@
+#!/usr/bin/env ruby
+#--
+# Color
+# Colour management with Ruby
+# http://rubyforge.org/projects/color
+#   Version 1.4.0
+#
+# Licensed under a MIT-style licence. See Licence.txt in the main
+# distribution for full licensing information.
+#
+# Copyright (c) 2005 - 2007 Austin Ziegler and Matt Lyon
+#
+# $Id: test_all.rb 55 2007-02-03 23:29:34Z austin $
+#++
+
+$LOAD_PATH.unshift("#{File.dirname(__FILE__)}/../lib") if __FILE__ == $0
+require 'test/unit'
+require 'color'
+
+module TestColor
+  class TestGrayScale < Test::Unit::TestCase
+    def setup
+      @gs = Color::GrayScale.from_percent(33)
+    end
+
+    def test_brightness
+      assert_in_delta(0.33, @gs.brightness, Color::COLOR_TOLERANCE)
+    end
+
+    def test_darken_by
+      assert_in_delta(29.7, @gs.darken_by(10).gray, Color::COLOR_TOLERANCE)
+    end
+
+    def test_g
+      assert_in_delta(0.33, @gs.g, Color::COLOR_TOLERANCE)
+      assert_in_delta(33, @gs.grey, Color::COLOR_TOLERANCE)
+      assert_nothing_raised { @gs.gray = 40 }
+      assert_in_delta(0.4, @gs.g, Color::COLOR_TOLERANCE)
+      assert_nothing_raised { @gs.g = 2.0 }
+      assert_in_delta(100, @gs.gray, Color::COLOR_TOLERANCE)
+      assert_nothing_raised { @gs.grey = -2.0 }
+      assert_in_delta(0.0, @gs.g, Color::COLOR_TOLERANCE)
+    end
+
+    def test_html_css
+      assert_equal("#545454", @gs.html)
+      assert_equal("rgb(33.00%, 33.00%, 33.00%)", @gs.css_rgb)
+      assert_equal("rgba(33.00%, 33.00%, 33.00%, 1.00)", @gs.css_rgba)
+    end
+
+    def test_lighten_by
+      assert_in_delta(0.363, @gs.lighten_by(10).g, Color::COLOR_TOLERANCE)
+    end
+
+    def test_pdf_fill
+      assert_equal("0.330 g", @gs.pdf_fill)
+      assert_equal("0.330 G", @gs.pdf_stroke)
+    end
+
+    def test_to_cmyk
+      cmyk = nil
+      assert_nothing_raised { cmyk = @gs.to_cmyk }
+      assert_kind_of(Color::CMYK, cmyk)
+      assert_in_delta(0.0, cmyk.c, Color::COLOR_TOLERANCE)
+      assert_in_delta(0.0, cmyk.m, Color::COLOR_TOLERANCE)
+      assert_in_delta(0.0, cmyk.y, Color::COLOR_TOLERANCE)
+      assert_in_delta(0.67, cmyk.k, Color::COLOR_TOLERANCE)
+    end
+
+    def test_to_grayscale
+      assert_equal(@gs, @gs.to_grayscale)
+      assert_equal(@gs, @gs.to_greyscale)
+    end
+
+    def test_to_hsl
+      hsl = nil
+      assert_nothing_raised { hsl = @gs.to_hsl }
+      assert_kind_of(Color::HSL, hsl)
+      assert_in_delta(0.0, hsl.h, Color::COLOR_TOLERANCE)
+      assert_in_delta(0.0, hsl.s, Color::COLOR_TOLERANCE)
+      assert_in_delta(0.33, hsl.l, Color::COLOR_TOLERANCE)
+      assert_equal("hsl(0.00, 0.00%, 33.00%)", @gs.css_hsl)
+      assert_equal("hsla(0.00, 0.00%, 33.00%, 1.00)", @gs.css_hsla)
+    end
+
+    def test_to_rgb
+      rgb = nil
+      assert_nothing_raised { rgb = @gs.to_rgb }
+      assert_kind_of(Color::RGB, rgb)
+      assert_in_delta(0.33, rgb.r, Color::COLOR_TOLERANCE)
+      assert_in_delta(0.33, rgb.g, Color::COLOR_TOLERANCE)
+      assert_in_delta(0.33, rgb.b, Color::COLOR_TOLERANCE)
+    end
+
+    def test_to_yiq
+      yiq = nil
+      assert_nothing_raised { yiq = @gs.to_yiq }
+      assert_kind_of(Color::YIQ, yiq)
+      assert_in_delta(0.33, yiq.y, Color::COLOR_TOLERANCE)
+      assert_in_delta(0.0, yiq.i, Color::COLOR_TOLERANCE)
+      assert_in_delta(0.0, yiq.q, Color::COLOR_TOLERANCE)
+    end
+
+    def test_add
+      delta = @gs + Color::GrayScale.new(20)
+      max   = @gs + Color::GrayScale.new(80)
+
+      assert_in_delta(1.0, max.g, Color::COLOR_TOLERANCE)
+      assert_in_delta(0.53, delta.g, Color::COLOR_TOLERANCE)
+    end
+
+    def test_subtract
+      delta = @gs - Color::GrayScale.new(20)
+      max   = @gs - Color::GrayScale.new(80)
+      assert_in_delta(0.0, max.g, Color::COLOR_TOLERANCE)
+      assert_in_delta(0.13, delta.g, Color::COLOR_TOLERANCE)
+    end
+
+    def test_inspect
+      assert_equal("Gray [33.00%]", @gs.inspect)
+    end
+  end
+end