timocratic-color 1.4.1.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

@@ -0,0 +1,116 @@
+#! /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')
+
+require 'color'
+
+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]
+
+  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")
+
+  p.extra_dev_deps      << [ "archive-tar-minitar", "~>0.5.1" ]
+
+  p.clean_globs     << "coverage"
+
+  p.spec_extras[:extra_rdoc_files] = MANIFEST.grep(/txt$/) -
+    ["Manifest.txt"]
+end
+
+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
+
+  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

@@ -0,0 +1,147 @@
+# :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.1.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
+    # Returns +true+ if the value is less than COLOR_EPSILON.
+    def near_zero?(value)
+      (value.abs <= COLOR_EPSILON)
+    end
+
+    # 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
+
+    # Returns +true+ if the value is within COLOR_EPSILON of one.
+    def near_one?(value)
+      near_zero?(value - 1.0)
+    end
+
+    # 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
+
+    # 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
+    end
+    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
+
+    # 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
+    
+    # Normalize the value to the range (0) .. (65535).
+    def normalize_word(value)
+      normalize_to_range(value, 0..65535).to_i
+    end
+    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
+    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