prawn 0.12.0 → 0.13.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (282) hide show
  1. checksums.yaml +7 -0
  2. data/COPYING +2 -2
  3. data/Gemfile +18 -0
  4. data/LICENSE +1 -1
  5. data/README.md +17 -4
  6. data/Rakefile +18 -22
  7. data/data/images/indexed_color.dat +0 -0
  8. data/data/images/indexed_color.png +0 -0
  9. data/data/pdfs/nested_pages.pdf +13 -13
  10. data/lib/pdf/core.rb +35 -0
  11. data/lib/{prawn → pdf}/core/annotations.rb +6 -7
  12. data/lib/{prawn → pdf}/core/byte_string.rb +1 -1
  13. data/lib/{prawn → pdf}/core/destinations.rb +23 -23
  14. data/lib/{prawn → pdf}/core/document_state.rb +8 -8
  15. data/lib/pdf/core/filter_list.rb +51 -0
  16. data/lib/pdf/core/filters.rb +36 -0
  17. data/lib/pdf/core/graphics_state.rb +68 -0
  18. data/lib/{prawn → pdf}/core/literal_string.rb +1 -1
  19. data/lib/{prawn → pdf}/core/name_tree.rb +14 -2
  20. data/lib/{prawn → pdf}/core/object_store.rb +80 -24
  21. data/lib/pdf/core/outline.rb +315 -0
  22. data/lib/{prawn → pdf}/core/page.rb +23 -26
  23. data/lib/{prawn/document → pdf/core}/page_geometry.rb +11 -21
  24. data/lib/{prawn → pdf}/core/pdf_object.rb +48 -32
  25. data/lib/{prawn → pdf}/core/reference.rb +35 -44
  26. data/lib/pdf/core/stream.rb +98 -0
  27. data/lib/{prawn → pdf}/core/text.rb +24 -17
  28. data/lib/prawn.rb +95 -17
  29. data/lib/prawn/compatibility.rb +66 -26
  30. data/lib/prawn/document.rb +48 -30
  31. data/lib/prawn/document/bounding_box.rb +3 -3
  32. data/lib/prawn/document/column_box.rb +46 -8
  33. data/lib/prawn/document/graphics_state.rb +10 -73
  34. data/lib/prawn/document/internals.rb +24 -23
  35. data/lib/prawn/document/snapshot.rb +6 -7
  36. data/lib/prawn/document/span.rb +10 -10
  37. data/lib/prawn/encoding.rb +7 -7
  38. data/lib/prawn/errors.rb +18 -29
  39. data/lib/prawn/font.rb +64 -28
  40. data/lib/prawn/font/afm.rb +32 -74
  41. data/lib/prawn/font/dfont.rb +2 -2
  42. data/lib/prawn/font/ttf.rb +28 -57
  43. data/lib/prawn/font_metric_cache.rb +45 -0
  44. data/lib/prawn/graphics.rb +307 -41
  45. data/lib/prawn/graphics/cap_style.rb +3 -3
  46. data/lib/prawn/graphics/color.rb +12 -5
  47. data/lib/prawn/graphics/dash.rb +52 -31
  48. data/lib/prawn/graphics/join_style.rb +7 -7
  49. data/lib/prawn/graphics/patterns.rb +137 -0
  50. data/lib/prawn/graphics/transformation.rb +9 -9
  51. data/lib/prawn/graphics/transparency.rb +1 -1
  52. data/lib/prawn/image_handler.rb +30 -0
  53. data/lib/prawn/images.rb +86 -105
  54. data/lib/prawn/images/image.rb +48 -0
  55. data/lib/prawn/images/jpg.rb +14 -10
  56. data/lib/prawn/images/png.rb +50 -37
  57. data/lib/prawn/layout.rb +2 -2
  58. data/lib/prawn/layout/grid.rb +51 -51
  59. data/lib/prawn/measurement_extensions.rb +5 -5
  60. data/lib/prawn/measurements.rb +25 -21
  61. data/lib/prawn/outline.rb +4 -308
  62. data/lib/prawn/repeater.rb +8 -8
  63. data/lib/prawn/security.rb +50 -36
  64. data/lib/prawn/soft_mask.rb +94 -0
  65. data/lib/prawn/stamp.rb +3 -3
  66. data/lib/prawn/table.rb +292 -118
  67. data/lib/prawn/table/cell.rb +272 -45
  68. data/lib/prawn/table/cell/image.rb +70 -0
  69. data/lib/prawn/table/cell/in_table.rb +2 -2
  70. data/lib/prawn/table/cell/span_dummy.rb +92 -0
  71. data/lib/prawn/table/cell/subtable.rb +2 -2
  72. data/lib/prawn/table/cell/text.rb +42 -24
  73. data/lib/prawn/table/cells.rb +137 -48
  74. data/lib/prawn/text.rb +35 -23
  75. data/lib/prawn/text/box.rb +18 -5
  76. data/lib/prawn/text/formatted.rb +5 -4
  77. data/lib/prawn/text/formatted/arranger.rb +292 -0
  78. data/lib/prawn/text/formatted/box.rb +52 -13
  79. data/lib/prawn/text/formatted/fragment.rb +37 -22
  80. data/lib/prawn/text/formatted/line_wrap.rb +286 -0
  81. data/lib/prawn/text/formatted/parser.rb +14 -6
  82. data/lib/prawn/text/formatted/wrap.rb +151 -0
  83. data/lib/prawn/utilities.rb +44 -0
  84. data/manual/basic_concepts/adding_pages.rb +27 -0
  85. data/manual/basic_concepts/basic_concepts.rb +34 -0
  86. data/manual/basic_concepts/creation.rb +39 -0
  87. data/manual/basic_concepts/cursor.rb +33 -0
  88. data/manual/basic_concepts/measurement.rb +25 -0
  89. data/manual/basic_concepts/origin.rb +38 -0
  90. data/manual/basic_concepts/other_cursor_helpers.rb +40 -0
  91. data/manual/bounding_box/bounding_box.rb +39 -0
  92. data/manual/bounding_box/bounds.rb +49 -0
  93. data/manual/bounding_box/canvas.rb +24 -0
  94. data/manual/bounding_box/creation.rb +23 -0
  95. data/manual/bounding_box/indentation.rb +46 -0
  96. data/manual/bounding_box/nesting.rb +45 -0
  97. data/manual/bounding_box/russian_boxes.rb +40 -0
  98. data/manual/bounding_box/stretchy.rb +31 -0
  99. data/manual/document_and_page_options/background.rb +27 -0
  100. data/manual/document_and_page_options/document_and_page_options.rb +31 -0
  101. data/manual/document_and_page_options/metadata.rb +23 -0
  102. data/manual/document_and_page_options/page_margins.rb +38 -0
  103. data/manual/document_and_page_options/page_size.rb +34 -0
  104. data/manual/example_file.rb +116 -0
  105. data/manual/example_helper.rb +411 -0
  106. data/manual/example_package.rb +53 -0
  107. data/manual/example_section.rb +46 -0
  108. data/manual/graphics/circle_and_ellipse.rb +22 -0
  109. data/manual/graphics/color.rb +24 -0
  110. data/manual/graphics/common_lines.rb +28 -0
  111. data/manual/graphics/fill_and_stroke.rb +42 -0
  112. data/manual/graphics/fill_rules.rb +37 -0
  113. data/manual/graphics/gradients.rb +37 -0
  114. data/manual/graphics/graphics.rb +58 -0
  115. data/manual/graphics/helper.rb +24 -0
  116. data/manual/graphics/line_width.rb +35 -0
  117. data/manual/graphics/lines_and_curves.rb +41 -0
  118. data/manual/graphics/polygon.rb +29 -0
  119. data/manual/graphics/rectangle.rb +21 -0
  120. data/manual/graphics/rotate.rb +28 -0
  121. data/manual/graphics/scale.rb +41 -0
  122. data/manual/graphics/soft_masks.rb +46 -0
  123. data/manual/graphics/stroke_cap.rb +31 -0
  124. data/manual/graphics/stroke_dash.rb +48 -0
  125. data/manual/graphics/stroke_join.rb +30 -0
  126. data/manual/graphics/translate.rb +29 -0
  127. data/manual/graphics/transparency.rb +35 -0
  128. data/manual/images/absolute_position.rb +23 -0
  129. data/manual/images/fit.rb +21 -0
  130. data/manual/images/horizontal.rb +25 -0
  131. data/manual/images/images.rb +40 -0
  132. data/manual/images/plain_image.rb +18 -0
  133. data/manual/images/scale.rb +22 -0
  134. data/manual/images/vertical.rb +28 -0
  135. data/manual/images/width_and_height.rb +25 -0
  136. data/manual/layout/boxes.rb +27 -0
  137. data/manual/layout/content.rb +25 -0
  138. data/manual/layout/layout.rb +28 -0
  139. data/manual/layout/simple_grid.rb +23 -0
  140. data/manual/manual/cover.rb +35 -0
  141. data/manual/manual/foreword.rb +85 -0
  142. data/manual/manual/how_to_read_this_manual.rb +41 -0
  143. data/manual/manual/manual.rb +35 -0
  144. data/manual/outline/add_subsection_to.rb +61 -0
  145. data/manual/outline/insert_section_after.rb +47 -0
  146. data/manual/outline/outline.rb +32 -0
  147. data/manual/outline/sections_and_pages.rb +67 -0
  148. data/manual/repeatable_content/page_numbering.rb +54 -0
  149. data/manual/repeatable_content/repeatable_content.rb +31 -0
  150. data/manual/repeatable_content/repeater.rb +55 -0
  151. data/manual/repeatable_content/stamp.rb +41 -0
  152. data/manual/security/encryption.rb +31 -0
  153. data/manual/security/permissions.rb +38 -0
  154. data/manual/security/security.rb +28 -0
  155. data/manual/syntax_highlight.rb +52 -0
  156. data/manual/table/basic_block.rb +53 -0
  157. data/manual/table/before_rendering_page.rb +26 -0
  158. data/manual/table/cell_border_lines.rb +24 -0
  159. data/manual/table/cell_borders_and_bg.rb +31 -0
  160. data/manual/table/cell_dimensions.rb +30 -0
  161. data/manual/table/cell_text.rb +38 -0
  162. data/manual/table/column_widths.rb +30 -0
  163. data/manual/table/content_and_subtables.rb +39 -0
  164. data/manual/table/creation.rb +27 -0
  165. data/manual/table/filtering.rb +36 -0
  166. data/manual/table/flow_and_header.rb +17 -0
  167. data/manual/table/image_cells.rb +33 -0
  168. data/manual/table/position.rb +29 -0
  169. data/manual/table/row_colors.rb +20 -0
  170. data/manual/table/span.rb +30 -0
  171. data/manual/table/style.rb +22 -0
  172. data/manual/table/table.rb +52 -0
  173. data/manual/table/width.rb +27 -0
  174. data/manual/templates/full_template.rb +25 -0
  175. data/manual/templates/page_template.rb +48 -0
  176. data/manual/templates/templates.rb +27 -0
  177. data/manual/text/alignment.rb +44 -0
  178. data/manual/text/color.rb +24 -0
  179. data/manual/text/column_box.rb +32 -0
  180. data/manual/text/fallback_fonts.rb +37 -0
  181. data/manual/text/font.rb +41 -0
  182. data/manual/text/font_size.rb +45 -0
  183. data/manual/text/font_style.rb +23 -0
  184. data/manual/text/formatted_callbacks.rb +60 -0
  185. data/manual/text/formatted_text.rb +54 -0
  186. data/manual/text/free_flowing_text.rb +51 -0
  187. data/manual/text/group.rb +29 -0
  188. data/manual/text/inline.rb +43 -0
  189. data/manual/text/kerning_and_character_spacing.rb +39 -0
  190. data/manual/text/leading.rb +25 -0
  191. data/manual/text/line_wrapping.rb +41 -0
  192. data/manual/text/paragraph_indentation.rb +26 -0
  193. data/manual/text/positioned_text.rb +38 -0
  194. data/manual/text/registering_families.rb +48 -0
  195. data/manual/text/rendering_and_color.rb +37 -0
  196. data/manual/text/right_to_left_text.rb +43 -0
  197. data/manual/text/rotation.rb +43 -0
  198. data/manual/text/single_usage.rb +37 -0
  199. data/manual/text/text.rb +75 -0
  200. data/manual/text/text_box_excess.rb +32 -0
  201. data/manual/text/text_box_extensions.rb +45 -0
  202. data/manual/text/text_box_overflow.rb +44 -0
  203. data/manual/text/utf8.rb +28 -0
  204. data/{examples/m17n → manual/text}/win_ansi_charset.rb +14 -10
  205. data/prawn.gemspec +18 -12
  206. data/spec/acceptance/png.rb +23 -0
  207. data/spec/annotations_spec.rb +16 -32
  208. data/spec/bounding_box_spec.rb +128 -15
  209. data/spec/cell_spec.rb +169 -38
  210. data/spec/column_box_spec.rb +33 -0
  211. data/spec/destinations_spec.rb +5 -5
  212. data/spec/document_spec.rb +150 -104
  213. data/spec/extensions/encoding_helpers.rb +10 -0
  214. data/spec/extensions/mocha.rb +1 -0
  215. data/spec/filters_spec.rb +34 -0
  216. data/spec/font_metric_cache_spec.rb +52 -0
  217. data/spec/font_spec.rb +183 -97
  218. data/spec/formatted_text_arranger_spec.rb +43 -43
  219. data/spec/formatted_text_box_spec.rb +30 -20
  220. data/spec/formatted_text_fragment_spec.rb +8 -8
  221. data/spec/graphics_spec.rb +158 -69
  222. data/spec/grid_spec.rb +15 -15
  223. data/spec/image_handler_spec.rb +42 -0
  224. data/spec/images_spec.rb +49 -24
  225. data/spec/inline_formatted_text_parser_spec.rb +73 -19
  226. data/spec/jpg_spec.rb +4 -4
  227. data/spec/line_wrap_spec.rb +26 -26
  228. data/spec/measurement_units_spec.rb +6 -6
  229. data/spec/name_tree_spec.rb +21 -21
  230. data/spec/object_store_spec.rb +39 -39
  231. data/spec/outline_spec.rb +93 -53
  232. data/spec/pdf_object_spec.rb +88 -86
  233. data/spec/png_spec.rb +31 -28
  234. data/spec/reference_spec.rb +32 -32
  235. data/spec/repeater_spec.rb +25 -11
  236. data/spec/security_spec.rb +44 -12
  237. data/spec/snapshot_spec.rb +8 -9
  238. data/spec/soft_mask_spec.rb +117 -0
  239. data/spec/span_spec.rb +10 -15
  240. data/spec/spec_helper.rb +25 -8
  241. data/spec/stamp_spec.rb +29 -30
  242. data/spec/stream_spec.rb +58 -0
  243. data/spec/stroke_styles_spec.rb +36 -18
  244. data/spec/table/span_dummy_spec.rb +17 -0
  245. data/spec/table_spec.rb +697 -105
  246. data/spec/template_spec.rb +108 -54
  247. data/spec/text_at_spec.rb +18 -17
  248. data/spec/text_box_spec.rb +111 -62
  249. data/spec/text_rendering_mode_spec.rb +5 -5
  250. data/spec/text_spacing_spec.rb +4 -4
  251. data/spec/text_spec.rb +57 -49
  252. data/spec/transparency_spec.rb +5 -5
  253. metadata +421 -213
  254. data/data/fonts/Action Man.dfont +0 -0
  255. data/data/fonts/Activa.ttf +0 -0
  256. data/data/fonts/Chalkboard.ttf +0 -0
  257. data/data/fonts/DejaVuSans.ttf +0 -0
  258. data/data/fonts/Dustismo_Roman.ttf +0 -0
  259. data/data/fonts/comicsans.ttf +0 -0
  260. data/data/fonts/gkai00mp.ttf +0 -0
  261. data/data/images/rails.dat +0 -0
  262. data/data/images/rails.png +0 -0
  263. data/examples/bounding_box/russian_boxes.rb +0 -37
  264. data/examples/example_helper.rb +0 -11
  265. data/examples/general/context_sensitive_headers.rb +0 -38
  266. data/examples/graphics/cmyk.rb +0 -13
  267. data/examples/graphics/gradient.rb +0 -23
  268. data/examples/graphics/png_types.rb +0 -23
  269. data/examples/graphics/remote_images.rb +0 -13
  270. data/examples/m17n/full_win_ansi_character_list.rb +0 -20
  271. data/examples/m17n/sjis.rb +0 -29
  272. data/examples/table/bill.rb +0 -54
  273. data/examples/table/header.rb +0 -15
  274. data/examples/text/font_calculations.rb +0 -92
  275. data/examples/text/hyphenation.rb +0 -45
  276. data/examples/text/indent_paragraphs.rb +0 -24
  277. data/lib/prawn/core.rb +0 -85
  278. data/lib/prawn/core/text/formatted/arranger.rb +0 -294
  279. data/lib/prawn/core/text/formatted/line_wrap.rb +0 -273
  280. data/lib/prawn/core/text/formatted/wrap.rb +0 -153
  281. data/lib/prawn/graphics/gradient.rb +0 -84
  282. data/lib/prawn/security/arcfour.rb +0 -51
@@ -1,24 +0,0 @@
1
- # encoding: utf-8
2
- #
3
- # Example of two ways of indenting paragraphs
4
- #
5
- #
6
- require File.expand_path(File.join(File.dirname(__FILE__),
7
- %w[.. example_helper]))
8
-
9
- Prawn::Document.generate "indent_paragraphs.pdf" do |pdf|
10
- hello = "hello " * 50
11
- world = "world " * 50
12
- string = hello + "©\n" + world + "©"
13
- pdf.text(string, :indent_paragraphs => 60, :align => :justify)
14
-
15
- pdf.move_cursor_to(pdf.font.height)
16
- pdf.text(string, :indent_paragraphs => 60, :align => :justify)
17
-
18
- pdf.move_cursor_to(pdf.font.height * 3)
19
- pdf.text(string, :indent_paragraphs => 60, :align => :justify)
20
-
21
- # can also indent using a non-breaking space
22
- nbsp = Prawn::Text::NBSP
23
- pdf.text("\n\n\n\n#{nbsp * 10}" + hello + "\n#{nbsp * 10}" + world, :align => :justify)
24
- end
@@ -1,85 +0,0 @@
1
- # encoding: utf-8
2
- # Prawn : A library for PDF generation in Ruby
3
- #
4
- # Copyright April 2008, Gregory Brown. All Rights Reserved.
5
- #
6
- # This is free software. Please see the LICENSE and COPYING files for details.
7
-
8
- require "set"
9
-
10
- %w[ttfunk/lib].each do |dep|
11
- $LOAD_PATH.unshift(File.dirname(__FILE__) + "/../../vendor/#{dep}")
12
- end
13
-
14
- begin
15
- require 'ttfunk'
16
- rescue LoadError
17
- puts "Failed to load ttfunk. If you are running Prawn from git:"
18
- puts " git submodule init"
19
- puts " git submodule update"
20
- exit
21
- end
22
-
23
- module Prawn
24
- extend self
25
-
26
- file = __FILE__
27
- file = File.readlink(file) if File.symlink?(file)
28
- dir = File.dirname(file)
29
-
30
- # The base source directory for Prawn as installed on the system
31
- #
32
- BASEDIR = File.expand_path(File.join(dir, '..', '..'))
33
-
34
- # Whe set to true, Prawn will verify hash options to ensure only valid keys
35
- # are used. Off by default.
36
- #
37
- # Example:
38
- # >> Prawn::Document.new(:tomato => "Juicy")
39
- # Prawn::Errors::UnknownOption:
40
- # Detected unknown option(s): [:tomato]
41
- # Accepted options are: [:page_size, :page_layout, :left_margin, ...]
42
- #
43
- attr_accessor :debug
44
-
45
- def verify_options(accepted, actual) #:nodoc:
46
- return unless debug || $DEBUG
47
- unless (act=Set[*actual.keys]).subset?(acc=Set[*accepted])
48
- raise Prawn::Errors::UnknownOption,
49
- "\nDetected unknown option(s): #{(act - acc).to_a.inspect}\n" <<
50
- "Accepted options are: #{accepted.inspect}"
51
- end
52
- yield if block_given?
53
- end
54
-
55
- module Configurable #:nodoc:
56
- def configuration(*args)
57
- @config ||= Marshal.load(Marshal.dump(default_configuration))
58
- if Hash === args[0]
59
- @config.update(args[0])
60
- elsif args.length > 1
61
- @config.values_at(*args)
62
- elsif args.length == 1
63
- @config[args[0]]
64
- else
65
- @config
66
- end
67
- end
68
-
69
- alias_method :C, :configuration
70
- end
71
- end
72
-
73
- require "prawn/compatibility"
74
- require "prawn/errors"
75
- require "prawn/core/pdf_object"
76
- require "prawn/core/reference"
77
- require "prawn/core/page"
78
- require "prawn/core/object_store"
79
- require "prawn/core/document_state"
80
- require "prawn/core/literal_string"
81
- require "prawn/core/byte_string"
82
- require "prawn/core/name_tree"
83
- require "prawn/core/annotations"
84
- require "prawn/core/destinations"
85
-
@@ -1,294 +0,0 @@
1
- # encoding: utf-8
2
-
3
- # core/text/formatted/arranger.rb : Implements a data structure for 2-stage
4
- # processing of lines of formatted text
5
- #
6
- # Copyright February 2010, Daniel Nelson. All Rights Reserved.
7
- #
8
- # This is free software. Please see the LICENSE and COPYING files for details.
9
-
10
- module Prawn
11
- module Core
12
- module Text
13
- module Formatted #:nodoc:
14
-
15
- class Arranger #:nodoc:
16
- attr_reader :max_line_height
17
- attr_reader :max_descender
18
- attr_reader :max_ascender
19
-
20
- # The following present only for testing purposes
21
- attr_reader :unconsumed
22
- attr_reader :consumed
23
- attr_reader :fragments
24
- attr_reader :current_format_state
25
-
26
- def initialize(document, options={})
27
- @document = document
28
- @fragments = []
29
- @unconsumed = []
30
- @kerning = options[:kerning]
31
- end
32
-
33
- def space_count
34
- if @unfinalized_line
35
- raise "Lines must be finalized before calling #space_count"
36
- end
37
- @fragments.inject(0) do |sum, fragment|
38
- sum + fragment.space_count
39
- end
40
- end
41
-
42
- def line_width
43
- if @unfinalized_line
44
- raise "Lines must be finalized before calling #line_width"
45
- end
46
- @fragments.inject(0) do |sum, fragment|
47
- sum + fragment.width
48
- end
49
- end
50
-
51
- def line
52
- if @unfinalized_line
53
- raise "Lines must be finalized before calling #line"
54
- end
55
- @fragments.collect do |fragment|
56
- if ruby_18 { true }
57
- fragment.text
58
- else
59
- fragment.text.dup.force_encoding("utf-8")
60
- end
61
- end.join
62
- end
63
-
64
- def finalize_line
65
- @unfinalized_line = false
66
- omit_trailing_whitespace_from_line_width
67
- @fragments = []
68
- @consumed.each do |hash|
69
- text = hash[:text]
70
- format_state = hash.dup
71
- format_state.delete(:text)
72
- fragment = Prawn::Text::Formatted::Fragment.new(text,
73
- format_state,
74
- @document)
75
- @fragments << fragment
76
- set_fragment_measurements(fragment)
77
- set_line_measurement_maximums(fragment)
78
- end
79
- end
80
-
81
- def format_array=(array)
82
- initialize_line
83
- @unconsumed = []
84
- array.each do |hash|
85
- hash[:text].scan(/[^\n]+|\n/) do |line|
86
- @unconsumed << hash.merge(:text => line)
87
- end
88
- end
89
- end
90
-
91
- def initialize_line
92
- @unfinalized_line = true
93
- @max_line_height = 0
94
- @max_descender = 0
95
- @max_ascender = 0
96
-
97
- @consumed = []
98
- @fragments = []
99
- end
100
-
101
- def finished?
102
- @unconsumed.length == 0
103
- end
104
-
105
- def next_string
106
- unless @unfinalized_line
107
- raise "Lines must not be finalized when calling #next_string"
108
- end
109
- hash = @unconsumed.shift
110
- if hash.nil?
111
- nil
112
- else
113
- @consumed << hash.dup
114
- @current_format_state = hash.dup
115
- @current_format_state.delete(:text)
116
- hash[:text]
117
- end
118
- end
119
-
120
- def preview_next_string
121
- hash = @unconsumed.first
122
- if hash.nil? then nil
123
- else hash[:text]
124
- end
125
- end
126
-
127
- def apply_color_and_font_settings(fragment, &block)
128
- if fragment.color
129
- original_fill_color = @document.fill_color
130
- original_stroke_color = @document.stroke_color
131
- @document.fill_color(*fragment.color)
132
- @document.stroke_color(*fragment.color)
133
- apply_font_settings(fragment, &block)
134
- @document.stroke_color = original_stroke_color
135
- @document.fill_color = original_fill_color
136
- else
137
- apply_font_settings(fragment, &block)
138
- end
139
- end
140
-
141
- def apply_font_settings(fragment=nil, &block)
142
- if fragment.nil?
143
- font = current_format_state[:font]
144
- size = current_format_state[:size]
145
- character_spacing = current_format_state[:character_spacing] ||
146
- @document.character_spacing
147
- styles = current_format_state[:styles]
148
- font_style = font_style(styles)
149
- else
150
- font = fragment.font
151
- size = fragment.size
152
- character_spacing = fragment.character_spacing
153
- styles = fragment.styles
154
- font_style = font_style(styles)
155
- end
156
-
157
- @document.character_spacing(character_spacing) do
158
- if font || font_style != :normal
159
- raise "Bad font family" unless @document.font.family
160
- @document.font(font || @document.font.family, :style => font_style) do
161
- apply_font_size(size, styles, &block)
162
- end
163
- else
164
- apply_font_size(size, styles, &block)
165
- end
166
- end
167
- end
168
-
169
- def update_last_string(printed, unprinted, normalized_soft_hyphen=nil)
170
- return if printed.nil?
171
- if printed.empty?
172
- @consumed.pop
173
- else
174
- @consumed.last[:text] = printed
175
- if normalized_soft_hyphen
176
- @consumed.last[:normalized_soft_hyphen] = normalized_soft_hyphen
177
- end
178
- end
179
-
180
- unless unprinted.empty?
181
- @unconsumed.unshift(@current_format_state.merge(:text => unprinted))
182
- end
183
-
184
- load_previous_format_state if printed.empty?
185
- end
186
-
187
- def retrieve_fragment
188
- if @unfinalized_line
189
- raise "Lines must be finalized before fragments can be retrieved"
190
- end
191
- @fragments.shift
192
- end
193
-
194
- def repack_unretrieved
195
- new_unconsumed = []
196
- while fragment = retrieve_fragment
197
- fragment.include_trailing_white_space!
198
- new_unconsumed << fragment.format_state.merge(:text => fragment.text)
199
- end
200
- @unconsumed = new_unconsumed.concat(@unconsumed)
201
- end
202
-
203
- def font_style(styles)
204
- if styles.nil?
205
- :normal
206
- elsif styles.include?(:bold) && styles.include?(:italic)
207
- :bold_italic
208
- elsif styles.include?(:bold)
209
- :bold
210
- elsif styles.include?(:italic)
211
- :italic
212
- else
213
- :normal
214
- end
215
- end
216
-
217
- private
218
-
219
- def load_previous_format_state
220
- if @consumed.empty?
221
- @current_format_state = {}
222
- else
223
- hash = @consumed.last
224
- @current_format_state = hash.dup
225
- @current_format_state.delete(:text)
226
- end
227
- end
228
-
229
- def apply_font_size(size, styles)
230
- if subscript?(styles) || superscript?(styles)
231
- relative_size = 0.583
232
- if size.nil?
233
- size = @document.font_size * relative_size
234
- else
235
- size = size * relative_size
236
- end
237
- end
238
- if size.nil?
239
- yield
240
- else
241
- @document.font_size(size) { yield }
242
- end
243
- end
244
-
245
- def subscript?(styles)
246
- if styles.nil? then false
247
- else styles.include?(:subscript)
248
- end
249
- end
250
-
251
- def superscript?(styles)
252
- if styles.nil? then false
253
- else styles.include?(:superscript)
254
- end
255
- end
256
-
257
- def omit_trailing_whitespace_from_line_width
258
- @consumed.reverse_each do |hash|
259
- if hash[:text] == "\n"
260
- break
261
- elsif hash[:text].strip.empty? && @consumed.length > 1
262
- # this entire fragment is trailing white space
263
- hash[:exclude_trailing_white_space] = true
264
- else
265
- # this fragment contains the first non-white space we have
266
- # encountered since the end of the line
267
- hash[:exclude_trailing_white_space] = true
268
- break
269
- end
270
- end
271
- end
272
-
273
- def set_fragment_measurements(fragment)
274
- apply_font_settings(fragment) do
275
- fragment.width = @document.width_of(fragment.text,
276
- :kerning => @kerning)
277
- fragment.line_height = @document.font.height
278
- fragment.descender = @document.font.descender
279
- fragment.ascender = @document.font.ascender
280
- end
281
- end
282
-
283
- def set_line_measurement_maximums(fragment)
284
- @max_line_height = [@max_line_height, fragment.line_height].max
285
- @max_descender = [@max_descender, fragment.descender].max
286
- @max_ascender = [@max_ascender, fragment.ascender].max
287
- end
288
-
289
- end
290
-
291
- end
292
- end
293
- end
294
- end
@@ -1,273 +0,0 @@
1
- # encoding: utf-8
2
-
3
- # core/text/formatted/line_wrap.rb : Implements individual line wrapping of
4
- # formatted text
5
- #
6
- # Copyright February 2010, Daniel Nelson. All Rights Reserved.
7
- #
8
- # This is free software. Please see the LICENSE and COPYING files for details.
9
- #
10
-
11
- module Prawn
12
- module Core
13
- module Text
14
- module Formatted #:nodoc:
15
-
16
- class LineWrap #:nodoc:
17
-
18
- # The width of the last wrapped line
19
- #
20
- def width
21
- @accumulated_width || 0
22
- end
23
-
24
- # The number of spaces in the last wrapped line
25
- attr_reader :space_count
26
-
27
- # Whether this line is the last line in the paragraph
28
- def paragraph_finished?
29
- @newline_encountered || is_next_string_newline? || @arranger.finished?
30
- end
31
-
32
- # Work in conjunction with the Prawn::Core::Formatted::Arranger
33
- # defined in the :arranger option to determine what formatted text
34
- # will fit within the width defined by the :width option
35
- #
36
- def wrap_line(options)
37
- initialize_line(options)
38
-
39
- while fragment = @arranger.next_string
40
- @fragment_output = ""
41
-
42
- fragment.lstrip! if first_fragment_on_this_line?(fragment)
43
- next if empty_line?(fragment)
44
-
45
- unless apply_font_settings_and_add_fragment_to_line(fragment)
46
- break
47
- end
48
- end
49
- @arranger.finalize_line
50
- @accumulated_width = @arranger.line_width
51
- @space_count = @arranger.space_count
52
- @arranger.line
53
- end
54
-
55
- private
56
-
57
- def first_fragment_on_this_line?(fragment)
58
- line_empty? && fragment != "\n"
59
- end
60
-
61
- def empty_line?(fragment)
62
- empty = line_empty? && fragment.empty? && is_next_string_newline?
63
- @arranger.update_last_string("", "", soft_hyphen) if empty
64
- empty
65
- end
66
-
67
- def is_next_string_newline?
68
- @arranger.preview_next_string == "\n"
69
- end
70
-
71
- def apply_font_settings_and_add_fragment_to_line(fragment)
72
- result = nil
73
- @arranger.apply_font_settings do
74
- result = add_fragment_to_line(fragment)
75
- end
76
- result
77
- end
78
-
79
- # returns true iff all text was printed without running into the end of
80
- # the line
81
- #
82
- def add_fragment_to_line(fragment)
83
- if fragment == ""
84
- true
85
- elsif fragment == "\n"
86
- @newline_encountered = true
87
- false
88
- else
89
- fragment.scan(scan_pattern).each do |segment|
90
- if segment == zero_width_space
91
- segment_width = 0
92
- else
93
- segment_width = @document.width_of(segment, :kerning => @kerning)
94
- end
95
-
96
- if @accumulated_width + segment_width <= @width
97
- @accumulated_width += segment_width
98
- @fragment_output += segment
99
- else
100
- end_of_the_line_reached(segment)
101
- fragment_finished(fragment)
102
- return false
103
- end
104
- end
105
-
106
- fragment_finished(fragment)
107
- true
108
- end
109
- end
110
-
111
- # The pattern used to determine chunks of text to place on a given line
112
- #
113
- def scan_pattern
114
- pattern = "[^#{break_chars}]+#{soft_hyphen}|" +
115
- "[^#{break_chars}]+#{hyphen}+|" +
116
- "[^#{break_chars}]+|" +
117
- "[#{whitespace}]+|" +
118
- "#{hyphen}+[^#{break_chars}]*|" +
119
- "#{soft_hyphen}"
120
- new_regexp(pattern)
121
- end
122
-
123
- # The pattern used to determine whether any word breaks exist on a
124
- # current line, which in turn determines whether character level
125
- # word breaking is needed
126
- #
127
- def word_division_scan_pattern
128
- new_regexp("\\s|[#{zero_width_space}#{soft_hyphen}#{hyphen}]")
129
- end
130
-
131
- def break_chars
132
- "#{whitespace}#{soft_hyphen}#{hyphen}"
133
- end
134
-
135
- def whitespace
136
- " \\t#{zero_width_space}"
137
- end
138
-
139
- def hyphen
140
- "-"
141
- end
142
-
143
- def soft_hyphen
144
- @document.font.normalize_encoding(Prawn::Text::SHY)
145
- end
146
-
147
- def zero_width_space
148
- @document.font.unicode? ? Prawn::Text::ZWSP : ""
149
- end
150
-
151
- def line_empty?
152
- @line_empty && @accumulated_width == 0
153
- end
154
-
155
- def initialize_line(options)
156
- @document = options[:document]
157
- @kerning = options[:kerning]
158
- @width = options[:width]
159
-
160
- @accumulated_width = 0
161
- @line_empty = true
162
- @line_contains_more_than_one_word = false
163
-
164
- @arranger = options[:arranger]
165
- @arranger.initialize_line
166
-
167
- @newline_encountered = false
168
- @line_full = false
169
- end
170
-
171
- def fragment_finished(fragment)
172
- if fragment == "\n"
173
- @newline_encountered = true
174
- @line_empty = false
175
- else
176
- update_output_based_on_last_fragment(fragment, soft_hyphen)
177
- update_line_status_based_on_last_output
178
- determine_whether_to_pull_preceding_fragment_to_join_this_one(fragment)
179
- end
180
- remember_this_fragment_for_backward_looking_ops
181
- end
182
-
183
- def update_output_based_on_last_fragment(fragment, normalized_soft_hyphen=nil)
184
- remaining_text = fragment.slice(@fragment_output.length..fragment.length)
185
- raise Errors::CannotFit if line_finished? && line_empty? &&
186
- @fragment_output.empty? && !fragment.strip.empty?
187
- @arranger.update_last_string(@fragment_output, remaining_text, normalized_soft_hyphen)
188
- end
189
-
190
- def determine_whether_to_pull_preceding_fragment_to_join_this_one(current_fragment)
191
- if @fragment_output.empty? &&
192
- !current_fragment.empty? &&
193
- @line_contains_more_than_one_word
194
- unless previous_fragment_ended_with_breakable? ||
195
- fragment_begins_with_breakable?(current_fragment)
196
- @fragment_output = @previous_fragment_output_without_last_word
197
- update_output_based_on_last_fragment(@previous_fragment)
198
- end
199
- end
200
- end
201
-
202
- def remember_this_fragment_for_backward_looking_ops
203
- @previous_fragment = @fragment_output.dup
204
- pf = @previous_fragment
205
- @previous_fragment_ended_with_breakable = pf =~ /[#{break_chars}]$/
206
- last_word = pf.slice(/[^#{break_chars}]*$/)
207
- last_word_length = last_word.nil? ? 0 : last_word.length
208
- @previous_fragment_output_without_last_word = pf.slice(0, pf.length - last_word_length)
209
- end
210
-
211
- def previous_fragment_ended_with_breakable?
212
- @previous_fragment_ended_with_breakable
213
- end
214
-
215
- def fragment_begins_with_breakable?(fragment)
216
- fragment =~ /^[#{break_chars}]/
217
- end
218
-
219
- def line_finished?
220
- @line_full || paragraph_finished?
221
- end
222
-
223
- def update_line_status_based_on_last_output
224
- @line_contains_more_than_one_word = true if @fragment_output =~ word_division_scan_pattern
225
- end
226
-
227
- def end_of_the_line_reached(segment)
228
- update_line_status_based_on_last_output
229
- wrap_by_char(segment) unless @line_contains_more_than_one_word
230
- @line_full = true
231
- end
232
-
233
- def wrap_by_char(segment)
234
- if @document.font.unicode?
235
- segment.unpack("U*").each do |char_int|
236
- break unless append_char([char_int].pack("U"))
237
- end
238
- else
239
- segment.each_char do |char|
240
- break unless append_char(char)
241
- end
242
- end
243
- end
244
-
245
- def append_char(char)
246
- # kerning doesn't make sense in the context of a single character
247
- char_width = @document.width_of(char)
248
-
249
- if @accumulated_width + char_width <= @width
250
- @accumulated_width += char_width
251
- @fragment_output << char
252
- true
253
- else
254
- false
255
- end
256
- end
257
-
258
- def new_regexp(pattern)
259
- regexp = ruby_19 {
260
- Regexp.new(pattern)
261
- }
262
- regexp = regexp || ruby_18 {
263
- lang = @document.font.unicode? ? 'U' : 'N'
264
- Regexp.new(pattern, 0, lang)
265
- }
266
- regexp
267
- end
268
-
269
- end
270
- end
271
- end
272
- end
273
- end