color 1.7.1 → 2.0.0.pre.0

data/History.rdoc

@@ -1,172 +0,0 @@
-== 1.7.1 / 2014-06-12
-
-* Minor enhancements:
-  * Renamed Color::RGB::BeccaPurple to Color::RGB::RebeccaPurple as stipulated
-    by Eric Meyer. http://meyerweb.com/eric/thoughts/2014/06/19/rebeccapurple/
-    For purposes of backwards compatibility, the previous name is still
-    permitted, but its use is strongly discouraged, and it will be removed in
-    the Color 2.0 release.
-
-== 1.7 / 2014-06-12
-
-* Minor enhancements:
-  * Added Color::RGB::BeccaPurple (#663399) in honour of Rebecca Meyer, the
-    daughter of Eric Meyer, who passed away on the 7th of June, 2014. Her
-    favourite colour was purple. #663399becca
-    https://twitter.com/meyerweb/status/476089708674428929
-    http://www.zeldman.com/2014/06/10/the-color-purple/
-    http://discourse.specifiction.org/t/name-663399-becca-purple-in-css4-color/225
-
-* Bug fixes:
-  * Changed the homepage in the gem to point to github.com instead of
-    RubyForge, which has been shut down. Fixes #10, reported by @voxik.
-
-== 1.6 / 2014-05-19
-
-* Major enhancements:
-  * Aaron Hill (@armahillo) implemented the CIE Delta E 94 method by which an
-    RGB colour can be asked for the closest matching colour from a list of
-    provided colours. Fixes #5.
-  * To implement #closest_match and #delta_e94, conversion methods for sRGB to
-    XYZ and XYZ to L*a*b* space were implemented. These should be considered
-    experimental.
-
-* Tooling fixes:
-  * Ensured that the gem manifest was up-to-date. Fixes #4 reported by @boutil.
-    Thanks!
-  * Fixed problems with Travis builds. Note that Ruby 1.9.2 is no longer
-    tested. Rubinius remains in a “failure-tolerated” mode.
-  * Color 1.6 is, barring security patches, the last release of Color that will
-    support Ruby 1.8.
-
-== 1.5.1 / 2014-01-28
-
-* color 1.5 was a yanked release.
-
-* Minor enhancements:
-  * Added new methods to Color::RGB to make it so that the default defined
-    colours can be looked up by hex, name, or both.
-  * Added a method to Color::RGB to extract colours from text by hex, name, or
-    both.
-  * Added new common methods for colour names. Converted colours do not retain
-    names.
-  * Restructured color comparisons to use protocols instead of custom
-    implementations. This makes it easier to implement new colour classes. To
-    make this work, color classes should +include+ Color only need to implement
-    <tt>#coerce(other)</tt>, <tt>#to_a</tt>, and supported conversion methods
-    (e.g., <tt>#to_rgb</tt>).
-  * Added @daveheitzman’s initial implementation of an RGB contrast method as
-    an extension file: <tt>require 'color/rgb/contrast'</tt>. This method and
-    the value it returns should be considered experimental; it requires further
-    examination to ensure that the results produced are consistent with the
-    contrast comparisons used in Color::Palette::MonoContrast.
-  * Reducing duplicated code.
-
-* Bug Fixes:
-  * Moved +lib/color/rgb-colors.rb+ to +lib/color/rgb/colors.rb+. This should
-    have no impact in general.
-  * Improved the way that named colors are specified internally.
-  * Fixed bugs with Ruby 1.8.7 that may have been introduced in color 1.4.2.
-
-* Tooling Changes:
-  * Added simplecov for test coverage analysis.
-  * Modernized Travis CI support.
-
-== 1.4.2 / 2013-06-30
-
-Maintenance:
-* Modernized Hoe installation of Color, removing some dependencies.
-* Switched to Minitest.
-* Turned on Travis CI.
-* Started using Code Climate.
-* Small code formatting cleanup that touched pretty much every file.
-
-== 1.4.1 / 2010-02-03
-
-* Imported to github.
-* Converted to Hoe 2.5 spec format.
-
-== 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.

data/Licence.rdoc

@@ -1,27 +0,0 @@
-== Licence
-
-This software is available under an MIT-style licence.
-
-* Copyright 2005–2014 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.

data/README.rdoc

@@ -1,50 +0,0 @@
-= Color
-
-home :: https://github.com/halostatue/color
-code :: https://github.com/halostatue/color
-bugs :: https://github.com/halostatue/color/issues
-rdoc :: http://rubydoc.info/github/halostatue/color
-continuous integration :: {<img src="https://travis-ci.org/halostatue/color.png" />}[https://travis-ci.org/halostatue/color]
-test coverage :: {<img src="https://coveralls.io/repos/halostatue/color/badge.png" alt="Coverage Status" />}[https://coveralls.io/r/halostatue/color]
-
-== Description
-
-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 Color library performs purely 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 RGB and HSL colour spaces,
-this won't matter. Absolute colour spaces (like CIE L*a*b* and XYZ) and cannot
-be reliably converted to relative colour spaces (like RGB) without colour
-profiles.
-
-Color version 1.7.1 adds Color::RGB::RebeccaPurple for the colour #663399 in
-honour of Rebecca Meyer, the daughter of Eric Meyer, who passed away on the 7th
-of June, 2014. Her favourite colour was purple.
-{rebeccapurple}[http://meyerweb.com/eric/thoughts/2014/06/19/rebeccapurple/]
-
-Barring bugs introduced in this release, this is the last version of color that
-supports Ruby 1.8, so make sure that your gem specification is set properly (to
-<tt>~> 1.6</tt>) if that matters for your application.
-
-== History
-
-Color 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.
-
-Color::Palette::MonoContrast 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/
-
-:include: Contributing.rdoc
-
-:include: Licence.rdoc

data/lib/color/css.rb

@@ -1,7 +0,0 @@
-# This namespace contains some CSS colour names.
-module Color::CSS
-  # Returns the RGB colour for name or +nil+ if the name is not valid.
-  def self.[](name)
-    Color::RGB.by_name(name) { nil }
-  end
-end

data/lib/color/palette/adobecolor.rb

@@ -1,260 +0,0 @@
-require 'color/palette'
-
-# A class that can read an Adobe Color palette file (used for Photoshop
-# swatches) and provide a Hash-like interface to the contents. Not all
-# colour formats in ACO files are supported. Based largely off the
-# information found by Larry Tesler[http://www.nomodes.com/aco.html].
-#
-# Not all Adobe Color files have named colours; all named entries are
-# returned as an array.
-#
-#   pal = Color::Palette::AdobeColor.from_file(my_aco_palette)
-#   pal[0]          => Color::RGB<...>
-#   pal["white"]    => [ Color::RGB<...> ]
-#   pal["unknown"]  => [ Color::RGB<...>, Color::RGB<...>, ... ]
-#
-# AdobeColor palettes are always indexable by insertion order (an integer
-# key).
-#
-# Version 2 palettes use UTF-16 colour names.
-class Color::Palette::AdobeColor
-  include Enumerable
-
-  class << self
-    # Create an AdobeColor palette object from the named file.
-    def from_file(filename)
-      File.open(filename, "rb") { |io| Color::Palette::AdobeColor.from_io(io) }
-    end
-
-    # Create an AdobeColor palette object from the provided IO.
-    def from_io(io)
-      Color::Palette::AdobeColor.new(io.read)
-    end
-  end
-
-  # Returns statistics about the nature of the colours loaded.
-  attr_reader :statistics
-  # Contains the "lost" colours in the palette. These colours could not be
-  # properly loaded (e.g., L*a*b* is not supported by Color, so it is
-  # "lost") or are not understood by the algorithms.
-  attr_reader :lost
-
-  # Use this to convert the unsigned word to the signed word, if necessary.
-  UwToSw = proc { |n| (n >= (2 ** 16)) ? n - (2 ** 32) : n } #:nodoc:
-
-  # Create a new AdobeColor palette from the palette file as a string.
-  def initialize(palette)
-    @colors     = []
-    @names      = {}
-    @statistics = Hash.new(0)
-    @lost       = []
-    @order      = []
-    @version    = nil
-
-    class << palette
-      def readwords(count = 1)
-        @offset ||= 0
-        raise IndexError if @offset >= self.size
-        val = self[@offset, count * 2]
-        raise IndexError if val.nil? or val.size < (count * 2)
-        val = val.unpack("n" * count)
-        @offset += count * 2
-        val
-      end
-
-      def readutf16(count = 1)
-        @offset ||= 0
-        raise IndexError if @offset >= self.size
-        val = self[@offset, count * 2]
-        raise IndexError if val.nil? or val.size < (count * 2)
-        @offset += count * 2
-        val
-      end
-    end
-
-    @version, count = palette.readwords 2
-
-    raise "Unknown AdobeColor palette version #@version." unless @version.between?(1, 2)
-
-    count.times do
-      space, w, x, y, z = palette.readwords 5
-      name = nil
-      if @version == 2
-        raise IndexError unless palette.readwords == [ 0 ]
-        len = palette.readwords
-        name = palette.readutf16(len[0] - 1)
-        raise IndexError unless palette.readwords == [ 0 ]
-      end
-
-      color = case space
-              when 0 then # RGB
-                @statistics[:rgb] += 1
-
-                Color::RGB.new(w / 256, x / 256, y / 256)
-              when 1 then # HS[BV] -- Convert to RGB
-                @statistics[:hsb] += 1
-
-                h = w / 65535.0
-                s = x / 65535.0
-                v = y / 65535.0
-
-                if defined?(Color::HSB)
-                  Color::HSB.from_fraction(h, s, v)
-                else
-                  @statistics[:converted] += 1
-                  if Color.near_zero_or_less?(s)
-                    Color::RGB.from_fraction(v, v, v)
-                  else
-                    if Color.near_one_or_more?(h)
-                      vh = 0
-                    else
-                      vh = h * 6.0
-                    end
-
-                    vi = vh.floor
-                    v1 = v.to_f * (1 - s.to_f)
-                    v2 = v.to_f * (1 - s.to_f * (vh - vi))
-                    v3 = v.to_f * (1 - s.to_f * (1 - (vh - vi)))
-
-                    case vi
-                    when 0 then Color::RGB.from_fraction(v, v3, v1)
-                    when 1 then Color::RGB.from_fraction(v2, v, v1)
-                    when 2 then Color::RGB.from_fraction(v1, v, v3)
-                    when 3 then Color::RGB.from_fraction(v1, v2, v)
-                    when 4 then Color::RGB.from_fraction(v3, v1, v)
-                    else Color::RGB.from_fraction(v, v1, v2)
-                    end
-                  end
-                end
-              when 2 then # CMYK
-                @statistics[:cmyk] += 1
-                Color::CMYK.from_percent(100 - (w / 655.35),
-                                         100 - (x / 655.35),
-                                         100 - (y / 655.35),
-                                         100 - (z / 655.35))
-              when 7 then # L*a*b*
-                @statistics[:lab] += 1
-
-                l = [w, 10000].min / 100.0
-                a = [[-12800, UwToSw[x]].max, 12700].min / 100.0
-                b = [[-12800, UwToSw[x]].max, 12700].min / 100.0
-
-                if defined? Color::Lab
-                  Color::Lab.new(l, a, b)
-                else
-                  [ space, w, x, y, z ]
-                end
-              when 8 then # Grayscale
-                @statistics[:gray] += 1
-
-                g = [w, 10000].min / 100.0
-                Color::GrayScale.new(g)
-              when 9 then # Wide CMYK
-                @statistics[:wcmyk] += 1
-
-                c = [w, 10000].min / 100.0
-                m = [x, 10000].min / 100.0
-                y = [y, 10000].min / 100.0
-                k = [z, 10000].min / 100.0
-                Color::CMYK.from_percent(c, m, y, k)
-              else
-                @statistics[space] += 1
-                [ space, w, x, y, z ]
-              end
-
-      @order << [ color, name ]
-
-      if color.kind_of? Array
-        @lost << color
-      else
-        @colors << color
-
-        if name
-          @names[name] ||= []
-          @names[name] << color
-        end
-      end
-    end
-  end
-
-  # Provides the colour or colours at the provided selectors.
-  def values_at(*selectors)
-    @colors.values_at(*selectors)
-  end
-
-  # If a Numeric +key+ is provided, the single colour value at that position
-  # will be returned. If a String +key+ is provided, the colour set (an
-  # array) for that colour name will be returned.
-  def [](key)
-    if key.kind_of?(Numeric)
-      @colors[key]
-    else
-      @names[key]
-    end
-  end
-
-  # Loops through each colour.
-  def each
-    @colors.each { |el| yield el }
-  end
-
-  # Loops through each named colour set.
-  def each_name #:yields color_name, color_set:#
-    @names.each { |color_name, color_set| yield color_name, color_set }
-  end
-
-  def size
-    @colors.size
-  end
-
-  attr_reader :version
-
-  def to_aco(version = @version) #:nodoc:
-    res = ""
-
-    res << [ version, @order.size ].pack("nn")
-
-    @order.each do |cnpair|
-      color, name = *cnpair
-
-      # Note: HSB and CMYK formats are lost by the conversions performed on
-      # import. They are turned into RGB and WCMYK, respectively.
-
-      cstr = case color
-             when Array
-               color
-             when Color::RGB
-               r = [(color.red * 256).round, 65535].min
-               g = [(color.green * 256).round, 65535].min
-               b = [(color.blue * 256).round, 65535].min
-               [ 0, r, g, b, 0 ]
-             when Color::GrayScale
-               g = [(color.gray * 100).round, 10000].min
-               [ 8, g, 0, 0, 0 ]
-             when Color::CMYK
-               c = [(color.cyan * 100).round, 10000].min
-               m = [(color.magenta * 100).round, 10000].min
-               y = [(color.yellow * 100).round, 10000].min
-               k = [(color.black * 100).round, 10000].min
-               [ 9, c, m, y, k ]
-             end
-      cstr = cstr.pack("nnnnn")
-
-      nstr = ""
-
-      if version == 2
-        if (name.size / 2 * 2) == name.size # only where s[0] == byte!
-          nstr << [ 0, (name.size / 2) + 1 ].pack("nn")
-          nstr << name
-          nstr << [ 0 ].pack("n")
-        else
-          nstr << [ 0, 1, 0 ].pack("nnn")
-        end
-      end
-
-      res << cstr << nstr
-    end
-
-    res
-  end
-end

data/lib/color/palette/gimp.rb

@@ -1,104 +0,0 @@
-require 'color/palette'
-
-# A class that can read a GIMP (GNU Image Manipulation Program) palette file
-# and provide a Hash-like interface to the contents. GIMP colour palettes
-# are RGB values only.
-#
-# Because two or more entries in a GIMP palette may have the same name, all
-# named entries are returned as an array.
-#
-#   pal = Color::Palette::Gimp.from_file(my_gimp_palette)
-#   pal[0]          => Color::RGB<...>
-#   pal["white"]    => [ Color::RGB<...> ]
-#   pal["unknown"]  => [ Color::RGB<...>, Color::RGB<...>, ... ]
-#
-# GIMP Palettes are always indexable by insertion order (an integer key).
-class Color::Palette::Gimp
-  include Enumerable
-
-  class << self
-    # Create a GIMP palette object from the named file.
-    def from_file(filename)
-      File.open(filename, "rb") { |io| Color::Palette::Gimp.from_io(io) }
-    end
-
-    # Create a GIMP palette object from the provided IO.
-    def from_io(io)
-      Color::Palette::Gimp.new(io.read)
-    end
-  end
-
-  # Create a new GIMP palette from the palette file as a string.
-  def initialize(palette)
-    @colors   = []
-    @names    = {}
-    @valid    = false
-    @name     = "(unnamed)"
-
-    palette.split($/).each do |line|
-      line.chomp!
-      line.gsub!(/\s*#.*\Z/, '')
-
-      next if line.empty?
-
-      if line =~ /\AGIMP Palette\Z/
-        @valid = true
-        next
-      end
-
-      info = /(\w+):\s(.*$)/.match(line)
-      if info
-        @name = info.captures[1] if info.captures[0] =~ /name/i
-        next
-      end
-
-      line.gsub!(/^\s+/, '')
-      data = line.split(/\s+/, 4)
-      name = data.pop.strip
-      data.map! { |el| el.to_i }
-
-      color = Color::RGB.new(*data)
-
-      @colors << color
-      @names[name] ||= []
-      @names[name]  << color
-    end
-  end
-
-  # Provides the colour or colours at the provided selectors.
-  def values_at(*selectors)
-    @colors.values_at(*selectors)
-  end
-
-  # If a Numeric +key+ is provided, the single colour value at that position
-  # will be returned. If a String +key+ is provided, the colour set (an
-  # array) for that colour name will be returned.
-  def [](key)
-    if key.kind_of?(Numeric)
-      @colors[key]
-    else
-      @names[key]
-    end
-  end
-
-  # Loops through each colour.
-  def each
-    @colors.each { |el| yield el }
-  end
-
-  # Loops through each named colour set.
-  def each_name #:yields color_name, color_set:#
-    @names.each { |color_name, color_set| yield color_name, color_set }
-  end
-
-  # Returns true if this is believed to be a valid GIMP palette.
-  def valid?
-    @valid
-  end
-
-  def size
-    @colors.size
-  end
-
-  attr_reader :name
-end