prawn-git 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (252) hide show
  1. checksums.yaml +7 -0
  2. data/.yardopts +10 -0
  3. data/COPYING +2 -0
  4. data/GPLv2 +340 -0
  5. data/GPLv3 +674 -0
  6. data/Gemfile +11 -0
  7. data/LICENSE +56 -0
  8. data/Rakefile +55 -0
  9. data/data/fonts/Courier-Bold.afm +342 -0
  10. data/data/fonts/Courier-BoldOblique.afm +342 -0
  11. data/data/fonts/Courier-Oblique.afm +342 -0
  12. data/data/fonts/Courier.afm +342 -0
  13. data/data/fonts/Helvetica-Bold.afm +2827 -0
  14. data/data/fonts/Helvetica-BoldOblique.afm +2827 -0
  15. data/data/fonts/Helvetica-Oblique.afm +3051 -0
  16. data/data/fonts/Helvetica.afm +3051 -0
  17. data/data/fonts/MustRead.html +19 -0
  18. data/data/fonts/Symbol.afm +213 -0
  19. data/data/fonts/Times-Bold.afm +2588 -0
  20. data/data/fonts/Times-BoldItalic.afm +2384 -0
  21. data/data/fonts/Times-Italic.afm +2667 -0
  22. data/data/fonts/Times-Roman.afm +2419 -0
  23. data/data/fonts/ZapfDingbats.afm +225 -0
  24. data/data/images/16bit.alpha +0 -0
  25. data/data/images/16bit.color +0 -0
  26. data/data/images/16bit.png +0 -0
  27. data/data/images/arrow.png +0 -0
  28. data/data/images/arrow2.png +0 -0
  29. data/data/images/dice.alpha +0 -0
  30. data/data/images/dice.color +0 -0
  31. data/data/images/dice.png +0 -0
  32. data/data/images/dice_interlaced.png +0 -0
  33. data/data/images/fractal.jpg +0 -0
  34. data/data/images/indexed_color.dat +0 -0
  35. data/data/images/indexed_color.png +0 -0
  36. data/data/images/letterhead.jpg +0 -0
  37. data/data/images/license.md +8 -0
  38. data/data/images/page_white_text.alpha +0 -0
  39. data/data/images/page_white_text.color +0 -0
  40. data/data/images/page_white_text.png +0 -0
  41. data/data/images/pal_bk.png +0 -0
  42. data/data/images/pigs.jpg +0 -0
  43. data/data/images/prawn.png +0 -0
  44. data/data/images/ruport.png +0 -0
  45. data/data/images/ruport_data.dat +0 -0
  46. data/data/images/ruport_transparent.png +0 -0
  47. data/data/images/ruport_type0.png +0 -0
  48. data/data/images/stef.jpg +0 -0
  49. data/data/images/tru256.bmp +0 -0
  50. data/data/images/web-links.dat +1 -0
  51. data/data/images/web-links.png +0 -0
  52. data/data/pdfs/complex_template.pdf +0 -0
  53. data/data/pdfs/contains_ttf_font.pdf +0 -0
  54. data/data/pdfs/encrypted.pdf +0 -0
  55. data/data/pdfs/form.pdf +820 -0
  56. data/data/pdfs/hexagon.pdf +61 -0
  57. data/data/pdfs/indirect_reference.pdf +86 -0
  58. data/data/pdfs/multipage_template.pdf +127 -0
  59. data/data/pdfs/nested_pages.pdf +118 -0
  60. data/data/pdfs/page_without_mediabox.pdf +193 -0
  61. data/data/pdfs/resources_as_indirect_object.pdf +83 -0
  62. data/data/pdfs/two_hexagons.pdf +90 -0
  63. data/data/pdfs/version_1_6.pdf +61 -0
  64. data/data/shift_jis_text.txt +1 -0
  65. data/lib/prawn.rb +89 -0
  66. data/lib/prawn/document.rb +706 -0
  67. data/lib/prawn/document/bounding_box.rb +539 -0
  68. data/lib/prawn/document/column_box.rb +144 -0
  69. data/lib/prawn/document/internals.rb +58 -0
  70. data/lib/prawn/document/span.rb +57 -0
  71. data/lib/prawn/encoding.rb +87 -0
  72. data/lib/prawn/errors.rb +80 -0
  73. data/lib/prawn/font.rb +413 -0
  74. data/lib/prawn/font/afm.rb +256 -0
  75. data/lib/prawn/font/dfont.rb +43 -0
  76. data/lib/prawn/font/ttf.rb +355 -0
  77. data/lib/prawn/font_metric_cache.rb +46 -0
  78. data/lib/prawn/graphics.rb +646 -0
  79. data/lib/prawn/graphics/cap_style.rb +47 -0
  80. data/lib/prawn/graphics/color.rb +232 -0
  81. data/lib/prawn/graphics/dash.rb +109 -0
  82. data/lib/prawn/graphics/join_style.rb +49 -0
  83. data/lib/prawn/graphics/patterns.rb +126 -0
  84. data/lib/prawn/graphics/transformation.rb +157 -0
  85. data/lib/prawn/graphics/transparency.rb +101 -0
  86. data/lib/prawn/grid.rb +279 -0
  87. data/lib/prawn/image_handler.rb +44 -0
  88. data/lib/prawn/images.rb +199 -0
  89. data/lib/prawn/images/image.rb +49 -0
  90. data/lib/prawn/images/jpg.rb +91 -0
  91. data/lib/prawn/images/png.rb +290 -0
  92. data/lib/prawn/measurement_extensions.rb +50 -0
  93. data/lib/prawn/measurements.rb +77 -0
  94. data/lib/prawn/outline.rb +289 -0
  95. data/lib/prawn/repeater.rb +124 -0
  96. data/lib/prawn/security.rb +288 -0
  97. data/lib/prawn/security/arcfour.rb +54 -0
  98. data/lib/prawn/soft_mask.rb +94 -0
  99. data/lib/prawn/stamp.rb +136 -0
  100. data/lib/prawn/text.rb +437 -0
  101. data/lib/prawn/text/box.rb +141 -0
  102. data/lib/prawn/text/formatted.rb +7 -0
  103. data/lib/prawn/text/formatted/arranger.rb +290 -0
  104. data/lib/prawn/text/formatted/box.rb +614 -0
  105. data/lib/prawn/text/formatted/fragment.rb +264 -0
  106. data/lib/prawn/text/formatted/line_wrap.rb +277 -0
  107. data/lib/prawn/text/formatted/parser.rb +224 -0
  108. data/lib/prawn/text/formatted/wrap.rb +160 -0
  109. data/lib/prawn/utilities.rb +46 -0
  110. data/lib/prawn/version.rb +5 -0
  111. data/lib/prawn/view.rb +91 -0
  112. data/manual/absolute_position.pdf +0 -0
  113. data/manual/basic_concepts/adding_pages.rb +27 -0
  114. data/manual/basic_concepts/basic_concepts.rb +36 -0
  115. data/manual/basic_concepts/creation.rb +39 -0
  116. data/manual/basic_concepts/cursor.rb +33 -0
  117. data/manual/basic_concepts/measurement.rb +25 -0
  118. data/manual/basic_concepts/origin.rb +38 -0
  119. data/manual/basic_concepts/other_cursor_helpers.rb +40 -0
  120. data/manual/basic_concepts/view.rb +42 -0
  121. data/manual/bounding_box/bounding_box.rb +39 -0
  122. data/manual/bounding_box/bounds.rb +49 -0
  123. data/manual/bounding_box/canvas.rb +24 -0
  124. data/manual/bounding_box/creation.rb +23 -0
  125. data/manual/bounding_box/indentation.rb +46 -0
  126. data/manual/bounding_box/nesting.rb +45 -0
  127. data/manual/bounding_box/russian_boxes.rb +40 -0
  128. data/manual/bounding_box/stretchy.rb +31 -0
  129. data/manual/contents.rb +29 -0
  130. data/manual/cover.rb +39 -0
  131. data/manual/document_and_page_options/background.rb +27 -0
  132. data/manual/document_and_page_options/document_and_page_options.rb +32 -0
  133. data/manual/document_and_page_options/metadata.rb +23 -0
  134. data/manual/document_and_page_options/page_margins.rb +38 -0
  135. data/manual/document_and_page_options/page_size.rb +34 -0
  136. data/manual/document_and_page_options/print_scaling.rb +20 -0
  137. data/manual/example_helper.rb +7 -0
  138. data/manual/graphics/circle_and_ellipse.rb +22 -0
  139. data/manual/graphics/color.rb +24 -0
  140. data/manual/graphics/common_lines.rb +30 -0
  141. data/manual/graphics/fill_and_stroke.rb +42 -0
  142. data/manual/graphics/fill_rules.rb +37 -0
  143. data/manual/graphics/gradients.rb +37 -0
  144. data/manual/graphics/graphics.rb +58 -0
  145. data/manual/graphics/helper.rb +24 -0
  146. data/manual/graphics/line_width.rb +35 -0
  147. data/manual/graphics/lines_and_curves.rb +41 -0
  148. data/manual/graphics/polygon.rb +29 -0
  149. data/manual/graphics/rectangle.rb +21 -0
  150. data/manual/graphics/rotate.rb +28 -0
  151. data/manual/graphics/scale.rb +41 -0
  152. data/manual/graphics/soft_masks.rb +46 -0
  153. data/manual/graphics/stroke_cap.rb +31 -0
  154. data/manual/graphics/stroke_dash.rb +48 -0
  155. data/manual/graphics/stroke_join.rb +30 -0
  156. data/manual/graphics/translate.rb +29 -0
  157. data/manual/graphics/transparency.rb +35 -0
  158. data/manual/how_to_read_this_manual.rb +40 -0
  159. data/manual/images/absolute_position.rb +23 -0
  160. data/manual/images/fit.rb +21 -0
  161. data/manual/images/horizontal.rb +25 -0
  162. data/manual/images/images.rb +40 -0
  163. data/manual/images/plain_image.rb +18 -0
  164. data/manual/images/scale.rb +22 -0
  165. data/manual/images/vertical.rb +28 -0
  166. data/manual/images/width_and_height.rb +25 -0
  167. data/manual/layout/boxes.rb +27 -0
  168. data/manual/layout/content.rb +25 -0
  169. data/manual/layout/layout.rb +28 -0
  170. data/manual/layout/simple_grid.rb +23 -0
  171. data/manual/outline/add_subsection_to.rb +61 -0
  172. data/manual/outline/insert_section_after.rb +47 -0
  173. data/manual/outline/outline.rb +32 -0
  174. data/manual/outline/sections_and_pages.rb +67 -0
  175. data/manual/repeatable_content/alternate_page_numbering.rb +32 -0
  176. data/manual/repeatable_content/page_numbering.rb +54 -0
  177. data/manual/repeatable_content/repeatable_content.rb +32 -0
  178. data/manual/repeatable_content/repeater.rb +55 -0
  179. data/manual/repeatable_content/stamp.rb +41 -0
  180. data/manual/security/encryption.rb +31 -0
  181. data/manual/security/permissions.rb +38 -0
  182. data/manual/security/security.rb +28 -0
  183. data/manual/table.rb +16 -0
  184. data/manual/text/alignment.rb +44 -0
  185. data/manual/text/color.rb +24 -0
  186. data/manual/text/column_box.rb +32 -0
  187. data/manual/text/fallback_fonts.rb +37 -0
  188. data/manual/text/font.rb +41 -0
  189. data/manual/text/font_size.rb +45 -0
  190. data/manual/text/font_style.rb +23 -0
  191. data/manual/text/formatted_callbacks.rb +60 -0
  192. data/manual/text/formatted_text.rb +50 -0
  193. data/manual/text/free_flowing_text.rb +51 -0
  194. data/manual/text/inline.rb +41 -0
  195. data/manual/text/kerning_and_character_spacing.rb +39 -0
  196. data/manual/text/leading.rb +25 -0
  197. data/manual/text/line_wrapping.rb +41 -0
  198. data/manual/text/paragraph_indentation.rb +34 -0
  199. data/manual/text/positioned_text.rb +38 -0
  200. data/manual/text/registering_families.rb +48 -0
  201. data/manual/text/rendering_and_color.rb +37 -0
  202. data/manual/text/right_to_left_text.rb +47 -0
  203. data/manual/text/rotation.rb +43 -0
  204. data/manual/text/single_usage.rb +37 -0
  205. data/manual/text/text.rb +73 -0
  206. data/manual/text/text_box_excess.rb +32 -0
  207. data/manual/text/text_box_extensions.rb +45 -0
  208. data/manual/text/text_box_overflow.rb +48 -0
  209. data/manual/text/utf8.rb +28 -0
  210. data/manual/text/win_ansi_charset.rb +60 -0
  211. data/prawn.gemspec +45 -0
  212. data/spec/acceptance/png.rb +25 -0
  213. data/spec/annotations_spec.rb +74 -0
  214. data/spec/bounding_box_spec.rb +510 -0
  215. data/spec/column_box_spec.rb +65 -0
  216. data/spec/data/curves.pdf +66 -0
  217. data/spec/destinations_spec.rb +15 -0
  218. data/spec/document_spec.rb +748 -0
  219. data/spec/extensions/encoding_helpers.rb +11 -0
  220. data/spec/extensions/mocha.rb +46 -0
  221. data/spec/font_metric_cache_spec.rb +52 -0
  222. data/spec/font_spec.rb +474 -0
  223. data/spec/formatted_text_arranger_spec.rb +421 -0
  224. data/spec/formatted_text_box_spec.rb +705 -0
  225. data/spec/formatted_text_fragment_spec.rb +298 -0
  226. data/spec/graphics_spec.rb +683 -0
  227. data/spec/grid_spec.rb +96 -0
  228. data/spec/image_handler_spec.rb +54 -0
  229. data/spec/images_spec.rb +153 -0
  230. data/spec/inline_formatted_text_parser_spec.rb +564 -0
  231. data/spec/jpg_spec.rb +25 -0
  232. data/spec/line_wrap_spec.rb +367 -0
  233. data/spec/measurement_units_spec.rb +25 -0
  234. data/spec/outline_spec.rb +430 -0
  235. data/spec/png_spec.rb +245 -0
  236. data/spec/reference_spec.rb +25 -0
  237. data/spec/repeater_spec.rb +160 -0
  238. data/spec/security_spec.rb +158 -0
  239. data/spec/soft_mask_spec.rb +79 -0
  240. data/spec/span_spec.rb +44 -0
  241. data/spec/spec_helper.rb +54 -0
  242. data/spec/stamp_spec.rb +160 -0
  243. data/spec/stroke_styles_spec.rb +211 -0
  244. data/spec/text_at_spec.rb +143 -0
  245. data/spec/text_box_spec.rb +1043 -0
  246. data/spec/text_rendering_mode_spec.rb +45 -0
  247. data/spec/text_spacing_spec.rb +93 -0
  248. data/spec/text_spec.rb +557 -0
  249. data/spec/text_with_inline_formatting_spec.rb +35 -0
  250. data/spec/transparency_spec.rb +91 -0
  251. data/spec/view_spec.rb +43 -0
  252. metadata +509 -0
@@ -0,0 +1,45 @@
1
+ # encoding: utf-8
2
+
3
+ require File.join(File.expand_path(File.dirname(__FILE__)), "spec_helper")
4
+
5
+ describe "#text_rendering_mode" do
6
+ it "should draw the text rendering mode to the document" do
7
+ create_pdf
8
+ @pdf.text_rendering_mode(:stroke) do
9
+ @pdf.text("hello world")
10
+ end
11
+ contents = PDF::Inspector::Text.analyze(@pdf.render)
12
+ contents.text_rendering_mode.first.should == 1
13
+ end
14
+ it "should not draw the text rendering mode to the document" +
15
+ " when the new mode matches the old" do
16
+ create_pdf
17
+ @pdf.text_rendering_mode(:fill) do
18
+ @pdf.text("hello world")
19
+ end
20
+ contents = PDF::Inspector::Text.analyze(@pdf.render)
21
+ contents.text_rendering_mode.should be_empty
22
+ end
23
+ it "should restore character spacing to 0" do
24
+ create_pdf
25
+ @pdf.text_rendering_mode(:stroke) do
26
+ @pdf.text("hello world")
27
+ end
28
+ contents = PDF::Inspector::Text.analyze(@pdf.render)
29
+ contents.text_rendering_mode.should == [1,0]
30
+ end
31
+ it "should function as an accessor when no parameter given" do
32
+ create_pdf
33
+ @pdf.text_rendering_mode(:fill_stroke) do
34
+ @pdf.text("hello world")
35
+ @pdf.text_rendering_mode.should == :fill_stroke
36
+ end
37
+ @pdf.text_rendering_mode.should == :fill
38
+ end
39
+ it "should raise_error an exception when passed an invalid mode" do
40
+ create_pdf
41
+ lambda { @pdf.text_rendering_mode(-1) }.should raise_error(ArgumentError)
42
+ lambda { @pdf.text_rendering_mode(8) }.should raise_error(ArgumentError)
43
+ lambda { @pdf.text_rendering_mode(:flil) }.should raise_error(ArgumentError)
44
+ end
45
+ end
@@ -0,0 +1,93 @@
1
+ # encoding: utf-8
2
+
3
+ require File.join(File.expand_path(File.dirname(__FILE__)), "spec_helper")
4
+
5
+ describe "#character_spacing" do
6
+ it "should draw the character spacing to the document" do
7
+ create_pdf
8
+ @pdf.character_spacing(10.555555) do
9
+ @pdf.text("hello world")
10
+ end
11
+ contents = PDF::Inspector::Text.analyze(@pdf.render)
12
+ contents.character_spacing.first.should == 10.5556
13
+ end
14
+ it "should not draw the character spacing to the document" +
15
+ " when the new character spacing matches the old" do
16
+ create_pdf
17
+ @pdf.character_spacing(0) do
18
+ @pdf.text("hello world")
19
+ end
20
+ contents = PDF::Inspector::Text.analyze(@pdf.render)
21
+ contents.character_spacing.should be_empty
22
+ end
23
+ it "should restore character spacing to 0" do
24
+ create_pdf
25
+ @pdf.character_spacing(10.555555) do
26
+ @pdf.text("hello world")
27
+ end
28
+ contents = PDF::Inspector::Text.analyze(@pdf.render)
29
+ contents.character_spacing.last.should == 0
30
+ end
31
+ it "should function as an accessor when no parameter given" do
32
+ create_pdf
33
+ @pdf.character_spacing(10.555555) do
34
+ @pdf.text("hello world")
35
+ @pdf.character_spacing.should == 10.555555
36
+ end
37
+ @pdf.character_spacing.should == 0
38
+ end
39
+
40
+ # ensure that we properly internationalize by using the number of characters
41
+ # in a string, not the number of bytes, to insert character spaces
42
+ #
43
+ it "should calculate character spacing widths by characters, not bytes" do
44
+ create_pdf
45
+ @pdf.font("#{Prawn::DATADIR}/fonts/gkai00mp.ttf")
46
+
47
+ str = "こんにちは世界"
48
+ @pdf.character_spacing(0) do
49
+ @raw_width = @pdf.width_of(str)
50
+ end
51
+
52
+ @pdf.character_spacing(10) do
53
+ # the new width should include seven 10-pt character spaces.
54
+ @pdf.width_of(str).should be_within(0.001).of(@raw_width + (10 * 7))
55
+ end
56
+ end
57
+ end
58
+
59
+ describe "#word_spacing" do
60
+ it "should draw the word spacing to the document" do
61
+ create_pdf
62
+ @pdf.word_spacing(10.555555) do
63
+ @pdf.text("hello world")
64
+ end
65
+ contents = PDF::Inspector::Text.analyze(@pdf.render)
66
+ contents.word_spacing.first.should == 10.5556
67
+ end
68
+ it "should draw the word spacing to the document" +
69
+ " when the new word spacing matches the old" do
70
+ create_pdf
71
+ @pdf.word_spacing(0) do
72
+ @pdf.text("hello world")
73
+ end
74
+ contents = PDF::Inspector::Text.analyze(@pdf.render)
75
+ contents.word_spacing.should be_empty
76
+ end
77
+ it "should restore word spacing to 0" do
78
+ create_pdf
79
+ @pdf.word_spacing(10.555555) do
80
+ @pdf.text("hello world")
81
+ end
82
+ contents = PDF::Inspector::Text.analyze(@pdf.render)
83
+ contents.word_spacing.last.should == 0
84
+ end
85
+ it "should function as an accessor when no parameter given" do
86
+ create_pdf
87
+ @pdf.word_spacing(10.555555) do
88
+ @pdf.text("hello world")
89
+ @pdf.word_spacing.should == 10.555555
90
+ end
91
+ @pdf.word_spacing.should == 0
92
+ end
93
+ end
@@ -0,0 +1,557 @@
1
+ # encoding: utf-8
2
+
3
+ require File.join(File.expand_path(File.dirname(__FILE__)), "spec_helper")
4
+
5
+ describe "Prawn::Text::NBSP" do
6
+ it "should be defined" do
7
+ Prawn::Text::NBSP.should == " "
8
+ end
9
+ end
10
+
11
+ describe "#height_of" do
12
+ before(:each) { create_pdf }
13
+
14
+ it "should return the height that would be required to print a" +
15
+ "particular string of text" do
16
+ original_y = @pdf.y
17
+ @pdf.text("Foo")
18
+ new_y = @pdf.y
19
+ @pdf.height_of("Foo").should be_within(0.0001).of(original_y - new_y)
20
+ end
21
+
22
+ it "should omit the gap below the last descender if :final_gap => false " +
23
+ "is given" do
24
+ original_y = @pdf.y
25
+ @pdf.text("Foo", :final_gap => false)
26
+ new_y = @pdf.y
27
+ @pdf.height_of("Foo", :final_gap => false).should be_within(0.0001).of(original_y - new_y)
28
+ end
29
+
30
+ it "should raise_error CannotFit if a too-small width is given" do
31
+ lambda do
32
+ @pdf.height_of("text", :width => 1)
33
+ end.should raise_error(Prawn::Errors::CannotFit)
34
+ end
35
+
36
+ it "should raise_error NotImplementedError if :indent_paragraphs option is provided" do
37
+ lambda {
38
+ @pdf.height_of("hai", :width => 300,
39
+ :indent_paragraphs => 60)
40
+ }.should raise_error(NotImplementedError)
41
+ end
42
+
43
+ it "should_not raise_error Prawn::Errors::UnknownOption if :final_gap option is provided" do
44
+ @pdf.height_of("hai", :width => 300, :final_gap => true)
45
+ end
46
+ end
47
+
48
+ describe "#text" do
49
+ before(:each) { create_pdf }
50
+
51
+ it "should not fail when @output is nil when PDF::Core::Text::LineWrap#finalize_line is called" do
52
+ # need a document with margins for these particulars to produce the
53
+ # condition that was throwing the error
54
+ pdf = Prawn::Document.new
55
+ pdf.text "transparency " * 150, :size => 18
56
+ end
57
+
58
+ it "should allow drawing empty strings to the page" do
59
+ @pdf.text " "
60
+ text = PDF::Inspector::Text.analyze(@pdf.render)
61
+ # If anything is rendered to the page, it should be whitespace.
62
+ text.strings.each { |str| str.should =~ /\A\s*\z/ }
63
+ end
64
+
65
+ it "should ignore call when string is nil" do
66
+ @pdf.text(nil).should be_false
67
+ end
68
+
69
+ it "should correctly render empty paragraphs" do
70
+ @pdf.text "text\n\ntext"
71
+ text = PDF::Inspector::Text.analyze(@pdf.render)
72
+ @pdf.page_count.should == 1
73
+ text.strings.reject{ |s| s.empty? }.should == ["text", "text"]
74
+ end
75
+
76
+ it "should correctly render empty paragraphs with :indent_paragraphs" do
77
+ @pdf.text "text\n\ntext", :indent_paragraphs => 5
78
+ text = PDF::Inspector::Text.analyze(@pdf.render)
79
+ @pdf.page_count.should == 1
80
+ text.strings.reject{ |s| s.empty? }.should == ["text", "text"]
81
+ end
82
+
83
+ it "should correctly render strings ending with empty paragraphs and " +
84
+ ":inline_format and :indent_paragraphs" do
85
+ @pdf.text "text\n\n", :inline_format => true, :indent_paragraphs => 5
86
+ text = PDF::Inspector::Text.analyze(@pdf.render)
87
+ @pdf.page_count.should == 1
88
+ text.strings.should == ["text"]
89
+ end
90
+
91
+ it "should default to use kerning information" do
92
+ @pdf.text "hello world"
93
+ text = PDF::Inspector::Text.analyze(@pdf.render)
94
+ text.kerned[0].should be_true
95
+ end
96
+
97
+ it "should be able to disable kerning with an option" do
98
+ @pdf.text "hello world", :kerning => false
99
+ text = PDF::Inspector::Text.analyze(@pdf.render)
100
+ text.kerned[0].should be_false
101
+ end
102
+
103
+ it "should be able to disable kerning document-wide" do
104
+ @pdf.default_kerning(false)
105
+ @pdf.default_kerning = false
106
+ @pdf.text "hello world"
107
+ text = PDF::Inspector::Text.analyze(@pdf.render)
108
+ text.kerned[0].should be_false
109
+ end
110
+
111
+ it "option should be able to override document-wide kerning disabling" do
112
+ @pdf.default_kerning = false
113
+ @pdf.text "hello world", :kerning => true
114
+ text = PDF::Inspector::Text.analyze(@pdf.render)
115
+ text.kerned[0].should be_true
116
+ end
117
+
118
+ it "should raise_error ArgumentError if :at option included" do
119
+ lambda { @pdf.text("hai", :at => [0, 0]) }.should raise_error(ArgumentError)
120
+ end
121
+
122
+ it "should advance down the document based on font_height" do
123
+ position = @pdf.y
124
+ @pdf.text "Foo"
125
+
126
+ @pdf.y.should be_within(0.0001).of(position - @pdf.font.height)
127
+
128
+ position = @pdf.y
129
+ @pdf.text "Foo\nBar\nBaz"
130
+ @pdf.y.should be_within(0.0001).of(position - 3*@pdf.font.height)
131
+ end
132
+
133
+ it "should advance down the document based on font_height" +
134
+ " with size option" do
135
+ position = @pdf.y
136
+ @pdf.text "Foo", :size => 15
137
+
138
+ @pdf.font_size = 15
139
+ @pdf.y.should be_within(0.0001).of(position - @pdf.font.height)
140
+
141
+ position = @pdf.y
142
+ @pdf.text "Foo\nBar\nBaz"
143
+ @pdf.y.should be_within(0.0001).of(position - 3 * @pdf.font.height)
144
+ end
145
+
146
+ it "should advance down the document based on font_height" +
147
+ " with leading option" do
148
+ position = @pdf.y
149
+ leading = 2
150
+ @pdf.text "Foo", :leading => leading
151
+
152
+ @pdf.y.should be_within(0.0001).of(position - @pdf.font.height - leading)
153
+
154
+ position = @pdf.y
155
+ @pdf.text "Foo\nBar\nBaz"
156
+ @pdf.y.should be_within(0.0001).of(position - 3*@pdf.font.height)
157
+ end
158
+
159
+ it "should advance only to the bottom of the final descender "+
160
+ "if final_gap is false" do
161
+ position = @pdf.y
162
+ @pdf.text "Foo", :final_gap => false
163
+
164
+ @pdf.y.should be_within(0.0001).of(position - @pdf.font.ascender - @pdf.font.descender)
165
+
166
+ position = @pdf.y
167
+ @pdf.text "Foo\nBar\nBaz", :final_gap => false
168
+ @pdf.y.should be_within(0.0001).of(position - 2*@pdf.font.height - @pdf.font.ascender - @pdf.font.descender)
169
+ end
170
+
171
+ it "should be able to print text starting at the last line of a page" do
172
+ @pdf.move_cursor_to(@pdf.font.height)
173
+ @pdf.text("hello world")
174
+ pages = PDF::Inspector::Page.analyze(@pdf.render).pages
175
+ pages.size.should == 1
176
+ end
177
+
178
+ it "should default to 12 point helvetica" do
179
+ @pdf.text "Blah"
180
+ text = PDF::Inspector::Text.analyze(@pdf.render)
181
+ text.font_settings[0][:name].should == :Helvetica
182
+ text.font_settings[0][:size].should == 12
183
+ text.strings.first.should == "Blah"
184
+ end
185
+
186
+ it "should allow setting font size" do
187
+ @pdf.text "Blah", :size => 16
188
+ text = PDF::Inspector::Text.analyze(@pdf.render)
189
+ text.font_settings[0][:size].should == 16
190
+ end
191
+
192
+ it "should allow setting a default font size" do
193
+ @pdf.font_size = 16
194
+ @pdf.text "Blah"
195
+ text = PDF::Inspector::Text.analyze(@pdf.render)
196
+ text.font_settings[0][:size].should == 16
197
+ end
198
+
199
+ it "should allow overriding default font for a single instance" do
200
+ @pdf.font_size = 16
201
+
202
+ @pdf.text "Blah", :size => 11
203
+ @pdf.text "Blaz"
204
+ text = PDF::Inspector::Text.analyze(@pdf.render)
205
+ text.font_settings[0][:size].should == 11
206
+ text.font_settings[1][:size].should == 16
207
+ end
208
+
209
+ it "should allow setting a font size transaction with a block" do
210
+ @pdf.font_size 16 do
211
+ @pdf.text 'Blah'
212
+ end
213
+
214
+ @pdf.text 'blah'
215
+
216
+ text = PDF::Inspector::Text.analyze(@pdf.render)
217
+ text.font_settings[0][:size].should == 16
218
+ text.font_settings[1][:size].should == 12
219
+ end
220
+
221
+ it "should allow manual setting the font size " +
222
+ "when in a font size block" do
223
+ @pdf.font_size(16) do
224
+ @pdf.text 'Foo'
225
+ @pdf.text 'Blah', :size => 11
226
+ @pdf.text 'Blaz'
227
+ end
228
+ text = PDF::Inspector::Text.analyze(@pdf.render)
229
+ text.font_settings[0][:size].should == 16
230
+ text.font_settings[1][:size].should == 11
231
+ text.font_settings[2][:size].should == 16
232
+ end
233
+
234
+ it "should allow registering of built-in font_settings on the fly" do
235
+ @pdf.font "Times-Roman"
236
+ @pdf.text "Blah"
237
+ @pdf.font "Courier"
238
+ @pdf.text "Blaz"
239
+ text = PDF::Inspector::Text.analyze(@pdf.render)
240
+ text.font_settings[0][:name].should == :"Times-Roman"
241
+ text.font_settings[1][:name].should == :Courier
242
+ end
243
+
244
+ it "should utilise the same default font across multiple pages" do
245
+ @pdf.text "Blah"
246
+ @pdf.start_new_page
247
+ @pdf.text "Blaz"
248
+ text = PDF::Inspector::Text.analyze(@pdf.render)
249
+
250
+ text.font_settings.size.should == 2
251
+ text.font_settings[0][:name].should == :Helvetica
252
+ text.font_settings[1][:name].should == :Helvetica
253
+ end
254
+
255
+ it "should raise_error an exception when an unknown font is used" do
256
+ lambda { @pdf.font "Pao bu" }.should raise_error(Prawn::Errors::UnknownFont)
257
+ end
258
+
259
+ it "should_not raise_error an exception when providing Pathname instance as font" do
260
+ @pdf.font Pathname.new("#{Prawn::DATADIR}/fonts/DejaVuSans.ttf")
261
+ end
262
+
263
+ it "should correctly render a utf-8 string when using a built-in font" do
264
+ str = "©" # copyright symbol
265
+ @pdf.text str
266
+
267
+ # grab the text from the rendered PDF and ensure it matches
268
+ text = PDF::Inspector::Text.analyze(@pdf.render)
269
+ text.strings.first.should == str
270
+ end
271
+
272
+ it "should correctly render a utf-8 string when using a TTF font" do
273
+ str = "©" # copyright symbol
274
+ @pdf.font "#{Prawn::DATADIR}/fonts/DejaVuSans.ttf"
275
+ @pdf.text str
276
+
277
+ # grab the text from the rendered PDF and ensure it matches
278
+ text = PDF::Inspector::Text.analyze(@pdf.render)
279
+ text.strings.first.should == str
280
+ end
281
+
282
+ it "subsets mixed low-ASCII and non-ASCII characters when they can be " +
283
+ "subsetted together" do
284
+ str = "It’s super effective!"
285
+ @pdf.font "#{Prawn::DATADIR}/fonts/DejaVuSans.ttf"
286
+ @pdf.text str
287
+
288
+ text = PDF::Inspector::Text.analyze(@pdf.render)
289
+ text.strings.first.should == str
290
+ end
291
+
292
+ it "should correctly render a string with higher bit characters across" +
293
+ " a page break when using a built-in font" do
294
+ str = "©"
295
+ @pdf.move_cursor_to(@pdf.font.height)
296
+ @pdf.text(str + "\n" + str)
297
+
298
+ pages = PDF::Inspector::Page.analyze(@pdf.render).pages
299
+ pages.size.should == 2
300
+ pages[0][:strings].should == [str]
301
+ pages[1][:strings].should == [str]
302
+ end
303
+
304
+ it "should correctly render a string with higher bit characters across" +
305
+ " a page break when using a built-in font and :indent_paragraphs option" do
306
+ str = "©"
307
+ @pdf.move_cursor_to(@pdf.font.height)
308
+ @pdf.text(str + "\n" + str, :indent_paragraphs => 20)
309
+
310
+ pages = PDF::Inspector::Page.analyze(@pdf.render).pages
311
+ pages.size.should == 2
312
+ pages[0][:strings].should == [str]
313
+ pages[1][:strings].should == [str]
314
+ end
315
+
316
+ it "should raise_error an exception when a utf-8 incompatible string is rendered" do
317
+ str = "Blah \xDD"
318
+ lambda { @pdf.text str }.should raise_error(
319
+ Prawn::Errors::IncompatibleStringEncoding)
320
+ end
321
+
322
+ it "should_not raise_error an exception when a shift-jis string is rendered" do
323
+ datafile = "#{Prawn::DATADIR}/shift_jis_text.txt"
324
+ sjis_str = File.open(datafile, "r:shift_jis") { |f| f.gets }
325
+ @pdf.font("#{Prawn::DATADIR}/fonts/gkai00mp.ttf")
326
+
327
+ # Expect that the call to text will not raise an encoding error
328
+ @pdf.text(sjis_str)
329
+ end
330
+
331
+ it "should call move_past_bottom when printing more text than can fit" +
332
+ " between the current document.y and bounds.bottom" do
333
+ @pdf.y = @pdf.font.height
334
+ @pdf.text "Hello"
335
+ @pdf.text "World"
336
+ pages = PDF::Inspector::Page.analyze(@pdf.render).pages
337
+ pages.size.should == 2
338
+ pages[0][:strings].should == ["Hello"]
339
+ pages[1][:strings].should == ["World"]
340
+ end
341
+
342
+ describe "with :indent_paragraphs option" do
343
+ it "should indent the paragraphs" do
344
+ hello = "hello " * 50
345
+ hello2 = "hello " * 50
346
+ @pdf.text(hello + "\n" + hello2, :indent_paragraphs => 60)
347
+ text = PDF::Inspector::Text.analyze(@pdf.render)
348
+ text.strings[0].should == ("hello " * 19).strip
349
+ text.strings[1].should == ("hello " * 21).strip
350
+ text.strings[3].should == ("hello " * 19).strip
351
+ text.strings[4].should == ("hello " * 21).strip
352
+ end
353
+
354
+
355
+ it "should indent from right side when using :rtl direction" do
356
+ para1 = "The rain in spain falls mainly on the plains " * 3
357
+ para2 = "The rain in spain falls mainly on the plains " * 3
358
+
359
+ @pdf.text(para1 + "\n" + para2, :indent_paragraphs => 60, :direction => :rtl)
360
+
361
+ text = PDF::Inspector::Text.analyze(@pdf.render)
362
+
363
+ lines = text.strings
364
+ x_positions = text.positions.map { |e| e[0] }
365
+
366
+ # NOTE: The code below reflects Prawn's current kerning behavior for RTL
367
+ # text, which isn't necessarily correct. If we change that behavior,
368
+ # this test will need to be updated.
369
+
370
+ x_positions[0].should(
371
+ be_within(0.001).of(@pdf.bounds.absolute_right - 60 -
372
+ @pdf.width_of(lines[0].reverse, :kerning => true)))
373
+
374
+ x_positions[1].should(
375
+ be_within(0.001).of(@pdf.bounds.absolute_right -
376
+ @pdf.width_of(lines[1].reverse, :kerning => true)))
377
+
378
+ x_positions[2].should(
379
+ be_within(0.001).of(@pdf.bounds.absolute_right - 60 -
380
+ @pdf.width_of(lines[2].reverse, :kerning => true)))
381
+
382
+ x_positions[3].should(
383
+ be_within(0.001).of(@pdf.bounds.absolute_right -
384
+ @pdf.width_of(lines[3].reverse, :kerning => true)))
385
+ end
386
+
387
+ it "should indent from right side when document has :rtl direction" do
388
+ para1 = "The rain in spain falls mainly on the plains " * 3
389
+ para2 = "The rain in spain falls mainly on the plains " * 3
390
+
391
+ @pdf.text_direction = :rtl
392
+ @pdf.text(para1 + "\n" + para2, :indent_paragraphs => 60)
393
+
394
+ text = PDF::Inspector::Text.analyze(@pdf.render)
395
+
396
+ lines = text.strings
397
+ x_positions = text.positions.map { |e| e[0] }
398
+
399
+ # NOTE: The code below reflects Prawn's current kerning behavior for RTL
400
+ # text, which isn't necessarily correct. If we change that behavior,
401
+ # this test will need to be updated.
402
+
403
+ x_positions[0].should(
404
+ be_within(0.001).of(@pdf.bounds.absolute_right - 60 -
405
+ @pdf.width_of(lines[0].reverse, :kerning => true)))
406
+
407
+ x_positions[1].should(
408
+ be_within(0.001).of(@pdf.bounds.absolute_right -
409
+ @pdf.width_of(lines[1].reverse, :kerning => true)))
410
+
411
+ x_positions[2].should(
412
+ be_within(0.001).of(@pdf.bounds.absolute_right - 60 -
413
+ @pdf.width_of(lines[2].reverse, :kerning => true)))
414
+
415
+ x_positions[3].should(
416
+ be_within(0.001).of(@pdf.bounds.absolute_right -
417
+ @pdf.width_of(lines[3].reverse, :kerning => true)))
418
+ end
419
+
420
+ it "should indent from left side when using :ltr direction" do
421
+ para1 = "The rain in spain falls mainly on the plains " * 3
422
+ para2 = "The rain in spain falls mainly on the plains " * 3
423
+
424
+ @pdf.text(para1 + "\n" + para2, :indent_paragraphs => 60, :direction => :ltr)
425
+
426
+ text = PDF::Inspector::Text.analyze(@pdf.render)
427
+
428
+ x_positions = text.positions.map { |e| e[0] }
429
+
430
+ x_positions[0].should == 60
431
+ x_positions[1].should == 0
432
+
433
+ x_positions[2].should == 60
434
+ x_positions[3].should == 0
435
+ end
436
+
437
+ it "should indent from left side when document has :ltr direction" do
438
+ para1 = "The rain in spain falls mainly on the plains " * 3
439
+ para2 = "The rain in spain falls mainly on the plains " * 3
440
+
441
+ @pdf.text_direction = :ltr
442
+ @pdf.text(para1 + "\n" + para2, :indent_paragraphs => 60)
443
+
444
+ text = PDF::Inspector::Text.analyze(@pdf.render)
445
+
446
+ x_positions = text.positions.map { |e| e[0] }
447
+
448
+ x_positions[0].should == 60
449
+ x_positions[1].should == 0
450
+
451
+ x_positions[2].should == 60
452
+ x_positions[3].should == 0
453
+ end
454
+
455
+ describe "when wrap to new page, and first line of new page" +
456
+ " is not the start of a new paragraph, that line should" +
457
+ " not be indented" do
458
+ it "should indent the paragraphs" do
459
+ hello = "hello " * 50
460
+ hello2 = "hello " * 50
461
+ @pdf.move_cursor_to(@pdf.font.height)
462
+ @pdf.text(hello + "\n" + hello2, :indent_paragraphs => 60)
463
+ text = PDF::Inspector::Text.analyze(@pdf.render)
464
+ text.strings[0].should == ("hello " * 19).strip
465
+ text.strings[1].should == ("hello " * 21).strip
466
+ text.strings[3].should == ("hello " * 19).strip
467
+ text.strings[4].should == ("hello " * 21).strip
468
+ end
469
+ end
470
+ describe "when wrap to new page, and first line of new page" +
471
+ " is the start of a new paragraph, that line should" +
472
+ " be indented" do
473
+ it "should indent the paragraphs" do
474
+ hello = "hello " * 50
475
+ hello2 = "hello " * 50
476
+ @pdf.move_cursor_to(@pdf.font.height * 3)
477
+ @pdf.text(hello + "\n" + hello2, :indent_paragraphs => 60)
478
+ text = PDF::Inspector::Text.analyze(@pdf.render)
479
+ text.strings[0].should == ("hello " * 19).strip
480
+ text.strings[1].should == ("hello " * 21).strip
481
+ text.strings[3].should == ("hello " * 19).strip
482
+ text.strings[4].should == ("hello " * 21).strip
483
+ end
484
+ end
485
+ end
486
+
487
+ describe "kerning" do
488
+ it "should respect text kerning setting (document default)" do
489
+ create_pdf
490
+ @pdf.font.expects(:compute_width_of).with do |str, options|
491
+ str == "VAT" && options[:kerning] == true
492
+ end.at_least_once.returns(10)
493
+ @pdf.text "VAT"
494
+ end
495
+
496
+ it "should respect text kerning setting (kerning=true)" do
497
+ create_pdf
498
+ @pdf.font.expects(:compute_width_of).with do |str, options|
499
+ str == "VAT" && options[:kerning] == true
500
+ end.at_least_once.returns(10)
501
+ @pdf.text "VAT", :kerning => true
502
+ end
503
+
504
+ it "should respect text kerning setting (kerning=false)" do
505
+ create_pdf
506
+ @pdf.font.expects(:compute_width_of).with do |str, options|
507
+ str == "VAT" && options[:kerning] == false
508
+ end.at_least_once.returns(10)
509
+ @pdf.text "VAT", :kerning => false
510
+ end
511
+ end
512
+
513
+ describe "#shrink_to_fit with special utf-8 text" do
514
+ it "Should not throw an exception",
515
+ :unresolved, :issue => 603 do
516
+ pages = 0
517
+ doc = Prawn::Document.new(page_size: 'A4', margin: [2, 2, 2, 2]) do |pdf|
518
+ add_unicode_fonts(pdf)
519
+ pdf.bounding_box([1, 1], :width => 90, :height => 50) do
520
+ broken_text = " Sample Text\nSAMPLE SAMPLE SAMPLEoddělení ZMĚN\nSAMPLE"
521
+ pdf.text broken_text, :overflow => :shrink_to_fit
522
+ end
523
+ end
524
+ end
525
+ end
526
+
527
+
528
+ def add_unicode_fonts(pdf)
529
+ dejavu = "#{::Prawn::BASEDIR}/data/fonts/DejaVuSans.ttf"
530
+ pdf.font_families.update("dejavu" => {
531
+ :normal => dejavu,
532
+ :italic => dejavu,
533
+ :bold => dejavu,
534
+ :bold_italic => dejavu
535
+ })
536
+ pdf.fallback_fonts = ["dejavu"]
537
+ end
538
+
539
+ describe "fallback_fonts" do
540
+ it "should preserve font style" do
541
+ create_pdf
542
+
543
+ @pdf.fallback_fonts ["Helvetica"]
544
+ @pdf.font "Times-Roman", :style => :italic do
545
+ @pdf.text "hello"
546
+ end
547
+
548
+ text = PDF::Inspector::Text.analyze(@pdf.render)
549
+ fonts_used = text.font_settings.map { |e| e[:name] }
550
+
551
+ fonts_used.length.should == 1
552
+ fonts_used[0].should == :"Times-Italic"
553
+ text.strings[0].should == "hello"
554
+ end
555
+ end
556
+
557
+ end