color 0.1.0 → 1.4.0

data/History.txt

@@ -0,0 +1,91 @@
+== Color 1.4.0 / 2007.02.11
+* Merged Austin Ziegler's color-tools library (previously part of the Ruby
+  PDF Tools project) with Matt Lyon's color library.
+  - The HSL implementation from the Color class has been merged into
+    Color::HSL. Color is a module the way it was for color-tools.
+  - A thin veneer has been written to allow Color::new to return a Color::HSL
+    instance; Color::HSL supports as many methods as possible that were
+    previously supported by the Color class.
+  - Values that were previously rounded by Color are no longer rounded;
+    fractional values matter.
+* Converted to hoe for project management.
+* Moved to the next step of deprecating Color::Name values; printing a
+  warning for each use (see the history for color-tools 1.3.0).
+* Print a warning on the access of either VERSION or COLOR_TOOLS_VERSION; the
+  version constant is now COLOR_VERSION.
+* Added humanized versions of accessors (e.g., CMYK colours now have both #cyan
+  and #c to access the cyan component of the colour; #cyan provides the value
+  as a percentage).
+* Added CSS3 formatters for RGB, RGBA, HSL, and HSLA outputs. Note that the
+  Color library does not yet have a way of setting alpha opacity, so the
+  output for RGBA and HSLA are at full alpha opacity (1.0). The values are
+  output with two decimal places.
+* Applied a patch to provide simple arithmetic colour addition and subtraction
+  to Color::GrayScale and Color::RGB. The patch was contributed by Jeremy
+  Hinegardner <jeremy@hinegardner.org>. This patch also provides the ability to
+  return the maximum RGB value as a grayscale colour.
+* Fixed two problems reported by Jean Krohn <jb.krohn@free.fr> against
+  color-tools relating to RGB-to-HSL and HSL-to-RGB conversion. (Color and
+  color-tools use the same formulas, but the ordering of the calculations is
+  slightly different with Color and did not suffer from this problem;
+  color-tools was more sensitive to floating-point values and precision
+  errors.)
+* Fixed an issue with HSL/RGB conversions reported by Adam Johnson
+  <adam.sven.johnson@gmail.com>.
+* Added an Adobe Color swatch (Photoshop) palette reader,
+  Color::Palette::AdobeColor (for .aco files only).
+
+== Color 0.1.0 / 2006.08.05
+* Added HSL (degree, percent, percent) interface.
+* Removed RGB instance variable; color is managed internally as HSL floating
+  point.
+* Tests!
+
+== color-tools 1.3.0
+* Added new metallic colours suggested by Jim Freeze <jfn@freeze.org>. These
+  are in the namespace Color::Metallic.
+* Colours that were defined in the Color namespace (e.g., Color::Red,
+  Color::AliceBlue) are now defined in Color::RGB (e.g., Color::RGB::Red,
+  Color::RGB::AliceBlue). They are added back to the Color namespace on the
+  first use of the old colours and a warning is printed. In version 1.4, this
+  warning will be printed on every use of the old colours. In version 1.5,
+  the backwards compatible support for colours like Color::Red will be
+  removed completely.
+* Added the Color::CSS module, color/css or Color::CSS that provides a name
+  lookup of Color::RGB-namespaced constants with Color::CSS[name]. Most of
+  these colours (which are mirrored from the Color::RGB default colours) are
+  only "officially" recognised under the CSS3 colour module or SVG.
+* Added the Color::HSL colour space and some helper utilities to Color::RGB
+  for colour manipulation using the HSL value.
+* Controlled internal value replacement to be between 0 and 1 for all
+  colours.
+* Updated Color::Palette::Gimp to more meaningfully deal with duplicate named
+  colours. Named colours now return an array of colours.
+* Indicated the plans for some methods and constants out to color-tools 2.0.
+* Added unit tests and fixed a number of hidden bugs because of them.
+
+== color-tools 1.2.0
+* Changed installer from a custom-written install.rb to setup.rb
+  3.3.1-modified.
+* Added Color::GreyScale (or Color::GrayScale).
+* Added Color::YIQ. This colour definition is incomplete; it does not have
+  conversions from YIQ to other colour spaces.
+
+== color-tools 1.1.0
+* Added color/palette/gimp to support the reading and use of GIMP color
+  palettes.
+
+== color-tools 1.0.0
+* Initial release.
+
+== Copyright
+  Color
+  Colour Management with Ruby
+  http://rubyforge.org/projects/color
+
+  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: History.txt 50 2007-02-03 20:26:19Z austin $

data/Install.txt

@@ -0,0 +1,20 @@
+== Installing Color
+
+Color may be installed with:
+
+  % ruby setup.rb
+
+Alternatively, the RubyGems version of Color may be installed from the usual
+sources.
+
+== Copyright
+  Color
+  Colour Management with Ruby
+  http://rubyforge.org/projects/color
+
+  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: History.txt 50 2007-02-03 20:26:19Z austin $

data/Licence.txt

@@ -0,0 +1,29 @@
+Color
+Colour management in Ruby
+http://rubyforge.org/projects/color/
+
+Copyright (c) 2005 - 2007 Austin Ziegler, Matt Lyon, and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+* The names of its contributors may not be used to endorse or promote
+  products derived from this software without specific prior written
+  permission.
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+$Id: History.txt 50 2007-02-03 20:26:19Z austin $

data/Manifest.txt

@@ -0,0 +1,31 @@
+History.txt
+Install.txt
+Licence.txt
+Manifest.txt
+Rakefile
+Readme.txt
+lib/color.rb
+lib/color/cmyk.rb
+lib/color/css.rb
+lib/color/grayscale.rb
+lib/color/hsl.rb
+lib/color/palette.rb
+lib/color/palette/adobecolor.rb
+lib/color/palette/gimp.rb
+lib/color/palette/monocontrast.rb
+lib/color/rgb-colors.rb
+lib/color/rgb.rb
+lib/color/rgb/metallic.rb
+lib/color/yiq.rb
+setup.rb
+test/test_adobecolor.rb
+test/test_all.rb
+test/test_cmyk.rb
+test/test_color.rb
+test/test_css.rb
+test/test_gimp.rb
+test/test_grayscale.rb
+test/test_hsl.rb
+test/test_monocontrast.rb
+test/test_rgb.rb
+test/test_yiq.rb

data/Rakefile

@@ -1,53 +1,116 @@
-require 'rake'
-require 'rake/gempackagetask'
-# require 'rake/rdoctask'
-require 'rake/testtask'
+#! /usr/bin/env rake
+#--
+# Color
+# Colour Management with Ruby
+# http://rubyforge.org/projects/color
+#
+# 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: History.txt 50 2007-02-03 20:26:19Z austin $
+#++
+
 require 'rubygems'
+require 'hoe'
+
+$LOAD_PATH.unshift('lib')
 
-$:.unshift(File.dirname(__FILE__) + "/lib")
 require 'color'
 
-PKG_NAME      = 'color'
-PKG_VERSION   = Color::VERSION
-PKG_FILE_NAME = "#{PKG_NAME}-#{PKG_VERSION}"
+PKG_NAME    = 'color'
+PKG_VERSION = Color::COLOR_VERSION
+PKG_DIST    = "#{PKG_NAME}-#{PKG_VERSION}"
+PKG_TAR     = "pkg/#{PKG_DIST}.tar.gz"
+MANIFEST    = File.read("Manifest.txt").split
+
+Hoe.new PKG_NAME, PKG_VERSION do |p|
+  p.rubyforge_name  = PKG_NAME
+  # This is a lie becasue I will continue to use Archive::Tar::Minitar.
+  p.need_tar        = false
+  # need_zip - Should package create a zipfile? [default: false]
 
-RELEASE_NAME  = "REL #{PKG_VERSION}"
+  p.author          = [ "Austin Ziegler", "Matt Lyon" ]
+  p.email           = %W(austin@rubyforge.org matt@postsomnia.com)
+  p.url             = "http://color.rubyforge.org/"
+  p.summary         = "Colour management with Ruby"
+  p.changes         = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.description     = p.paragraphs_of("Readme.txt", 1..1).join("\n\n")
 
-RUBY_FORGE_PROJECT = "color"
-RUBY_FORGE_USER    = "mly"
+  p.extra_deps      << [ "archive-tar-minitar", "~>0.5.1" ]
 
-desc "Default Task"
-task :default => [ :test ]
+  p.clean_globs     << "coverage"
 
-Rake::TestTask.new do |t|
-  t.test_files = FileList['test/*_test.rb']
-  t.warning = true
-  t.verbose = false
+  p.spec_extras[:extra_rdoc_files] = MANIFEST.grep(/txt$/) -
+    ["Manifest.txt"]
 end
 
-spec = Gem::Specification.new do |s|
-  s.platform = Gem::Platform::RUBY
-  s.name = PKG_NAME
-  s.summary = "A Simply Library for Color Manipulation"
-  s.description = %q{Manipulate Colors Programatically}
-  s.version = PKG_VERSION
-  
-  s.author = "Matt Lyon"
-  s.email = "matt@postsomnia.com"
-  s.rubyforge_project = RUBY_FORGE_PROJECT
-  s.homepage = ""
-  
-  s.has_rdoc = false
-  s.require_path = 'lib'
-  s.autorequire = 'color'
-  
-  s.files = [ "Rakefile", "README", "CHANGELOG", "LICENSE" ]
-  s.files = s.files + Dir.glob("lib/**/*").delete_if {|item| item.include?("\.svn")}
-  s.files = s.files + Dir.glob("test/**/*").delete_if {|item| item.include?("\.svn")}
+desc "Build a Color .tar.gz distribution."
+task :tar => [ PKG_TAR ]
+file PKG_TAR => [ :test ] do |t|
+  require 'archive/tar/minitar'
+  require 'zlib'
+  files = MANIFEST.map { |f|
+    fn = File.join(PKG_DIST, f)
+    tm = File.stat(f).mtime
+
+    if File.directory?(f)
+      { :name => fn, :mode => 0755, :dir => true, :mtime => tm }
+    else
+      mode = if f =~ %r{^bin}
+               0755
+             else
+               0644
+             end
+      data = File.read(f)
+      { :name => fn, :mode => mode, :data => data, :size => data.size,
+        :mtime => tm }
+    end
+  }
+
+  begin
+    unless File.directory?(File.dirname(t.name))
+      require 'fileutils'
+      File.mkdir_p File.dirname(t.name)
+    end
+    tf = File.open(t.name, 'wb')
+    gz = Zlib::GzipWriter.new(tf)
+    tw = Archive::Tar::Minitar::Writer.new(gz)
+
+    files.each do |entry|
+      if entry[:dir]
+        tw.mkdir(entry[:name], entry)
+      else
+        tw.add_file_simple(entry[:name], entry) { |os|
+          os.write(entry[:data])
+        }
+      end
+    end
+  ensure
+    tw.close if tw
+    gz.close if gz
+  end
 end
+task :package => [ PKG_TAR ]
+
+desc "Build the manifest file from the current set of files."
+task :build_manifest do |t|
+  require 'find'
+
+  paths = []
+  Find.find(".") do |path|
+    next if File.directory?(path)
+    next if path =~ /\.svn/
+    next if path =~ /\.swp$/
+    next if path =~ %r{coverage/}
+    next if path =~ /~$/
+    paths << path.sub(%r{^\./}, '')
+  end
 
-Rake::GemPackageTask.new(spec) do |p|
-  p.gem_spec = spec
-  p.need_tar = true
-  p.need_zip = true
-end
+  File.open("Manifest.txt", "w") do |f|
+    f.puts paths.sort.join("\n")
+  end
+
+  puts paths.sort.join("\n")
+end

data/Readme.txt

@@ -0,0 +1,33 @@
+= Color
+Color is a Ruby library to provide basic RGB, CMYK, HSL, and other colourspace
+manipulation support to applications that require it. It also provides 152
+named RGB colours (184 with spelling variations) that are commonly supported
+in HTML, SVG, and X11 applications. A technique for generating monochromatic
+contrasting palettes is also included.
+
+The capabilities of the Color library are limited to pure mathematical
+manipulation of the colours based on colour theory without reference to colour
+profiles (such as sRGB or Adobe RGB). For most purposes, when working with the
+RGB and HSL colours, this won't matter. However, some colour models (like CIE
+L*a*b*) are not supported because Color does not yet support colour profiles,
+giving no meaningful way to convert colours in absolute colour spaces (like
+L*a*b*, XYZ) to non-absolute colour spaces (like RGB).
+
+Color version 1.4 is the result of a project merge between color.rb 0.1.0 by
+Matt Lyon and color-tools 1.3 by Austin Ziegler. Please see History.txt for
+details on the changes this merge brings.
+
+Copyright:: Copyright (c) 2005 - 2007 by Austin Ziegler and Matt Lyon
+Version::   1.4.0
+Homepage::  http://rubyforge.org/projects/color/
+Licence::   MIT-Style; see Licence.txt
+
+Color::Palette was developed based on techniques described by Andy "Malarkey"
+Clarke[1], implemented in JavaScript by Steve G. Chipman at SlayerOffice[2] and
+by Patrick Fitzgerald of BarelyFitz[3] in PHP.
+
+[1] http://www.stuffandnonsense.co.uk/archives/creating_colour_palettes.html 
+[2] http://slayeroffice.com/tools/color_palette/
+[3] http://www.barelyfitz.com/projects/csscolor/
+
+$Id: Readme.txt 50 2007-02-03 20:26:19Z austin $

data/lib/color.rb

@@ -1,202 +1,147 @@
-class Color
-  
-  VERSION = "0.1.0"
-  
-  # attr_accessor :rgb
-  attr_accessor :hue
-  attr_accessor :saturation
-  attr_accessor :lightness
-    
-  def initialize(values, mode=:rgb)
-    rgb = case mode
-    when :hsl
-      Color.hsl_to_rgb(values)
-    when :rgb
-      values = [values].flatten
-      case values.size
-      when 1
-        Color.rgbhex_to_rgb(values.first)
-      else
-        values
-      end
-    when :cmyk
-      Color.cmyk_to_rgb(values)
-    end
-    rgb.collect! {|n| n.coerce(0).max.coerce(255).min }
-    @hue, @saturation, @lightness = Color.rgb_to_hsl(rgb)
-  end
-  
-  def hue=(value)
-    value = value.abs >= 1 ? (value/360.0) : value
-    @hue = value
-    @hue += 1 if @hue < 0 # color is _perceived_ as a wheel, not a continuum
-    @hue -= 1 if @hue > 1
-  end
-  
-  def hue
-    (@hue * 360).round
-  end
-  
-  def saturation
-    (@saturation * 100).round
-  end
-  
-  def saturation=(value)
-    @saturation = value.abs >= 1 ? (value / 100.0) : value
-    @saturation = @saturation.coerce(0.0).max.coerce(1.0).min
-  end
-  
-  def lightness
-    (@lightness * 100).round
-  end
-  
-  def lightness=(value)
-    @lightness = value.abs >= 1 ? (value / 100.0) : value
-    @lightness = @lightness.coerce(0.0).max.coerce(1.0).min
-  end
-  
-  def mix_with(color, percent_as_decimal=0.5)
-    target = color.to_hsl
-    deltas = []
-    self.hsl.each_with_index {|val, i| deltas[i] = target[i] - val }
-    deltas.collect! {|n| n * percent_as_decimal }
-    new_color = []
-    deltas.each_with_index {|val, i| new_color[i] = val + self.hsl[i] }
-    Color.new(new_color, :hsl)
-  end
-  
-  def hsl
-    [@hue, @saturation, @lightness]
-  end
-  
-  def to_hsl
-    [(@hue * 360.0).round, (@saturation * 100.0).round, (@lightness * 100.0).round]
-  end
-    
-  def to_rgb
-    Color.hsl_to_rgb(hsl)
-  end
-  
-  def to_hex
-    Color.rgb_to_rgbhex(@rgb)
-  end
-  
-  def to_cmyk
-    Color.rgb_to_cmyk(@rgb)
-  end
-  
+# :title: Color -- Colour Management with Ruby
+# :main: Readme.txt
+
+#--
+# 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 $
+#++
+
+# = Colour Management with Ruby
+module Color
+  COLOR_VERSION = '1.4.0'
+
+  class RGB; end
+  class CMYK; end
+  class GrayScale; end
+  class YIQ; end
+
+  # The maximum "resolution" for colour math; if any value is less than or
+  # equal to this value, it is treated as zero.
+  COLOR_EPSILON = 1e-5
+  # The tolerance for comparing the components of two colours. In general,
+  # colours are considered equal if all of their components are within this
+  # tolerance value of each other.
+  COLOR_TOLERANCE = 1e-4
+
   class << self
-    
-    def rgb_to_rgbhex(rgb=[])
-      '#' + rgb.collect {|n| "%02X" % n }.join('').downcase
+    # Returns +true+ if the value is less than COLOR_EPSILON.
+    def near_zero?(value)
+      (value.abs <= COLOR_EPSILON)
     end
-    
-    def rgbhex_to_rgb(value)
-      rg, blue = value.sub(/#/,'').hex.divmod(256)
-      red, green = rg.divmod(256)
-      return red, green, blue
+
+    # Returns +true+ if the value is within COLOR_EPSILON of zero or less than
+    # zero.
+    def near_zero_or_less?(value)
+      (value < 0.0 or near_zero?(value))
     end
-    
-    # conversion formulas from http://www.easyrgb.com/math.php
-    # They're on Wikipedia too. And elsewhere, really, but the easyrbg ones
-    # were most easily translatable to ruby.
-    #
-    # What's the difference between HSL and HSV? Quite a bit. 
-    # Wikipedia knows all:
-    #   http://en.wikipedia.org/wiki/HSV_color_space
-    #   http://en.wikipedia.org/wiki/HSL_color_space
-    #
-    # Generally, HSL has a more decoupled notion of saturation and lightness
-    # whereas with HSV saturation and value are coupled in such a way as to
-    # not behave intuitively. HSV is a bit more mathematically straightforward.
-    # 
-    # Since the author of this library is an artist and has a personal bias
-    # towards HSL, this library reflects that bias and uses HSL internally.   
-    # HSL is also part of the CSS3 Color Module, if I haven't convinced you yet.
-    
-    def rgb_to_hsl(rgb=[])
-      r, g, b, min, max, delta = rgb_to_values(rgb)
-      lightness = (max + min) / 2.0
-      return [0,0,lightness] if delta.zero?  # gray, no chroma
-      saturation = (lightness < 0.5) ? (delta / (max + min)) : (delta / (2.0 - max - min))
-      hue = figure_hue_for(rgb)
-      return hue, saturation, lightness
+
+    # Returns +true+ if the value is within COLOR_EPSILON of one.
+    def near_one?(value)
+      near_zero?(value - 1.0)
     end
-    
-    def rgb_to_hsl_human(rgb=[])
-      h,s,l = Color.rgb_to_hsl(rgb)
-      return (h * 360).round, (s * 100).round, (l * 100).round
+
+    # Returns +true+ if the value is within COLOR_EPSILON of one or more than
+    # one.
+    def near_one_or_more?(value)
+      (value > 1.0 or near_one?(value))
     end
-    
-    def hsl_to_rgb(hsl=[])
-      h, s, l = hsl
-      if h > 1 || s > 1 || l > 1
-        h = h / 360.0
-        s = s * 0.01
-        l = l * 0.01
-      end
-      return [l,l,l].collect {|l| (l * 255.0).round } if s.zero? # gray, no chroma
-      v2 = (l < 0.5) ? (l * (1 + s)) : (l + s) - (s * l)
-      v1 = 2.0 * l - v2
-      rgb = [h+(1/3.0), h, h-(1/3.0)]
-      rgb.collect! do |hue|
-        hue += 1 if hue < 0
-        hue -= 1 if hue > 1
-        if (6 * hue) < 1
-          v1 + (v2 - v1) * 6 * hue
-        elsif (2 * hue) < 1
-          v2
-        elsif (3 * hue) < 2
-          v1 + (v2 - v1) * ((2 / 3.0) - hue) * 6
-        else
-          v1
-        end
+
+    # Normalizes the value to the range (0.0) .. (1.0).
+    def normalize(value)
+      if near_zero_or_less? value
+        0.0
+      elsif near_one_or_more? value
+        1.0
+      else
+        value
       end
-      return rgb.collect {|n| (n * 255.0).round }
     end
-    
-    # def rgb_to_hsv(rgb=[])
-    #   r, g, b, min, max, delta = rgb_to_values(rgb)
-    #   value = max
-    #   return [0.0, 0.0, value] if delta.zero? # gray, no chroma
-    #   saturation = delta / max
-    #   hue = figure_hue_for(rgb)
-    #   return hue, saturation, value
-    # end
-        
-    def rgb_to_cmyk(rgb=[])
-      cmy = rgb.collect {|n| 1 - (n / 255.0)}
-      k = cmy.min
-      return [0.0,0.0,0.0,1.0] if k == 1.0  # black
-      cmy.collect {|n| (n - k) / (1 - k) } << k
+    alias normalize_fractional normalize
+
+    def normalize_to_range(value, range)
+      range = (range.end..range.begin) if (range.end < range.begin)
+
+      if value <= range.begin
+        range.begin
+      elsif value >= range.end
+        range.end
+      else
+        value
+      end
     end
-    
-    def cmyk_to_rgb(cmyk=[])
-      c,m,y,k = cmyk
-      [c,m,y].collect {|n| ((1 - (n * (1 - k) + k)) * 255.0).to_i }
+
+    # Normalize the value to the range (0) .. (255).
+    def normalize_byte(value)
+      normalize_to_range(value, 0..255).to_i
     end
+    alias normalize_8bit normalize_byte
     
-    private
-    def rgb_to_values(rgb=[])
-      rgb.collect! {|n| n / 255.0 }
-      rgb << rgb.min << rgb.max << rgb.max - rgb.min
+    # Normalize the value to the range (0) .. (65535).
+    def normalize_word(value)
+      normalize_to_range(value, 0..65535).to_i
     end
-    
-    def figure_hue_for(rgb=[])
-      r, g, b, min, max, delta = rgb_to_values(rgb)
-      delta_r, delta_g, delta_b = [r,g,b].collect {|n| (((max - n) / 6.0) + (delta / 2.0)) / delta }
-      hue = if r.eql? max
-        delta_b - delta_g
-      elsif g.eql? max
-        (1 / 3.0) + delta_r - delta_b
-      else # blue
-        (2 / 3.0) + delta_g - delta_r
+    alias normalize_16bit normalize_word
+  end
+end
+
+require 'color/rgb'
+require 'color/cmyk'
+require 'color/grayscale'
+require 'color/hsl'
+require 'color/yiq'
+require 'color/rgb/metallic'
+
+module Color
+  def self.const_missing(name) #:nodoc:
+    case name
+    when "VERSION", :VERSION, "COLOR_TOOLS_VERSION", :COLOR_TOOLS_VERSION
+      warn "Color::#{name} has been deprecated. Use Color::COLOR_VERSION instead."
+      Color::COLOR_VERSION
+    else
+      if Color::RGB.const_defined?(name)
+        warn "Color::#{name} has been deprecated. Use Color::RGB::#{name} instead."
+        Color::RGB.const_get(name)
+      else
+        super
       end
-      hue += 1 if hue < 0
-      hue -= 1 if hue > 1
-      hue
     end
-    
   end
-  
-end
+
+  # Provides a thin veneer over the Color module to make it seem like this
+  # is Color 0.1.0 (a class) and not Color 1.4.0 (a module). This
+  # "constructor" will be removed in the future.
+  #
+  # mode = :hsl::   +values+ must be an array of [ hue deg, sat %, lum % ].
+  #                 A Color::HSL object will be created.
+  # mode = :rgb::   +values+ will either be an HTML-style colour string or
+  #                 an array of [ red, green, blue ] (range 0 .. 255). A
+  #                 Color::RGB object will be created.
+  # mode = :cmyk::  +values+ must be an array of [ cyan %, magenta %, yellow
+  #                 %, black % ]. A Color::CMYK object will be created.
+  def self.new(values, mode = :rgb)
+    warn "Color.new has been deprecated. Use Color::#{mode.to_s.upcase}.new instead."
+    color = case mode
+            when :hsl
+              Color::HSL.new(*values)
+            when :rgb
+              values = [ values ].flatten
+              if values.size == 1
+                Color::RGB.from_html(*values)
+              else
+                Color::RGB.new(*values)
+              end
+            when :cmyk
+              Color::CMYK.new(*values)
+            end
+    color.to_hsl
+  end
+end