pdf-labels 1.0.0

data/vendor/color.rb

@@ -0,0 +1,87 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: color.rb,v 1.8 2005/08/08 02:44:17 austin Exp $
+#++
+
+# = 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.
+module Color
+  COLOR_TOOLS_VERSION = '1.3.0'
+
+  class RGB; end
+  class CMYK; end
+  class GrayScale; end
+  class YIQ; end
+end
+
+require 'color/rgb'
+require 'color/cmyk'
+require 'color/grayscale'
+require 'color/hsl'
+require 'color/yiq'
+require 'color/rgb/metallic'
+
+  # We load EVERYTHING if we're being run under ZenTest.
+if defined? $ZENTEST and $ZENTEST
+  require 'color/css'
+  require 'color/palette/gimp'
+  require 'color/palette/monocontrast'
+end
+
+module Color
+  def self.const_missing(name) #:nodoc:
+    if Color::RGB.const_defined?(name)
+      warn "These colour constants have been deprecated. Use Color::RGB::#{name} instead."
+      Color::RGB::constants.each do |const|
+        next if const == "PDF_FORMAT_STR"
+        next if const == "Metallic"
+        const_set(const, Color::RGB.const_get(const))
+      end
+      class << Color; remove_method :const_missing; end
+      Color.const_get(name)
+    else
+      super
+    end
+  end
+end

data/vendor/color/cmyk.rb

@@ -0,0 +1,182 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: cmyk.rb,v 1.5 2005/08/08 02:44:17 austin Exp $
+#++
+
+  # 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.
+class Color::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 1e-4
+    # (0.0001) of each other.
+  def ==(other)
+    other = other.to_cmyk
+    other.kind_of?(Color::CMYK) and
+    ((@c - other.c).abs <= 1e-4) and
+    ((@m - other.m).abs <= 1e-4) and
+    ((@y - other.y).abs <= 1e-4) and
+    ((@k - other.k).abs <= 1e-4)
+  end
+
+    # Creates a CMYK colour object from fractional values 0..1.
+    #
+    #   Color::CMYK.from_fraction(0.3, 0, 0.8, 0.3)
+  def self.from_fraction(c = 0, m = 0, y = 0, k = 0)
+    colour = Color::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.
+    #
+    #   Color::CMYK.from_fraction(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. Note that this
+    # will perform a #to_rgb operation using the default conversion formula.
+  def html
+    to_rgb.html
+  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
+    # in color-tools 1.2 or later. The Adobe method is not used by default;
+    # to enable it, pass +true+ to #to_rgb.
+    #
+    # Future versions of color-tools may offer other conversion mechanisms
+    # that offer greater colour fidelity.
+  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
+    Color::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
+    Color::GrayScale.from_fraction(g)
+  end
+  alias to_greyscale to_grayscale
+
+  def to_cmyk
+    self
+  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
+
+  attr_accessor :c, :m, :y, :k
+  remove_method :c=, :m=, :y=, :k= ;
+  def c=(cc) #:nodoc:
+    cc = 1.0 if cc > 1
+    cc = 0.0 if cc < 0
+    @c = cc
+  end
+  def m=(mm) #:nodoc:
+    mm = 1.0 if mm > 1
+    mm = 0.0 if mm < 0
+    @m = mm
+  end
+  def y=(yy) #:nodoc:
+    yy = 1.0 if yy > 1
+    yy = 0.0 if yy < 0
+    @y = yy
+  end
+  def k=(kk) #:nodoc:
+    kk = 1.0 if kk > 1
+    kk = 0.0 if kk < 0
+    @k = kk
+  end
+end

data/vendor/color/css.rb

@@ -0,0 +1,27 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: css.rb,v 1.1 2005/08/05 23:07:20 austin Exp $
+#++
+
+require 'color'
+
+  # 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)
+    @colors[name.to_s.downcase.to_sym]
+  end
+
+  @colors = {}
+  Color::RGB.constants.each do |const|
+    next if const == "PDF_FORMAT_STR"
+    next if const == "Metallic"
+    @colors[const.downcase.to_sym] ||= Color::RGB.const_get(const)
+  end
+end

data/vendor/color/grayscale.rb

@@ -0,0 +1,135 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: grayscale.rb,v 1.3 2005/08/08 02:44:17 austin Exp $
+#++
+
+  # A colour object representing shades of grey. Used primarily in PDF
+  # document creation.
+class Color::GrayScale
+    # The format of a DeviceGrey 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 %s"
+
+    # Creates a greyscale colour object from fractional values 0..1.
+    #
+    #   Color::GreyScale.from_fraction(0.5)
+  def self.from_fraction(g = 0)
+    color = Color::GrayScale.new
+    color.g = g
+    color
+  end
+
+    # Creates a greyscale colour object from percentages 0..100.
+    #
+    #   Color::GrayScale.new(50)
+  def initialize(g = 0)
+    @g = g / 100.0
+  end
+
+    # Compares the other colour to this one. The other colour will be
+    # converted to GreyScale before comparison, so the comparison between a
+    # GreyScale colour and a non-GreyScale colour will be approximate and
+    # based on the other colour's #to_greyscale conversion. If there is no
+    # #to_greyscale conversion, this will raise an exception. This will
+    # report that two GreyScale values are equivalent if they are within
+    # 1e-4 (0.0001) of each other.
+  def ==(other)
+    other = other.to_grayscale
+    other.kind_of?(Color::GrayScale) and
+    ((@g - other.g).abs <= 1e-4)
+  end
+
+    # Present the colour as a DeviceGrey fill colour string for PDF. This
+    # will be removed from the default package in color-tools 2.0.
+  def pdf_fill
+    PDF_FORMAT_STR % [ @g, "g" ]
+  end
+
+    # Present the colour as a DeviceGrey stroke colour string for PDF. This
+    # will be removed from the default package in color-tools 2.0.
+  def pdf_stroke
+    PDF_FORMAT_STR % [ @g, "G" ]
+  end
+
+  def to_255
+    [(@g * 255).round, 255].min
+  end
+  private :to_255
+
+    # Present the colour as an HTML/CSS colour string.
+  def html
+    gs = "%02x" % to_255
+    "##{gs * 3}"
+  end
+
+    # Convert the greyscale colour to CMYK.
+  def to_cmyk
+    k = 1.0 - @g.to_f
+    Color::CMYK.from_fraction(0, 0, 0, k)
+  end
+
+    # Convert the greyscale colour to RGB.
+  def to_rgb(ignored = true)
+    g = to_255
+    Color::RGB.new(g, g, g)
+  end
+
+  def to_grayscale
+    self
+  end
+  alias to_greyscale to_grayscale
+
+    # Lightens the greyscale colour by the stated percent.
+  def lighten_by(percent)
+    g = [@g + (@g * (percent / 100.0)), 1.0].min
+    Color::GrayScale.from_fraction(g)
+  end
+
+    # Darken the RGB hue by the stated percent.
+  def darken_by(percent)
+    g = [@g - (@g * (percent / 100.0)), 0.0].max
+    Color::GrayScale.from_fraction(g)
+  end
+
+    # Returns the YIQ (NTSC) colour encoding of the greyscale value. This
+    # is an approximation, as the values for I and Q are calculated by
+    # treating the greyscale value as an RGB value. The Y (intensity or
+    # brightness) value is the same as the greyscale value.
+  def to_yiq
+    y = @g
+    i = (@g * 0.596) + (@g * -0.275) + (@g * -0.321)
+    q = (@g * 0.212) + (@g * -0.523) + (@g *  0.311)
+    Color::YIQ.from_fraction(y, i, q)
+  end
+
+    # Returns the HSL colour encoding of the greyscale value.
+  def to_hsl
+    Color::HSL.from_fraction(0, 0, @g)
+  end
+
+    # Returns the brightness value for this greyscale value; this is the
+    # greyscale value.
+  def brightness
+    @g
+  end
+
+  attr_accessor :g
+  remove_method :g= ;
+  def g=(gg) #:nodoc:
+    gg = 1.0 if gg > 1
+    gg = 0.0 if gg < 0
+    @g = gg
+  end
+end
+
+module Color
+    # A synonym for Color::GrayScale.
+  GreyScale = GrayScale
+end

data/vendor/color/hsl.rb

@@ -0,0 +1,130 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: hsl.rb,v 1.2 2005/08/08 02:44:17 austin Exp $
+#++
+
+  # An HSL colour object. Internally, the hue (#h), saturation (#s), and
+  # luminosity (#l) values are dealt with as fractional values in the range
+  # 0..1.
+class Color::HSL
+  class << self
+      # Creates an HSL colour object from fractional values 0..1.
+    def from_fraction(h = 0.0, s = 0.0, l = 0.0)
+      colour = Color::HSL.new
+      colour.h = h
+      colour.s = s
+      colour.l = l
+      colour
+    end
+  end
+
+    # Compares the other colour to this one. The other colour will be
+    # converted to HSL before comparison, so the comparison between a HSL
+    # colour and a non-HSL colour will be approximate and based on the other
+    # colour's #to_hsl conversion. If there is no #to_hsl conversion, this
+    # will raise an exception. This will report that two HSL values are
+    # equivalent if all component values are within 1e-4 (0.0001) of each
+    # other.
+  def ==(other)
+    other = other.to_hsl
+    other.kind_of?(Color::HSL) and
+    ((@h - other.h).abs <= 1e-4) and
+    ((@s - other.s).abs <= 1e-4) and
+    ((@l - other.l).abs <= 1e-4)
+  end
+
+    # Creates an HSL colour object from the standard values of degrees and
+    # percentages (e.g., 145�, 30%, 50%).
+  def initialize(h = 0, s = 0, l = 0)
+    @h = h / 360.0
+    @s = s / 100.0
+    @l = l / 100.0
+  end
+
+    # Present the colour as an HTML/CSS colour string.
+  def html
+    to_rgb.html
+  end
+
+    # Converting to HSL as adapted from Foley and Van-Dam from
+    # http://www.bobpowell.net/RGBHSB.htm.
+  def to_rgb(ignored = nil)
+      # If luminosity is zero, the colour is always black.
+    return Color::RGB.new if @l == 0
+      # If luminosity is one, the colour is always white.
+    return Color::RGB.new(0xff, 0xff, 0xff) if @l == 1
+      # If saturation is zero, the colour is always a greyscale colour.
+    return Color::RGB.new(@l, @l, @l) if @s <= 1e-5
+
+    if (@l - 0.5) < 1e-5
+      tmp2 = @l * (1.0 + @s.to_f)
+    else
+      tmp2 = @l + @s - (@l * @s.to_f)
+    end
+    tmp1 = 2.0 * @l - tmp2
+
+    t3  = [ @h + 1.0 / 3.0, @h, @h - 1.0 / 3.0 ]
+    t3 = t3.map { |tmp3|
+      tmp3 += 1.0 if tmp3 < 1e-5
+      tmp3 -= 1.0 if (tmp3 - 1.0) > 1e-5
+      tmp3
+    }
+
+    rgb = t3.map do |tmp3|
+      if ((6.0 * tmp3) - 1.0) < 1e-5
+        tmp1 + ((tmp2 - tmp1) * tmp3 * 6.0)
+      elsif ((2.0 * tmp3) - 1.0) < 1e-5
+        tmp2
+      elsif ((3.0 * tmp3) - 2.0) < 1e-5
+        tmp1 + (tmp2 - tmp1) * ((2 / 3.0) - tmp3) * 6.0
+      else
+        tmp1
+      end
+    end
+
+     Color::RGB.from_fraction(*rgb)
+  end
+
+    # Converts to RGB then YIQ.
+  def to_yiq
+    to_rgb.to_yiq
+  end
+
+    # Converts to RGB then CMYK.
+  def to_cmyk
+    to_rgb.to_cmyk
+  end
+
+    # Returns the luminosity (#l) of the colour.
+  def brightness
+    @l
+  end
+  def to_greyscale
+    Color::GrayScale.from_fraction(@l)
+  end
+  alias to_grayscale to_greyscale
+
+  attr_accessor :h, :s, :l
+  remove_method :h=, :s=, :l= ;
+  def h=(hh) #:nodoc:
+    hh = 1.0 if hh > 1
+    hh = 0.0 if hh < 0
+    @h = hh
+  end
+  def s=(ss) #:nodoc:
+    ss = 1.0 if ss > 1
+    ss = 0.0 if ss < 0
+    @s = ss
+  end
+  def l=(ll) #:nodoc:
+    ll = 1.0 if ll > 1
+    ll = 0.0 if ll < 0
+    @l = ll
+  end
+end