color_lib 1.4.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a1f04b55358a9cdc8a5c4fa32df79b152fd6b91e
+  data.tar.gz: 5972b46bd97e6f4a4d61951dee4c49726d2d7aa9
+SHA512:
+  metadata.gz: ef2a082378edd5344546018019c90f1787a51b8c64d2242ca7758e06db1ab50d1252eff2dbd4450093e30deb914f6ce82aa2f01612c0585fc740f321df3e0168
+  data.tar.gz: e687268a86384904554f54bfb377db5dddd07b9b8a1d7a7b7f1ac778c71fa05b43a9061ac984e5de49c4b1d273747534cf06f94873f4c00a30c1ca1994868619

data/.gitignore

@@ -0,0 +1,22 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+*.swp
+html
+doc
+pkg
+publish
+coverage
+coverage.info
+type-lists

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 2.1.5
+  - 2.2.0
+
+sudo: false

data/CHANGELOG

@@ -0,0 +1,96 @@
+== ColorLib 1.4.2 / 2010.02.03
+* Added 7000 range to Pantone
+
+== ColorLib 1.4.1 / 2010.02.03
+* Imported to github.
+* Converted to Hoe 2.5 spec format.
+
+== ColorLib 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 ColorLib class has been merged into
+    ColorLib::HSL. ColorLib is a module the way it was for color-tools.
+  - A thin veneer has been written to allow ColorLib::new to return a ColorLib::HSL
+    instance; ColorLib::HSL supports as many methods as possible that were
+    previously supported by the ColorLib class.
+  - Values that were previously rounded by ColorLib are no longer rounded;
+    fractional values matter.
+* Converted to hoe for project management.
+* Moved to the next step of deprecating ColorLib::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
+  ColorLib 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 ColorLib::GrayScale and ColorLib::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. (ColorLib and
+  color-tools use the same formulas, but the ordering of the calculations is
+  slightly different with ColorLib 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 ColorLib swatch (Photoshop) palette reader,
+  ColorLib::Palette::AdobeColorLib (for .aco files only).
+
+== ColorLib 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 ColorLib::Metallic.
+* Colours that were defined in the ColorLib namespace (e.g., ColorLib::Red,
+  ColorLib::AliceBlue) are now defined in ColorLib::RGB (e.g., ColorLib::RGB::Red,
+  ColorLib::RGB::AliceBlue). They are added back to the ColorLib 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 ColorLib::Red will be
+  removed completely.
+* Added the ColorLib::CSS module, color_lib/css or ColorLib::CSS that provides a name
+  lookup of ColorLib::RGB-namespaced constants with ColorLib::CSS[name]. Most of
+  these colours (which are mirrored from the ColorLib::RGB default colours) are
+  only "officially" recognised under the CSS3 colour module or SVG.
+* Added the ColorLib::HSL colour space and some helper utilities to ColorLib::RGB
+  for colour manipulation using the HSL value.
+* Controlled internal value replacement to be between 0 and 1 for all
+  colours.
+* Updated ColorLib::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 ColorLib::GreyScale (or ColorLib::GrayScale).
+* Added ColorLib::YIQ. This colour definition is incomplete; it does not have
+  conversions from YIQ to other colour spaces.
+
+== color-tools 1.1.0
+* Added color_lib/palette/gimp to support the reading and use of GIMP color
+  palettes.
+
+== color-tools 1.0.0
+* Initial release.
+
+== Copyright
+  ColorLib
+  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 - 2010 Austin Ziegler and Matt Lyon

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Brandfolder, Inc.
+
+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 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.md

@@ -0,0 +1,25 @@
+# ColorLib [![Build Status](https://travis-ci.org/brandfolder/color_lib.svg?branch=master)](https://travis-ci.org/brandfolder/color_lib)
+
+A lib for colors.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'color_lib'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install color_lib## Contributing
+
+1. Fork it ( https://github.com/brandfolder/color_lib/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+require 'rake/testtask'
+require 'color_lib'
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/test_*.rb']
+  t.verbose    = true
+end
+
+task default: :test

data/color_lib.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'color_lib/version'
+
+Gem::Specification.new do |spec|
+  spec.name        = "color_lib"
+  spec.version     = ColorLib::VERSION
+  spec.authors     = ["Brandfolder, Inc."]
+  spec.email       = ["developers@brandfolder.com"]
+  spec.summary     = %q{A lib for colors}
+  spec.description = %q{A lib for working with colors in ruby}
+  spec.homepage    = "https://github.com/brandfolder/color_lib"
+  spec.license     = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.7"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest", "~> 5.5"
+end

data/lib/color_lib.rb

@@ -0,0 +1,139 @@
+require "color_lib/version"
+
+module ColorLib
+  COLOR_VERSION = VERSION
+
+  class RGB;
+  end
+  class CMYK;
+  end
+  class GrayScale;
+  end
+  class YIQ;
+  end
+  class Pantone;
+  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
+
+    def const_missing(name) #:nodoc:
+      case name
+      when "VERSION", :VERSION, "COLOR_TOOLS_VERSION", :COLOR_TOOLS_VERSION
+        warn "ColorLib::#{name} has been deprecated. Use ColorLib::COLOR_VERSION instead."
+        ColorLib::COLOR_VERSION
+      else
+        if ColorLib::RGB.const_defined?(name)
+          warn "ColorLib::#{name} has been deprecated. Use ColorLib::RGB::#{name} instead."
+          ColorLib::RGB.const_get(name)
+        else
+          super
+        end
+      end
+    end
+
+    # Provides a thin veneer over the ColorLib module to make it seem like this
+    # is ColorLib 0.1.0 (a class) and not ColorLib 1.4.1 (a module). This
+    # "constructor" will be removed in the future.
+    #
+    # mode = :hsl::   +values+ must be an array of [ hue deg, sat %, lum % ].
+    #                 A ColorLib::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
+    #                 ColorLib::RGB object will be created.
+    # mode = :cmyk::  +values+ must be an array of [ cyan %, magenta %, yellow
+    #                 %, black % ]. A ColorLib::CMYK object will be created.
+    def new(values, mode = :rgb)
+      warn "ColorLib.new has been deprecated. Use ColorLib::#{mode.to_s.upcase}.new instead."
+      color = case mode
+              when :hsl
+                ColorLib::HSL.new(*values)
+              when :rgb
+                values = [values].flatten
+                if values.size == 1
+                  ColorLib::RGB.from_html(*values)
+                else
+                  ColorLib::RGB.new(*values)
+                end
+              when :cmyk
+                ColorLib::CMYK.new(*values)
+              end
+      color.to_hsl
+    end
+  end
+end
+
+require 'color_lib/rgb'
+require 'color_lib/cmyk'
+require 'color_lib/grayscale'
+require 'color_lib/hsl'
+require 'color_lib/yiq'
+require 'color_lib/rgb/metallic'
+require 'color_lib/pantone'

data/lib/color_lib/cmyk.rb

@@ -0,0 +1,280 @@
+# An CMYK colour object. CMYK (cyan, magenta, yellow, and black) colours are
+# based on additive percentages of ink. A CMYK colour of (0.3, 0, 0.8, 0.3)
+# would be mixed from 30% cyan, 0% magenta, 80% yellow, and 30% black.
+# Primarily used in four-colour printing processes.
+class ColorLib::CMYK
+  # The format of a DeviceCMYK colour for PDF. In color-tools 2.0 this will
+  # be removed from this package and added back as a modification by the
+  # PDF::Writer package.
+  PDF_FORMAT_STR = "%.3f %.3f %.3f %.3f %s"
+
+  # Compares the other colour to this one. The other colour will be
+  # converted to CMYK before comparison, so the comparison between a CMYK
+  # colour and a non-CMYK colour will be approximate and based on the other
+  # colour's #to_cmyk conversion. If there is no #to_cmyk conversion, this
+  # will raise an exception. This will report that two CMYK colours are
+  # equivalent if all component values are within COLOR_TOLERANCE of each
+  # other.
+  def ==(other)
+    other = other.to_cmyk
+    other.kind_of?(ColorLib::CMYK) and
+      ((@c - other.c).abs <= ColorLib::COLOR_TOLERANCE) and
+      ((@m - other.m).abs <= ColorLib::COLOR_TOLERANCE) and
+      ((@y - other.y).abs <= ColorLib::COLOR_TOLERANCE) and
+      ((@k - other.k).abs <= ColorLib::COLOR_TOLERANCE)
+  end
+
+  # Creates a CMYK colour object from fractional values 0..1.
+  #
+  #   ColorLib::CMYK.from_fraction(0.3, 0, 0.8, 0.3)
+  def self.from_fraction(c = 0, m = 0, y = 0, k = 0)
+    colour   = ColorLib::CMYK.new
+    colour.c = c
+    colour.m = m
+    colour.y = y
+    colour.k = k
+    colour
+  end
+
+  # Creates a CMYK colour object from percentages. Internally, the colour is
+  # managed as fractional values 0..1.
+  #
+  #   ColorLib::CMYK.new(30, 0, 80, 30)
+  def self.from_percent(c = 0, m = 0, y = 0, k = 0)
+    ColorLib::CMYK.new(c, m, y, k)
+  end
+
+  # Creates a CMYK colour object from percentages. Internally, the colour is
+  # managed as fractional values 0..1.
+  #
+  #   ColorLib::CMYK.new(30, 0, 80, 30)
+  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 DeviceCMYK fill colour string for PDF. This will
+  # be removed from the default package in color-tools 2.0.
+  def pdf_fill
+    PDF_FORMAT_STR % [@c, @m, @y, @k, "k"]
+  end
+
+  # Present the colour as a DeviceCMYK stroke colour string for PDF. This
+  # will be removed from the default package in color-tools 2.0.
+  def pdf_stroke
+    PDF_FORMAT_STR % [@c, @m, @y, @k, "K"]
+  end
+
+  # Present the colour as an RGB HTML/CSS colour string (e.g., "#aabbcc").
+  # Note that this will perform a #to_rgb operation using the default
+  # conversion formula.
+  def html
+    to_rgb.html
+  end
+
+  # Present the colour as an RGB HTML/CSS colour string (e.g., "rgb(0%, 50%,
+  # 100%)"). Note that this will perform a #to_rgb operation using the
+  # default conversion formula.
+  def css_rgb
+    to_rgb.css_rgb
+  end
+
+  # Present the colour as an RGBA (with alpha) HTML/CSS colour string (e.g.,
+  # "rgb(0%, 50%, 100%, 1)"). Note that this will perform a #to_rgb
+  # operation using the default conversion formula.
+  def css_rgba
+    to_rgb.css_rgba
+  end
+
+  # Present the colour as an HSL HTML/CSS colour string (e.g., "hsl(180,
+  # 25%, 35%)"). Note that this will perform a #to_hsl operation using the
+  # default conversion formula.
+  def css_hsl
+    to_hsl.css_hsl
+  end
+
+  # Present the colour as an HSLA (with alpha) HTML/CSS colour string (e.g.,
+  # "hsla(180, 25%, 35%, 1)"). Note that this will perform a #to_hsl
+  # operation using the default conversion formula.
+  def css_hsla
+    to_hsl.css_hsla
+  end
+
+  # Converts the CMYK colour to RGB. Most colour experts strongly suggest
+  # that this is not a good idea (some even suggesting that it's a very bad
+  # idea). CMYK represents additive percentages of inks on white paper,
+  # whereas RGB represents mixed colour intensities on a black screen.
+  #
+  # However, the colour conversion can be done, and there are two different
+  # methods for the conversion that provide slightly different results.
+  # Adobe PDF conversions are done with the first form.
+  #
+  #     # Adobe PDF Display Formula
+  #   r = 1.0 - min(1.0, c + k)
+  #   g = 1.0 - min(1.0, m + k)
+  #   b = 1.0 - min(1.0, y + k)
+  #
+  #     # Other
+  #   r = 1.0 - (c * (1.0 - k) + k)
+  #   g = 1.0 - (m * (1.0 - k) + k)
+  #   b = 1.0 - (y * (1.0 - k) + k)
+  #
+  # If we have a CMYK colour of [33% 66% 83% 25%], the first method will
+  # give an approximate RGB colour of (107, 23, 0) or #6b1700. The second
+  # method will give an approximate RGB colour of (128, 65, 33) or #804121.
+  # Which is correct? Although the colours may seem to be drastically
+  # different in the RGB colour space, they are very similar colours,
+  # differing mostly in intensity. The first is a darker, slightly redder
+  # brown; the second is a lighter brown.
+  #
+  # Because of this subtlety, both methods are now offered for conversion.
+  # The Adobe method is not used by default; to enable it, pass +true+ to
+  # #to_rgb.
+  #
+  # Future versions of ColorLib may offer other conversion mechanisms that
+  # offer greater colour fidelity, including recognition of ICC colour
+  # profiles.
+  def to_rgb(use_adobe_method = false)
+    if use_adobe_method
+      r = 1.0 - [1.0, @c + @k].min
+      g = 1.0 - [1.0, @m + @k].min
+      b = 1.0 - [1.0, @y + @k].min
+    else
+      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)
+    end
+    ColorLib::RGB.from_fraction(r, g, b)
+  end
+
+  # Converts the CMYK colour to a single greyscale value. There are
+  # undoubtedly multiple methods for this conversion, but only a minor
+  # variant of the Adobe conversion method will be used:
+  #
+  #   g = 1.0 - min(1.0, 0.299 * c + 0.587 * m + 0.114 * y + k)
+  #
+  # This treats the CMY values similarly to YIQ (NTSC) values and then adds
+  # the level of black. This is a variant of the Adobe version because it
+  # uses the more precise YIQ (NTSC) conversion values for Y (intensity)
+  # rather than the approximates provided by Adobe (0.3, 0.59, and 0.11).
+  def to_grayscale
+    c = 0.299 * @c.to_f
+    m = 0.587 * @m.to_f
+    y = 0.114 * @y.to_f
+    g = 1.0 - [1.0, c + m + y + @k].min
+    ColorLib::GrayScale.from_fraction(g)
+  end
+
+  alias to_greyscale to_grayscale
+
+  def to_cmyk
+    self
+  end
+
+  def inspect
+    "CMYK [%.2f%%, %.2f%%, %.2f%%, %.2f%%]" % [cyan, magenta, yellow, black]
+  end
+
+  # Converts to RGB then YIQ.
+  def to_yiq
+    to_rgb.to_yiq
+  end
+
+  # Converts to RGB then HSL.
+  def to_hsl
+    to_rgb.to_hsl
+  end
+
+  # Returns the cyan (C) component of the CMYK colour as a percentage value.
+  def cyan
+    @c * 100.0
+  end
+
+  # Returns the cyan (C) component of the CMYK colour as a value in the
+  # range 0.0 .. 1.0.
+  def c
+    @c
+  end
+
+  # Sets the cyan (C) component of the CMYK colour as a percentage value.
+  def cyan=(cc)
+    @c = ColorLib.normalize(cc / 100.0)
+  end
+
+  # Sets the cyan (C) component of the CMYK colour as a value in the range
+  # 0.0 .. 1.0.
+  def c=(cc)
+    @c = ColorLib.normalize(cc)
+  end
+
+  # Returns the magenta (M) component of the CMYK colour as a percentage
+  # value.
+  def magenta
+    @m * 100.0
+  end
+
+  # Returns the magenta (M) component of the CMYK colour as a value in the
+  # range 0.0 .. 1.0.
+  def m
+    @m
+  end
+
+  # Sets the magenta (M) component of the CMYK colour as a percentage value.
+  def magenta=(mm)
+    @m = ColorLib.normalize(mm / 100.0)
+  end
+
+  # Sets the magenta (M) component of the CMYK colour as a value in the
+  # range 0.0 .. 1.0.
+  def m=(mm)
+    @m = ColorLib.normalize(mm)
+  end
+
+  # Returns the yellow (Y) component of the CMYK colour as a percentage
+  # value.
+  def yellow
+    @y * 100.0
+  end
+
+  # Returns the yellow (Y) component of the CMYK colour as a value in the
+  # range 0.0 .. 1.0.
+  def y
+    @y
+  end
+
+  # Sets the yellow (Y) component of the CMYK colour as a percentage value.
+  def yellow=(yy)
+    @y = ColorLib.normalize(yy / 100.0)
+  end
+
+  # Sets the yellow (Y) component of the CMYK colour as a value in the range
+  # 0.0 .. 1.0.
+  def y=(kk)
+    @y = ColorLib.normalize(kk)
+  end
+
+  # Returns the black (K) component of the CMYK colour as a percentage
+  # value.
+  def black
+    @k * 100.0
+  end
+
+  # Returns the black (K) component of the CMYK colour as a value in the
+  # range 0.0 .. 1.0.
+  def k
+    @k
+  end
+
+  # Sets the black (K) component of the CMYK colour as a percentage value.
+  def black=(kk)
+    @k = ColorLib.normalize(kk / 100.0)
+  end
+
+  # Sets the black (K) component of the CMYK colour as a value in the range
+  # 0.0 .. 1.0.
+  def k=(kk)
+    @k = ColorLib.normalize(kk)
+  end
+end