prawn 1.0.0.rc2 → 1.0.0

data/lib/prawn/core/text/formatted/line_wrap.rb

@@ -1,288 +0,0 @@
-# encoding: utf-8
-
-# core/text/formatted/line_wrap.rb : Implements individual line wrapping of 
-#                                    formatted text
-#
-# Copyright February 2010, Daniel Nelson. All Rights Reserved.
-#
-# This is free software. Please see the LICENSE and COPYING files for details.
-#
-
-module Prawn
-  module Core
-    module Text
-      module Formatted #:nodoc:
-        
-        class LineWrap #:nodoc:
-
-          # The width of the last wrapped line
-          #
-          def width
-            @accumulated_width || 0
-          end
-
-          # The number of spaces in the last wrapped line
-          attr_reader :space_count
-
-          # Whether this line is the last line in the paragraph
-          def paragraph_finished?
-            @newline_encountered || is_next_string_newline? || @arranger.finished?
-          end
-
-          # Work in conjunction with the Prawn::Core::Formatted::Arranger
-          # defined in the :arranger option to determine what formatted text
-          # will fit within the width defined by the :width option
-          #
-          def wrap_line(options)
-            initialize_line(options)
-
-            while fragment = @arranger.next_string
-              @fragment_output = ""
-
-              fragment.lstrip! if first_fragment_on_this_line?(fragment)
-              next if empty_line?(fragment)
-
-              unless apply_font_settings_and_add_fragment_to_line(fragment)
-                break
-              end
-            end
-            @arranger.finalize_line
-            @accumulated_width = @arranger.line_width
-            @space_count = @arranger.space_count
-            @arranger.line
-          end
-
-          private
-
-          def first_fragment_on_this_line?(fragment)
-            line_empty? && fragment != "\n"
-          end
-
-          def empty_line?(fragment)
-            empty = line_empty? && fragment.empty? && is_next_string_newline?
-            @arranger.update_last_string("", "", soft_hyphen) if empty
-            empty
-          end
-
-          def is_next_string_newline?
-            @arranger.preview_next_string == "\n"
-          end
-
-          def apply_font_settings_and_add_fragment_to_line(fragment)
-            result = nil
-            @arranger.apply_font_settings do
-              # if font has changed from Unicode to non-Unicode, or vice versa, the characters used for soft hyphens
-              #   and zero-width spaces will be different
-              set_soft_hyphen_and_zero_width_space
-              result = add_fragment_to_line(fragment)
-            end
-            result
-          end
-
-          # returns true iff all text was printed without running into the end of
-          # the line
-          #
-          def add_fragment_to_line(fragment)
-            if fragment == ""
-              true
-            elsif fragment == "\n"
-              @newline_encountered = true
-              false
-            else
-              fragment.scan(scan_pattern).each do |segment|
-                if segment == zero_width_space
-                  segment_width = 0
-                else
-                  segment_width = @document.width_of(segment, :kerning => @kerning)
-                end
-
-                if @accumulated_width + segment_width <= @width
-                  @accumulated_width += segment_width
-                  @fragment_output += segment
-                else
-                  end_of_the_line_reached(segment)
-                  fragment_finished(fragment)
-                  return false
-                end
-              end
-
-              fragment_finished(fragment)
-              true
-            end
-          end
-
-          # The pattern used to determine chunks of text to place on a given line
-          #
-          def scan_pattern
-            pattern = "[^#{break_chars}]+#{soft_hyphen}|" +
-              "[^#{break_chars}]+#{hyphen}+|" +
-              "[^#{break_chars}]+|" +
-              "[#{whitespace}]+|" +
-              "#{hyphen}+[^#{break_chars}]*|" +
-              "#{soft_hyphen}"
-            new_regexp(pattern)
-          end
-
-          # The pattern used to determine whether any word breaks exist on a
-          # current line, which in turn determines whether character level
-          # word breaking is needed
-          #
-          def word_division_scan_pattern
-            new_regexp("\\s|[#{zero_width_space}#{soft_hyphen}#{hyphen}]")
-          end
-
-          def break_chars
-            "#{whitespace}#{soft_hyphen}#{hyphen}"
-          end
-
-          def whitespace
-            " \\t#{zero_width_space}"
-          end
-
-          def hyphen
-            "-"
-          end
-
-          def soft_hyphen
-            @soft_hyphen
-          end
-
-          def zero_width_space
-            @zero_width_space 
-          end
-
-          def line_empty?
-            @line_empty && @accumulated_width == 0
-          end
-
-          def initialize_line(options)
-            @document = options[:document]
-            @kerning = options[:kerning]
-            @width = options[:width]
-
-            @accumulated_width = 0
-            @line_empty = true
-            @line_contains_more_than_one_word = false
-
-            @arranger = options[:arranger]
-            @arranger.initialize_line
-
-            @newline_encountered = false
-            @line_full = false
-          end
-
-          def set_soft_hyphen_and_zero_width_space
-            # this is done once per fragment, after the font settings for the fragment are applied --
-            #   it could actually be skipped if the font hasn't changed
-            font = @document.font
-            @soft_hyphen = font.normalize_encoding(Prawn::Text::SHY) 
-            @zero_width_space = font.unicode? ? Prawn::Text::ZWSP : ""
-          end
-
-          def fragment_finished(fragment)
-            if fragment == "\n"
-              @newline_encountered = true
-              @line_empty = false
-            else
-              update_output_based_on_last_fragment(fragment, soft_hyphen)
-              update_line_status_based_on_last_output
-              determine_whether_to_pull_preceding_fragment_to_join_this_one(fragment)
-            end
-            remember_this_fragment_for_backward_looking_ops
-          end
-
-          def update_output_based_on_last_fragment(fragment, normalized_soft_hyphen=nil)
-            remaining_text = fragment.slice(@fragment_output.length..fragment.length)
-            raise Errors::CannotFit if line_finished? && line_empty? &&
-              @fragment_output.empty? && !fragment.strip.empty?
-            @arranger.update_last_string(@fragment_output, remaining_text, normalized_soft_hyphen)
-          end
-
-          def determine_whether_to_pull_preceding_fragment_to_join_this_one(current_fragment)
-            if @fragment_output.empty? &&
-                !current_fragment.empty? &&
-                @line_contains_more_than_one_word
-              unless previous_fragment_ended_with_breakable? ||
-                  fragment_begins_with_breakable?(current_fragment)
-                @fragment_output = @previous_fragment_output_without_last_word
-                update_output_based_on_last_fragment(@previous_fragment)
-              end
-            end
-          end
-
-          def remember_this_fragment_for_backward_looking_ops
-            @previous_fragment = @fragment_output.dup
-            pf = @previous_fragment
-            @previous_fragment_ended_with_breakable = pf =~ /[#{break_chars}]$/
-            last_word = pf.slice(/[^#{break_chars}]*$/)
-            last_word_length = last_word.nil? ? 0 : last_word.length
-            @previous_fragment_output_without_last_word = pf.slice(0, pf.length - last_word_length)
-          end
-
-          def previous_fragment_ended_with_breakable?
-            @previous_fragment_ended_with_breakable
-          end
-
-          def fragment_begins_with_breakable?(fragment)
-            fragment =~ /^[#{break_chars}]/
-          end
-
-          def line_finished?
-            @line_full || paragraph_finished?
-          end
-
-          def update_line_status_based_on_last_output
-            @line_contains_more_than_one_word = true if @fragment_output =~ word_division_scan_pattern
-          end
-
-          def end_of_the_line_reached(segment)
-            update_line_status_based_on_last_output
-            wrap_by_char(segment) unless @line_contains_more_than_one_word
-            @line_full = true
-          end
-
-          def wrap_by_char(segment)
-            # this conditional is only necessary for Ruby 1.8 compatibility
-            # String#unicode_characters is a helper which iterates over UTF-8 characters
-            #   under Ruby 1.9, it is implemented simply by aliasing #each_char
-            font = @document.font
-            if font.unicode?
-              segment.unicode_characters do |char|
-                break unless append_char(char,font)
-              end
-            else
-              segment.each_char do |char|
-                break unless append_char(char,font)
-              end
-            end
-          end
-
-          def append_char(char,font)
-            # kerning doesn't make sense in the context of a single character
-            char_width = font.compute_width_of(char)
-
-            if @accumulated_width + char_width <= @width
-              @accumulated_width += char_width
-              @fragment_output << char
-              true
-            else
-              false
-            end
-          end
-
-          def new_regexp(pattern)
-            regexp = ruby_19 {
-              Regexp.new(pattern)
-            }
-            regexp = regexp || ruby_18 {
-              lang = @document.font.unicode? ? 'U' : 'N'
-              Regexp.new(pattern, 0, lang)
-            }
-            regexp
-          end
-
-        end
-      end
-    end
-  end
-end

data/lib/prawn/core/text/formatted/wrap.rb

@@ -1,153 +0,0 @@
-require "prawn/core/text/formatted/line_wrap"
-require "prawn/core/text/formatted/arranger"
-
-module Prawn
-  module Core
-    module Text
-      module Formatted #:nodoc:
-        module Wrap #:nodoc:
-
-          def initialize(array, options)
-            @line_wrap = Prawn::Core::Text::Formatted::LineWrap.new
-            @arranger = Prawn::Core::Text::Formatted::Arranger.new(@document,
-              :kerning => options[:kerning])
-          end
-          
-
-          # See the developer documentation for Prawn::Core::Text#wrap
-          #
-          # Formatted#wrap should set the following variables:
-          #   <tt>@line_height</tt>::
-          #        the height of the tallest fragment in the last printed line
-          #   <tt>@descender</tt>::
-          #        the descender height of the tallest fragment in the last
-          #        printed line
-          #   <tt>@ascender</tt>::
-          #        the ascender heigth of the tallest fragment in the last
-          #        printed line
-          #   <tt>@baseline_y</tt>::
-          #       the baseline of the current line
-          #   <tt>@nothing_printed</tt>::
-          #       set to true until something is printed, then false
-          #   <tt>@everything_printed</tt>::
-          #       set to false until everything printed, then true
-          #
-          # Returns any formatted text that was not printed
-          #
-          def wrap(array) #:nodoc:
-            initialize_wrap(array)
-
-            stop = false
-            while !stop
-              # wrap before testing if enough height for this line because the
-              # height of the highest fragment on this line will be used to
-              # determine the line height
-              @line_wrap.wrap_line(:document => @document,
-                                   :kerning => @kerning,
-                                   :width => available_width,
-                                   :arranger => @arranger)
-
-              if enough_height_for_this_line?
-                move_baseline_down
-                print_line
-              else
-                stop = true
-              end
-
-              stop ||= @single_line || @arranger.finished?
-            end
-            @text = @printed_lines.join("\n")
-            @everything_printed = @arranger.finished?
-            @arranger.unconsumed
-          end
-
-          private
-
-          def print_line
-            @nothing_printed = false
-            printed_fragments = []
-            fragments_this_line = []
-
-            word_spacing = word_spacing_for_this_line
-            while fragment = @arranger.retrieve_fragment
-              fragment.word_spacing = word_spacing
-              if fragment.text == "\n"
-                printed_fragments << "\n" if @printed_lines.last == ""
-                break
-              end
-              printed_fragments << fragment.text
-              fragments_this_line << fragment
-            end
-
-            accumulated_width = 0
-            fragments_this_line.reverse! if @direction == :rtl
-            fragments_this_line.each do |fragment|
-              fragment.default_direction = @direction
-              format_and_draw_fragment(fragment, accumulated_width,
-                                       @line_wrap.width, word_spacing)
-              accumulated_width += fragment.width
-            end
-
-            if "".respond_to?(:force_encoding)
-              printed_fragments.map! { |s| s.force_encoding("utf-8") }
-            end
-            @printed_lines << printed_fragments.join
-          end
-
-          def word_spacing_for_this_line
-            if @align == :justify &&
-                @line_wrap.space_count > 0 &&
-                !@line_wrap.paragraph_finished?
-              (available_width - @line_wrap.width) / @line_wrap.space_count
-            else
-              0
-            end
-          end
-
-          def enough_height_for_this_line?
-            @line_height = @arranger.max_line_height
-            @descender   = @arranger.max_descender
-            @ascender    = @arranger.max_ascender
-            if @baseline_y == 0
-              diff = @ascender + @descender
-            else
-              diff = @descender + @line_height + @leading
-            end
-            required_total_height = @baseline_y.abs + diff
-            if required_total_height > @height + 0.0001
-              # no room for the full height of this line
-              @arranger.repack_unretrieved
-              false
-            else
-              true
-            end
-          end
-
-          def initialize_wrap(array)
-            @text = nil
-            @arranger.format_array = array
-
-            # these values will depend on the maximum value within a given line
-            @line_height = 0
-            @descender   = 0
-            @ascender    = 0
-            @baseline_y  = 0
-
-            @printed_lines = []
-            @nothing_printed = true
-            @everything_printed = false
-          end
-
-          def format_and_draw_fragment(fragment, accumulated_width,
-                                       line_width, word_spacing)
-            @arranger.apply_color_and_font_settings(fragment) do
-              draw_fragment(fragment, accumulated_width,
-                            line_width, word_spacing)
-            end
-          end
-
-        end
-      end
-    end
-  end
-end

data/lib/prawn/document/page_geometry.rb

@@ -1,136 +0,0 @@
-# encoding: utf-8
-
-# page_geometry.rb : Describes PDF page geometries
-#
-# Copyright April 2008, Gregory Brown.  All Rights Reserved.
-#
-# This is free software. Please see the LICENSE and COPYING files for details.
-
-module Prawn
-  class Document
-    
-    # Dimensions pulled from PDF::Writer, rubyforge.org/projects/ruby-pdf
-    # 
-    # All of these dimensions are in PDF Points, see Prawn::Measurements for
-    # conversion utilities.
-    # 
-    # Additionally, if the size you are after is not listed below, you can always
-    # specify your size by passing an array of width and height to Prawn::Document.new
-    # like:
-    # 
-    #  Prawn::Document.new(:page_size => [1000, 20000])
-    #
-    # The sizes below can be used by passing the appropriate string to :size:
-    # 
-    #  Prawn::Document.new(:page_size => '2A0')
-    # 
-    # ===Inbuilt Sizes:
-    # 
-    # 
-    # 4A0:: => 4767.87 x 6740.79
-    # 2A0:: => 3370.39 x 4767.87
-    # A0:: => 2383.94 x 3370.39
-    # A1:: => 1683.78 x 2383.94
-    # A2:: => 1190.55 x 1683.78
-    # A3:: => 841.89 x 1190.55
-    # A4:: => 595.28 x 841.89
-    # A5:: => 419.53 x 595.28
-    # A6:: => 297.64 x 419.53
-    # A7:: => 209.76 x 297.64
-    # A8:: => 147.40 x 209.76
-    # A9:: => 104.88 x 147.40
-    # A10:: => 73.70 x 104.88
-    # B0:: => 2834.65 x 4008.19
-    # B1:: => 2004.09 x 2834.65
-    # B2:: => 1417.32 x 2004.09
-    # B3:: => 1000.63 x 1417.32
-    # B4:: => 708.66 x 1000.63
-    # B5:: => 498.90 x 708.66
-    # B6:: => 354.33 x 498.90
-    # B7:: => 249.45 x 354.33
-    # B8:: => 175.75 x 249.45
-    # B9:: => 124.72 x 175.75
-    # B10:: => 87.87 x 124.72
-    # C0:: => 2599.37 x 3676.54
-    # C1:: => 1836.85 x 2599.37
-    # C2:: => 1298.27 x 1836.85
-    # C3:: => 918.43 x 1298.27
-    # C4:: => 649.13 x 918.43
-    # C5:: => 459.21 x 649.13
-    # C6:: => 323.15 x 459.21
-    # C7:: => 229.61 x 323.15
-    # C8:: => 161.57 x 229.61
-    # C9:: => 113.39 x 161.57
-    # C10:: => 79.37 x 113.39
-    # RA0:: => 2437.80 x 3458.27
-    # RA1:: => 1729.13 x 2437.80
-    # RA2:: => 1218.90 x 1729.13
-    # RA3:: => 864.57 x 1218.90
-    # RA4:: => 609.45 x 864.57
-    # SRA0:: => 2551.18 x 3628.35
-    # SRA1:: => 1814.17 x 2551.18
-    # SRA2:: => 1275.59 x 1814.17
-    # SRA3:: => 907.09 x 1275.59
-    # SRA4:: => 637.80 x 907.09
-    # EXECUTIVE:: => 521.86 x 756.00
-    # FOLIO:: => 612.00 x 936.00
-    # LEGAL:: => 612.00 x 1008.00
-    # LETTER:: => 612.00 x 792.00
-    # TABLOID:: => 792.00 x 1224.00 
-    #
-    module PageGeometry
-
-      SIZES = { "4A0" => [4767.87, 6740.79],
-                "2A0" => [3370.39, 4767.87],
-                 "A0" => [2383.94, 3370.39],
-                 "A1" => [1683.78, 2383.94],
-                 "A2" => [1190.55, 1683.78],
-                 "A3" => [841.89, 1190.55],
-                 "A4" => [595.28, 841.89],
-                 "A5" => [419.53, 595.28],
-                 "A6" => [297.64, 419.53],
-                 "A7" => [209.76, 297.64],
-                 "A8" => [147.40, 209.76],
-                 "A9" => [104.88, 147.40],
-                "A10" => [73.70, 104.88],
-                 "B0" => [2834.65, 4008.19],
-                 "B1" => [2004.09, 2834.65],
-                 "B2" => [1417.32, 2004.09],
-                 "B3" => [1000.63, 1417.32],
-                 "B4" => [708.66, 1000.63],
-                 "B5" => [498.90, 708.66],
-                 "B6" => [354.33, 498.90],
-                 "B7" => [249.45, 354.33],
-                 "B8" => [175.75, 249.45],
-                 "B9" => [124.72, 175.75],
-                "B10" => [87.87, 124.72],
-                 "C0" => [2599.37, 3676.54],
-                 "C1" => [1836.85, 2599.37],
-                 "C2" => [1298.27, 1836.85],
-                 "C3" => [918.43, 1298.27],
-                 "C4" => [649.13, 918.43],
-                 "C5" => [459.21, 649.13],
-                 "C6" => [323.15, 459.21],
-                 "C7" => [229.61, 323.15],
-                 "C8" => [161.57, 229.61],
-                 "C9" => [113.39, 161.57],
-                "C10" => [79.37, 113.39],
-                "RA0" => [2437.80, 3458.27],
-                "RA1" => [1729.13, 2437.80],
-                "RA2" => [1218.90, 1729.13],
-                "RA3" => [864.57, 1218.90],
-                "RA4" => [609.45, 864.57],
-               "SRA0" => [2551.18, 3628.35],
-               "SRA1" => [1814.17, 2551.18],
-               "SRA2" => [1275.59, 1814.17],
-               "SRA3" => [907.09, 1275.59],
-               "SRA4" => [637.80, 907.09],
-          "EXECUTIVE" => [521.86, 756.00],
-              "FOLIO" => [612.00, 936.00],
-              "LEGAL" => [612.00, 1008.00],
-             "LETTER" => [612.00, 792.00],
-            "TABLOID" => [792.00, 1224.00] }
-
-   end
-  end
-end