nurettin-prawn 1.0.0.rc1
Sign up to get free protection for your applications and to get access to all the features.
- data/COPYING +2 -0
- data/GPLv2 +340 -0
- data/GPLv3 +674 -0
- data/Gemfile +18 -0
- data/LICENSE +56 -0
- data/README.md +98 -0
- data/Rakefile +45 -0
- data/data/encodings/win_ansi.txt +29 -0
- data/data/fonts/Action Man.dfont +0 -0
- data/data/fonts/Activa.ttf +0 -0
- data/data/fonts/Chalkboard.ttf +0 -0
- data/data/fonts/Courier-Bold.afm +342 -0
- data/data/fonts/Courier-BoldOblique.afm +342 -0
- data/data/fonts/Courier-Oblique.afm +342 -0
- data/data/fonts/Courier.afm +342 -0
- data/data/fonts/DejaVuSans.ttf +0 -0
- data/data/fonts/Dustismo_Roman.ttf +0 -0
- data/data/fonts/Helvetica-Bold.afm +2827 -0
- data/data/fonts/Helvetica-BoldOblique.afm +2827 -0
- data/data/fonts/Helvetica-Oblique.afm +3051 -0
- data/data/fonts/Helvetica.afm +3051 -0
- data/data/fonts/MustRead.html +19 -0
- data/data/fonts/Symbol.afm +213 -0
- data/data/fonts/Times-Bold.afm +2588 -0
- data/data/fonts/Times-BoldItalic.afm +2384 -0
- data/data/fonts/Times-Italic.afm +2667 -0
- data/data/fonts/Times-Roman.afm +2419 -0
- data/data/fonts/ZapfDingbats.afm +225 -0
- data/data/fonts/comicsans.ttf +0 -0
- data/data/fonts/gkai00mp.ttf +0 -0
- data/data/images/16bit.alpha +0 -0
- data/data/images/16bit.dat +0 -0
- data/data/images/16bit.png +0 -0
- data/data/images/arrow.png +0 -0
- data/data/images/arrow2.png +0 -0
- data/data/images/barcode_issue.png +0 -0
- data/data/images/dice.alpha +0 -0
- data/data/images/dice.dat +0 -0
- data/data/images/dice.png +0 -0
- data/data/images/dice_interlaced.png +0 -0
- data/data/images/fractal.jpg +0 -0
- data/data/images/letterhead.jpg +0 -0
- data/data/images/page_white_text.alpha +0 -0
- data/data/images/page_white_text.dat +0 -0
- data/data/images/page_white_text.png +0 -0
- data/data/images/pigs.jpg +0 -0
- data/data/images/prawn.png +0 -0
- data/data/images/rails.dat +0 -0
- data/data/images/rails.png +0 -0
- data/data/images/ruport.png +0 -0
- data/data/images/ruport_data.dat +0 -0
- data/data/images/ruport_transparent.png +0 -0
- data/data/images/ruport_type0.png +0 -0
- data/data/images/stef.jpg +0 -0
- data/data/images/tru256.bmp +0 -0
- data/data/images/web-links.dat +1 -0
- data/data/images/web-links.png +0 -0
- data/data/pdfs/complex_template.pdf +0 -0
- data/data/pdfs/contains_ttf_font.pdf +0 -0
- data/data/pdfs/encrypted.pdf +0 -0
- data/data/pdfs/form.pdf +820 -0
- data/data/pdfs/hexagon.pdf +61 -0
- data/data/pdfs/indirect_reference.pdf +86 -0
- data/data/pdfs/multipage_template.pdf +127 -0
- data/data/pdfs/nested_pages.pdf +118 -0
- data/data/pdfs/page_without_mediabox.pdf +193 -0
- data/data/pdfs/resources_as_indirect_object.pdf +83 -0
- data/data/pdfs/two_hexagons.pdf +90 -0
- data/data/pdfs/version_1_6.pdf +61 -0
- data/data/shift_jis_text.txt +1 -0
- data/lib/prawn.rb +29 -0
- data/lib/prawn/compatibility.rb +87 -0
- data/lib/prawn/core.rb +87 -0
- data/lib/prawn/core/annotations.rb +61 -0
- data/lib/prawn/core/byte_string.rb +9 -0
- data/lib/prawn/core/destinations.rb +90 -0
- data/lib/prawn/core/document_state.rb +79 -0
- data/lib/prawn/core/literal_string.rb +16 -0
- data/lib/prawn/core/name_tree.rb +177 -0
- data/lib/prawn/core/object_store.rb +320 -0
- data/lib/prawn/core/page.rb +212 -0
- data/lib/prawn/core/pdf_object.rb +125 -0
- data/lib/prawn/core/reference.rb +119 -0
- data/lib/prawn/core/text.rb +268 -0
- data/lib/prawn/core/text/formatted/arranger.rb +294 -0
- data/lib/prawn/core/text/formatted/line_wrap.rb +288 -0
- data/lib/prawn/core/text/formatted/wrap.rb +153 -0
- data/lib/prawn/document.rb +707 -0
- data/lib/prawn/document/bounding_box.rb +510 -0
- data/lib/prawn/document/column_box.rb +132 -0
- data/lib/prawn/document/graphics_state.rb +136 -0
- data/lib/prawn/document/internals.rb +173 -0
- data/lib/prawn/document/page_geometry.rb +136 -0
- data/lib/prawn/document/snapshot.rb +89 -0
- data/lib/prawn/document/span.rb +55 -0
- data/lib/prawn/encoding.rb +121 -0
- data/lib/prawn/errors.rb +99 -0
- data/lib/prawn/font.rb +386 -0
- data/lib/prawn/font/afm.rb +203 -0
- data/lib/prawn/font/dfont.rb +42 -0
- data/lib/prawn/font/ttf.rb +343 -0
- data/lib/prawn/graphics.rb +523 -0
- data/lib/prawn/graphics/cap_style.rb +46 -0
- data/lib/prawn/graphics/color.rb +231 -0
- data/lib/prawn/graphics/dash.rb +82 -0
- data/lib/prawn/graphics/join_style.rb +47 -0
- data/lib/prawn/graphics/patterns.rb +137 -0
- data/lib/prawn/graphics/transformation.rb +156 -0
- data/lib/prawn/graphics/transparency.rb +99 -0
- data/lib/prawn/images.rb +196 -0
- data/lib/prawn/images/image.rb +65 -0
- data/lib/prawn/images/jpg.rb +85 -0
- data/lib/prawn/images/png.rb +362 -0
- data/lib/prawn/layout.rb +20 -0
- data/lib/prawn/layout/grid.rb +259 -0
- data/lib/prawn/measurement_extensions.rb +46 -0
- data/lib/prawn/measurements.rb +71 -0
- data/lib/prawn/outline.rb +326 -0
- data/lib/prawn/repeater.rb +122 -0
- data/lib/prawn/security.rb +269 -0
- data/lib/prawn/soft_mask.rb +94 -0
- data/lib/prawn/stamp.rb +134 -0
- data/lib/prawn/table.rb +609 -0
- data/lib/prawn/table/cell.rb +776 -0
- data/lib/prawn/table/cell/image.rb +70 -0
- data/lib/prawn/table/cell/in_table.rb +27 -0
- data/lib/prawn/table/cell/span_dummy.rb +88 -0
- data/lib/prawn/table/cell/subtable.rb +65 -0
- data/lib/prawn/table/cell/text.rb +152 -0
- data/lib/prawn/table/cells.rb +260 -0
- data/lib/prawn/text.rb +420 -0
- data/lib/prawn/text/box.rb +141 -0
- data/lib/prawn/text/formatted.rb +4 -0
- data/lib/prawn/text/formatted/box.rb +563 -0
- data/lib/prawn/text/formatted/fragment.rb +253 -0
- data/lib/prawn/text/formatted/parser.rb +217 -0
- data/lib/prawn/utilities.rb +44 -0
- data/manual/basic_concepts/adding_pages.rb +27 -0
- data/manual/basic_concepts/basic_concepts.rb +34 -0
- data/manual/basic_concepts/creation.rb +39 -0
- data/manual/basic_concepts/cursor.rb +33 -0
- data/manual/basic_concepts/measurement.rb +25 -0
- data/manual/basic_concepts/origin.rb +38 -0
- data/manual/basic_concepts/other_cursor_helpers.rb +40 -0
- data/manual/bounding_box/bounding_box.rb +39 -0
- data/manual/bounding_box/bounds.rb +49 -0
- data/manual/bounding_box/canvas.rb +24 -0
- data/manual/bounding_box/creation.rb +23 -0
- data/manual/bounding_box/indentation.rb +46 -0
- data/manual/bounding_box/nesting.rb +45 -0
- data/manual/bounding_box/russian_boxes.rb +40 -0
- data/manual/bounding_box/stretchy.rb +31 -0
- data/manual/document_and_page_options/background.rb +27 -0
- data/manual/document_and_page_options/document_and_page_options.rb +31 -0
- data/manual/document_and_page_options/metadata.rb +23 -0
- data/manual/document_and_page_options/page_margins.rb +38 -0
- data/manual/document_and_page_options/page_size.rb +34 -0
- data/manual/example_file.rb +116 -0
- data/manual/example_helper.rb +430 -0
- data/manual/example_package.rb +53 -0
- data/manual/example_section.rb +46 -0
- data/manual/graphics/circle_and_ellipse.rb +22 -0
- data/manual/graphics/color.rb +24 -0
- data/manual/graphics/common_lines.rb +28 -0
- data/manual/graphics/fill_and_stroke.rb +42 -0
- data/manual/graphics/fill_rules.rb +37 -0
- data/manual/graphics/gradients.rb +37 -0
- data/manual/graphics/graphics.rb +58 -0
- data/manual/graphics/helper.rb +17 -0
- data/manual/graphics/line_width.rb +35 -0
- data/manual/graphics/lines_and_curves.rb +41 -0
- data/manual/graphics/polygon.rb +29 -0
- data/manual/graphics/rectangle.rb +21 -0
- data/manual/graphics/rotate.rb +28 -0
- data/manual/graphics/scale.rb +41 -0
- data/manual/graphics/soft_masks.rb +46 -0
- data/manual/graphics/stroke_cap.rb +31 -0
- data/manual/graphics/stroke_dash.rb +43 -0
- data/manual/graphics/stroke_join.rb +30 -0
- data/manual/graphics/translate.rb +29 -0
- data/manual/graphics/transparency.rb +35 -0
- data/manual/images/absolute_position.rb +23 -0
- data/manual/images/fit.rb +21 -0
- data/manual/images/horizontal.rb +25 -0
- data/manual/images/images.rb +40 -0
- data/manual/images/plain_image.rb +18 -0
- data/manual/images/scale.rb +22 -0
- data/manual/images/vertical.rb +28 -0
- data/manual/images/width_and_height.rb +25 -0
- data/manual/layout/boxes.rb +27 -0
- data/manual/layout/content.rb +25 -0
- data/manual/layout/layout.rb +28 -0
- data/manual/layout/simple_grid.rb +23 -0
- data/manual/manual/cover.rb +26 -0
- data/manual/manual/foreword.rb +13 -0
- data/manual/manual/how_to_read_this_manual.rb +41 -0
- data/manual/manual/manual.rb +36 -0
- data/manual/outline/add_subsection_to.rb +61 -0
- data/manual/outline/insert_section_after.rb +47 -0
- data/manual/outline/outline.rb +32 -0
- data/manual/outline/sections_and_pages.rb +67 -0
- data/manual/repeatable_content/page_numbering.rb +54 -0
- data/manual/repeatable_content/repeatable_content.rb +31 -0
- data/manual/repeatable_content/repeater.rb +55 -0
- data/manual/repeatable_content/stamp.rb +41 -0
- data/manual/security/encryption.rb +31 -0
- data/manual/security/permissions.rb +38 -0
- data/manual/security/security.rb +28 -0
- data/manual/syntax_highlight.rb +52 -0
- data/manual/table/basic_block.rb +53 -0
- data/manual/table/before_rendering_page.rb +26 -0
- data/manual/table/cell_border_lines.rb +24 -0
- data/manual/table/cell_borders_and_bg.rb +31 -0
- data/manual/table/cell_dimensions.rb +30 -0
- data/manual/table/cell_text.rb +38 -0
- data/manual/table/column_widths.rb +30 -0
- data/manual/table/content_and_subtables.rb +39 -0
- data/manual/table/creation.rb +27 -0
- data/manual/table/filtering.rb +36 -0
- data/manual/table/flow_and_header.rb +17 -0
- data/manual/table/image_cells.rb +33 -0
- data/manual/table/position.rb +29 -0
- data/manual/table/row_colors.rb +20 -0
- data/manual/table/span.rb +30 -0
- data/manual/table/style.rb +22 -0
- data/manual/table/table.rb +52 -0
- data/manual/table/width.rb +27 -0
- data/manual/templates/full_template.rb +23 -0
- data/manual/templates/page_template.rb +47 -0
- data/manual/templates/templates.rb +26 -0
- data/manual/text/alignment.rb +44 -0
- data/manual/text/color.rb +24 -0
- data/manual/text/column_box.rb +32 -0
- data/manual/text/fallback_fonts.rb +37 -0
- data/manual/text/font.rb +41 -0
- data/manual/text/font_size.rb +45 -0
- data/manual/text/font_style.rb +23 -0
- data/manual/text/formatted_callbacks.rb +60 -0
- data/manual/text/formatted_text.rb +50 -0
- data/manual/text/free_flowing_text.rb +51 -0
- data/manual/text/group.rb +29 -0
- data/manual/text/inline.rb +43 -0
- data/manual/text/kerning_and_character_spacing.rb +39 -0
- data/manual/text/leading.rb +25 -0
- data/manual/text/line_wrapping.rb +41 -0
- data/manual/text/paragraph_indentation.rb +26 -0
- data/manual/text/positioned_text.rb +38 -0
- data/manual/text/registering_families.rb +48 -0
- data/manual/text/rendering_and_color.rb +37 -0
- data/manual/text/right_to_left_text.rb +43 -0
- data/manual/text/rotation.rb +43 -0
- data/manual/text/single_usage.rb +37 -0
- data/manual/text/text.rb +75 -0
- data/manual/text/text_box_excess.rb +32 -0
- data/manual/text/text_box_extensions.rb +45 -0
- data/manual/text/text_box_overflow.rb +44 -0
- data/manual/text/utf8.rb +28 -0
- data/manual/text/win_ansi_charset.rb +59 -0
- data/prawn.gemspec +46 -0
- data/spec/annotations_spec.rb +90 -0
- data/spec/bounding_box_spec.rb +493 -0
- data/spec/cell_spec.rb +584 -0
- data/spec/column_box_spec.rb +33 -0
- data/spec/data/curves.pdf +66 -0
- data/spec/destinations_spec.rb +15 -0
- data/spec/document_spec.rb +736 -0
- data/spec/extensions/encoding_helpers.rb +6 -0
- data/spec/extensions/mocha.rb +44 -0
- data/spec/font_spec.rb +433 -0
- data/spec/formatted_text_arranger_spec.rb +421 -0
- data/spec/formatted_text_box_spec.rb +640 -0
- data/spec/formatted_text_fragment_spec.rb +298 -0
- data/spec/graphics_spec.rb +651 -0
- data/spec/grid_spec.rb +85 -0
- data/spec/images_spec.rb +140 -0
- data/spec/inline_formatted_text_parser_spec.rb +515 -0
- data/spec/jpg_spec.rb +25 -0
- data/spec/line_wrap_spec.rb +333 -0
- data/spec/measurement_units_spec.rb +23 -0
- data/spec/name_tree_spec.rb +112 -0
- data/spec/object_store_spec.rb +170 -0
- data/spec/outline_spec.rb +426 -0
- data/spec/pdf_object_spec.rb +172 -0
- data/spec/png_spec.rb +240 -0
- data/spec/reference_spec.rb +105 -0
- data/spec/repeater_spec.rb +158 -0
- data/spec/security_spec.rb +126 -0
- data/spec/snapshot_spec.rb +186 -0
- data/spec/soft_mask_spec.rb +117 -0
- data/spec/span_spec.rb +49 -0
- data/spec/spec_helper.rb +36 -0
- data/spec/stamp_spec.rb +159 -0
- data/spec/stroke_styles_spec.rb +193 -0
- data/spec/table_spec.rb +1209 -0
- data/spec/template_spec.rb +351 -0
- data/spec/text_at_spec.rb +129 -0
- data/spec/text_box_spec.rb +1029 -0
- data/spec/text_rendering_mode_spec.rb +45 -0
- data/spec/text_spacing_spec.rb +93 -0
- data/spec/text_spec.rb +421 -0
- data/spec/text_with_inline_formatting_spec.rb +35 -0
- data/spec/transparency_spec.rb +89 -0
- metadata +544 -0
data/lib/prawn/text.rb
ADDED
@@ -0,0 +1,420 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
|
3
|
+
# text.rb : Implements PDF text primitives
|
4
|
+
#
|
5
|
+
# Copyright May 2008, Gregory Brown. All Rights Reserved.
|
6
|
+
#
|
7
|
+
# This is free software. Please see the LICENSE and COPYING files for details.
|
8
|
+
require "prawn/core/text"
|
9
|
+
require "prawn/text/formatted"
|
10
|
+
require "prawn/text/box"
|
11
|
+
require "zlib"
|
12
|
+
|
13
|
+
module Prawn
|
14
|
+
module Text
|
15
|
+
|
16
|
+
include Prawn::Core::Text
|
17
|
+
include Prawn::Text::Formatted
|
18
|
+
|
19
|
+
# No-Break Space
|
20
|
+
Prawn::Text::NBSP = " "
|
21
|
+
# Zero Width Space (indicate word boundaries without a space)
|
22
|
+
Prawn::Text::ZWSP = [8203].pack("U")
|
23
|
+
# Soft Hyphen (invisible, except when causing a line break)
|
24
|
+
Prawn::Text::SHY = ""
|
25
|
+
|
26
|
+
# If you want text to flow onto a new page or between columns, this is the
|
27
|
+
# method to use. If, instead, if you want to place bounded text outside of
|
28
|
+
# the flow of a document (for captions, labels, charts, etc.), use Text::Box
|
29
|
+
# or its convenience method text_box.
|
30
|
+
#
|
31
|
+
# Draws text on the page. Prawn attempts to wrap the text to fit within your
|
32
|
+
# current bounding box (or margin_box if no bounding box is being used).
|
33
|
+
# Text will flow onto the next page when it reaches the bottom of the
|
34
|
+
# bounding box. Text wrap in Prawn does not re-flow linebreaks, so if you
|
35
|
+
# want fully automated text wrapping, be sure to remove newlines before
|
36
|
+
# attempting to draw your string.
|
37
|
+
#
|
38
|
+
# == Examples
|
39
|
+
#
|
40
|
+
# pdf.text "Will be wrapped when it hits the edge of your bounding box"
|
41
|
+
# pdf.text "This will be centered", :align => :center
|
42
|
+
# pdf.text "This will be right aligned", :align => :right
|
43
|
+
# pdf.text "This <i>includes <b>inline</b></i> <font size='24'>" +
|
44
|
+
# "formatting</font>", :inline_format => true
|
45
|
+
#
|
46
|
+
# If your font contains kerning pair data that Prawn can parse, the
|
47
|
+
# text will be kerned by default. You can disable kerning by including
|
48
|
+
# a false <tt>:kerning</tt> option. If you want to disable kerning on an
|
49
|
+
# entire document, set default_kerning = false for that document
|
50
|
+
#
|
51
|
+
# === Text Positioning Details
|
52
|
+
#
|
53
|
+
# The text is positioned at font.ascender below the baseline,
|
54
|
+
# making it easy to use this method within bounding boxes and spans.
|
55
|
+
#
|
56
|
+
# == Encoding
|
57
|
+
#
|
58
|
+
# Note that strings passed to this function should be encoded as UTF-8.
|
59
|
+
# If you get unexpected characters appearing in your rendered document,
|
60
|
+
# check this.
|
61
|
+
#
|
62
|
+
# If the current font is a built-in one, although the string must be
|
63
|
+
# encoded as UTF-8, only characters that are available in WinAnsi
|
64
|
+
# are allowed.
|
65
|
+
#
|
66
|
+
# If an empty box is rendered to your PDF instead of the character you
|
67
|
+
# wanted it usually means the current font doesn't include that character.
|
68
|
+
#
|
69
|
+
# == Options (default values marked in [])
|
70
|
+
#
|
71
|
+
# <tt>:inline_format</tt>::
|
72
|
+
# <tt>boolean</tt>. If true, then the string parameter is interpreted
|
73
|
+
# as a HTML-esque string that recognizes the following tags:
|
74
|
+
# <tt>\<b></b></tt>:: bold
|
75
|
+
# <tt>\<i></i></tt>:: italic
|
76
|
+
# <tt>\<u></u></tt>:: underline
|
77
|
+
# <tt>\<strikethrough></strikethrough></tt>:: strikethrough
|
78
|
+
# <tt>\<sub></sub></tt>:: subscript
|
79
|
+
# <tt>\<sup></sup></tt>:: superscript
|
80
|
+
# <tt>\<font></font></tt>::
|
81
|
+
# with the following attributes (using double or single quotes)
|
82
|
+
# <tt>size="24"</tt>::
|
83
|
+
# attribute for setting size
|
84
|
+
# <tt>character_spacing="2.5"</tt>::
|
85
|
+
# attribute for setting character spacing
|
86
|
+
# <tt>name="Helvetica"</tt>::
|
87
|
+
# attribute for setting the font. The font name must be an
|
88
|
+
# AFM font with the desired faces or must be a font that is
|
89
|
+
# already registered using Prawn::Document#font_families
|
90
|
+
# <tt>\<color></color></tt>::
|
91
|
+
# with the following attributes
|
92
|
+
# <tt>rgb="ffffff" or rgb="#ffffff"</tt>::
|
93
|
+
# <tt>c="100" m="100" y="100" k="100"</tt>::
|
94
|
+
# <tt>\<link></link></tt>::
|
95
|
+
# with the following attributes
|
96
|
+
# <tt>href="http://example.com"</tt>:: an external link
|
97
|
+
# <tt>anchor="ToC"</tt>::
|
98
|
+
# where the value of the anchor attribute is the name of a
|
99
|
+
# destination that has already been or will be registered
|
100
|
+
# using Prawn::Core::Destinations#add_dest. A clickable link
|
101
|
+
# will be created to that destination.
|
102
|
+
# Note that you must explicitly underline and color using the
|
103
|
+
# appropriate tags if you which to draw attention to the link
|
104
|
+
#
|
105
|
+
# <tt>:kerning</tt>:: <tt>boolean</tt>. Whether or not to use kerning (if it
|
106
|
+
# is available with the current font)
|
107
|
+
# [value of document.default_kerning?]
|
108
|
+
# <tt>:size</tt>:: <tt>number</tt>. The font size to use. [current font
|
109
|
+
# size]
|
110
|
+
# <tt>:color</tt>:: an RGB color ("ff0000") or CMYK array [10, 20, 30, 40].
|
111
|
+
# <tt>:character_spacing</tt>:: <tt>number</tt>. The amount of space to add
|
112
|
+
# to or remove from the default character
|
113
|
+
# spacing. [0]
|
114
|
+
# <tt>:style</tt>:: The style to use. The requested style must be part of
|
115
|
+
# the current font familly. [current style]
|
116
|
+
# <tt>:indent_paragraphs</tt>:: <tt>number</tt>. The amount to indent the
|
117
|
+
# first line of each paragraph. Omit this
|
118
|
+
# option if you do not want indenting
|
119
|
+
# <tt>:direction</tt>::
|
120
|
+
# <tt>:ltr</tt>, <tt>:rtl</tt>, Direction of the text (left-to-right
|
121
|
+
# or right-to-left) [value of document.text_direction]
|
122
|
+
# <tt>:fallback_fonts</tt>::
|
123
|
+
# An array of font names. Each name must be the name of an AFM font or
|
124
|
+
# the name that was used to register a family of TTF fonts (see
|
125
|
+
# Prawn::Document#font_families). If present, then each glyph will be
|
126
|
+
# rendered using the first font that includes the glyph, starting with
|
127
|
+
# the current font and then moving through :fallback_fonts from
|
128
|
+
# left to right.
|
129
|
+
# <tt>:align</tt>::
|
130
|
+
# <tt>:left</tt>, <tt>:center</tt>, <tt>:right</tt>, or
|
131
|
+
# <tt>:justify</tt> Alignment within the bounding box
|
132
|
+
# [:left if direction is :ltr, :right if direction is :rtl]
|
133
|
+
# <tt>:valign</tt>:: <tt>:top</tt>, <tt>:center</tt>, or <tt>:bottom</tt>.
|
134
|
+
# Vertical alignment within the bounding box [:top]
|
135
|
+
# <tt>:leading</tt>::
|
136
|
+
# <tt>number</tt>. Additional space between lines [value of
|
137
|
+
# document.default_leading]
|
138
|
+
# <tt>:final_gap</tt>:: <tt>boolean</tt>. If true, then the space between
|
139
|
+
# each line is included below the last line;
|
140
|
+
# otherwise, document.y is placed just below the
|
141
|
+
# descender of the last line printed [true]
|
142
|
+
# <tt>:mode</tt>:: The text rendering mode to use. Use this to specify if the
|
143
|
+
# text should render with the fill color, stroke color or
|
144
|
+
# both. See the comments to text_rendering_mode() to see
|
145
|
+
# a list of valid options. [0]
|
146
|
+
#
|
147
|
+
# == Exceptions
|
148
|
+
#
|
149
|
+
# Raises <tt>ArgumentError</tt> if <tt>:at</tt> option included
|
150
|
+
#
|
151
|
+
# Raises <tt>Prawn::Errrors::CannotFit</tt> if not wide enough to print
|
152
|
+
# any text
|
153
|
+
#
|
154
|
+
def text(string, options={})
|
155
|
+
return false if string.nil?
|
156
|
+
# we modify the options. don't change the user's hash
|
157
|
+
options = options.dup
|
158
|
+
|
159
|
+
if options[:inline_format]
|
160
|
+
options.delete(:inline_format)
|
161
|
+
array = Text::Formatted::Parser.to_array(string)
|
162
|
+
else
|
163
|
+
array = [{ :text => string }]
|
164
|
+
end
|
165
|
+
|
166
|
+
formatted_text(array, options)
|
167
|
+
end
|
168
|
+
|
169
|
+
|
170
|
+
# Draws formatted text to the page.
|
171
|
+
# Formatted text is comprised of an array of hashes, where each hash defines
|
172
|
+
# text and format information. See Text::Formatted#formatted_text_box for
|
173
|
+
# more information on the structure of this array
|
174
|
+
#
|
175
|
+
# == Example
|
176
|
+
#
|
177
|
+
# text([{ :text => "hello" },
|
178
|
+
# { :text => "world",
|
179
|
+
# :size => 24,
|
180
|
+
# :styles => [:bold, :italic] }])
|
181
|
+
#
|
182
|
+
# == Options
|
183
|
+
#
|
184
|
+
# Accepts the same options as #text
|
185
|
+
#
|
186
|
+
# == Exceptions
|
187
|
+
#
|
188
|
+
# Same as for #text
|
189
|
+
#
|
190
|
+
def formatted_text(array, options={})
|
191
|
+
options = inspect_options_for_text(options.dup)
|
192
|
+
|
193
|
+
if color = options.delete(:color)
|
194
|
+
array = array.map do |fragment|
|
195
|
+
fragment[:color] ? fragment : fragment.merge(:color => color)
|
196
|
+
end
|
197
|
+
end
|
198
|
+
|
199
|
+
if @indent_paragraphs
|
200
|
+
Text::Formatted::Parser.array_paragraphs(array).each do |paragraph|
|
201
|
+
options[:skip_encoding] = false
|
202
|
+
remaining_text = draw_indented_formatted_line(paragraph, options)
|
203
|
+
options[:skip_encoding] = true
|
204
|
+
|
205
|
+
if @no_text_printed
|
206
|
+
# unless this paragraph was an empty line
|
207
|
+
unless @all_text_printed
|
208
|
+
@bounding_box.move_past_bottom
|
209
|
+
options[:skip_encoding] = false
|
210
|
+
remaining_text = draw_indented_formatted_line(paragraph, options)
|
211
|
+
options[:skip_encoding] = true
|
212
|
+
end
|
213
|
+
end
|
214
|
+
|
215
|
+
remaining_text = fill_formatted_text_box(remaining_text, options)
|
216
|
+
draw_remaining_formatted_text_on_new_pages(remaining_text, options)
|
217
|
+
end
|
218
|
+
else
|
219
|
+
remaining_text = fill_formatted_text_box(array, options)
|
220
|
+
options[:skip_encoding] = true
|
221
|
+
draw_remaining_formatted_text_on_new_pages(remaining_text, options)
|
222
|
+
end
|
223
|
+
end
|
224
|
+
|
225
|
+
# Draws text on the page, beginning at the point specified by the :at option
|
226
|
+
# the string is assumed to be pre-formatted to properly fit the page.
|
227
|
+
#
|
228
|
+
# pdf.draw_text "Hello World", :at => [100,100]
|
229
|
+
# pdf.draw_text "Goodbye World", :at => [50,50], :size => 16
|
230
|
+
#
|
231
|
+
# If your font contains kerning pair data that Prawn can parse, the
|
232
|
+
# text will be kerned by default. You can disable kerning by including
|
233
|
+
# a false <tt>:kerning</tt> option. If you want to disable kerning on an
|
234
|
+
# entire document, set default_kerning = false for that document
|
235
|
+
#
|
236
|
+
# === Text Positioning Details:
|
237
|
+
#
|
238
|
+
# Prawn will position your text by the left-most edge of its baseline, and
|
239
|
+
# flow along a single line. (This means that :align will not work)
|
240
|
+
#
|
241
|
+
# == Rotation
|
242
|
+
#
|
243
|
+
# Text can be rotated before it is placed on the canvas by specifying the
|
244
|
+
# <tt>:rotate</tt> option with a given angle. Rotation occurs counter-clockwise.
|
245
|
+
#
|
246
|
+
# == Encoding
|
247
|
+
#
|
248
|
+
# Note that strings passed to this function should be encoded as UTF-8.
|
249
|
+
# If you get unexpected characters appearing in your rendered document,
|
250
|
+
# check this.
|
251
|
+
#
|
252
|
+
# If the current font is a built-in one, although the string must be
|
253
|
+
# encoded as UTF-8, only characters that are available in WinAnsi
|
254
|
+
# are allowed.
|
255
|
+
#
|
256
|
+
# If an empty box is rendered to your PDF instead of the character you
|
257
|
+
# wanted it usually means the current font doesn't include that character.
|
258
|
+
#
|
259
|
+
# == Options (default values marked in [])
|
260
|
+
#
|
261
|
+
# <tt>:at</tt>:: <tt>[x, y]</tt>(required). The position at which to start the text
|
262
|
+
# <tt>:kerning</tt>:: <tt>boolean</tt>. Whether or not to use kerning (if it
|
263
|
+
# is available with the current font)
|
264
|
+
# [value of default_kerning?]
|
265
|
+
# <tt>:size</tt>:: <tt>number</tt>. The font size to use. [current font
|
266
|
+
# size]
|
267
|
+
# <tt>:style</tt>:: The style to use. The requested style must be part of
|
268
|
+
# the current font familly. [current style]
|
269
|
+
#
|
270
|
+
# <tt>:rotate</tt>:: <tt>number</tt>. The angle to which to rotate text
|
271
|
+
#
|
272
|
+
# == Exceptions
|
273
|
+
#
|
274
|
+
# Raises <tt>ArgumentError</tt> if <tt>:at</tt> option omitted
|
275
|
+
#
|
276
|
+
# Raises <tt>ArgumentError</tt> if <tt>:align</tt> option included
|
277
|
+
#
|
278
|
+
def draw_text(text, options)
|
279
|
+
options = inspect_options_for_draw_text(options.dup)
|
280
|
+
|
281
|
+
# dup because normalize_encoding changes the string
|
282
|
+
text = text.to_s.dup
|
283
|
+
save_font do
|
284
|
+
process_text_options(options)
|
285
|
+
font.normalize_encoding!(text) unless @skip_encoding
|
286
|
+
font_size(options[:size]) { draw_text!(text, options) }
|
287
|
+
end
|
288
|
+
end
|
289
|
+
|
290
|
+
# Gets height of text in PDF points.
|
291
|
+
# Same options as #text, except as noted.
|
292
|
+
# Not compatible with :indent_paragraphs option
|
293
|
+
#
|
294
|
+
# ==Example
|
295
|
+
#
|
296
|
+
# height_of("hello\nworld")
|
297
|
+
#
|
298
|
+
# == Exceptions
|
299
|
+
#
|
300
|
+
# Raises <tt>NotImplementedError</tt> if <tt>:indent_paragraphs</tt>
|
301
|
+
# option included
|
302
|
+
#
|
303
|
+
# Raises <tt>Prawn::Errrors::CannotFit</tt> if not wide enough to print
|
304
|
+
# any text
|
305
|
+
#
|
306
|
+
def height_of(string, options={})
|
307
|
+
height_of_formatted([{ :text => string }], options)
|
308
|
+
end
|
309
|
+
|
310
|
+
# Gets height of formatted text in PDF points.
|
311
|
+
# See documentation for #height_of.
|
312
|
+
#
|
313
|
+
# ==Example
|
314
|
+
#
|
315
|
+
# height_of_formatted([{ :text => "hello" },
|
316
|
+
# { :text => "world",
|
317
|
+
# :size => 24,
|
318
|
+
# :styles => [:bold, :italic] }])
|
319
|
+
#
|
320
|
+
def height_of_formatted(array, options={})
|
321
|
+
if options[:indent_paragraphs]
|
322
|
+
raise NotImplementedError, ":indent_paragraphs option not available" +
|
323
|
+
"with height_of"
|
324
|
+
end
|
325
|
+
process_final_gap_option(options)
|
326
|
+
box = Text::Formatted::Box.new(array,
|
327
|
+
options.merge(:height => 100000000,
|
328
|
+
:document => self))
|
329
|
+
printed = box.render(:dry_run => true)
|
330
|
+
|
331
|
+
height = box.height
|
332
|
+
height += box.line_gap + box.leading if @final_gap
|
333
|
+
height
|
334
|
+
end
|
335
|
+
|
336
|
+
private
|
337
|
+
|
338
|
+
def draw_remaining_formatted_text_on_new_pages(remaining_text, options)
|
339
|
+
while remaining_text.length > 0
|
340
|
+
@bounding_box.move_past_bottom
|
341
|
+
previous_remaining_text = remaining_text
|
342
|
+
remaining_text = fill_formatted_text_box(remaining_text, options)
|
343
|
+
break if remaining_text == previous_remaining_text
|
344
|
+
end
|
345
|
+
end
|
346
|
+
|
347
|
+
def draw_indented_formatted_line(string, options)
|
348
|
+
indent(@indent_paragraphs) do
|
349
|
+
fill_formatted_text_box(string, options.dup.merge(:single_line => true))
|
350
|
+
end
|
351
|
+
end
|
352
|
+
|
353
|
+
def fill_formatted_text_box(text, options)
|
354
|
+
merge_text_box_positioning_options(options)
|
355
|
+
box = Text::Formatted::Box.new(text, options)
|
356
|
+
remaining_text = box.render
|
357
|
+
@no_text_printed = box.nothing_printed?
|
358
|
+
@all_text_printed = box.everything_printed?
|
359
|
+
|
360
|
+
self.y -= box.height
|
361
|
+
self.y -= box.line_gap + box.leading if @final_gap
|
362
|
+
|
363
|
+
remaining_text
|
364
|
+
end
|
365
|
+
|
366
|
+
def merge_text_box_positioning_options(options)
|
367
|
+
bottom = @bounding_box.stretchy? ? @margin_box.absolute_bottom :
|
368
|
+
@bounding_box.absolute_bottom
|
369
|
+
|
370
|
+
options[:height] = y - bottom
|
371
|
+
options[:width] = bounds.width
|
372
|
+
options[:at] = [@bounding_box.left_side - @bounding_box.absolute_left,
|
373
|
+
y - @bounding_box.absolute_bottom]
|
374
|
+
end
|
375
|
+
|
376
|
+
def inspect_options_for_draw_text(options)
|
377
|
+
if options[:at].nil?
|
378
|
+
raise ArgumentError, "The :at option is required for draw_text"
|
379
|
+
elsif options[:align]
|
380
|
+
raise ArgumentError, "The :align option does not work with draw_text"
|
381
|
+
end
|
382
|
+
if options[:kerning].nil? then
|
383
|
+
options[:kerning] = default_kerning?
|
384
|
+
end
|
385
|
+
valid_options = Prawn::Core::Text::VALID_OPTIONS + [:at, :rotate]
|
386
|
+
Prawn.verify_options(valid_options, options)
|
387
|
+
options
|
388
|
+
end
|
389
|
+
|
390
|
+
def inspect_options_for_text(options)
|
391
|
+
if options[:at]
|
392
|
+
raise ArgumentError, ":at is no longer a valid option with text." +
|
393
|
+
"use draw_text or text_box instead"
|
394
|
+
end
|
395
|
+
process_final_gap_option(options)
|
396
|
+
process_indent_paragraphs_option(options)
|
397
|
+
options[:document] = self
|
398
|
+
options
|
399
|
+
end
|
400
|
+
|
401
|
+
def process_final_gap_option(options)
|
402
|
+
@final_gap = options[:final_gap].nil? || options[:final_gap]
|
403
|
+
options.delete(:final_gap)
|
404
|
+
end
|
405
|
+
|
406
|
+
def process_indent_paragraphs_option(options)
|
407
|
+
@indent_paragraphs = options[:indent_paragraphs]
|
408
|
+
options.delete(:indent_paragraphs)
|
409
|
+
end
|
410
|
+
|
411
|
+
def move_text_position(dy)
|
412
|
+
bottom = @bounding_box.stretchy? ? @margin_box.absolute_bottom :
|
413
|
+
@bounding_box.absolute_bottom
|
414
|
+
|
415
|
+
@bounding_box.move_past_bottom if (y - dy) < bottom
|
416
|
+
|
417
|
+
self.y -= dy
|
418
|
+
end
|
419
|
+
end
|
420
|
+
end
|
@@ -0,0 +1,141 @@
|
|
1
|
+
# encoding: utf-8
|
2
|
+
|
3
|
+
# text/rectangle.rb : Implements text boxes
|
4
|
+
#
|
5
|
+
# Copyright November 2009, Daniel Nelson. All Rights Reserved.
|
6
|
+
#
|
7
|
+
# This is free software. Please see the LICENSE and COPYING files for details.
|
8
|
+
#
|
9
|
+
|
10
|
+
module Prawn
|
11
|
+
module Text
|
12
|
+
|
13
|
+
# Draws the requested text into a box. When the text overflows
|
14
|
+
# the rectangle, you shrink to fit, or truncate the text. Text
|
15
|
+
# boxes are independent of the document y position.
|
16
|
+
#
|
17
|
+
# == Encoding
|
18
|
+
#
|
19
|
+
# Note that strings passed to this function should be encoded as UTF-8.
|
20
|
+
# If you get unexpected characters appearing in your rendered document,
|
21
|
+
# check this.
|
22
|
+
#
|
23
|
+
# If the current font is a built-in one, although the string must be
|
24
|
+
# encoded as UTF-8, only characters that are available in WinAnsi
|
25
|
+
# are allowed.
|
26
|
+
#
|
27
|
+
# If an empty box is rendered to your PDF instead of the character you
|
28
|
+
# wanted it usually means the current font doesn't include that character.
|
29
|
+
#
|
30
|
+
# == Options (default values marked in [])
|
31
|
+
#
|
32
|
+
# <tt>:kerning</tt>:: <tt>boolean</tt>. Whether or not to use kerning (if it
|
33
|
+
# is available with the current font)
|
34
|
+
# [value of document.default_kerning?]
|
35
|
+
# <tt>:size</tt>:: <tt>number</tt>. The font size to use. [current font
|
36
|
+
# size]
|
37
|
+
# <tt>:character_spacing</tt>:: <tt>number</tt>. The amount of space to add
|
38
|
+
# to or remove from the default character
|
39
|
+
# spacing. [0]
|
40
|
+
# <tt>:mode</tt>:: <tt>symbol</tt>. The text rendering mode. See
|
41
|
+
# documentation for Prawn::Document#text_rendering_mode
|
42
|
+
# for a list of valid options. [:fill]
|
43
|
+
# <tt>:style</tt>:: The style to use. The requested style must be part of
|
44
|
+
# the current font familly. [current style]
|
45
|
+
#
|
46
|
+
# <tt>:at</tt>::
|
47
|
+
# <tt>[x, y]</tt>. The upper left corner of the box
|
48
|
+
# [@document.bounds.left, @document.bounds.top]
|
49
|
+
# <tt>:width</tt>::
|
50
|
+
# <tt>number</tt>. The width of the box [@document.bounds.right - @at[0]]
|
51
|
+
# <tt>:height</tt>::
|
52
|
+
# <tt>number</tt>. The height of the box [default_height()]
|
53
|
+
# <tt>:direction</tt>::
|
54
|
+
# <tt>:ltr</tt>, <tt>:rtl</tt>, Direction of the text (left-to-right
|
55
|
+
# or right-to-left) [value of document.text_direction]
|
56
|
+
# <tt>:fallback_fonts</tt>::
|
57
|
+
# An array of font names. Each name must be the name of an AFM font or
|
58
|
+
# the name that was used to register a family of TTF fonts (see
|
59
|
+
# Prawn::Document#font_families). If present, then each glyph will be
|
60
|
+
# rendered using the first font that includes the glyph, starting with
|
61
|
+
# the current font and then moving through :fallback_fonts from
|
62
|
+
# left to right.
|
63
|
+
# <tt>:align</tt>::
|
64
|
+
# <tt>:left</tt>, <tt>:center</tt>, <tt>:right</tt>, or
|
65
|
+
# <tt>:justify</tt> Alignment within the bounding box
|
66
|
+
# [:left if direction is :ltr, :right if direction is :rtl]
|
67
|
+
# <tt>:valign</tt>::
|
68
|
+
# <tt>:top</tt>, <tt>:center</tt>, or <tt>:bottom</tt>. Vertical
|
69
|
+
# alignment within the bounding box [:top]
|
70
|
+
#
|
71
|
+
# <tt>:rotate</tt>::
|
72
|
+
# <tt>number</tt>. The angle to rotate the text
|
73
|
+
# <tt>:rotate_around</tt>::
|
74
|
+
# <tt>:center</tt>, <tt>:upper_left</tt>, <tt>:upper_right</tt>,
|
75
|
+
# <tt>:lower_right</tt>, or <tt>:lower_left</tt>. The point around which
|
76
|
+
# to rotate the text [:upper_left]
|
77
|
+
# <tt>:leading</tt>::
|
78
|
+
# <tt>number</tt>. Additional space between lines [value of
|
79
|
+
# document.default_leading]
|
80
|
+
# <tt>:single_line</tt>::
|
81
|
+
# <tt>boolean</tt>. If true, then only the first line will be drawn [false]
|
82
|
+
# <tt>:skip_encoding</tt>::
|
83
|
+
# <tt>boolean</tt> [false]
|
84
|
+
# <tt>:overflow</tt>::
|
85
|
+
# <tt>:truncate</tt>, <tt>:shrink_to_fit</tt>, or <tt>:expand</tt>
|
86
|
+
# This controls the behavior when the amount of text
|
87
|
+
# exceeds the available space. [:truncate]
|
88
|
+
# <tt>:min_font_size</tt>::
|
89
|
+
# <tt>number</tt>. The minimum font size to use when :overflow is set to
|
90
|
+
# :shrink_to_fit (that is the font size will not be reduced to less than
|
91
|
+
# this value, even if it means that some text will be cut off). [5]
|
92
|
+
#
|
93
|
+
# == Returns
|
94
|
+
#
|
95
|
+
# Returns any text that did not print under the current settings.
|
96
|
+
#
|
97
|
+
# NOTE: if an AFM font is used, then the returned text is encoded in
|
98
|
+
# WinAnsi. Subsequent calls to text_box that pass this returned text back
|
99
|
+
# into text box must include a :skip_encoding => true option. This is
|
100
|
+
# unnecessary when using TTF fonts because those operate on UTF-8 encoding.
|
101
|
+
#
|
102
|
+
# == Exceptions
|
103
|
+
#
|
104
|
+
# Raises <tt>Prawn::Errrors::CannotFit</tt> if not wide enough to print
|
105
|
+
# any text
|
106
|
+
#
|
107
|
+
def text_box(string, options={})
|
108
|
+
options = options.dup
|
109
|
+
options[:document] = self
|
110
|
+
|
111
|
+
box = if options.delete(:inline_format)
|
112
|
+
array = Text::Formatted::Parser.to_array(string)
|
113
|
+
Text::Formatted::Box.new(array, options)
|
114
|
+
else
|
115
|
+
Text::Box.new(string, options)
|
116
|
+
end
|
117
|
+
|
118
|
+
box.render
|
119
|
+
end
|
120
|
+
|
121
|
+
# Generally, one would use the Prawn::Text#text_box convenience
|
122
|
+
# method. However, using Text::Box.new in conjunction with
|
123
|
+
# #render(:dry_run=> true) enables one to do look-ahead calculations prior
|
124
|
+
# to placing text on the page, or to determine how much vertical space was
|
125
|
+
# consumed by the printed text
|
126
|
+
#
|
127
|
+
class Box < Prawn::Text::Formatted::Box
|
128
|
+
|
129
|
+
def initialize(string, options={})
|
130
|
+
super([{ :text => string }], options)
|
131
|
+
end
|
132
|
+
|
133
|
+
def render(flags={})
|
134
|
+
leftover = super(flags)
|
135
|
+
leftover.collect { |hash| hash[:text] }.join
|
136
|
+
end
|
137
|
+
|
138
|
+
end
|
139
|
+
|
140
|
+
end
|
141
|
+
end
|