davebenvenuti-prawn 0.11.1.pre

Sign up to get free protection for your applications and to get access to all the features.
Files changed (291) hide show
  1. data/COPYING +340 -0
  2. data/HACKING +50 -0
  3. data/LICENSE +56 -0
  4. data/README +141 -0
  5. data/Rakefile +52 -0
  6. data/data/encodings/win_ansi.txt +29 -0
  7. data/data/fonts/Action Man.dfont +0 -0
  8. data/data/fonts/Activa.ttf +0 -0
  9. data/data/fonts/Chalkboard.ttf +0 -0
  10. data/data/fonts/Courier-Bold.afm +342 -0
  11. data/data/fonts/Courier-BoldOblique.afm +342 -0
  12. data/data/fonts/Courier-Oblique.afm +342 -0
  13. data/data/fonts/Courier.afm +342 -0
  14. data/data/fonts/DejaVuSans.ttf +0 -0
  15. data/data/fonts/Dustismo_Roman.ttf +0 -0
  16. data/data/fonts/Helvetica-Bold.afm +2827 -0
  17. data/data/fonts/Helvetica-BoldOblique.afm +2827 -0
  18. data/data/fonts/Helvetica-Oblique.afm +3051 -0
  19. data/data/fonts/Helvetica.afm +3051 -0
  20. data/data/fonts/MustRead.html +19 -0
  21. data/data/fonts/Symbol.afm +213 -0
  22. data/data/fonts/Times-Bold.afm +2588 -0
  23. data/data/fonts/Times-BoldItalic.afm +2384 -0
  24. data/data/fonts/Times-Italic.afm +2667 -0
  25. data/data/fonts/Times-Roman.afm +2419 -0
  26. data/data/fonts/ZapfDingbats.afm +225 -0
  27. data/data/fonts/comicsans.ttf +0 -0
  28. data/data/fonts/gkai00mp.ttf +0 -0
  29. data/data/images/16bit.alpha +0 -0
  30. data/data/images/16bit.dat +0 -0
  31. data/data/images/16bit.png +0 -0
  32. data/data/images/arrow.png +0 -0
  33. data/data/images/arrow2.png +0 -0
  34. data/data/images/barcode_issue.png +0 -0
  35. data/data/images/dice.alpha +0 -0
  36. data/data/images/dice.dat +0 -0
  37. data/data/images/dice.png +0 -0
  38. data/data/images/dice_interlaced.png +0 -0
  39. data/data/images/fractal.jpg +0 -0
  40. data/data/images/letterhead.jpg +0 -0
  41. data/data/images/page_white_text.alpha +0 -0
  42. data/data/images/page_white_text.dat +0 -0
  43. data/data/images/page_white_text.png +0 -0
  44. data/data/images/pigs.jpg +0 -0
  45. data/data/images/rails.dat +0 -0
  46. data/data/images/rails.png +0 -0
  47. data/data/images/ruport.png +0 -0
  48. data/data/images/ruport_data.dat +0 -0
  49. data/data/images/ruport_transparent.png +0 -0
  50. data/data/images/ruport_type0.png +0 -0
  51. data/data/images/stef.jpg +0 -0
  52. data/data/images/tru256.bmp +0 -0
  53. data/data/images/web-links.dat +1 -0
  54. data/data/images/web-links.png +0 -0
  55. data/data/pdfs/complex_template.pdf +0 -0
  56. data/data/pdfs/contains_ttf_font.pdf +0 -0
  57. data/data/pdfs/encrypted.pdf +0 -0
  58. data/data/pdfs/hexagon.pdf +61 -0
  59. data/data/pdfs/indirect_reference.pdf +86 -0
  60. data/data/pdfs/nested_pages.pdf +118 -0
  61. data/data/pdfs/page_without_mediabox.pdf +193 -0
  62. data/data/pdfs/resources_as_indirect_object.pdf +83 -0
  63. data/data/pdfs/two_hexagons.pdf +90 -0
  64. data/data/pdfs/version_1_6.pdf +61 -0
  65. data/data/shift_jis_text.txt +1 -0
  66. data/examples/bounding_box/bounding_boxes.rb +44 -0
  67. data/examples/bounding_box/indentation.rb +35 -0
  68. data/examples/bounding_box/russian_boxes.rb +37 -0
  69. data/examples/bounding_box/stretched_nesting.rb +68 -0
  70. data/examples/example_helper.rb +8 -0
  71. data/examples/general/background.rb +24 -0
  72. data/examples/general/canvas.rb +16 -0
  73. data/examples/general/context_sensitive_headers.rb +38 -0
  74. data/examples/general/float.rb +12 -0
  75. data/examples/general/margin.rb +37 -0
  76. data/examples/general/measurement_units.rb +52 -0
  77. data/examples/general/metadata-info.rb +17 -0
  78. data/examples/general/multi_page_layout.rb +19 -0
  79. data/examples/general/outlines.rb +67 -0
  80. data/examples/general/page_geometry.rb +32 -0
  81. data/examples/general/page_numbering.rb +16 -0
  82. data/examples/general/repeaters.rb +48 -0
  83. data/examples/general/stamp.rb +42 -0
  84. data/examples/general/templates.rb +14 -0
  85. data/examples/graphics/basic_images.rb +24 -0
  86. data/examples/graphics/cmyk.rb +13 -0
  87. data/examples/graphics/curves.rb +12 -0
  88. data/examples/graphics/hexagon.rb +14 -0
  89. data/examples/graphics/image_fit.rb +16 -0
  90. data/examples/graphics/image_flow.rb +38 -0
  91. data/examples/graphics/image_position.rb +18 -0
  92. data/examples/graphics/line.rb +33 -0
  93. data/examples/graphics/png_types.rb +23 -0
  94. data/examples/graphics/polygons.rb +17 -0
  95. data/examples/graphics/remote_images.rb +13 -0
  96. data/examples/graphics/rounded_polygons.rb +20 -0
  97. data/examples/graphics/rounded_rectangle.rb +21 -0
  98. data/examples/graphics/ruport_style_helpers.rb +20 -0
  99. data/examples/graphics/stroke_bounds.rb +21 -0
  100. data/examples/graphics/stroke_cap_and_join.rb +46 -0
  101. data/examples/graphics/stroke_dash.rb +43 -0
  102. data/examples/graphics/transformations.rb +53 -0
  103. data/examples/graphics/transparency.rb +27 -0
  104. data/examples/grid/bounding_boxes.rb +22 -0
  105. data/examples/grid/column_gutter_grid.rb +21 -0
  106. data/examples/grid/multi_boxes.rb +52 -0
  107. data/examples/grid/show_grid.rb +14 -0
  108. data/examples/grid/simple_grid.rb +21 -0
  109. data/examples/m17n/chinese_text_wrapping.rb +18 -0
  110. data/examples/m17n/euro.rb +16 -0
  111. data/examples/m17n/sjis.rb +29 -0
  112. data/examples/m17n/utf8.rb +14 -0
  113. data/examples/m17n/win_ansi_charset.rb +55 -0
  114. data/examples/security/hello_foo.rb +9 -0
  115. data/examples/table/bill.rb +54 -0
  116. data/examples/table/cell.rb +13 -0
  117. data/examples/table/checkerboard.rb +23 -0
  118. data/examples/table/header.rb +15 -0
  119. data/examples/table/inline_format_table.rb +13 -0
  120. data/examples/table/multi_page_table.rb +10 -0
  121. data/examples/table/simple_table.rb +25 -0
  122. data/examples/table/subtable.rb +13 -0
  123. data/examples/table/widths.rb +21 -0
  124. data/examples/text/alignment.rb +19 -0
  125. data/examples/text/character_spacing.rb +13 -0
  126. data/examples/text/dfont.rb +49 -0
  127. data/examples/text/family_based_styling.rb +25 -0
  128. data/examples/text/font_calculations.rb +92 -0
  129. data/examples/text/font_size.rb +34 -0
  130. data/examples/text/hyphenation.rb +46 -0
  131. data/examples/text/indent_paragraphs.rb +23 -0
  132. data/examples/text/inline_format.rb +104 -0
  133. data/examples/text/kerning.rb +31 -0
  134. data/examples/text/rotated.rb +99 -0
  135. data/examples/text/shaped_text_box.rb +32 -0
  136. data/examples/text/simple_text.rb +18 -0
  137. data/examples/text/simple_text_ttf.rb +18 -0
  138. data/examples/text/span.rb +30 -0
  139. data/examples/text/text_box.rb +89 -0
  140. data/examples/text/text_box_returning_excess.rb +52 -0
  141. data/examples/text/text_flow.rb +68 -0
  142. data/lib/prawn.rb +26 -0
  143. data/lib/prawn/compatibility.rb +51 -0
  144. data/lib/prawn/core.rb +85 -0
  145. data/lib/prawn/core/annotations.rb +61 -0
  146. data/lib/prawn/core/byte_string.rb +9 -0
  147. data/lib/prawn/core/destinations.rb +90 -0
  148. data/lib/prawn/core/document_state.rb +78 -0
  149. data/lib/prawn/core/literal_string.rb +16 -0
  150. data/lib/prawn/core/name_tree.rb +165 -0
  151. data/lib/prawn/core/object_store.rb +236 -0
  152. data/lib/prawn/core/page.rb +199 -0
  153. data/lib/prawn/core/pdf_object.rb +108 -0
  154. data/lib/prawn/core/reference.rb +112 -0
  155. data/lib/prawn/core/text.rb +140 -0
  156. data/lib/prawn/core/text/formatted/arranger.rb +266 -0
  157. data/lib/prawn/core/text/formatted/line_wrap.rb +127 -0
  158. data/lib/prawn/core/text/formatted/wrap.rb +112 -0
  159. data/lib/prawn/core/text/line_wrap.rb +211 -0
  160. data/lib/prawn/core/text/wrap.rb +82 -0
  161. data/lib/prawn/document.rb +575 -0
  162. data/lib/prawn/document/bounding_box.rb +428 -0
  163. data/lib/prawn/document/graphics_state.rb +48 -0
  164. data/lib/prawn/document/internals.rb +170 -0
  165. data/lib/prawn/document/page_geometry.rb +136 -0
  166. data/lib/prawn/document/snapshot.rb +87 -0
  167. data/lib/prawn/document/span.rb +55 -0
  168. data/lib/prawn/encoding.rb +121 -0
  169. data/lib/prawn/errors.rb +86 -0
  170. data/lib/prawn/font.rb +368 -0
  171. data/lib/prawn/font/afm.rb +225 -0
  172. data/lib/prawn/font/dfont.rb +42 -0
  173. data/lib/prawn/font/ttf.rb +350 -0
  174. data/lib/prawn/graphics.rb +325 -0
  175. data/lib/prawn/graphics/cap_style.rb +38 -0
  176. data/lib/prawn/graphics/color.rb +205 -0
  177. data/lib/prawn/graphics/dash.rb +71 -0
  178. data/lib/prawn/graphics/join_style.rb +38 -0
  179. data/lib/prawn/graphics/transformation.rb +156 -0
  180. data/lib/prawn/graphics/transparency.rb +99 -0
  181. data/lib/prawn/images.rb +217 -0
  182. data/lib/prawn/images/jpg.rb +85 -0
  183. data/lib/prawn/images/png.rb +356 -0
  184. data/lib/prawn/layout.rb +20 -0
  185. data/lib/prawn/layout/grid.rb +259 -0
  186. data/lib/prawn/measurement_extensions.rb +46 -0
  187. data/lib/prawn/measurements.rb +71 -0
  188. data/lib/prawn/outline.rb +326 -0
  189. data/lib/prawn/repeater.rb +129 -0
  190. data/lib/prawn/security.rb +262 -0
  191. data/lib/prawn/security/arcfour.rb +51 -0
  192. data/lib/prawn/stamp.rb +126 -0
  193. data/lib/prawn/table.rb +451 -0
  194. data/lib/prawn/table/cell.rb +395 -0
  195. data/lib/prawn/table/cell/in_table.rb +27 -0
  196. data/lib/prawn/table/cell/subtable.rb +65 -0
  197. data/lib/prawn/table/cell/text.rb +135 -0
  198. data/lib/prawn/table/cells.rb +206 -0
  199. data/lib/prawn/text.rb +449 -0
  200. data/lib/prawn/text/box.rb +397 -0
  201. data/lib/prawn/text/formatted.rb +4 -0
  202. data/lib/prawn/text/formatted/box.rb +222 -0
  203. data/lib/prawn/text/formatted/fragment.rb +181 -0
  204. data/lib/prawn/text/formatted/parser.rb +213 -0
  205. data/prawn.gemspec +28 -0
  206. data/spec/annotations_spec.rb +90 -0
  207. data/spec/bounding_box_spec.rb +190 -0
  208. data/spec/cell_spec.rb +430 -0
  209. data/spec/destinations_spec.rb +15 -0
  210. data/spec/document_spec.rb +476 -0
  211. data/spec/extensions/mocha.rb +32 -0
  212. data/spec/font_spec.rb +324 -0
  213. data/spec/formatted_text_arranger_spec.rb +426 -0
  214. data/spec/formatted_text_box_spec.rb +756 -0
  215. data/spec/formatted_text_fragment_spec.rb +211 -0
  216. data/spec/graphics_spec.rb +446 -0
  217. data/spec/grid_spec.rb +85 -0
  218. data/spec/images_spec.rb +119 -0
  219. data/spec/inline_formatted_text_parser_spec.rb +502 -0
  220. data/spec/jpg_spec.rb +25 -0
  221. data/spec/line_wrap_spec.rb +341 -0
  222. data/spec/measurement_units_spec.rb +23 -0
  223. data/spec/name_tree_spec.rb +112 -0
  224. data/spec/object_store_spec.rb +160 -0
  225. data/spec/outline_spec.rb +404 -0
  226. data/spec/pdf_object_spec.rb +170 -0
  227. data/spec/png_spec.rb +237 -0
  228. data/spec/reference_spec.rb +82 -0
  229. data/spec/repeater_spec.rb +96 -0
  230. data/spec/security_spec.rb +120 -0
  231. data/spec/snapshot_spec.rb +154 -0
  232. data/spec/span_spec.rb +49 -0
  233. data/spec/spec_helper.rb +34 -0
  234. data/spec/stamp_spec.rb +108 -0
  235. data/spec/stroke_styles_spec.rb +163 -0
  236. data/spec/table_spec.rb +687 -0
  237. data/spec/template_spec.rb +165 -0
  238. data/spec/text_at_spec.rb +125 -0
  239. data/spec/text_box_spec.rb +777 -0
  240. data/spec/text_spacing_spec.rb +75 -0
  241. data/spec/text_spec.rb +349 -0
  242. data/spec/text_with_inline_formatting_spec.rb +193 -0
  243. data/spec/transparency_spec.rb +89 -0
  244. data/vendor/pdf-inspector/README +18 -0
  245. data/vendor/pdf-inspector/lib/pdf/inspector.rb +26 -0
  246. data/vendor/pdf-inspector/lib/pdf/inspector/extgstate.rb +18 -0
  247. data/vendor/pdf-inspector/lib/pdf/inspector/graphics.rb +131 -0
  248. data/vendor/pdf-inspector/lib/pdf/inspector/page.rb +25 -0
  249. data/vendor/pdf-inspector/lib/pdf/inspector/text.rb +46 -0
  250. data/vendor/pdf-inspector/lib/pdf/inspector/xobject.rb +19 -0
  251. data/vendor/ttfunk/data/fonts/DejaVuSans.ttf +0 -0
  252. data/vendor/ttfunk/data/fonts/comicsans.ttf +0 -0
  253. data/vendor/ttfunk/example.rb +45 -0
  254. data/vendor/ttfunk/lib/ttfunk.rb +102 -0
  255. data/vendor/ttfunk/lib/ttfunk/directory.rb +17 -0
  256. data/vendor/ttfunk/lib/ttfunk/encoding/mac_roman.rb +88 -0
  257. data/vendor/ttfunk/lib/ttfunk/encoding/windows_1252.rb +69 -0
  258. data/vendor/ttfunk/lib/ttfunk/reader.rb +44 -0
  259. data/vendor/ttfunk/lib/ttfunk/resource_file.rb +78 -0
  260. data/vendor/ttfunk/lib/ttfunk/subset.rb +18 -0
  261. data/vendor/ttfunk/lib/ttfunk/subset/base.rb +141 -0
  262. data/vendor/ttfunk/lib/ttfunk/subset/mac_roman.rb +50 -0
  263. data/vendor/ttfunk/lib/ttfunk/subset/unicode.rb +48 -0
  264. data/vendor/ttfunk/lib/ttfunk/subset/unicode_8bit.rb +63 -0
  265. data/vendor/ttfunk/lib/ttfunk/subset/windows_1252.rb +55 -0
  266. data/vendor/ttfunk/lib/ttfunk/subset_collection.rb +72 -0
  267. data/vendor/ttfunk/lib/ttfunk/table.rb +46 -0
  268. data/vendor/ttfunk/lib/ttfunk/table/cmap.rb +34 -0
  269. data/vendor/ttfunk/lib/ttfunk/table/cmap/format00.rb +54 -0
  270. data/vendor/ttfunk/lib/ttfunk/table/cmap/format04.rb +126 -0
  271. data/vendor/ttfunk/lib/ttfunk/table/cmap/subtable.rb +79 -0
  272. data/vendor/ttfunk/lib/ttfunk/table/glyf.rb +64 -0
  273. data/vendor/ttfunk/lib/ttfunk/table/glyf/compound.rb +81 -0
  274. data/vendor/ttfunk/lib/ttfunk/table/glyf/simple.rb +37 -0
  275. data/vendor/ttfunk/lib/ttfunk/table/head.rb +44 -0
  276. data/vendor/ttfunk/lib/ttfunk/table/hhea.rb +41 -0
  277. data/vendor/ttfunk/lib/ttfunk/table/hmtx.rb +47 -0
  278. data/vendor/ttfunk/lib/ttfunk/table/kern.rb +79 -0
  279. data/vendor/ttfunk/lib/ttfunk/table/kern/format0.rb +62 -0
  280. data/vendor/ttfunk/lib/ttfunk/table/loca.rb +43 -0
  281. data/vendor/ttfunk/lib/ttfunk/table/maxp.rb +40 -0
  282. data/vendor/ttfunk/lib/ttfunk/table/name.rb +125 -0
  283. data/vendor/ttfunk/lib/ttfunk/table/os2.rb +78 -0
  284. data/vendor/ttfunk/lib/ttfunk/table/post.rb +91 -0
  285. data/vendor/ttfunk/lib/ttfunk/table/post/format10.rb +43 -0
  286. data/vendor/ttfunk/lib/ttfunk/table/post/format20.rb +35 -0
  287. data/vendor/ttfunk/lib/ttfunk/table/post/format25.rb +23 -0
  288. data/vendor/ttfunk/lib/ttfunk/table/post/format30.rb +17 -0
  289. data/vendor/ttfunk/lib/ttfunk/table/post/format40.rb +17 -0
  290. data/vendor/ttfunk/lib/ttfunk/table/simple.rb +14 -0
  291. metadata +379 -0
@@ -0,0 +1,170 @@
1
+ # encoding: utf-8
2
+ #
3
+ # internals.rb : Implements document internals for Prawn
4
+ #
5
+ # Copyright August 2008, Gregory Brown. All Rights Reserved.
6
+ #
7
+ # This is free software. Please see the LICENSE and COPYING files for details.
8
+
9
+ module Prawn
10
+ class Document
11
+
12
+ # This module exposes a few low-level PDF features for those who want
13
+ # to extend Prawn's core functionality. If you are not comfortable with
14
+ # low level PDF functionality as defined by Adobe's specification, chances
15
+ # are you won't need anything you find here.
16
+ #
17
+ module Internals
18
+
19
+ # Creates a new Prawn::Reference and adds it to the Document's object
20
+ # list. The +data+ argument is anything that Prawn::PdfObject() can convert.
21
+ #
22
+ # Returns the identifier which points to the reference in the ObjectStore
23
+ #
24
+ def ref(data)
25
+ ref!(data).identifier
26
+ end
27
+
28
+ # Like ref, but returns the actual reference instead of its identifier.
29
+ #
30
+ # While you can use this to build up nested references within the object
31
+ # tree, it is recommended to persist only identifiers, and them provide
32
+ # helper methods to look up the actual references in the ObjectStore
33
+ # if needed. If you take this approach, Prawn::Document::Snapshot
34
+ # will probably work with your extension
35
+ #
36
+ def ref!(data)
37
+ state.store.ref(data)
38
+ end
39
+
40
+ # At any stage in the object tree an object can be replaced with an
41
+ # indirect reference. To get access to the object safely, regardless
42
+ # of if it's hidden behind a Prawn::Reference, wrap it in deref().
43
+ #
44
+ def deref(obj)
45
+ obj.is_a?(Prawn::Core::Reference) ? obj.data : obj
46
+ end
47
+
48
+ # Appends a raw string to the current page content.
49
+ #
50
+ # # Raw line drawing example:
51
+ # x1,y1,x2,y2 = 100,500,300,550
52
+ # pdf.add_content("%.3f %.3f m" % [ x1, y1 ]) # move
53
+ # pdf.add_content("%.3f %.3f l" % [ x2, y2 ]) # draw path
54
+ # pdf.add_content("S") # stroke
55
+ #
56
+ def add_content(str)
57
+ state.page.content << str << "\n"
58
+ end
59
+
60
+ # The Name dictionary (PDF spec 3.6.3) for this document. It is
61
+ # lazily initialized, so that documents that do not need a name
62
+ # dictionary do not incur the additional overhead.
63
+ #
64
+ def names
65
+ state.store.root.data[:Names] ||= ref!(:Type => :Names)
66
+ end
67
+
68
+ # Returns true if the Names dictionary is in use for this document.
69
+ #
70
+ def names?
71
+ state.store.root.data[:Names]
72
+ end
73
+
74
+ # Defines a block to be called just before the document is rendered.
75
+ #
76
+ def before_render(&block)
77
+ state.before_render_callbacks << block
78
+ end
79
+
80
+ # Defines a block to be called just before a new page is started.
81
+ #
82
+ def on_page_create(&block)
83
+ if block_given?
84
+ state.on_page_create_callback = block
85
+ else
86
+ state.on_page_create_callback = nil
87
+ end
88
+ end
89
+
90
+ private
91
+
92
+ # adds a new, empty content stream to each page. Used in templating so
93
+ # that imported content streams can be left pristine
94
+ #
95
+ def fresh_content_streams(options={})
96
+ (1..page_count).each do |i|
97
+ go_to_page i
98
+ state.page.new_content_stream
99
+ apply_margin_options(options)
100
+ use_graphic_settings
101
+ save_graphics_state
102
+ end
103
+ end
104
+
105
+ def finalize_all_page_contents
106
+ (1..page_count).each do |i|
107
+ go_to_page i
108
+ repeaters.each { |r| r.run(i) }
109
+ restore_graphics_state
110
+ state.page.finalize
111
+ end
112
+ end
113
+
114
+ # raise the PDF version of the file we're going to generate.
115
+ # A private method, designed for internal use when the user adds a feature
116
+ # to their document that requires a particular version.
117
+ #
118
+ def min_version(min)
119
+ state.version = min if min > state.version
120
+ end
121
+
122
+ # Write out the PDF Header, as per spec 3.4.1
123
+ #
124
+ def render_header(output)
125
+ state.before_render_actions(self)
126
+
127
+ # pdf version
128
+ output << "%PDF-#{state.version}\n"
129
+
130
+ # 4 binary chars, as recommended by the spec
131
+ output << "%\xFF\xFF\xFF\xFF\n"
132
+ end
133
+
134
+ # Write out the PDF Body, as per spec 3.4.2
135
+ #
136
+ def render_body(output)
137
+ state.render_body(output)
138
+ end
139
+
140
+ # Write out the PDF Cross Reference Table, as per spec 3.4.3
141
+ #
142
+ def render_xref(output)
143
+ @xref_offset = output.size
144
+ output << "xref\n"
145
+ output << "0 #{state.store.size + 1}\n"
146
+ output << "0000000000 65535 f \n"
147
+ state.store.each do |ref|
148
+ output.printf("%010d", ref.offset)
149
+ output << " 00000 n \n"
150
+ end
151
+ end
152
+
153
+ # Write out the PDF Trailer, as per spec 3.4.4
154
+ #
155
+ def render_trailer(output)
156
+ trailer_hash = {:Size => state.store.size + 1,
157
+ :Root => state.store.root,
158
+ :Info => state.store.info}
159
+ trailer_hash.merge!(state.trailer) if state.trailer
160
+
161
+ output << "trailer\n"
162
+ output << Prawn::Core::PdfObject(trailer_hash) << "\n"
163
+ output << "startxref\n"
164
+ output << @xref_offset << "\n"
165
+ output << "%%EOF" << "\n"
166
+ end
167
+
168
+ end
169
+ end
170
+ end
@@ -0,0 +1,136 @@
1
+ # encoding: utf-8
2
+
3
+ # page_geometry.rb : Describes PDF page geometries
4
+ #
5
+ # Copyright April 2008, Gregory Brown. All Rights Reserved.
6
+ #
7
+ # This is free software. Please see the LICENSE and COPYING files for details.
8
+
9
+ module Prawn
10
+ class Document
11
+
12
+ # Dimensions pulled from PDF::Writer, rubyforge.org/projects/ruby-pdf
13
+ #
14
+ # All of these dimensions are in PDF Points, see Prawn::Measurements for
15
+ # conversion utilities.
16
+ #
17
+ # Additionally, if the size you are after is not listed below, you can always
18
+ # specify your size by passing an array of width and height to Prawn::Document.new
19
+ # like:
20
+ #
21
+ # Prawn::Document.new(:page_size => [1000, 20000])
22
+ #
23
+ # The sizes below can be used by passing the appropriate string to :size:
24
+ #
25
+ # Prawn::Document.new(:page_size => '2A0')
26
+ #
27
+ # ===Inbuilt Sizes:
28
+ #
29
+ #
30
+ # 4A0:: => 4767.87 x 6740.79
31
+ # 2A0:: => 3370.39 x 4767.87
32
+ # A0:: => 2383.94 x 3370.39
33
+ # A1:: => 1683.78 x 2383.94
34
+ # A2:: => 1190.55 x 1683.78
35
+ # A3:: => 841.89 x 1190.55
36
+ # A4:: => 595.28 x 841.89
37
+ # A5:: => 419.53 x 595.28
38
+ # A6:: => 297.64 x 419.53
39
+ # A7:: => 209.76 x 297.64
40
+ # A8:: => 147.40 x 209.76
41
+ # A9:: => 104.88 x 147.40
42
+ # A10:: => 73.70 x 104.88
43
+ # B0:: => 2834.65 x 4008.19
44
+ # B1:: => 2004.09 x 2834.65
45
+ # B2:: => 1417.32 x 2004.09
46
+ # B3:: => 1000.63 x 1417.32
47
+ # B4:: => 708.66 x 1000.63
48
+ # B5:: => 498.90 x 708.66
49
+ # B6:: => 354.33 x 498.90
50
+ # B7:: => 249.45 x 354.33
51
+ # B8:: => 175.75 x 249.45
52
+ # B9:: => 124.72 x 175.75
53
+ # B10:: => 87.87 x 124.72
54
+ # C0:: => 2599.37 x 3676.54
55
+ # C1:: => 1836.85 x 2599.37
56
+ # C2:: => 1298.27 x 1836.85
57
+ # C3:: => 918.43 x 1298.27
58
+ # C4:: => 649.13 x 918.43
59
+ # C5:: => 459.21 x 649.13
60
+ # C6:: => 323.15 x 459.21
61
+ # C7:: => 229.61 x 323.15
62
+ # C8:: => 161.57 x 229.61
63
+ # C9:: => 113.39 x 161.57
64
+ # C10:: => 79.37 x 113.39
65
+ # RA0:: => 2437.80 x 3458.27
66
+ # RA1:: => 1729.13 x 2437.80
67
+ # RA2:: => 1218.90 x 1729.13
68
+ # RA3:: => 864.57 x 1218.90
69
+ # RA4:: => 609.45 x 864.57
70
+ # SRA0:: => 2551.18 x 3628.35
71
+ # SRA1:: => 1814.17 x 2551.18
72
+ # SRA2:: => 1275.59 x 1814.17
73
+ # SRA3:: => 907.09 x 1275.59
74
+ # SRA4:: => 637.80 x 907.09
75
+ # EXECUTIVE:: => 521.86 x 756.00
76
+ # FOLIO:: => 612.00 x 936.00
77
+ # LEGAL:: => 612.00 x 1008.00
78
+ # LETTER:: => 612.00 x 792.00
79
+ # TABLOID:: => 792.00 x 1224.00
80
+ #
81
+ module PageGeometry
82
+
83
+ SIZES = { "4A0" => [4767.87, 6740.79],
84
+ "2A0" => [3370.39, 4767.87],
85
+ "A0" => [2383.94, 3370.39],
86
+ "A1" => [1683.78, 2383.94],
87
+ "A2" => [1190.55, 1683.78],
88
+ "A3" => [841.89, 1190.55],
89
+ "A4" => [595.28, 841.89],
90
+ "A5" => [419.53, 595.28],
91
+ "A6" => [297.64, 419.53],
92
+ "A7" => [209.76, 297.64],
93
+ "A8" => [147.40, 209.76],
94
+ "A9" => [104.88, 147.40],
95
+ "A10" => [73.70, 104.88],
96
+ "B0" => [2834.65, 4008.19],
97
+ "B1" => [2004.09, 2834.65],
98
+ "B2" => [1417.32, 2004.09],
99
+ "B3" => [1000.63, 1417.32],
100
+ "B4" => [708.66, 1000.63],
101
+ "B5" => [498.90, 708.66],
102
+ "B6" => [354.33, 498.90],
103
+ "B7" => [249.45, 354.33],
104
+ "B8" => [175.75, 249.45],
105
+ "B9" => [124.72, 175.75],
106
+ "B10" => [87.87, 124.72],
107
+ "C0" => [2599.37, 3676.54],
108
+ "C1" => [1836.85, 2599.37],
109
+ "C2" => [1298.27, 1836.85],
110
+ "C3" => [918.43, 1298.27],
111
+ "C4" => [649.13, 918.43],
112
+ "C5" => [459.21, 649.13],
113
+ "C6" => [323.15, 459.21],
114
+ "C7" => [229.61, 323.15],
115
+ "C8" => [161.57, 229.61],
116
+ "C9" => [113.39, 161.57],
117
+ "C10" => [79.37, 113.39],
118
+ "RA0" => [2437.80, 3458.27],
119
+ "RA1" => [1729.13, 2437.80],
120
+ "RA2" => [1218.90, 1729.13],
121
+ "RA3" => [864.57, 1218.90],
122
+ "RA4" => [609.45, 864.57],
123
+ "SRA0" => [2551.18, 3628.35],
124
+ "SRA1" => [1814.17, 2551.18],
125
+ "SRA2" => [1275.59, 1814.17],
126
+ "SRA3" => [907.09, 1275.59],
127
+ "SRA4" => [637.80, 907.09],
128
+ "EXECUTIVE" => [521.86, 756.00],
129
+ "FOLIO" => [612.00, 936.00],
130
+ "LEGAL" => [612.00, 1008.00],
131
+ "LETTER" => [612.00, 792.00],
132
+ "TABLOID" => [792.00, 1224.00] }
133
+
134
+ end
135
+ end
136
+ end
@@ -0,0 +1,87 @@
1
+ # encoding: utf-8
2
+
3
+ # snapshot.rb : Implements transactional rendering for Prawn
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
+ require 'delegate'
10
+
11
+ module Prawn
12
+ class Document
13
+ module Snapshot
14
+
15
+ RollbackTransaction = Class.new(StandardError)
16
+
17
+ # Call this within a +transaction+ block to roll back the transaction and
18
+ # prevent any of its data from being rendered. You must reset the
19
+ # y-position yourself if you have performed any drawing operations that
20
+ # modify it.
21
+ #
22
+ def rollback
23
+ raise RollbackTransaction
24
+ end
25
+
26
+ # Run a block of drawing operations, to be completed atomically. If
27
+ # +rollback+ is called or a RollbackTransaction exception is raised
28
+ # inside the block, all actions taken inside the block will be rolled
29
+ # back (with the exception of y-position, which you must restore
30
+ # yourself).
31
+ #
32
+ # Returns true on success, or false if the transaction was rolled back.
33
+ #
34
+ def transaction
35
+ snap = take_snapshot
36
+ yield
37
+ true
38
+ rescue RollbackTransaction
39
+ restore_snapshot(snap)
40
+ false
41
+ end
42
+
43
+ private
44
+
45
+ # Takes a current snapshot of the document's state, sufficient to
46
+ # reconstruct it after it was amended.
47
+ #
48
+ def take_snapshot
49
+ # current_page holds a ref to the Pages dictionary which grows
50
+ # monotonically as data is added to the document, so we share that
51
+ # between the old and new copies.
52
+ {:page_content => state.page.content.deep_copy,
53
+ :current_page => state.page.dictionary.deep_copy(share=[:Parent]),
54
+ :page_number => page_number,
55
+ :page_kids => state.store.pages.data[:Kids].map{|kid| kid.identifier},
56
+ :dests => names? &&
57
+ Marshal.load(Marshal.dump(names.data[:Dests]))}
58
+ end
59
+
60
+ # Rolls the page state back to the state of the given snapshot.
61
+ #
62
+ def restore_snapshot(shot)
63
+ page = state.page
64
+ # Because these objects are referenced by identifier from the Pages
65
+ # dictionary, we can't just restore them over the current refs in
66
+ # page_content and current_page. We have to restore them over the old
67
+ # ones.
68
+ page.content = shot[:page_content].identifier
69
+ page.content.replace shot[:page_content]
70
+
71
+ page.dictionary = shot[:current_page].identifier
72
+ page.dictionary.replace shot[:current_page]
73
+ page.dictionary.data[:Contents] = page.content
74
+
75
+ self.page_number = shot[:page_number]
76
+
77
+ state.store.pages.data[:Kids] = shot[:page_kids].map{|id| state.store[id]}
78
+ state.store.pages.data[:Count] = shot[:page_kids].size
79
+
80
+ if shot[:dests]
81
+ names.data[:Dests] = shot[:dests]
82
+ end
83
+ end
84
+
85
+ end
86
+ end
87
+ end
@@ -0,0 +1,55 @@
1
+ # encoding: utf-8
2
+
3
+ # span.rb : Implements text columns
4
+ #
5
+ # Copyright September 2008, Gregory Brown. All Rights Reserved.
6
+ #
7
+ # This is free software. Please see the LICENSE and COPYING files for details.
8
+
9
+ module Prawn
10
+ class Document
11
+ # A span is a special purpose bounding box that allows a column of
12
+ # elements to be positioned relative to the margin_box.
13
+ #
14
+ # Arguments:
15
+ # +width+:: The width of the column in PDF points
16
+ #
17
+ # Options:
18
+ # <tt>:position</tt>:: One of :left, :center, :right or an x offset
19
+ #
20
+ # This method is typically used for flowing a column of text from one
21
+ # page to the next.
22
+ #
23
+ # span(350, :position => :center) do
24
+ # text "Here's some centered text in a 350 point column. " * 100
25
+ # end
26
+ #
27
+ def span(width, options={})
28
+ Prawn.verify_options [:position], options
29
+ original_position = self.y
30
+
31
+ # FIXME: Any way to move this upstream?
32
+ left_boundary = case(options[:position] || :left)
33
+ when :left
34
+ margin_box.absolute_left
35
+ when :center
36
+ margin_box.absolute_left + margin_box.width / 2.0 - width /2.0
37
+ when :right
38
+ margin_box.absolute_right - width
39
+ when Numeric
40
+ margin_box.absolute_left + options[:position]
41
+ else
42
+ raise ArgumentError, "Invalid option for :position"
43
+ end
44
+
45
+ # we need to bust out of whatever nested bounding boxes we're in.
46
+ canvas do
47
+ bounding_box([left_boundary,
48
+ margin_box.absolute_top], :width => width) do
49
+ self.y = original_position
50
+ yield
51
+ end
52
+ end
53
+ end
54
+ end
55
+ end