color-tools 1.0.0

data/Changelog

@@ -0,0 +1,2 @@
+== color-utils 1.0.0
+* Initial release.

data/Install

@@ -0,0 +1,6 @@
+Installing this package is as simple as:
+
+% ruby install.rb
+
+Alternatively, you can use the RubyGem version of color-tools available as
+color-tools-1.0.0.gem from the usual sources.

data/README

@@ -0,0 +1,46 @@
+color-tools README
+==================
+color-tools is a Ruby library to provide RGB and CMYK colour support to
+applications that require it. It provides 148 named RGB colours that are
+commonly supported and used in HTML, colour manipulation operations, and
+a monochromatic contrasting palette generator.
+
+Copyright
+=========
+Copyright 2005 by Austin Ziegler
+
+Color::RGB and Color::CMYK were originally developed for the Ruby PDF
+project and PDF::Writer and represent wholly unique code.
+
+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.
+
+Licence
+=======
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Soft-
+ware"), 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 MERCHANTABIL-
+ITY, 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.
+
+[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/

data/Rakefile

@@ -0,0 +1,116 @@
+#! /usr/bin/env rake
+$LOAD_PATH.unshift('lib')
+
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'color'
+require 'archive/tar/minitar'
+require 'zlib'
+
+DISTDIR = "color-tools-#{Color::COLOR_TOOLS_VERSION}"
+TARDIST = "../#{DISTDIR}.tar.gz"
+
+DATE_RE = %r<(\d{4})[./-]?(\d{2})[./-]?(\d{2})(?:[\sT]?(\d{2})[:.]?(\d{2})[:.]?(\d{2})?)?>
+
+if ENV['RELEASE_DATE']
+  year, month, day, hour, minute, second = DATE_RE.match(ENV['RELEASE_DATE']).captures
+  year ||= 0
+  month ||= 0
+  day ||= 0
+  hour ||= 0
+  minute ||= 0
+  second ||= 0
+  ReleaseDate = Time.mktime(year, month, day, hour, minute, second)
+else
+  ReleaseDate = nil
+end
+
+task :test do |t|
+  require 'test/unit/testsuite'
+  require 'test/unit/ui/console/testrunner'
+
+  runner = Test::Unit::UI::Console::TestRunner
+
+  $LOAD_PATH.unshift('tests')
+  $stderr.puts "Checking for test cases:" if t.verbose
+  Dir['tests/tc_*.rb'].each do |testcase|
+    $stderr.puts "\t#{testcase}" if t.verbose
+    load testcase
+  end
+
+  suite = Test::Unit::TestSuite.new("color-tools")
+
+  ObjectSpace.each_object(Class) do |testcase|
+    suite << testcase.suite if testcase < Test::Unit::TestCase
+  end
+
+  runner.run(suite)
+end
+
+spec = eval(File.read("color-tools.gemspec"))
+spec.version = Color::COLOR_TOOLS_VERSION
+desc "Build the RubyGem for color-tools"
+task :gem => [ :test ]
+Rake::GemPackageTask.new(spec) do |g|
+  g.need_tar    = false
+  g.need_zip    = false
+  g.package_dir = ".."
+end
+
+desc "Build a color-tools .tar.gz distribution."
+task :tar => [ TARDIST ]
+file TARDIST => [ :test ] do |t|
+  current = File.basename(Dir.pwd)
+  Dir.chdir("..") do
+    begin
+      files = Dir["#{current}/**/*"].select { |dd| dd !~ %r{(?:/CVS/?|~$)} }
+      files.map! do |dd|
+        ddnew = dd.gsub(/^#{current}/, DISTDIR)
+        mtime = ReleaseDate || File.stat(dd).mtime
+        if File.directory?(dd)
+          { :name => ddnew, :mode => 0755, :dir => true, :mtime => mtime }
+        else
+          if dd =~ %r{bin/}
+            mode = 0755
+          else
+            mode = 0644
+          end
+          data = File.read(dd)
+          { :name => ddnew, :mode => mode, :data => data, :size => data.size,
+            :mtime => mtime }
+        end
+      end
+
+      ff = File.open(t.name.gsub(%r{^\.\./}o, ''), "wb")
+      gz = Zlib::GzipWriter.new(ff)
+      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
+end
+task TARDIST => [ :test ]
+
+def sign(file)
+  system %("C:/Apps/GnuPG/gpg.exe" -ba #{file}).gsub(%r{/}) { "\\" }
+  raise "Error signing with GPG." unless File.exists?("#{file}.asc")
+end
+
+task :signtar => [ :tar ] do
+  sign TARDIST
+end
+task :signgem => [ :gem ] do
+  sign "../#{DISTDIR}.gem"
+end
+
+desc "Build everything."
+task :default => [ :signtar, :signgem ]

data/lib/color.rb

@@ -0,0 +1,201 @@
+# = Colour Management with Ruby
+#
+# == Copyright
+# Copyright 2005 by Austin Ziegler
+#
+# Color::RGB and Color::CMYK were originally developed for the Ruby PDF
+# project and PDF::Writer and represent wholly unique code.
+#
+# Color::Palette was developed based on techniques described by Andy
+# "Malarkey"[http://www.stuffandnonsense.co.uk/archives/creating_colour_palettes.html]
+# Clarke, implemented in JavaScript by Steve G. Chipman at
+# SlayerOffice[http://slayeroffice.com/tools/color_palette/] and by Patrick
+# Fitzgerald of BarelyFitz[http://www.barelyfitz.com/projects/csscolor/] in
+# PHP.
+#
+# == LICENCE
+# 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.
+
+require 'color/rgb'
+require 'color/cmyk'
+
+module Color
+  COLOR_TOOLS_VERSION = '1.0.0'
+
+  Black                 = Color::RGB.new
+  Navy                  = Color::RGB.new(0x00, 0x00, 0x80)
+  DarkBlue              = Color::RGB.new(0x00, 0x00, 0x8b)
+  MediumBlue            = Color::RGB.new(0x00, 0x00, 0xcd)
+  Blue                  = Color::RGB.new(0x00, 0x00, 0xff)
+  DarkGreen             = Color::RGB.new(0x00, 0x64, 0x00)
+  Green                 = Color::RGB.new(0x00, 0x80, 0x00)
+  Teal                  = Color::RGB.new(0x00, 0x80, 0x80)
+  DarkCyan              = Color::RGB.new(0x00, 0x8b, 0x8b)
+  DeepSkyBlue           = Color::RGB.new(0x00, 0xbf, 0xbf)
+  DarkTurquoise         = Color::RGB.new(0x00, 0xce, 0xd1)
+  MediumSpringGreen     = Color::RGB.new(0x00, 0xfa, 0x9a)
+  Lime                  = Color::RGB.new(0x00, 0xff, 0x00)
+  SpringGreen           = Color::RGB.new(0x00, 0xff, 0x7f)
+  Aqua                  = Color::RGB.new(0x00, 0xff, 0xff)
+  Cyan                  = Color::RGB.new(0x00, 0xff, 0xff)
+  MidnightBlue          = Color::RGB.new(0x19, 0x19, 0x70)
+  DodgerBlue            = Color::RGB.new(0x1e, 0x90, 0xff)
+  LightSeaGreen         = Color::RGB.new(0x20, 0xb2, 0xaa)
+  ForestGreen           = Color::RGB.new(0x22, 0x8b, 0x22)
+  SeaGreen              = Color::RGB.new(0x2e, 0x8b, 0x57)
+  DarkSlateGray         = Color::RGB.new(0x2f, 0x4f, 0x4f)
+  DarkSlateGrey         = DarkSlateGray
+  LimeGreen             = Color::RGB.new(0x32, 0xcd, 0x32)
+  MediumSeaGreen        = Color::RGB.new(0x3c, 0xb3, 0x71)
+  Turquoise             = Color::RGB.new(0x40, 0xe0, 0xd0)
+  RoyalBlue             = Color::RGB.new(0x41, 0x69, 0xe1)
+  SteelBlue             = Color::RGB.new(0x46, 0x82, 0xb4)
+  DarkSlateBlue         = Color::RGB.new(0x48, 0x3d, 0x8b)
+  MediumTurquoise       = Color::RGB.new(0x48, 0xd1, 0xcc)
+  Indigo                = Color::RGB.new(0x4b, 0x00, 0x82)
+  DarkoliveGreen        = Color::RGB.new(0x55, 0x6b, 0x2f)
+  CadetBlue             = Color::RGB.new(0x5f, 0x9e, 0xa0)
+  CornflowerBlue        = Color::RGB.new(0x64, 0x95, 0xed)
+  MediumAquamarine      = Color::RGB.new(0x66, 0xcd, 0xaa)
+  DimGray               = Color::RGB.new(0x69, 0x69, 0x69)
+  DimGrey               = DimGray
+  SlateBlue             = Color::RGB.new(0x6a, 0x5a, 0xcd)
+  Olivedrab             = Color::RGB.new(0x6b, 0x8e, 0x23)
+  SlateGray             = Color::RGB.new(0x70, 0x80, 0x90)
+  SlateGrey             = SlateGray
+  LightSlateGray        = Color::RGB.new(0x77, 0x88, 0x99)
+  LightSlateGrey        = LightSlateGray
+  MediumSlateBlue       = Color::RGB.new(0x7b, 0x68, 0xee)
+  LawnGreen             = Color::RGB.new(0x7c, 0xfc, 0x00)
+  Chartreuse            = Color::RGB.new(0x7f, 0xff, 0x00)
+  Aquamarine            = Color::RGB.new(0x7f, 0xff, 0xd4)
+  Maroon                = Color::RGB.new(0x80, 0x00, 0x00)
+  Purple                = Color::RGB.new(0x80, 0x00, 0x80)
+  Olive                 = Color::RGB.new(0x80, 0x80, 0x00)
+  Gray                  = Color::RGB.new(0x80, 0x80, 0x80)
+  Grey                  = Gray
+  SkyBlue               = Color::RGB.new(0x87, 0xce, 0xeb)
+  LightSkyBlue          = Color::RGB.new(0x87, 0xce, 0xfa)
+  BlueViolet            = Color::RGB.new(0x8a, 0x2b, 0xe2)
+  DarkRed               = Color::RGB.new(0x8b, 0x00, 0x00)
+  DarkMagenta           = Color::RGB.new(0x8b, 0x00, 0x8b)
+  SaddleBrown           = Color::RGB.new(0x8b, 0x45, 0x13)
+  DarkSeaGreen          = Color::RGB.new(0x8f, 0xbc, 0x8f)
+  LightGreen            = Color::RGB.new(0x90, 0xee, 0x90)
+  MediumPurple          = Color::RGB.new(0x93, 0x70, 0xdb)
+  DarkViolet            = Color::RGB.new(0x94, 0x00, 0xd3)
+  PaleGreen             = Color::RGB.new(0x98, 0xfb, 0x98)
+  DarkOrchid            = Color::RGB.new(0x99, 0x32, 0xcc)
+  YellowGreen           = Color::RGB.new(0x9a, 0xcd, 0x32)
+  Sienna                = Color::RGB.new(0xa0, 0x52, 0x2d)
+  Brown                 = Color::RGB.new(0xa5, 0x2a, 0x2a)
+  DarkGray              = Color::RGB.new(0xa9, 0xa9, 0xa9)
+  DarkGrey              = DarkGray
+  LightBlue             = Color::RGB.new(0xad, 0xd8, 0xe6)
+  GreenYellow           = Color::RGB.new(0xad, 0xff, 0x2f)
+  PaleTurquoise         = Color::RGB.new(0xaf, 0xee, 0xee)
+  LightsteelBlue        = Color::RGB.new(0xb0, 0xc4, 0xde)
+  PowderBlue            = Color::RGB.new(0xb0, 0xe0, 0xe6)
+  Firebrick             = Color::RGB.new(0xb2, 0x22, 0x22)
+  DarkGoldenrod         = Color::RGB.new(0xb8, 0x86, 0x0b)
+  MediumOrchid          = Color::RGB.new(0xba, 0x55, 0xd3)
+  RosyBrown             = Color::RGB.new(0xbc, 0x8f, 0x8f)
+  DarkKhaki             = Color::RGB.new(0xbd, 0xb7, 0x6b)
+  Silver                = Color::RGB.new(0xc0, 0xc0, 0xc0)
+  MediumVioletRed       = Color::RGB.new(0xc7, 0x15, 0x85)
+  IndianRed             = Color::RGB.new(0xcd, 0x5c, 0x5c)
+  Peru                  = Color::RGB.new(0xcd, 0x85, 0x3f)
+  Chocolate             = Color::RGB.new(0xd2, 0x69, 0x1e)
+  Tan                   = Color::RGB.new(0xd2, 0xb4, 0x8c)
+  LightGray             = Color::RGB.new(0xd3, 0xd3, 0xd3)
+  LightGrey             = LightGray
+  Thistle               = Color::RGB.new(0xd8, 0xbf, 0xd8)
+  Orchid                = Color::RGB.new(0xda, 0x70, 0xd6)
+  Goldenrod             = Color::RGB.new(0xda, 0xa5, 0x20)
+  PaleVioletRed         = Color::RGB.new(0xdb, 0x70, 0x93)
+  Crimson               = Color::RGB.new(0xdc, 0x14, 0x3c)
+  Gainsboro             = Color::RGB.new(0xdc, 0xdc, 0xdc)
+  Plum                  = Color::RGB.new(0xdd, 0xa0, 0xdd)
+  Burlywood             = Color::RGB.new(0xde, 0xb8, 0x87)
+  LightCyan             = Color::RGB.new(0xe0, 0xff, 0xff)
+  Lavender              = Color::RGB.new(0xe6, 0xe6, 0xfa)
+  Darksalmon            = Color::RGB.new(0xe9, 0x96, 0x7a)
+  Violet                = Color::RGB.new(0xee, 0x82, 0xee)
+  PaleGoldenrod         = Color::RGB.new(0xee, 0xe8, 0xaa)
+  LightCoral            = Color::RGB.new(0xf0, 0x80, 0x80)
+  Khaki                 = Color::RGB.new(0xf0, 0xe6, 0x8c)
+  AliceBlue             = Color::RGB.new(0xf0, 0xf8, 0xff)
+  Honeydew              = Color::RGB.new(0xf0, 0xff, 0xf0)
+  Azure                 = Color::RGB.new(0xf0, 0xff, 0xff)
+  SandyBrown            = Color::RGB.new(0xf4, 0xa4, 0x60)
+  Wheat                 = Color::RGB.new(0xf5, 0xde, 0xb3)
+  Beige                 = Color::RGB.new(0xf5, 0xf5, 0xdc)
+  WhiteSmoke            = Color::RGB.new(0xf5, 0xf5, 0xf5)
+  MintCream             = Color::RGB.new(0xf5, 0xff, 0xfa)
+  GhostWhite            = Color::RGB.new(0xf8, 0xf8, 0xff)
+  Salmon                = Color::RGB.new(0xfa, 0x80, 0x72)
+  AntiqueWhite          = Color::RGB.new(0xfa, 0xeb, 0xd7)
+  Linen                 = Color::RGB.new(0xfa, 0xf0, 0xe6)
+  LightGoldenrodYellow  = Color::RGB.new(0xfa, 0xfa, 0xd2)
+  OldLace               = Color::RGB.new(0xfd, 0xf5, 0xe6)
+  Red                   = Color::RGB.new(0xff, 0x00, 0x00)
+  Fuchsia               = Color::RGB.new(0xff, 0x00, 0xff)
+  Magenta               = Color::RGB.new(0xff, 0x00, 0xff)
+  DeepPink              = Color::RGB.new(0xff, 0x14, 0x93)
+  OrangeRed             = Color::RGB.new(0xff, 0x45, 0x00)
+  Tomato                = Color::RGB.new(0xff, 0x63, 0x47)
+  HotPink               = Color::RGB.new(0xff, 0x69, 0xb4)
+  Coral                 = Color::RGB.new(0xff, 0x7f, 0x50)
+  Darkorange            = Color::RGB.new(0xff, 0x8c, 0x00)
+  Lightsalmon           = Color::RGB.new(0xff, 0xa0, 0x7a)
+  Orange                = Color::RGB.new(0xff, 0xa5, 0x00)
+  LightPink             = Color::RGB.new(0xff, 0xb6, 0xc1)
+  Pink                  = Color::RGB.new(0xff, 0xc0, 0xcb)
+  Gold                  = Color::RGB.new(0xff, 0xd7, 0x00)
+  Peachpuff             = Color::RGB.new(0xff, 0xda, 0xb9)
+  NavajoWhite           = Color::RGB.new(0xff, 0xde, 0xad)
+  Moccasin              = Color::RGB.new(0xff, 0xe4, 0xb5)
+  Bisque                = Color::RGB.new(0xff, 0xe4, 0xc4)
+  MistyRose             = Color::RGB.new(0xff, 0xe4, 0xe1)
+  BlanchedAlmond        = Color::RGB.new(0xff, 0xeb, 0xcd)
+  PapayaWhip            = Color::RGB.new(0xff, 0xef, 0xd5)
+  LavenderBlush         = Color::RGB.new(0xff, 0xf0, 0xf5)
+  Seashell              = Color::RGB.new(0xff, 0xf5, 0xee)
+  Cornsilk              = Color::RGB.new(0xff, 0xf8, 0xdc)
+  LemonChiffon          = Color::RGB.new(0xff, 0xfa, 0xcd)
+  FloralWhite           = Color::RGB.new(0xff, 0xfa, 0xf0)
+  Snow                  = Color::RGB.new(0xff, 0xfa, 0xfa)
+  Yellow                = Color::RGB.new(0xff, 0xff, 0x00)
+  LightYellow           = Color::RGB.new(0xff, 0xff, 0xe0)
+  Ivory                 = Color::RGB.new(0xff, 0xff, 0xf0)
+  White                 = Color::RGB.new(0xff, 0xff, 0xff)
+  Gray10 = Grey10       = Color::RGB.from_percentage(10, 10, 10)
+  Gray20 = Grey20       = Color::RGB.from_percentage(20, 20, 20)
+  Gray30 = Grey30       = Color::RGB.from_percentage(30, 30, 30)
+  Gray40 = Grey40       = Color::RGB.from_percentage(40, 40, 40)
+  Gray50 = Grey50       = Color::RGB.from_percentage(50, 50, 50)
+  Gray60 = Grey60       = Color::RGB.from_percentage(60, 60, 60)
+  Gray70 = Grey70       = Color::RGB.from_percentage(70, 70, 70)
+  Gray80 = Grey80       = Color::RGB.from_percentage(80, 80, 80)
+  Gray90 = Grey90       = Color::RGB.from_percentage(90, 90, 90)
+end

data/lib/color/cmyk.rb

@@ -0,0 +1,73 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#++
+
+require 'color/rgb'
+
+module Color
+    # An CMYK colour object.
+  class CMYK
+    PDF_FORMAT_STR = "%.3f %.3f %.3f %.3f %s"
+
+    def ==(other)
+      other = other.to_cmyk if other.kind_of?(Color::RGB)
+      other.kind_of?(Color::CMYK) and
+      (@c == other.c) and
+      (@m == other.m) and
+      (@y == other.y) and
+      (@k == other.k)
+    end
+
+      # Creates a CMYK colour object from fractional values 0 .. 1.
+    def self.from_fraction(c = 0, m = 0, y = 0, k = 0)
+      colour = Color::CMYK.new
+      colour.instance_variable_set(:@c, c)
+      colour.instance_variable_set(:@m, m)
+      colour.instance_variable_set(:@y, y)
+      colour.instance_variable_set(:@k, k)
+      colour
+    end
+
+      # Creates a CMYK colour object from percentages.
+    def initialize(c = 0, m = 0, y = 0, k = 0)
+      @c = c / 100.0
+      @m = m / 100.0
+      @y = y / 100.0
+      @k = k / 100.0
+    end
+
+      # Present the colour as a fill colour string for PDF.
+    def pdf_fill
+      PDF_FORMAT_STR % [ @c, @m, @y, @k, "k" ]
+    end
+
+      # Present the colour as a stroke colour string for PDF.
+    def pdf_stroke
+      PDF_FORMAT_STR % [ @c, @m, @y, @k, "K" ]
+    end
+
+      # Present the colour as an HTML/CSS colour string.
+    def html
+      to_rgb.html
+    end
+
+      # Convert the CMYK colour to RGB. Note that colour experts strongly
+      # suggest that this is a *bad* idea, as CMYK represents percentages of
+      # inks, not mixed colour intensities like RGB.
+    def to_rgb
+      r = 1.0 - (@c.to_f * (1.0 - @k.to_f) + @k.to_f)
+      g = 1.0 - (@m.to_f * (1.0 - @k.to_f) + @k.to_f)
+      b = 1.0 - (@y.to_f * (1.0 - @k.to_f) + @k.to_f)
+      Color::RGB.from_fraction(r, g, b)
+    end
+
+    def to_cmyk
+      self.dup
+    end
+
+    attr_accessor :c, :m, :y, :k
+  end
+end

data/lib/color/palette.rb

@@ -0,0 +1,11 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#++
+
+require 'color'
+
+module Color::Palette
+end

data/lib/color/palette/monocontrast.rb

@@ -0,0 +1,150 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#++
+
+require 'color/palette'
+
+  # Generates a monochromatic constrasting colour palette for background and
+  # foreground. What does this mean?
+  #
+  # Monochromatic: A single colour is used to generate the base palette, and
+  # this colour is lightened five times and darkened five times to provide
+  # eleven distinct colours.
+  #
+  # Contrasting: The foreground is also generated as a monochromatic colour
+  # palettte; however, all generated colours are tested to see that they are
+  # appropriately contrasting to ensure maximum readability of the
+  # foreground against the background.
+class Color::Palette::MonoContrast
+    # Hash of CSS background colour values.
+    # 
+    # This is always 11 values:
+    #
+    # 0::       The starting colour.
+    # +1..+5::  Lighter colours.
+    # -1..-5::  Darker colours.
+  attr_accessor :background
+    # Hash of CSS foreground colour values.
+    # 
+    # This is always 11 values:
+    #
+    # 0::       The starting colour.
+    # +1..+5::  Lighter colours.
+    # -1..-5::  Darker colours.
+  attr_accessor :foreground
+
+    # The minimum brightness difference between the background and the
+    # foreground. Setting this value will regenerate the palette based on
+    # the base colours. The default value for this is 125 / 255.0.
+  attr_accessor :minimum_brightness_diff
+  def minimum_brightness_diff=(bd) #:nodoc:
+    @minimum_brightness_diff = bd
+    regenerate(@background[0], @foreground[0])
+  end
+
+    # The minimum colour difference between the background and the
+    # foreground. Setting this value will regenerate the palette based on
+    # the base colours.
+  attr_accessor :minimum_color_diff
+  def minimum_color_diff=(cd) #:noco:
+    @minimum_color_diff = bd
+    regenerate(@background[0], @foreground[0])
+  end
+
+    # Generate the initial palette.
+  def initialize(background, foreground = nil)
+    @minimum_brightness_diff = 125 / 255.0
+    @minimum_color_diff = 500 / 765.0
+
+    regenerate(background, foreground)
+  end
+
+    # Generate the colour palettes.
+  def regenerate(background, foreground = nil)
+    foreground ||= background
+    background = background.to_rgb
+    foreground = foreground.to_rgb
+
+    @background = {}
+    @foreground = {}
+
+    @background[-5] = background.darken_by(10)
+    @background[-4] = background.darken_by(25)
+    @background[-3] = background.darken_by(50)
+    @background[-2] = background.darken_by(75)
+    @background[-1] = background.darken_by(85)
+    @background[ 0] = background
+    @background[+1] = background.lighten_by(85)
+    @background[+2] = background.lighten_by(75)
+    @background[+3] = background.lighten_by(50)
+    @background[+4] = background.lighten_by(25)
+    @background[+5] = background.lighten_by(10)
+
+    @foreground[-5] = calculate_foreground(@background[-5], foreground)
+    @foreground[-4] = calculate_foreground(@background[-4], foreground)
+    @foreground[-3] = calculate_foreground(@background[-3], foreground)
+    @foreground[-2] = calculate_foreground(@background[-2], foreground)
+    @foreground[-1] = calculate_foreground(@background[-1], foreground)
+    @foreground[ 0] = calculate_foreground(@background[ 0], foreground)
+    @foreground[+1] = calculate_foreground(@background[+1], foreground)
+    @foreground[+2] = calculate_foreground(@background[+2], foreground)
+    @foreground[+3] = calculate_foreground(@background[+3], foreground)
+    @foreground[+4] = calculate_foreground(@background[+4], foreground)
+    @foreground[+5] = calculate_foreground(@background[+5], foreground)
+  end
+
+    # Given a background colour and a foreground colour, modifies the
+    # foreground colour so that it will have enough contrast to be seen
+    # against the background colour.
+    #
+    # Uses #mininum_brightness_diff and #minimum_color_diff.
+  def calculate_foreground(background, foreground)
+    nfg = nil
+      # Loop through brighter and darker versions of the foreground color.
+      # The numbers here represent the amount of foreground color to mix
+      # with black and white.
+    [100, 75, 50, 25, 0].each do |percent|
+      dfg = foreground.darken_by(percent)
+      lfg = foreground.lighten_by(percent)
+
+      dbd = brightness_diff(background, dfg)
+      lbd = brightness_diff(background, lfg)
+
+      if lbd > dbd
+        nfg = lfg
+        nbd = lbd
+      else
+        nfg = dfg
+        nbd = dbd
+      end
+
+      ncd = color_diff(background, nfg)
+
+      break if nbd >= @minimum_brightness_diff and ncd >= @minimum_color_diff
+    end
+    nfg
+  end
+
+    # Returns the absolute difference between the brightness levels of two
+    # colours. This will be a decimal value between 0 and 1. W3C
+    # accessibility guidelines for colour
+    # contrast[http://www.w3.org/TR/AERT#color-contrast] suggest that this
+    # value be at least approximately 0.49 (125 / 255.0) for proper contrast.
+  def brightness_diff(c1, c2)
+    (c1.brightness - c2.brightness).abs
+  end
+
+    # Returns the contrast between to colours, a decimal value between 0 and
+    # 3. W3C accessibility guidelines for colour
+    # contrast[http://www.w3.org/TR/AERT#color-contrast] suggest that this
+    # value be at least approximately 1.96 (500 / 765.0) for proper contrast.
+  def color_diff(c1, c2)
+    r = (c1.r - c2.r).abs
+    g = (c1.g - c2.g).abs
+    b = (c1.b - c2.b).abs
+    r + g + b
+  end
+end

data/lib/color/rgb.rb

@@ -0,0 +1,155 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#++
+
+require 'color/cmyk'
+
+module Color
+    # An RGB colour object.
+  class RGB
+      # The format required to present the colour to a PDF document.
+    PDF_FORMAT_STR  = "%.3f %.3f %.3f %s"
+
+    class << self
+        # Creates an RGB colour object from percentages 0 .. 100.
+      def from_percentage(r = 0, g = 0, b = 0)
+        from_fraction(r / 100.0, g / 100.0, b / 100.0)
+      end
+
+        # Creates an RGB colour object from fractional values 0 .. 1.
+      def from_fraction(r = 0.0, g = 0.0, b = 0.0)
+        colour = Color::RGB.new
+        colour.instance_variable_set(:@r, r)
+        colour.instance_variable_set(:@g, g)
+        colour.instance_variable_set(:@b, b)
+        colour
+      end
+
+        # Creates an RGB colour object from an HTML colour descriptor (e.g.,
+        # <tt>"fed"</tt> or <tt>"#cabbed;"</tt>.
+      def from_html(html_colour)
+        html_colour = html_colour.gsub(%r{[#;]}, '')
+        case html_colour.size 
+        when 3
+          colours = html_colour.scan(%r{[0-9A-Fa-f]}).map { |el| (el * 2).to_i(16) }
+        when 6
+          colours = html_colour.scan(%r<[0-9A-Fa-f]{2}>).map { |el| el.to_i(16) }
+        else
+          raise ArgumentError
+        end
+
+        Color::RGB.new(*colours)
+      end
+    end
+
+    def ==(other)
+      other = other.to_rgb
+      other.kind_of?(Color::RGB) and
+      (@r == other.r) and
+      (@g == other.g) and
+      (@b == other.b)
+    end
+
+      # Creates an RGB colour object from the standard range 0 .. 255.
+    def initialize(r = 0, g = 0, b = 0)
+      @r = r / 255.0
+      @g = g / 255.0
+      @b = b / 255.0
+    end
+
+      # Present the colour as a fill colour string for PDF.
+    def pdf_fill
+      PDF_FORMAT_STR % [ @r, @g, @b, "rg" ]
+    end
+
+      # Present the colour as a stroke colour string for PDF.
+    def pdf_stroke
+      PDF_FORMAT_STR % [ @r, @g, @b, "RG" ]
+    end
+
+      # Present the colour as an HTML/CSS colour string.
+    def html
+      r = (@r * 255).round
+      r = 255 if r > 255
+
+      g = (@g * 255).round
+      g = 255 if g > 255
+
+      b = (@b * 255).round
+      b = 255 if b > 255
+
+      "#%02x%02x%02x" % [ r, g, b ]
+    end
+
+      # Convert the RGB colour to CMYK. Note that colour experts strongly
+      # suggest that this is a *bad* idea, as CMYK represents percentages of
+      # inks, not mixed colour intensities like RGB.
+    def to_cmyk
+      c = 1.0 - @r.to_f
+      m = 1.0 - @g.to_f
+      y = 1.0 - @b.to_f
+
+      k = 1.0
+      k = c if c < k
+      k = m if m < k
+      k = y if y < k
+
+      c = (c.to_f - k.to_f) / (1.0 - k.to_f)
+      m = (m.to_f - k.to_f) / (1.0 - k.to_f)
+      y = (y.to_f - k.to_f) / (1.0 - k.to_f)
+
+      Color::CMYK.new(c, m, y, k)
+    end
+
+    def to_rgb
+      self.dup
+    end
+
+      # Lighten the RGB hue by the stated percent.
+    def lighten_by(percent)
+      mix_with(White, percent)
+    end
+
+      # Darken the RGB hue by the stated percent.
+    def darken_by(percent)
+      mix_with(Black, percent)
+    end
+
+      # Mix the mask colour (which must be an RGB object) with the current
+      # colour at the stated opacity percentage (0 .. 100).
+    def mix_with(mask, opacity)
+      opacity /= 100.0
+      rgb = self.dup
+
+      rgb.r = (@r * opacity) + (mask.r * (1 - opacity))
+      rgb.g = (@g * opacity) + (mask.g * (1 - opacity))
+      rgb.b = (@b * opacity) + (mask.b * (1 - opacity))
+
+      rgb
+    end
+
+      # Returns the YIQ (NTSC) colour encoding of the RGB value.
+    def to_yiq
+      {
+        :y => (@r * 0.299) + (@g *  0.587) + (@b *  0.114),
+        :i => (@r * 0.596) + (@g * -0.275) + (@b * -0.321),
+        :q => (@r * 0.212) + (@g * -0.523) + (@b *  0.311),
+      }
+    end
+
+      # Returns the brightness value for a colour, a number between 0 and
+      # 1. Based on the Y value of YIQ encoding, representing luminosity, or
+      # perceived brightness.
+    def brightness
+      to_yiq[:y]
+    end
+
+    attr_accessor :r, :g, :b
+
+    White = RGB.new(255, 255, 255)
+    Black = RGB.new(0, 0, 0)
+  end
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.6
+specification_version: 1
+name: color-tools
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+date: 2005-03-06
+summary: color-tools provides RGB and CMYK colour definitions and manpiulations.
+require_paths: 
+  - lib
+email: austin@rubyforge.org
+homepage: http://rubyforge.org/projects/ruby-pdf
+rubyforge_project: ruby-pdf
+description: "color-tools is a Ruby library to provide RGB and CMYK colour support to
+  applications that require it. It provides 148 named RGB colours that are
+  commonly supported and used in HTML, colour manipulation operations, and a
+  monochromatic contrasting palette generator."
+autorequire: color
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+    - 
+      - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+  version: 
+platform: ruby
+authors: 
+  - Austin Ziegler
+files: 
+  - Changelog
+  - Install
+  - lib
+  - Rakefile
+  - README
+  - lib/color
+  - lib/color.rb
+  - lib/color/cmyk.rb
+  - lib/color/palette
+  - lib/color/palette.rb
+  - lib/color/rgb.rb
+  - lib/color/palette/monocontrast.rb
+test_files: []
+rdoc_options: 
+  - "--title"
+  - color-tools
+  - "--main"
+  - README
+  - "--line-numbers"
+extra_rdoc_files: 
+  - README
+  - Install
+  - Changelog
+executables: []
+extensions: []
+requirements: []
+dependencies: []