pdf-labels 1.0.0

data/vendor/color/rgb.rb

@@ -0,0 +1,311 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: rgb.rb,v 1.6 2005/08/08 02:44:17 austin Exp $
+#++
+
+  # An RGB colour object.
+class Color::RGB
+    # The format of a DeviceRGB 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 %s"
+
+  class << self
+      # Creates an RGB colour object from percentages 0..100.
+      #
+      #   Color::RGB.from_percentage(10, 20 30)
+    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.
+      #
+      #   Color::RGB.from_fraction(.3, .2, .1)
+    def from_fraction(r = 0.0, g = 0.0, b = 0.0)
+      colour = Color::RGB.new
+      colour.r = r
+      colour.g = g
+      colour.b = b
+      colour
+    end
+
+      # Creates an RGB colour object from an HTML colour descriptor (e.g.,
+      # <tt>"fed"</tt> or <tt>"#cabbed;"</tt>.
+      #
+      #   Color::RGB.from_html("fed")
+      #   Color::RGB.from_html("#fed")
+      #   Color::RGB.from_html("#cabbed")
+      #   Color::RGB.from_html("cabbed")
+    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
+
+    # Compares the other colour to this one. The other colour will be
+    # converted to RGB before comparison, so the comparison between a RGB
+    # colour and a non-RGB colour will be approximate and based on the other
+    # colour's default #to_rgb conversion. If there is no #to_rgb
+    # conversion, this will raise an exception. This will report that two
+    # RGB colours are equivalent if all component values are within 1e-4
+    # (0.0001) of each other.
+  def ==(other)
+    other = other.to_rgb
+    other.kind_of?(Color::RGB) and
+    ((@r - other.r).abs <= 1e-4) and
+    ((@g - other.g).abs <= 1e-4) and
+    ((@b - other.b).abs <= 1e-4)
+  end
+
+    # Creates an RGB colour object from the standard range 0..255.
+    #
+    #   Color::RGB.new(32, 64, 128)
+    #   Color::RGB.new(0x20, 0x40, 0x80)
+  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 DeviceRGB fill colour string for PDF. This
+    # will be removed from the default package in color-tools 2.0.
+  def pdf_fill
+    PDF_FORMAT_STR % [ @r, @g, @b, "rg" ]
+  end
+
+    # Present the colour as a DeviceRGB stroke colour string for PDF. This
+    # will be removed from the default package in color-tools 2.0.
+  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
+
+    # Converts the RGB colour to CMYK. 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. The basic method is
+    # multi-step:
+    #
+    # 1. Convert the R, G, and B components to C, M, and Y components.
+    #     c = 1.0 � r
+    #     m = 1.0 � g
+    #     y = 1.0 � b
+    # 2. Compute the minimum amount of black (K) required to smooth the
+    #    colour in inks.
+    #     k = min(c, m, y)
+    # 3. Perform undercolour removal on the C, M, and Y components of the
+    #    colours because less of each colour is needed for each bit of
+    #    black. Also, regenerate the black (K) based on the undercolour
+    #    removal so that the colour is more accurately represented in ink.
+    #     c = min(1.0, max(0.0, c � UCR(k)))
+    #     m = min(1.0, max(0.0, m � UCR(k)))
+    #     y = min(1.0, max(0.0, y � UCR(k)))
+    #     k = min(1.0, max(0.0, BG(k)))
+    #
+    # The undercolour removal function and the black generation functions
+    # return a value based on the brightness of the RGB colour.
+  def to_cmyk
+    c = 1.0 - @r.to_f
+    m = 1.0 - @g.to_f
+    y = 1.0 - @b.to_f
+
+    k = [c, m, y].min
+    k = k - (k * brightness)
+
+    c = [1.0, [0.0, c - k].max].min
+    m = [1.0, [0.0, m - k].max].min
+    y = [1.0, [0.0, y - k].max].min
+    k = [1.0, [0.0, k].max].min
+
+    Color::CMYK.from_fraction(c, m, y, k)
+  end
+
+  def to_rgb(ignored = nil)
+    self
+  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)
+    Color::YIQ.from_fraction(y, i, q)
+  end
+
+    # Returns the HSL colour encoding of the RGB value.
+  def to_hsl
+    min   = [ @r, @g, @b ].min
+    max   = [ @r, @g, @b ].max
+    delta = (max - min).to_f
+
+    lum   = (max + min) / 2.0
+
+    if delta <= 1e-5  # close to 0.0, so it's a grey
+      hue = 0
+      sat = 0
+    else
+      if (lum - 0.5) <= 1e-5
+        sat = delta / (max + min).to_f
+      else
+        sat = delta / (2 - max - min).to_f
+      end
+
+      if @r == max
+        hue = (@g - @b) / delta.to_f
+      elsif @g == max
+        hue = (2.0 + @b - @r) / delta.to_f
+      elsif (@b - max) <= 1e-5
+        hue = (4.0 + @r - @g) / delta.to_f
+      end
+      hue /= 6.0
+
+      hue += 1 if hue < 0
+      hue -= 1 if hue > 1
+    end
+    Color::HSL.from_fraction(hue, sat, lum)
+  end
+
+    # Mix the RGB hue with White so that the RGB hue is the specified
+    # percentage of the resulting colour. Strictly speaking, this isn't a
+    # darken_by operation.
+  def lighten_by(percent)
+    mix_with(White, percent)
+  end
+
+    # Mix the RGB hue with Black so that the RGB hue is the specified
+    # percentage of the resulting colour. Strictly speaking, this isn't a
+    # darken_by operation.
+  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 brightness value for a colour, a number between 0..1.
+    # Based on the Y value of YIQ encoding, representing luminosity, or
+    # perceived brightness.
+    #
+    # This may be modified in a future version of color-tools to use the
+    # luminosity value of HSL.
+  def brightness
+    to_yiq.y
+  end
+  def to_grayscale
+    Color::GrayScale.from_fraction(to_hsl.l)
+  end
+
+  alias to_greyscale to_grayscale
+
+    # Returns a new colour with the brightness adjusted by the specified
+    # percentage. Negative percentages will darken the colour; positive
+    # percentages will brighten the colour.
+    #
+    #   Color::RGB::DarkBlue.adjust_brightness(10)
+    #   Color::RGB::DarkBlue.adjust_brightness(-10)
+  def adjust_brightness(percent)
+    percent /= 100.0
+    percent += 1.0
+    percent  = [ percent, 2.0 ].min
+    percent  = [ 0.0, percent ].max
+
+    hsl      = to_hsl
+    hsl.l   *= percent
+    hsl.to_rgb
+  end
+
+    # Returns a new colour with the saturation adjusted by the specified
+    # percentage. Negative percentages will reduce the saturation; positive
+    # percentages will increase the saturation.
+    #
+    #   Color::RGB::DarkBlue.adjust_saturation(10)
+    #   Color::RGB::DarkBlue.adjust_saturation(-10)
+  def adjust_saturation(percent)
+    percent  /= 100.0
+    percent  += 1.0
+    percent  = [ percent, 2.0 ].min
+    percent  = [ 0.0, percent ].max
+
+    hsl      = to_hsl
+    hsl.s   *= percent
+    hsl.to_rgb
+  end
+
+    # Returns a new colour with the hue adjusted by the specified
+    # percentage. Negative percentages will reduce the hue; positive
+    # percentages will increase the hue.
+    #
+    #   Color::RGB::DarkBlue.adjust_hue(10)
+    #   Color::RGB::DarkBlue.adjust_hue(-10)
+  def adjust_hue(percent)
+    percent  /= 100.0
+    percent  += 1.0
+    percent  = [ percent, 2.0 ].min
+    percent  = [ 0.0, percent ].max
+
+    hsl      = to_hsl
+    hsl.h   *= percent
+    hsl.to_rgb
+  end
+
+  attr_accessor :r, :g, :b
+  remove_method :r=, :g=, :b= ;
+  def r=(rr) #:nodoc:
+    rr = 1.0 if rr > 1
+    rr = 0.0 if rr < 0
+    @r = rr
+  end
+  def g=(gg) #:nodoc:
+    gg = 1.0 if gg > 1
+    gg = 0.0 if gg < 0
+    @g = gg
+  end
+  def b=(bb) #:nodoc:
+    bb = 1.0 if bb > 1
+    bb = 0.0 if bb < 0
+    @b = bb
+  end
+end
+
+require 'color/rgb-colors'

data/vendor/color/rgb/metallic.rb

@@ -0,0 +1,28 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: metallic.rb,v 1.1 2005/08/05 23:07:20 austin Exp $
+#++
+
+  # This namespace contains some RGB metallic colours suggested by Jim Freeze.
+module Color::RGB::Metallic
+  Aluminum    = Color::RGB.new(0x99, 0x99, 0x99)
+  CoolCopper  = Color::RGB.new(0xd9, 0x87, 0x19)
+  Copper      = Color::RGB.new(0xb8, 0x73, 0x33)
+  Iron        = Color::RGB.new(0x4c, 0x4c, 0x4c)
+  Lead        = Color::RGB.new(0x19, 0x19, 0x19)
+  Magnesium   = Color::RGB.new(0xb3, 0xb3, 0xb3)
+  Mercury     = Color::RGB.new(0xe6, 0xe6, 0xe6)
+  Nickel      = Color::RGB.new(0x80, 0x80, 0x80)
+  PolySilicon = Color::RGB.new(0x60, 0x00, 0x00)
+  Poly        = PolySilicon
+  Silver      = Color::RGB.new(0xcc, 0xcc, 0xcc)
+  Steel       = Color::RGB.new(0x66, 0x66, 0x66)
+  Tin         = Color::RGB.new(0x7f, 0x7f, 0x7f)
+  Tungsten    = Color::RGB.new(0x33, 0x33, 0x33)
+end

data/vendor/color/yiq.rb

@@ -0,0 +1,78 @@
+#--
+# Colour management with Ruby.
+#
+# Copyright 2005 Austin Ziegler
+#   http://rubyforge.org/ruby-pdf/
+#
+#   Licensed under a MIT-style licence.
+#
+# $Id: yiq.rb,v 1.3 2005/08/08 02:44:17 austin Exp $
+#++
+
+  # A colour object representing YIQ (NTSC) colour encoding.
+class Color::YIQ
+    # Creates a YIQ colour object from fractional values 0 .. 1.
+    #
+    #   Color::YIQ.new(0.3, 0.2, 0.1)
+  def self.from_fraction(y = 0, i = 0, q = 0)
+    color = Color::YIQ.new
+    color.y = y
+    color.i = i
+    color.q = q
+    color
+  end
+
+    # Creates a YIQ colour object from percentages 0 .. 100.
+    #
+    #   Color::YIQ.new(10, 20, 30)
+  def initialize(y = 0, i = 0, q = 0)
+    @y = y / 100.0
+    @i = i / 100.0
+    @q = q / 100.0
+  end
+
+    # Compares the other colour to this one. The other colour will be
+    # converted to YIQ before comparison, so the comparison between a YIQ
+    # colour and a non-YIQ colour will be approximate and based on the other
+    # colour's #to_yiq conversion. If there is no #to_yiq conversion, this
+    # will raise an exception. This will report that two YIQ values are
+    # equivalent if all component colours are within 1e-4 (0.0001) of each
+    # other.
+  def ==(other)
+    other = other.to_yiq
+    other.kind_of?(Color::YIQ) and
+    ((@y - other.y).abs <= 1e-4) and
+    ((@i - other.i).abs <= 1e-4) and
+    ((@q - other.q).abs <= 1e-4) 
+  end
+
+  def to_yiq
+    self
+  end
+
+  def brightness
+    @y
+  end
+  def to_grayscale
+    Color::GrayScale.new(@y)
+  end
+  alias to_greyscale to_grayscale
+
+  attr_accessor :y, :i, :q
+  remove_method :y=, :i=, :q=
+  def y=(yy) #:nodoc:
+    yy = 1.0 if yy > 1
+    yy = 0.0 if yy < 0
+    @y = yy
+  end
+  def i=(ii) #:nodoc:
+    ii = 1.0 if ii > 1
+    ii = 0.0 if ii < 0
+    @i = ii
+  end
+  def q=(qq) #:nodoc:
+    qq = 1.0 if qq > 1
+    qq = 0.0 if qq < 0
+    @q = qq
+  end
+end

data/vendor/pdf/charts.rb

@@ -0,0 +1,13 @@
+#--
+# PDF::Writer for Ruby.
+#   http://rubyforge.org/projects/ruby-pdf/
+#   Copyright 2003 - 2005 Austin Ziegler.
+#
+#   Licensed under a MIT-style licence. See LICENCE in the main distribution
+#   for full licensing information.
+#
+# $Id: charts.rb,v 1.2 2005/05/16 03:59:21 austin Exp $
+#++
+  # A namespace for charts that can be drawn on PDF::Writer canvases.
+module PDF::Charts
+end

data/vendor/pdf/charts/stddev.rb

@@ -0,0 +1,433 @@
+#--
+# PDF::Writer for Ruby.
+#   http://rubyforge.org/projects/ruby-pdf/
+#   Copyright 2003 - 2005 Austin Ziegler.
+#
+#   Licensed under a MIT-style licence. See LICENCE in the main distribution
+#   for full licensing information.
+#
+# $Id: stddev.rb,v 1.12 2005/10/12 14:41:40 austin Exp $
+#++
+require 'pdf/writer'
+require 'pdf/charts'
+require 'ostruct'
+
+  # Creates a standard deviation chart. This is a type of chart that is
+  # effective for the display of survey results or other data that can
+  # easily be measured in terms of the average and the standard deviation
+  # from that average.
+  #
+  # The scale of responses is the vertical scale; the average data points
+  # and standard deviation values are the horizontal scale.
+class PDF::Charts::StdDev
+  VERSION = '1.1.4'
+
+    # A data element.
+  DataPoint = Struct.new(:label, :average, :stddev)
+
+    # A label for displaying the scale (vertical) of data in the dataset or
+    # the data set identifiers.
+  class Label
+    def initialize
+      yield self if block_given?
+    end
+
+      # The height of the label, in PDF user units. Ignored for scale
+      # labels.
+    attr_accessor :height
+      # The background color of the label. Ignored for scale labels.
+    attr_accessor :background_color
+      # The text color of the label.
+    attr_accessor :text_color
+      # The text size, in points, of the label.
+    attr_accessor :text_size
+      # The padding of the label. Only used for scale labels.
+    attr_accessor :pad
+      # The decimal precision of the label. Only used for scale labels.
+    attr_accessor :decimal_precision
+  end
+
+    # The scale of the dataset.
+  class Scale
+    def initialize(args = { })
+      @range        = args[:range]
+      @step         = args[:step]
+      @style        = args[:style]
+      @show_labels  = false
+
+      yield self if block_given?
+
+      raise TypeError, PDF::Lange[:charts_stddev_scale_norange] if @range.nil?
+      raise TypeError, PDF::Lange[:charts_stddev_scale_nostep] if @step.nil?
+    end
+
+      # Range of the scale. This should be a Range object.
+    attr_accessor :range
+      # The lower end of the range of the scale. The scale range may be
+      # modified by changing this value.
+    attr_accessor :first
+    remove_method :first, :first= ;
+    def first #:nodoc:
+      @range.first
+    end
+    def first=(ff) #:nodoc:
+      @range = (ff..@range.last)
+    end
+      # The upper end of the range of the scale. The scale range may be
+      # modified by changing this value.
+    attr_accessor :last
+    remove_method :last, :last= ;
+    def last #:nodoc:
+      @range.last
+    end
+    def last=(ll) #:nodoc:
+      @range = (@range.first..ll)
+    end
+      # Defines the step of the scale. Each step represents a vertical
+      # position on the chart.
+    attr_accessor :step
+      # Defines the line style for the scale on the chart. If this is unset
+      # (+nil+), there will be no horizontal marks across the chart for the
+      # steps of the scale.
+    attr_accessor :style
+      # Shows the scale labels if +true+.
+    attr_accessor :show_labels
+      # Defines the label options.
+    attr_accessor :label
+  end
+
+    # This is any line that will be drawn; this is a combination of the line
+    # style (which must be a PDF::Writer::StrokeStyle object) and a color.
+  class Marker
+    def initialize
+      yield self if block_given?
+    end
+
+      # The stroke style of the marker.
+    attr_accessor :style
+      # The stroke color of the marker.
+    attr_accessor :color
+  end
+
+  def initialize
+    @data                       = []
+
+    @scale                      = Scale.new do |scale|
+      scale.range               = 0..6
+      scale.step                = 1
+      scale.style               = PDF::Writer::StrokeStyle.new(0.25)
+      scale.show_labels         = false
+      scale.label               = Label.new do |label|
+        label.text_size         = 8
+        label.text_color        = Color::RGB::Black
+        label.pad               = 2
+        label.decimal_precision = 1
+      end
+    end
+    @leading_gap              = 10
+    @show_labels              = true
+    @label                    = Label.new do |label|
+      label.height            = 25
+      label.background_color  = Color::RGB::Black
+      label.text_color        = Color::RGB::White
+      label.text_size         = 12
+    end
+
+    @outer_borders            = Marker.new do |marker|
+      marker.style            = PDF::Writer::StrokeStyle.new(1.5)
+      marker.color            = Color::RGB::Black
+    end
+    @inner_borders            = nil
+
+    @dot                      = Marker.new do |marker|
+      marker.style            = PDF::Writer::StrokeStyle.new(5)
+      marker.color            = Color::RGB::Black
+    end
+    @bar                      = Marker.new do |marker|
+      marker.style            = PDF::Writer::StrokeStyle.new(0.5)
+      marker.color            = Color::RGB::Black
+    end
+    @upper_crossbar           = Marker.new do |marker|
+      marker.style            = PDF::Writer::StrokeStyle.new(1)
+      marker.color            = Color::RGB::Black
+    end
+    @lower_crossbar           = Marker.new do |marker|
+      marker.style            = PDF::Writer::StrokeStyle.new(1)
+      marker.color            = Color::RGB::Black
+    end
+
+    @height                   = 200
+    @maximum_width            = 500
+    @datapoint_width          = 35
+
+    yield self if block_given?
+  end
+
+    # The data used to generate the standard deviation chart. This is an
+    # array of DataPoint objects, each containing a +label+, an +average+,
+    # and the +stddev+ (standard deviation) from that average.
+  attr_reader :data
+    # The scale of the chart. All values must be within this range. This
+    # will be a Scale object. It defaults to a scale of 0..6 with a step of
+    # 1.
+  attr_accessor :scale
+
+    # The minimum gap between the chart and the bottom of the page, in
+    # PDF user units.
+  attr_accessor :leading_gap
+
+    # This will be +true+ if labels are to be displayed.
+  attr_accessor :show_labels
+    # The label style of the labels if they are displayed. This must be a
+    # PDF::Charts::StdDev::Label object.
+  attr_accessor :label
+
+    # The inner border style. If +nil+, no inner borders are drawn. This is
+    # a PDF::Charts::StdDev::Marker object.
+  attr_accessor :inner_borders
+    # The outer border style. If +nil+, no inner borders are drawn. This is
+    # a PDF::Charts::StdDev::Marker object.
+  attr_accessor :outer_borders
+
+    # The dot marker. A filled circle will be drawn with this information.
+    # If +nil+, the dot will not be drawn. This is a
+    # PDF::Charts::StdDev::Marker object.
+  attr_accessor :dot
+    # The standard deviation bar. A line will be drawn through the dot
+    # marker (if drawn) from the upper to lower standard deviation.
+    # If +nil+, the line will not be drawn. This is a
+    # PDF::Charts::StdDev::Marker object.
+  attr_accessor :bar
+    # The upper crossbar. A line will be drawn across the top of the
+    # standard deviation bar to the width of the dot marker. If #dot is
+    # +nil+, then the line will be twice as wide as it is thick. If +nil+,
+    # the upper crossbar will not be drawn. This is a
+    # PDF::Charts::StdDev::Marker object.
+  attr_accessor :upper_crossbar
+    # The lower crossbar. A line will be drawn across the bottom of the
+    # standard deviation bar to the width of the dot marker. If #dot is
+    # +nil+, then the line will be twice as wide as it is thick. If +nil+,
+    # the lower crossbar will not be drawn. This is a
+    # PDF::Charts::StdDev::Marker object.
+  attr_accessor :lower_crossbar
+
+    # The height of the chart in PDF user units. Default 200 units.
+  attr_accessor :height
+    # The maximum width of the chart in PDF user units. Default 500 units.
+  attr_accessor :maximum_width
+    # The width of a single datapoint.
+  attr_accessor :datapoint_width
+
+    # Draw the standard deviation chart on the supplied PDF document.
+  def render_on(pdf)
+    raise TypeError, PDF::Writer::Lang[:charts_stddev_data_empty] if @data.empty?
+    data = @data.dup
+    leftover_data = nil
+
+    loop do
+      # Set up the scale information.
+      scale = []
+
+      (@scale.first + @scale.step).step(@scale.last, @scale.step) do |ii|
+        scale << "%01.#{@scale.label.decimal_precision}f" % ii
+      end
+
+      scales = PDF::Writer::OHash.new
+      scale.each_with_index do |gg, ii|
+        scales[ii] = OpenStruct.new
+        scales[ii].value = gg
+      end
+
+      # Add information about the scales' locations to the scales
+      # hash. Note that the count is one smaller than it should be, so we're
+      # increasing it. The first scale is the bottom of the chart.
+      scale_count = scale.size + 1
+
+      label_height_adjuster = 0
+      label_height_adjuster = @label.height if @show_labels
+
+      chart_area_height = @height - label_height_adjuster
+      scale_height   = chart_area_height / scale_count.to_f
+
+      scales.each_key do |index|
+        this_height = scale_height * (index + 1) + @label.height
+        scales[index].line_height = this_height
+        if @scale.show_labels
+          scales[index].label_height = this_height -
+          (@scale.label.text_size / 3.0)
+        end
+      end
+
+      # How many sections do we need in this chart, and how wide will it
+      # need to be?
+      chunk_width = @datapoint_width
+      num_chunks  = data.size
+      widest_scale_label = 0
+
+      if @scale.show_labels
+        scales.each_value do |scale|
+          this_width = pdf.text_width(scale.value, @scale.label.text_size)
+          widest_scale_label = this_width if this_width > widest_scale_label
+        end
+      end
+
+      chart_width = chunk_width * num_chunks
+      total_width = chart_width + widest_scale_label + @scale.label.pad
+
+        # What happens if the projected width of the chart is too big?
+        # Figure out how to break the chart in pieces.
+      if total_width > @maximum_width
+        max_column_count = 0
+        base_width = widest_scale_label + @scale.label.pad
+        (1..(num_chunks + 1)).each do |ii|
+          if (base_width + (ii * chunk_width)) > @maximum_width
+            break
+          else
+            max_column_count += 1
+          end
+        end
+
+        leftover_data = data.slice!(max_column_count, -1)
+
+        num_chunks  = data.size
+        chart_width = chunk_width * num_chunks
+        total_width = chart_width + widest_scale_label + @scale.label.pad
+      end
+
+      chart_y = pdf.y - @height + @leading_gap
+      chart_y += (@outer_borders.style.width * 2.0) if @outer_borders
+
+      if chart_y < pdf.bottom_margin
+        pdf.start_new_page
+        chart_y = pdf.y - @height
+        chart_y += (@outer_borders.style.width * 2.0) if @outer_borders
+      end
+
+      chart_x = pdf.absolute_x_middle - (total_width / 2.0) + widest_scale_label
+
+        # Add labels, if needed.
+      if @show_labels
+        pdf.save_state
+        pdf.fill_color! @label.background_color
+        # Draw a rectangle for each label
+        num_chunks.times do |ii|
+          this_x = chart_x + ii * chunk_width
+          pdf.rectangle(this_x, chart_y, chunk_width, @label.height).fill
+        end
+
+          # Add a border above the label rectangle.
+        if @outer_borders
+          pdf.stroke_style! @outer_borders.style
+          pdf.line(chart_x, chart_y + @label.height, chart_x + chart_width, chart_y + @label.height).stroke
+        end
+        pdf.fill_color! @label.text_color
+
+        data.each_with_index do |datum, ii|
+          label = datum.label.to_s
+          label_width = pdf.text_width(label, @label.text_size)
+          this_x = chart_x + (ii * chunk_width) + (chunk_width / 2.0) - (label_width / 2.0)
+          this_y = chart_y + (@label.height / 2.0) - (@label.text_size / 3.0)
+          pdf.add_text(this_x, this_y, label, @label.text_size)
+        end
+        pdf.restore_state
+      end
+
+      if @inner_borders
+        pdf.save_state
+        pdf.stroke_color! @inner_borders.color
+        pdf.stroke_style! @inner_borders.style
+        (num_chunks - 1).times do |ii|
+          this_x = chart_x + (ii * chunk_width) + chunk_width
+          pdf.line(this_x, chart_y, this_x, chart_y + @height).stroke
+        end
+        pdf.restore_state
+      end
+
+      pdf.save_state
+      if @outer_borders
+        pdf.stroke_color! @outer_borders.color
+        pdf.stroke_style! @outer_borders.style
+        pdf.rectangle(chart_x, chart_y, chart_width, @height).stroke
+      end
+
+      if @scale.style
+        pdf.save_state
+        pdf.stroke_style! @scale.style
+        scales.each_value do |scale|
+          this_y = chart_y + scale.line_height
+          pdf.line(chart_x, this_y, chart_x + chart_width, this_y).stroke
+        end
+        pdf.restore_state
+      end
+
+      if @scale.show_labels
+        pdf.save_state
+        scales.each_value do |scale|
+          this_y = chart_y + scale.label_height
+          label_width = pdf.text_width(scale.value, @scale.label.text_size)
+          this_x = chart_x - label_width - @scale.label.pad
+          pdf.fill_color! @scale.label.text_color
+          pdf.add_text(this_x, this_y, scale.value, @scale.label.text_size)
+        end
+        pdf.restore_state
+      end
+
+      data.each_with_index do |datum, ii|
+        avg_height    = datum.average * scale_height
+        stddev_height = datum.stddev * scale_height
+        this_y        = chart_y + label_height_adjuster + avg_height
+        this_x        = chart_x + (ii * chunk_width) + (chunk_width / 2.0)
+        line_top_y    = this_y + (stddev_height / 2.0)
+        line_bot_y    = this_y - (stddev_height / 2.0)
+
+          # Plot the dot
+        if @dot
+          pdf.stroke_color! @dot.color
+          pdf.stroke_style! @dot.style
+          pdf.circle_at(this_x, this_y, (@dot.style.width / 2.0)).fill
+        end
+
+          # Plot the bar
+        if @bar
+          pdf.stroke_color! @bar.color
+          pdf.stroke_style! @bar.style
+          pdf.line(this_x, line_top_y, this_x, line_bot_y).stroke
+        end
+
+          # Plot the crossbars
+        if @upper_crossbar
+          if @dot
+            cb_width = @dot.style.width
+          else
+            cb_width = @upper_crossbar.style.width
+          end
+          pdf.stroke_color! @upper_crossbar.color
+          pdf.stroke_style! @upper_crossbar.style
+          pdf.line(this_x - cb_width, line_top_y, this_x + cb_width, line_top_y).stroke
+        end
+        if @lower_crossbar
+          if @dot
+            cb_width = @dot.style.width
+          else
+            cb_width = @lower_crossbar.style.width
+          end
+          pdf.stroke_color! @lower_crossbar.color
+          pdf.stroke_style! @lower_crossbar.style
+
+          pdf.line(this_x - cb_width, line_bot_y, this_x + cb_width, line_bot_y).stroke
+        end
+      end
+
+      pdf.restore_state
+
+      pdf.y = chart_y
+
+      break if leftover_data.nil?
+
+      data = leftover_data
+      leftover_data = nil
+    end
+
+    pdf.y
+  end
+end