prawn 0.13.0 → 2.4.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (348) hide show
  1. checksums.yaml +5 -5
  2. checksums.yaml.gz.sig +0 -0
  3. data/.yardopts +10 -0
  4. data/GPLv2 +20 -21
  5. data/Gemfile +3 -16
  6. data/Rakefile +17 -39
  7. data/lib/prawn/document/bounding_box.rb +85 -42
  8. data/lib/prawn/document/column_box.rb +21 -11
  9. data/lib/prawn/document/internals.rb +40 -147
  10. data/lib/prawn/document/span.rb +25 -17
  11. data/lib/prawn/document.rb +286 -245
  12. data/lib/prawn/encoding.rb +68 -101
  13. data/lib/prawn/errors.rb +47 -43
  14. data/lib/prawn/font.rb +204 -155
  15. data/lib/prawn/font_metric_cache.rb +25 -21
  16. data/lib/prawn/fonts/afm.rb +292 -0
  17. data/lib/prawn/{font → fonts}/dfont.rb +7 -13
  18. data/lib/prawn/fonts/otf.rb +11 -0
  19. data/lib/prawn/fonts/ttc.rb +36 -0
  20. data/lib/prawn/{font → fonts}/ttf.rb +142 -80
  21. data/lib/prawn/graphics/blend_mode.rb +65 -0
  22. data/lib/prawn/graphics/cap_style.rb +6 -5
  23. data/lib/prawn/graphics/color.rb +47 -44
  24. data/lib/prawn/graphics/dash.rb +30 -13
  25. data/lib/prawn/graphics/join_style.rb +13 -6
  26. data/lib/prawn/graphics/patterns.rb +221 -90
  27. data/lib/prawn/graphics/transformation.rb +21 -12
  28. data/lib/prawn/graphics/transparency.rb +21 -17
  29. data/lib/prawn/graphics.rb +155 -128
  30. data/lib/prawn/{layout/grid.rb → grid.rb} +110 -47
  31. data/lib/prawn/image_handler.rb +16 -2
  32. data/lib/prawn/images/image.rb +4 -2
  33. data/lib/prawn/images/jpg.rb +39 -30
  34. data/lib/prawn/images/png.rb +132 -169
  35. data/lib/prawn/images.rb +70 -62
  36. data/lib/prawn/measurement_extensions.rb +15 -10
  37. data/lib/prawn/measurements.rb +22 -23
  38. data/lib/prawn/outline.rb +301 -13
  39. data/lib/prawn/repeater.rb +19 -17
  40. data/lib/prawn/security/arcfour.rb +54 -0
  41. data/lib/prawn/security.rb +108 -86
  42. data/lib/prawn/soft_mask.rb +40 -41
  43. data/lib/prawn/stamp.rb +29 -12
  44. data/lib/prawn/text/box.rb +27 -29
  45. data/lib/prawn/text/formatted/arranger.rb +110 -67
  46. data/lib/prawn/text/formatted/box.rb +233 -165
  47. data/lib/prawn/text/formatted/fragment.rb +27 -27
  48. data/lib/prawn/text/formatted/line_wrap.rb +137 -97
  49. data/lib/prawn/text/formatted/parser.rb +149 -127
  50. data/lib/prawn/text/formatted/wrap.rb +57 -37
  51. data/lib/prawn/text/formatted.rb +6 -4
  52. data/lib/prawn/text.rb +105 -73
  53. data/lib/prawn/transformation_stack.rb +44 -0
  54. data/lib/prawn/utilities.rb +11 -21
  55. data/lib/prawn/version.rb +5 -0
  56. data/lib/prawn/view.rb +101 -0
  57. data/lib/prawn.rb +42 -68
  58. data/{data/images/fractal.jpg → manual/absolute_position.pdf} +0 -0
  59. data/manual/basic_concepts/adding_pages.rb +9 -10
  60. data/manual/basic_concepts/basic_concepts.rb +33 -24
  61. data/manual/basic_concepts/creation.rb +10 -11
  62. data/manual/basic_concepts/cursor.rb +9 -10
  63. data/manual/basic_concepts/measurement.rb +10 -11
  64. data/manual/basic_concepts/origin.rb +8 -9
  65. data/manual/basic_concepts/other_cursor_helpers.rb +17 -18
  66. data/manual/basic_concepts/view.rb +48 -0
  67. data/manual/bounding_box/bounding_box.rb +31 -29
  68. data/manual/bounding_box/bounds.rb +17 -18
  69. data/manual/bounding_box/canvas.rb +8 -9
  70. data/manual/bounding_box/creation.rb +8 -9
  71. data/manual/bounding_box/indentation.rb +22 -23
  72. data/manual/bounding_box/nesting.rb +32 -25
  73. data/manual/bounding_box/russian_boxes.rb +19 -19
  74. data/manual/bounding_box/stretchy.rb +18 -20
  75. data/manual/contents.rb +35 -0
  76. data/manual/cover.rb +43 -0
  77. data/manual/document_and_page_options/background.rb +16 -14
  78. data/manual/document_and_page_options/document_and_page_options.rb +26 -23
  79. data/manual/document_and_page_options/metadata.rb +21 -19
  80. data/manual/document_and_page_options/page_margins.rb +20 -22
  81. data/manual/document_and_page_options/page_size.rb +15 -15
  82. data/manual/document_and_page_options/print_scaling.rb +23 -0
  83. data/manual/example_helper.rb +5 -408
  84. data/manual/graphics/blend_mode.rb +52 -0
  85. data/manual/graphics/circle_and_ellipse.rb +8 -9
  86. data/manual/graphics/color.rb +11 -13
  87. data/manual/graphics/common_lines.rb +13 -12
  88. data/manual/graphics/fill_and_stroke.rb +10 -11
  89. data/manual/graphics/fill_rules.rb +13 -12
  90. data/manual/graphics/gradients.rb +28 -22
  91. data/manual/graphics/graphics.rb +52 -46
  92. data/manual/graphics/helper.rb +20 -10
  93. data/manual/graphics/line_width.rb +13 -12
  94. data/manual/graphics/lines_and_curves.rb +13 -14
  95. data/manual/graphics/polygon.rb +10 -12
  96. data/manual/graphics/rectangle.rb +7 -8
  97. data/manual/graphics/rotate.rb +9 -12
  98. data/manual/graphics/scale.rb +19 -18
  99. data/manual/graphics/soft_masks.rb +5 -7
  100. data/manual/graphics/stroke_cap.rb +10 -11
  101. data/manual/graphics/stroke_dash.rb +16 -17
  102. data/manual/graphics/stroke_join.rb +10 -11
  103. data/manual/graphics/translate.rb +13 -13
  104. data/manual/graphics/transparency.rb +11 -13
  105. data/manual/{manual/how_to_read_this_manual.rb → how_to_read_this_manual.rb} +23 -25
  106. data/manual/images/absolute_position.rb +9 -10
  107. data/manual/images/fit.rb +9 -10
  108. data/manual/images/horizontal.rb +13 -14
  109. data/manual/images/images.rb +31 -30
  110. data/manual/images/plain_image.rb +6 -7
  111. data/manual/images/scale.rb +12 -13
  112. data/manual/images/vertical.rb +19 -17
  113. data/manual/images/width_and_height.rb +13 -14
  114. data/manual/layout/boxes.rb +14 -15
  115. data/manual/layout/content.rb +12 -13
  116. data/manual/layout/layout.rb +19 -20
  117. data/manual/layout/simple_grid.rb +8 -9
  118. data/manual/outline/add_subsection_to.rb +26 -27
  119. data/manual/outline/insert_section_after.rb +19 -20
  120. data/manual/outline/outline.rb +23 -22
  121. data/manual/outline/sections_and_pages.rb +24 -25
  122. data/manual/repeatable_content/alternate_page_numbering.rb +36 -0
  123. data/manual/repeatable_content/page_numbering.rb +20 -19
  124. data/manual/repeatable_content/repeatable_content.rb +26 -22
  125. data/manual/repeatable_content/repeater.rb +18 -19
  126. data/manual/repeatable_content/stamp.rb +18 -19
  127. data/manual/security/encryption.rb +8 -11
  128. data/manual/security/permissions.rb +20 -15
  129. data/manual/security/security.rb +20 -20
  130. data/manual/table.rb +16 -0
  131. data/manual/text/alignment.rb +17 -18
  132. data/manual/text/color.rb +13 -13
  133. data/manual/text/column_box.rb +10 -12
  134. data/manual/text/fallback_fonts.rb +29 -25
  135. data/manual/text/font.rb +17 -18
  136. data/manual/text/font_size.rb +21 -22
  137. data/manual/text/font_style.rb +12 -10
  138. data/manual/text/formatted_callbacks.rb +36 -26
  139. data/manual/text/formatted_text.rb +41 -34
  140. data/manual/text/free_flowing_text.rb +28 -29
  141. data/manual/text/inline.rb +23 -26
  142. data/manual/text/kerning_and_character_spacing.rb +20 -21
  143. data/manual/text/leading.rb +10 -11
  144. data/manual/text/line_wrapping.rb +40 -21
  145. data/manual/text/paragraph_indentation.rb +17 -12
  146. data/manual/text/positioned_text.rb +19 -20
  147. data/manual/text/registering_families.rb +33 -30
  148. data/manual/text/rendering_and_color.rb +11 -12
  149. data/manual/text/right_to_left_text.rb +31 -20
  150. data/manual/text/rotation.rb +36 -27
  151. data/manual/text/single_usage.rb +13 -14
  152. data/manual/text/text.rb +62 -62
  153. data/manual/text/text_box_excess.rb +22 -19
  154. data/manual/text/text_box_extensions.rb +21 -18
  155. data/manual/text/text_box_overflow.rb +28 -21
  156. data/manual/text/utf8.rb +16 -17
  157. data/manual/text/win_ansi_charset.rb +29 -26
  158. data/prawn.gemspec +45 -43
  159. data/spec/extensions/encoding_helpers.rb +4 -3
  160. data/spec/prawn/document/bounding_box_spec.rb +550 -0
  161. data/spec/prawn/document/column_box_spec.rb +75 -0
  162. data/spec/prawn/document/security_spec.rb +176 -0
  163. data/spec/prawn/document_annotations_spec.rb +76 -0
  164. data/spec/prawn/document_destinations_spec.rb +15 -0
  165. data/spec/prawn/document_grid_spec.rb +99 -0
  166. data/spec/prawn/document_reference_spec.rb +27 -0
  167. data/spec/prawn/document_span_spec.rb +44 -0
  168. data/spec/prawn/document_spec.rb +805 -0
  169. data/spec/prawn/font_metric_cache_spec.rb +54 -0
  170. data/spec/prawn/font_spec.rb +544 -0
  171. data/spec/prawn/graphics/blend_mode_spec.rb +63 -0
  172. data/spec/prawn/graphics/transparency_spec.rb +81 -0
  173. data/spec/prawn/graphics_spec.rb +872 -0
  174. data/spec/prawn/graphics_stroke_styles_spec.rb +229 -0
  175. data/spec/prawn/image_handler_spec.rb +53 -0
  176. data/spec/prawn/images/jpg_spec.rb +20 -0
  177. data/spec/prawn/images/png_spec.rb +283 -0
  178. data/spec/prawn/images_spec.rb +229 -0
  179. data/spec/prawn/measurements_extensions_spec.rb +24 -0
  180. data/spec/prawn/outline_spec.rb +512 -0
  181. data/spec/prawn/repeater_spec.rb +166 -0
  182. data/spec/prawn/soft_mask_spec.rb +74 -0
  183. data/spec/prawn/stamp_spec.rb +173 -0
  184. data/spec/prawn/text/box_spec.rb +1110 -0
  185. data/spec/prawn/text/formatted/arranger_spec.rb +466 -0
  186. data/spec/prawn/text/formatted/box_spec.rb +849 -0
  187. data/spec/prawn/text/formatted/fragment_spec.rb +343 -0
  188. data/spec/prawn/text/formatted/line_wrap_spec.rb +495 -0
  189. data/spec/prawn/text/formatted/parser_spec.rb +697 -0
  190. data/spec/prawn/text_draw_text_spec.rb +150 -0
  191. data/spec/prawn/text_rendering_mode_spec.rb +48 -0
  192. data/spec/prawn/text_spacing_spec.rb +95 -0
  193. data/spec/prawn/text_spec.rb +603 -0
  194. data/spec/prawn/text_with_inline_formatting_spec.rb +35 -0
  195. data/spec/prawn/transformation_stack_spec.rb +66 -0
  196. data/spec/prawn/view_spec.rb +63 -0
  197. data/spec/prawn_manual_spec.rb +35 -0
  198. data/spec/spec_helper.rb +22 -21
  199. data.tar.gz.sig +0 -0
  200. metadata +168 -307
  201. metadata.gz.sig +0 -0
  202. data/README.md +0 -109
  203. data/data/encodings/win_ansi.txt +0 -29
  204. data/data/images/16bit.alpha +0 -0
  205. data/data/images/16bit.dat +0 -0
  206. data/data/images/16bit.png +0 -0
  207. data/data/images/arrow.png +0 -0
  208. data/data/images/arrow2.png +0 -0
  209. data/data/images/barcode_issue.png +0 -0
  210. data/data/images/dice.alpha +0 -0
  211. data/data/images/dice.dat +0 -0
  212. data/data/images/dice.png +0 -0
  213. data/data/images/dice_interlaced.png +0 -0
  214. data/data/images/indexed_color.dat +0 -0
  215. data/data/images/indexed_color.png +0 -0
  216. data/data/images/letterhead.jpg +0 -0
  217. data/data/images/page_white_text.alpha +0 -0
  218. data/data/images/page_white_text.dat +0 -0
  219. data/data/images/page_white_text.png +0 -0
  220. data/data/images/pigs.jpg +0 -0
  221. data/data/images/prawn.png +0 -0
  222. data/data/images/ruport.png +0 -0
  223. data/data/images/ruport_data.dat +0 -0
  224. data/data/images/ruport_transparent.png +0 -0
  225. data/data/images/ruport_type0.png +0 -0
  226. data/data/images/stef.jpg +0 -0
  227. data/data/images/tru256.bmp +0 -0
  228. data/data/images/web-links.dat +0 -1
  229. data/data/images/web-links.png +0 -0
  230. data/data/pdfs/complex_template.pdf +0 -0
  231. data/data/pdfs/contains_ttf_font.pdf +0 -0
  232. data/data/pdfs/encrypted.pdf +0 -0
  233. data/data/pdfs/form.pdf +1 -819
  234. data/data/pdfs/hexagon.pdf +0 -61
  235. data/data/pdfs/indirect_reference.pdf +0 -86
  236. data/data/pdfs/multipage_template.pdf +0 -127
  237. data/data/pdfs/nested_pages.pdf +0 -118
  238. data/data/pdfs/page_without_mediabox.pdf +0 -193
  239. data/data/pdfs/resources_as_indirect_object.pdf +0 -83
  240. data/data/pdfs/two_hexagons.pdf +0 -90
  241. data/data/pdfs/version_1_6.pdf +0 -61
  242. data/data/shift_jis_text.txt +0 -1
  243. data/lib/pdf/core/annotations.rb +0 -60
  244. data/lib/pdf/core/byte_string.rb +0 -9
  245. data/lib/pdf/core/destinations.rb +0 -90
  246. data/lib/pdf/core/document_state.rb +0 -78
  247. data/lib/pdf/core/filter_list.rb +0 -51
  248. data/lib/pdf/core/filters.rb +0 -36
  249. data/lib/pdf/core/graphics_state.rb +0 -68
  250. data/lib/pdf/core/literal_string.rb +0 -16
  251. data/lib/pdf/core/name_tree.rb +0 -177
  252. data/lib/pdf/core/object_store.rb +0 -320
  253. data/lib/pdf/core/outline.rb +0 -315
  254. data/lib/pdf/core/page.rb +0 -212
  255. data/lib/pdf/core/page_geometry.rb +0 -126
  256. data/lib/pdf/core/pdf_object.rb +0 -124
  257. data/lib/pdf/core/reference.rb +0 -103
  258. data/lib/pdf/core/stream.rb +0 -98
  259. data/lib/pdf/core/text.rb +0 -275
  260. data/lib/pdf/core.rb +0 -35
  261. data/lib/prawn/compatibility.rb +0 -91
  262. data/lib/prawn/document/graphics_state.rb +0 -73
  263. data/lib/prawn/document/snapshot.rb +0 -89
  264. data/lib/prawn/font/afm.rb +0 -203
  265. data/lib/prawn/layout.rb +0 -20
  266. data/lib/prawn/table/cell/image.rb +0 -70
  267. data/lib/prawn/table/cell/in_table.rb +0 -27
  268. data/lib/prawn/table/cell/span_dummy.rb +0 -92
  269. data/lib/prawn/table/cell/subtable.rb +0 -65
  270. data/lib/prawn/table/cell/text.rb +0 -153
  271. data/lib/prawn/table/cell.rb +0 -770
  272. data/lib/prawn/table/cells.rb +0 -295
  273. data/lib/prawn/table.rb +0 -643
  274. data/manual/example_file.rb +0 -116
  275. data/manual/example_package.rb +0 -53
  276. data/manual/example_section.rb +0 -46
  277. data/manual/manual/cover.rb +0 -35
  278. data/manual/manual/foreword.rb +0 -85
  279. data/manual/manual/manual.rb +0 -35
  280. data/manual/syntax_highlight.rb +0 -52
  281. data/manual/table/basic_block.rb +0 -53
  282. data/manual/table/before_rendering_page.rb +0 -26
  283. data/manual/table/cell_border_lines.rb +0 -24
  284. data/manual/table/cell_borders_and_bg.rb +0 -31
  285. data/manual/table/cell_dimensions.rb +0 -30
  286. data/manual/table/cell_text.rb +0 -38
  287. data/manual/table/column_widths.rb +0 -30
  288. data/manual/table/content_and_subtables.rb +0 -39
  289. data/manual/table/creation.rb +0 -27
  290. data/manual/table/filtering.rb +0 -36
  291. data/manual/table/flow_and_header.rb +0 -17
  292. data/manual/table/image_cells.rb +0 -33
  293. data/manual/table/position.rb +0 -29
  294. data/manual/table/row_colors.rb +0 -20
  295. data/manual/table/span.rb +0 -30
  296. data/manual/table/style.rb +0 -22
  297. data/manual/table/table.rb +0 -52
  298. data/manual/table/width.rb +0 -27
  299. data/manual/templates/full_template.rb +0 -25
  300. data/manual/templates/page_template.rb +0 -48
  301. data/manual/templates/templates.rb +0 -27
  302. data/manual/text/group.rb +0 -29
  303. data/spec/acceptance/png.rb +0 -23
  304. data/spec/annotations_spec.rb +0 -74
  305. data/spec/bounding_box_spec.rb +0 -493
  306. data/spec/cell_spec.rb +0 -628
  307. data/spec/column_box_spec.rb +0 -33
  308. data/spec/destinations_spec.rb +0 -15
  309. data/spec/document_spec.rb +0 -761
  310. data/spec/extensions/mocha.rb +0 -44
  311. data/spec/filters_spec.rb +0 -34
  312. data/spec/font_metric_cache_spec.rb +0 -52
  313. data/spec/font_spec.rb +0 -464
  314. data/spec/formatted_text_arranger_spec.rb +0 -421
  315. data/spec/formatted_text_box_spec.rb +0 -650
  316. data/spec/formatted_text_fragment_spec.rb +0 -298
  317. data/spec/graphics_spec.rb +0 -651
  318. data/spec/grid_spec.rb +0 -85
  319. data/spec/image_handler_spec.rb +0 -42
  320. data/spec/images_spec.rb +0 -157
  321. data/spec/inline_formatted_text_parser_spec.rb +0 -564
  322. data/spec/jpg_spec.rb +0 -25
  323. data/spec/line_wrap_spec.rb +0 -333
  324. data/spec/measurement_units_spec.rb +0 -23
  325. data/spec/name_tree_spec.rb +0 -112
  326. data/spec/object_store_spec.rb +0 -170
  327. data/spec/outline_spec.rb +0 -448
  328. data/spec/pdf_object_spec.rb +0 -172
  329. data/spec/png_spec.rb +0 -240
  330. data/spec/reference_spec.rb +0 -82
  331. data/spec/repeater_spec.rb +0 -158
  332. data/spec/security_spec.rb +0 -158
  333. data/spec/snapshot_spec.rb +0 -186
  334. data/spec/soft_mask_spec.rb +0 -117
  335. data/spec/span_spec.rb +0 -44
  336. data/spec/stamp_spec.rb +0 -158
  337. data/spec/stream_spec.rb +0 -58
  338. data/spec/stroke_styles_spec.rb +0 -211
  339. data/spec/table/span_dummy_spec.rb +0 -17
  340. data/spec/table_spec.rb +0 -1355
  341. data/spec/template_spec.rb +0 -351
  342. data/spec/text_at_spec.rb +0 -130
  343. data/spec/text_box_spec.rb +0 -1030
  344. data/spec/text_rendering_mode_spec.rb +0 -45
  345. data/spec/text_spacing_spec.rb +0 -93
  346. data/spec/text_spec.rb +0 -425
  347. data/spec/text_with_inline_formatting_spec.rb +0 -35
  348. data/spec/transparency_spec.rb +0 -89
@@ -1,177 +0,0 @@
1
- # encoding: utf-8
2
-
3
- # name_tree.rb : Implements NameTree for PDF
4
- #
5
- # Copyright November 2008, Jamis Buck. All Rights Reserved.
6
- #
7
- # This is free software. Please see the LICENSE and COPYING files for details.
8
- #
9
- module PDF
10
- module Core
11
- module NameTree #:nodoc:
12
- class Node #:nodoc:
13
- attr_reader :children
14
- attr_reader :limit
15
- attr_reader :document
16
- attr_accessor :parent
17
- attr_accessor :ref
18
-
19
- def initialize(document, limit, parent=nil)
20
- @document = document
21
- @children = []
22
- @limit = limit
23
- @parent = parent
24
- @ref = nil
25
- end
26
-
27
- def empty?
28
- children.empty?
29
- end
30
-
31
- def size
32
- leaf? ? children.size : children.inject(0) { |sum, child| sum + child.size }
33
- end
34
-
35
- def leaf?
36
- children.empty? || children.first.is_a?(Value)
37
- end
38
-
39
- def add(name, value)
40
- self << Value.new(name, value)
41
- end
42
-
43
- def to_hash
44
- hash = {}
45
-
46
- hash[:Limits] = [least, greatest] if parent
47
- if leaf?
48
- hash[:Names] = children if leaf?
49
- else
50
- hash[:Kids] = children.map { |child| child.ref }
51
- end
52
-
53
- return hash
54
- end
55
-
56
- def least
57
- if leaf?
58
- children.first.name
59
- else
60
- children.first.least
61
- end
62
- end
63
-
64
- def greatest
65
- if leaf?
66
- children.last.name
67
- else
68
- children.last.greatest
69
- end
70
- end
71
-
72
- def <<(value)
73
- if children.empty?
74
- children << value
75
- elsif leaf?
76
- children.insert(insertion_point(value), value)
77
- split! if children.length > limit
78
- else
79
- fit = children.detect { |child| child >= value }
80
- fit = children.last unless fit
81
- fit << value
82
- end
83
-
84
- value
85
- end
86
-
87
- def >=(value)
88
- children.empty? || children.last >= value
89
- end
90
-
91
- def split!
92
- if parent
93
- parent.split(self)
94
- else
95
- left, right = new_node(self), new_node(self)
96
- split_children(self, left, right)
97
- children.replace([left, right])
98
- end
99
- end
100
-
101
- # Returns a deep copy of this node, without copying expensive things
102
- # like the ref to @document.
103
- #
104
- def deep_copy
105
- node = dup
106
- node.instance_variable_set("@children",
107
- Marshal.load(Marshal.dump(children)))
108
- node.instance_variable_set("@ref",
109
- node.ref ? node.ref.deep_copy : nil)
110
- node
111
- end
112
-
113
- protected
114
-
115
- def split(node)
116
- new_child = new_node(self)
117
- split_children(node, node, new_child)
118
- index = children.index(node)
119
- children.insert(index+1, new_child)
120
- split! if children.length > limit
121
- end
122
-
123
- private
124
-
125
- def new_node(parent=nil)
126
- node = Node.new(document, limit, parent)
127
- node.ref = document.ref!(node)
128
- return node
129
- end
130
-
131
- def split_children(node, left, right)
132
- half = (node.limit+1)/2
133
-
134
- left_children, right_children = node.children[0...half], node.children[half..-1]
135
-
136
- left.children.replace(left_children)
137
- right.children.replace(right_children)
138
-
139
- unless node.leaf?
140
- left_children.each { |child| child.parent = left }
141
- right_children.each { |child| child.parent = right }
142
- end
143
- end
144
-
145
- def insertion_point(value)
146
- children.each_with_index do |child, index|
147
- return index if child >= value
148
- end
149
- return children.length
150
- end
151
- end
152
-
153
- class Value #:nodoc:
154
- include Comparable
155
-
156
- attr_reader :name
157
- attr_reader :value
158
-
159
- def initialize(name, value)
160
- @name, @value = PDF::Core::LiteralString.new(name), value
161
- end
162
-
163
- def <=>(leaf)
164
- name <=> leaf.name
165
- end
166
-
167
- def inspect
168
- "#<Value: #{name.inspect} : #{value.inspect}>"
169
- end
170
-
171
- def to_s
172
- "#{name} : #{value}"
173
- end
174
- end
175
- end
176
- end
177
- end
@@ -1,320 +0,0 @@
1
- # encoding: utf-8
2
-
3
- # Implements PDF object repository
4
- #
5
- # Copyright August 2009, Brad Ediger. All Rights Reserved.
6
- #
7
- # This is free software. Please see the LICENSE and COPYING files for details.
8
-
9
-
10
- require 'pdf/reader'
11
-
12
- module PDF
13
- module Core
14
- class ObjectStore #:nodoc:
15
- include Enumerable
16
-
17
- attr_reader :min_version
18
-
19
- BASE_OBJECTS = %w[info pages root]
20
-
21
- def initialize(opts = {})
22
- @objects = {}
23
- @identifiers = []
24
-
25
- load_file(opts[:template]) if opts[:template]
26
-
27
- @info ||= ref(opts[:info] || {}).identifier
28
- @root ||= ref(:Type => :Catalog).identifier
29
- if pages.nil?
30
- root.data[:Pages] = ref(:Type => :Pages, :Count => 0, :Kids => [])
31
- end
32
- end
33
-
34
- def ref(data, &block)
35
- push(size + 1, data, &block)
36
- end
37
-
38
- def info
39
- @objects[@info]
40
- end
41
-
42
- def root
43
- @objects[@root]
44
- end
45
-
46
- def pages
47
- root.data[:Pages]
48
- end
49
-
50
- def page_count
51
- pages.data[:Count]
52
- end
53
-
54
- # Adds the given reference to the store and returns the reference object.
55
- # If the object provided is not a PDF::Core::Reference, one is created from the
56
- # arguments provided.
57
- #
58
- def push(*args, &block)
59
- reference = if args.first.is_a?(PDF::Core::Reference)
60
- args.first
61
- else
62
- PDF::Core::Reference.new(*args, &block)
63
- end
64
-
65
- @objects[reference.identifier] = reference
66
- @identifiers << reference.identifier
67
- reference
68
- end
69
-
70
- alias_method :<<, :push
71
-
72
- def each
73
- @identifiers.each do |id|
74
- yield @objects[id]
75
- end
76
- end
77
-
78
- def [](id)
79
- @objects[id]
80
- end
81
-
82
- def size
83
- @identifiers.size
84
- end
85
- alias_method :length, :size
86
-
87
- def compact
88
- # Clear live markers
89
- each { |o| o.live = false }
90
-
91
- # Recursively mark reachable objects live, starting from the roots
92
- # (the only objects referenced in the trailer)
93
- root.mark_live
94
- info.mark_live
95
-
96
- # Renumber live objects to eliminate gaps (shrink the xref table)
97
- if @objects.any?{ |_, o| !o.live }
98
- new_id = 1
99
- new_objects = {}
100
- new_identifiers = []
101
-
102
- each do |obj|
103
- if obj.live
104
- obj.identifier = new_id
105
- new_objects[new_id] = obj
106
- new_identifiers << new_id
107
- new_id += 1
108
- end
109
- end
110
-
111
- @objects = new_objects
112
- @identifiers = new_identifiers
113
- end
114
- end
115
-
116
- # returns the object ID for a particular page in the document. Pages
117
- # are indexed starting at 1 (not 0!).
118
- #
119
- # object_id_for_page(1)
120
- # => 5
121
- # object_id_for_page(10)
122
- # => 87
123
- # object_id_for_page(-11)
124
- # => 17
125
- #
126
- def object_id_for_page(k)
127
- k -= 1 if k > 0
128
- flat_page_ids = get_page_objects(pages).flatten
129
- flat_page_ids[k]
130
- end
131
-
132
- # imports all objects required to render a page from another PDF. The
133
- # objects are added to the current object store, but NOT linked
134
- # anywhere.
135
- #
136
- # The object ID of the root Page object is returned, it's up to the
137
- # calling code to link that into the document structure somewhere. If
138
- # this isn't done the imported objects will just be removed when the
139
- # store is compacted.
140
- #
141
- # Imports nothing and returns nil if the requested page number doesn't
142
- # exist. page_num is 1 indexed, so 1 indicates the first page.
143
- #
144
- def import_page(input, page_num)
145
- @loaded_objects = {}
146
- if template_id = indexed_template(input, page_num)
147
- return template_id
148
- end
149
-
150
- io = if input.respond_to?(:seek) && input.respond_to?(:read)
151
- input
152
- elsif File.file?(input.to_s)
153
- StringIO.new(File.binread(input.to_s))
154
- else
155
- raise ArgumentError, "input must be an IO-like object or a filename"
156
- end
157
-
158
- # unless File.file?(filename)
159
- # raise ArgumentError, "#{filename} does not exist"
160
- # end
161
-
162
- hash = indexed_hash(input, io)
163
- ref = hash.page_references[page_num - 1]
164
-
165
- if ref.nil?
166
- nil
167
- else
168
- index_template(input, page_num, load_object_graph(hash, ref).identifier)
169
- end
170
-
171
- rescue PDF::Reader::MalformedPDFError, PDF::Reader::InvalidObjectError => e
172
- msg = "Error reading template file. If you are sure it's a valid PDF, it may be a bug.\n#{e.message}"
173
- raise PDF::Core::Errors::TemplateError, msg
174
- rescue PDF::Reader::UnsupportedFeatureError
175
- msg = "Template file contains unsupported PDF features"
176
- raise PDF::Core::Errors::TemplateError, msg
177
- end
178
-
179
- private
180
-
181
- # An index for page templates so that their loaded object graph
182
- # can be reused without multiple loading
183
- def template_index
184
- @template_index ||= {}
185
- end
186
-
187
- # An index for the read object hash of a pdf template so that the
188
- # object hash does not need to be parsed multiple times when using
189
- # different pages of the pdf as page templates
190
- def hash_index
191
- @hash_index ||= {}
192
- end
193
-
194
- # returns the indexed object graph identifier for a template page if
195
- # it exists
196
- def indexed_template(input, page_number)
197
- key = indexing_key(input)
198
- template_index[key] && template_index[key][page_number]
199
- end
200
-
201
- # indexes the identifier for a page from a template
202
- def index_template(input, page_number, id)
203
- (template_index[indexing_key(input)] ||= {})[page_number] ||= id
204
- end
205
-
206
- # reads and indexes a new IO for a template
207
- # if the IO has been indexed already then the parsed object hash
208
- # is returned directly
209
- def indexed_hash(input, io)
210
- hash_index[indexing_key(input)] ||= PDF::Reader::ObjectHash.new(io)
211
- end
212
-
213
- # the index key for the input.
214
- # uses object_id so that both a string filename or an IO stream can be
215
- # indexed and reused provided the same object gets used in multiple page
216
- # template calls.
217
- def indexing_key(input)
218
- input.object_id
219
- end
220
-
221
- # returns a nested array of object IDs for all pages in this object store.
222
- #
223
- def get_page_objects(obj)
224
- if obj.data[:Type] == :Page
225
- obj.identifier
226
- elsif obj.data[:Type] == :Pages
227
- obj.data[:Kids].map { |kid| get_page_objects(kid) }
228
- end
229
- end
230
-
231
- # takes a source PDF and uses it as a template for this document.
232
- #
233
- def load_file(template)
234
- unless (template.respond_to?(:seek) && template.respond_to?(:read)) ||
235
- File.file?(template)
236
- raise ArgumentError, "#{template} does not exist"
237
- end
238
-
239
- hash = PDF::Reader::ObjectHash.new(template)
240
- src_info = hash.trailer[:Info]
241
- src_root = hash.trailer[:Root]
242
- @min_version = hash.pdf_version.to_f
243
-
244
- if hash.trailer[:Encrypt]
245
- msg = "Template file is an encrypted PDF, it can't be used as a template"
246
- raise PDF::Core::Errors::TemplateError, msg
247
- end
248
-
249
- if src_info
250
- @info = load_object_graph(hash, src_info).identifier
251
- end
252
-
253
- if src_root
254
- @root = load_object_graph(hash, src_root).identifier
255
- end
256
- rescue PDF::Reader::MalformedPDFError, PDF::Reader::InvalidObjectError => e
257
- msg = "Error reading template file. If you are sure it's a valid PDF, it may be a bug.\n#{e.message}"
258
- raise PDF::Core::Errors::TemplateError, msg
259
- rescue PDF::Reader::UnsupportedFeatureError
260
- msg = "Template file contains unsupported PDF features"
261
- raise PDF::Core::Errors::TemplateError, msg
262
- end
263
-
264
- # recurse down an object graph from a source PDF, importing all the
265
- # indirect objects we find.
266
- #
267
- # hash is the PDF::Reader::ObjectHash to extract objects from, object is
268
- # the object to extract.
269
- #
270
- def load_object_graph(hash, object)
271
- @loaded_objects ||= {}
272
- case object
273
- when ::Hash then
274
- object.each { |key,value| object[key] = load_object_graph(hash, value) }
275
- object
276
- when Array then
277
- object.map { |item| load_object_graph(hash, item)}
278
- when PDF::Reader::Reference then
279
- unless @loaded_objects.has_key?(object.id)
280
- @loaded_objects[object.id] = ref(nil)
281
- new_obj = load_object_graph(hash, hash[object])
282
- if new_obj.kind_of?(PDF::Reader::Stream)
283
- stream_dict = load_object_graph(hash, new_obj.hash)
284
- @loaded_objects[object.id].data = stream_dict
285
- @loaded_objects[object.id] << new_obj.data
286
- else
287
- @loaded_objects[object.id].data = new_obj
288
- end
289
- end
290
- @loaded_objects[object.id]
291
- when PDF::Reader::Stream
292
- # Stream is a subclass of string, so this is here to prevent the stream
293
- # being wrapped in a LiteralString
294
- object
295
- when String
296
- is_utf8?(object) ? object : PDF::Core::ByteString.new(object)
297
- else
298
- object
299
- end
300
- end
301
-
302
- ruby_18 do
303
- def is_utf8?(str)
304
- begin
305
- str.unpack("U*")
306
- true
307
- rescue
308
- false
309
- end
310
- end
311
- end
312
- ruby_19 do
313
- def is_utf8?(str)
314
- str.force_encoding("utf-8")
315
- str.valid_encoding?
316
- end
317
- end
318
- end
319
- end
320
- end