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,325 @@
1
+ # encoding: utf-8
2
+
3
+ # graphics.rb : Implements PDF drawing primitives
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
+ require "prawn/graphics/color"
10
+ require "prawn/graphics/dash"
11
+ require "prawn/graphics/cap_style"
12
+ require "prawn/graphics/join_style"
13
+ require "prawn/graphics/transparency"
14
+ require "prawn/graphics/transformation"
15
+
16
+ module Prawn
17
+
18
+ # Implements the drawing facilities for Prawn::Document.
19
+ # Use this to draw the most beautiful imaginable things.
20
+ #
21
+ # This file lifts and modifies several of PDF::Writer's graphics functions
22
+ # ruby-pdf.rubyforge.org
23
+ #
24
+ module Graphics
25
+
26
+ include Color
27
+ include Dash
28
+ include CapStyle
29
+ include JoinStyle
30
+ include Transparency
31
+ include Transformation
32
+
33
+ #######################################################################
34
+ # Low level drawing operations must map the point to absolute coords! #
35
+ #######################################################################
36
+
37
+ # Moves the drawing position to a given point. The point can be
38
+ # specified as a tuple or a flattened argument list
39
+ #
40
+ # pdf.move_to [100,50]
41
+ # pdf.move_to(100,50)
42
+ #
43
+ def move_to(*point)
44
+ x,y = map_to_absolute(point)
45
+ add_content("%.3f %.3f m" % [ x, y ])
46
+ end
47
+
48
+ # Draws a line from the current drawing position to the specified point.
49
+ # The destination may be described as a tuple or a flattened list:
50
+ #
51
+ # pdf.line_to [50,50]
52
+ # pdf.line_to(50,50)
53
+ #
54
+ def line_to(*point)
55
+ x,y = map_to_absolute(point)
56
+ add_content("%.3f %.3f l" % [ x, y ])
57
+ end
58
+
59
+ # Draws a Bezier curve from the current drawing position to the
60
+ # specified point, bounded by two additional points.
61
+ #
62
+ # pdf.curve_to [100,100], :bounds => [[90,90],[75,75]]
63
+ #
64
+ def curve_to(dest,options={})
65
+ options[:bounds] or raise Prawn::Errors::InvalidGraphicsPath,
66
+ "Bounding points for bezier curve must be specified "+
67
+ "as :bounds => [[x1,y1],[x2,y2]]"
68
+
69
+ curve_points = (options[:bounds] << dest).map { |e| map_to_absolute(e) }
70
+ add_content("%.3f %.3f %.3f %.3f %.3f %.3f c" %
71
+ curve_points.flatten )
72
+ end
73
+
74
+ # Draws a rectangle given <tt>point</tt>, <tt>width</tt> and
75
+ # <tt>height</tt>. The rectangle is bounded by its upper-left corner.
76
+ #
77
+ # pdf.rectangle [300,300], 100, 200
78
+ #
79
+ def rectangle(point,width,height)
80
+ x,y = map_to_absolute(point)
81
+ add_content("%.3f %.3f %.3f %.3f re" % [ x, y - height, width, height ])
82
+ end
83
+
84
+ # Draws a rounded rectangle given <tt>point</tt>, <tt>width</tt> and
85
+ # <tt>height</tt> and <tt>radius</tt> for the rounded corner. The rectangle
86
+ # is bounded by its upper-left corner.
87
+ #
88
+ # pdf.rounded_rectangle [300,300], 100, 200, 10
89
+ #
90
+ def rounded_rectangle(point,width,height,radius)
91
+ x, y = point
92
+ rounded_polygon(radius, point, [x + width, y], [x + width, y - height], [x, y - height])
93
+ end
94
+
95
+
96
+ ###########################################################
97
+ # Higher level functions: May use relative coords #
98
+ ###########################################################
99
+
100
+ # Sets line thickness to the <tt>width</tt> specified.
101
+ #
102
+ def line_width=(width)
103
+ @line_width = width
104
+ add_content("#{width} w")
105
+ end
106
+
107
+ # When called without an argument, returns the current line thickness.
108
+ # When called with an argument, sets the line thickness to the specified
109
+ # value (in PDF points)
110
+ #
111
+ # pdf.line_width #=> 1
112
+ # pdf.line_width(5)
113
+ # pdf.line_width #=> 5
114
+ #
115
+ def line_width(width=nil)
116
+ if width
117
+ self.line_width = width
118
+ else
119
+ (defined?(@line_width) && @line_width) || 1
120
+ end
121
+ end
122
+
123
+ # Draws a line from one point to another. Points may be specified as
124
+ # tuples or flattened argument list:
125
+ #
126
+ # pdf.line [100,100], [200,250]
127
+ # pdf.line(100,100,200,250)
128
+ #
129
+ def line(*points)
130
+ x0,y0,x1,y1 = points.flatten
131
+ move_to(x0, y0)
132
+ line_to(x1, y1)
133
+ end
134
+
135
+ # Draws a horizontal line from <tt>x1</tt> to <tt>x2</tt> at the
136
+ # current <tt>y</tt> position, or the position specified by the :at option.
137
+ #
138
+ # # draw a line from [25, 75] to [100, 75]
139
+ # horizontal_line 25, 100, :at => 75
140
+ #
141
+ def horizontal_line(x1,x2,options={})
142
+ if options[:at]
143
+ y1 = options[:at]
144
+ else
145
+ y1 = y - bounds.absolute_bottom
146
+ end
147
+
148
+ line(x1,y1,x2,y1)
149
+ end
150
+
151
+ # Draws a horizontal line from the left border to the right border of the
152
+ # bounding box at the current <tt>y</tt> position.
153
+ #
154
+ def horizontal_rule
155
+ horizontal_line(bounds.left, bounds.right)
156
+ end
157
+
158
+ # Draws a vertical line at the x cooordinate given by :at from y1 to y2.
159
+ #
160
+ # # draw a line from [25, 100] to [25, 300]
161
+ # vertical_line 100, 300, :at => 25
162
+ #
163
+ def vertical_line(y1,y2,params)
164
+ line(params[:at],y1,params[:at],y2)
165
+ end
166
+
167
+ # Draws a Bezier curve between two points, bounded by two additional
168
+ # points
169
+ #
170
+ # pdf.curve [50,100], [100,100], :bounds => [[90,90],[75,75]]
171
+ #
172
+ def curve(origin,dest, options={})
173
+ move_to(*origin)
174
+ curve_to(dest,options)
175
+ end
176
+
177
+ # This constant is used to approximate a symmetrical arc using a cubic
178
+ # Bezier curve.
179
+ #
180
+ KAPPA = 4.0 * ((Math.sqrt(2) - 1.0) / 3.0)
181
+
182
+ # Draws a circle of radius <tt>:radius</tt> with the centre-point at <tt>point</tt>
183
+ # as a complete subpath. The drawing point will be moved to the
184
+ # centre-point upon completion of the drawing the circle.
185
+ #
186
+ # pdf.circle_at [100,100], :radius => 25
187
+ #
188
+ def circle_at(point, options)
189
+ x,y = point
190
+ ellipse_at [x, y], options[:radius]
191
+ end
192
+
193
+ # Draws an ellipse of +x+ radius <tt>r1</tt> and +y+ radius <tt>r2</tt>
194
+ # with the centre-point at <tt>point</tt> as a complete subpath. The
195
+ # drawing point will be moved to the centre-point upon completion of the
196
+ # drawing the ellipse.
197
+ #
198
+ # # draws an ellipse with x-radius 25 and y-radius 50
199
+ # pdf.ellipse_at [100,100], 25, 50
200
+ #
201
+ def ellipse_at(point, r1, r2 = r1)
202
+ x, y = point
203
+ l1 = r1 * KAPPA
204
+ l2 = r2 * KAPPA
205
+
206
+ move_to(x + r1, y)
207
+
208
+ # Upper right hand corner
209
+ curve_to [x, y + r2],
210
+ :bounds => [[x + r1, y + l1], [x + l2, y + r2]]
211
+
212
+ # Upper left hand corner
213
+ curve_to [x - r1, y],
214
+ :bounds => [[x - l2, y + r2], [x - r1, y + l1]]
215
+
216
+ # Lower left hand corner
217
+ curve_to [x, y - r2],
218
+ :bounds => [[x - r1, y - l1], [x - l2, y - r2]]
219
+
220
+ # Lower right hand corner
221
+ curve_to [x + r1, y],
222
+ :bounds => [[x + l2, y - r2], [x + r1, y - l1]]
223
+
224
+ move_to(x, y)
225
+ end
226
+
227
+ # Draws a polygon from the specified points.
228
+ #
229
+ # # draws a snazzy triangle
230
+ # pdf.polygon [100,100], [100,200], [200,200]
231
+ #
232
+ def polygon(*points)
233
+ move_to points[0]
234
+ (points[1..-1] << points[0]).each do |point|
235
+ line_to(*point)
236
+ end
237
+ # close the path
238
+ add_content "h"
239
+ end
240
+
241
+ # Draws a rounded polygon from specified points using the radius to define bezier curves
242
+ #
243
+ # # draws a rounded filled in polygon
244
+ # pdf.fill_and_stroke_rounded_polygon(10, [100, 250], [200, 300], [300, 250],
245
+ # [300, 150], [200, 100], [100, 150])
246
+ def rounded_polygon(radius, *points)
247
+ move_to point_on_line(radius, points[1], points[0])
248
+ sides = points.size
249
+ points << points[0] << points[1]
250
+ (sides).times do |i|
251
+ rounded_vertex(radius, points[i], points[i + 1], points[i + 2])
252
+ end
253
+ # close the path
254
+ add_content "h"
255
+ end
256
+
257
+
258
+ # Creates a rounded vertex for a line segment used for building a rounded polygon
259
+ # requires a radius to define bezier curve and three points. The first two points define
260
+ # the line segment and the third point helps define the curve for the vertex.
261
+ def rounded_vertex(radius, *points)
262
+ x0,y0,x1,y1,x2,y2 = points.flatten
263
+ radial_point_1 = point_on_line(radius, points[0], points[1])
264
+ bezier_point_1 = point_on_line((radius - radius*KAPPA), points[0], points[1] )
265
+ radial_point_2 = point_on_line(radius, points[2], points[1])
266
+ bezier_point_2 = point_on_line((radius - radius*KAPPA), points[2], points[1])
267
+ line_to(radial_point_1)
268
+ curve_to(radial_point_2, :bounds => [bezier_point_1, bezier_point_2])
269
+ end
270
+
271
+ # Strokes and closes the current path. See Graphic::Color for color details
272
+ #
273
+ def stroke
274
+ yield if block_given?
275
+ add_content "S"
276
+ end
277
+
278
+ # Draws and strokes a rectangle represented by the current bounding box
279
+ #
280
+ def stroke_bounds
281
+ stroke_rectangle bounds.top_left, bounds.width, bounds.height
282
+ end
283
+
284
+ # Fills and closes the current path. See Graphic::Color for color details
285
+ #
286
+ def fill
287
+ yield if block_given?
288
+ add_content "f"
289
+ end
290
+
291
+ # Fills, strokes, and closes the current path. See Graphic::Color for color details
292
+ #
293
+ def fill_and_stroke
294
+ yield if block_given?
295
+ add_content "b"
296
+ end
297
+
298
+ private
299
+
300
+ def map_to_absolute(*point)
301
+ x,y = point.flatten
302
+ [@bounding_box.absolute_left + x, @bounding_box.absolute_bottom + y]
303
+ end
304
+
305
+ def map_to_absolute!(point)
306
+ point.replace(map_to_absolute(point))
307
+ end
308
+
309
+ def degree_to_rad(angle)
310
+ angle * Math::PI / 180
311
+ end
312
+
313
+ # Returns the coordinates for a point on a line that is a given distance away from the second
314
+ # point defining the line segement
315
+ def point_on_line(distance_from_end, *points)
316
+ x0,y0,x1,y1 = points.flatten
317
+ length = Math.sqrt((x1 - x0)**2 + (y1 - y0)**2)
318
+ p = (length - distance_from_end) / length
319
+ xr = x0 + p*(x1 - x0)
320
+ yr = y0 + p*(y1 - y0)
321
+ [xr, yr]
322
+ end
323
+
324
+ end
325
+ end
@@ -0,0 +1,38 @@
1
+ # encoding: utf-8
2
+
3
+ # cap_style.rb : Implements stroke cap styling
4
+ #
5
+ # Contributed by Daniel Nelson. October, 2009
6
+ #
7
+ # This is free software. Please see the LICENSE and COPYING files for details.
8
+ #
9
+ module Prawn
10
+ module Graphics
11
+ module CapStyle
12
+
13
+ CAP_STYLES = { :butt => 0, :round => 1, :projecting_square => 2 }
14
+
15
+ # Sets the cap style for stroked lines and curves
16
+ #
17
+ # style is one of :butt, :round, or :projecting_square
18
+ #
19
+ # NOTE: If this method is never called, :butt will be used by default.
20
+ #
21
+ def cap_style(style=nil)
22
+ return @cap_style || :butt if style.nil?
23
+
24
+ @cap_style = style
25
+
26
+ write_stroke_cap_style
27
+ end
28
+
29
+ alias_method :cap_style=, :cap_style
30
+
31
+ private
32
+
33
+ def write_stroke_cap_style
34
+ add_content "#{CAP_STYLES[@cap_style]} J"
35
+ end
36
+ end
37
+ end
38
+ end
@@ -0,0 +1,205 @@
1
+ # encoding: utf-8
2
+
3
+ # color.rb : Implements color handling
4
+ #
5
+ # Copyright June 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
+ module Graphics
11
+ module Color
12
+
13
+ # Sets or returns the fill color.
14
+ #
15
+ # When called with no argument, it returns the current fill color.
16
+ #
17
+ # If a single argument is provided, it should be a 6 digit HTML color
18
+ # code.
19
+ #
20
+ # pdf.fill_color "f0ffc1"
21
+ #
22
+ # If 4 arguments are provided, the color is assumed to be a CMYK value
23
+ # Values range from 0 - 100.
24
+ #
25
+ # pdf.fill_color 0, 99, 95, 0
26
+ #
27
+ def fill_color(*color)
28
+ return @fill_color if color.empty?
29
+ @fill_color = process_color(*color)
30
+ set_fill_color
31
+ end
32
+
33
+ alias_method :fill_color=, :fill_color
34
+
35
+ # Sets or returns the line stroking color.
36
+ #
37
+ # When called with no argument, it returns the current stroking color.
38
+ #
39
+ # If a single argument is provided, it should be a 6 digit HTML color
40
+ # code.
41
+ #
42
+ # pdf.stroke_color "f0ffc1"
43
+ #
44
+ # If 4 arguments are provided, the color is assumed to be a CMYK value
45
+ # Values range from 0 - 100.
46
+ #
47
+ # pdf.stroke_color 0, 99, 95, 0
48
+ #
49
+ def stroke_color(*color)
50
+ return @stroke_color if color.empty?
51
+ @stroke_color = process_color(*color)
52
+ set_stroke_color
53
+ end
54
+
55
+ alias_method :stroke_color=, :stroke_color
56
+
57
+ # Provides the following shortcuts:
58
+ #
59
+ # stroke_some_method(*args) #=> some_method(*args); stroke
60
+ # fill_some_method(*args) #=> some_method(*args); fill
61
+ # fill_and_stroke_some_method(*args) #=> some_method(*args); fill_and_stroke
62
+ #
63
+ def method_missing(id,*args,&block)
64
+ case(id.to_s)
65
+ when /^fill_and_stroke_(.*)/
66
+ send($1,*args,&block); fill_and_stroke
67
+ when /^stroke_(.*)/
68
+ send($1,*args,&block); stroke
69
+ when /^fill_(.*)/
70
+ send($1,*args,&block); fill
71
+ else
72
+ super
73
+ end
74
+ end
75
+
76
+ module_function
77
+
78
+ # Converts RGB value array to hex string suitable for use with fill_color
79
+ # and stroke_color
80
+ #
81
+ # >> Prawn::Graphics::Color.rgb2hex([255,120,8])
82
+ # => "ff7808"
83
+ #
84
+ def rgb2hex(rgb)
85
+ rgb.map { |e| "%02x" % e }.join
86
+ end
87
+
88
+ # Converts hex string into RGB value array:
89
+ #
90
+ # >> Prawn::Graphics::Color.hex2rgb("ff7808")
91
+ # => [255, 120, 8]
92
+ #
93
+ def hex2rgb(hex)
94
+ r,g,b = hex[0..1], hex[2..3], hex[4..5]
95
+ [r,g,b].map { |e| e.to_i(16) }
96
+ end
97
+
98
+ private
99
+
100
+ def process_color(*color)
101
+ case(color.size)
102
+ when 1
103
+ color[0]
104
+ when 4
105
+ color
106
+ else
107
+ raise ArgumentError, 'wrong number of arguments supplied'
108
+ end
109
+ end
110
+
111
+ def color_type(color)
112
+ case color
113
+ when String
114
+ :RGB
115
+ when Array
116
+ :CMYK
117
+ end
118
+ end
119
+
120
+ def normalize_color(color)
121
+ case color_type(color)
122
+ when :RGB
123
+ r,g,b = hex2rgb(color)
124
+ [r / 255.0, g / 255.0, b / 255.0]
125
+ when :CMYK
126
+ c,m,y,k = *color
127
+ [c / 100.0, m / 100.0, y / 100.0, k / 100.0]
128
+ end
129
+ end
130
+
131
+ def color_to_s(color)
132
+ normalize_color(color).map { |c| '%.3f' % c }.join(' ')
133
+ end
134
+
135
+ def color_space(color)
136
+ case color_type(color)
137
+ when :RGB
138
+ :DeviceRGB
139
+ when :CMYK
140
+ :DeviceCMYK
141
+ end
142
+ end
143
+
144
+ COLOR_SPACES = [:DeviceRGB, :DeviceCMYK, :Pattern]
145
+
146
+ def set_color_space(type, color_space)
147
+ # don't set the same color space again
148
+ return if @color_space[type] == color_space
149
+ @color_space[type] = color_space
150
+
151
+ unless COLOR_SPACES.include?(color_space)
152
+ raise ArgumentError, "unknown color space: '#{color_space}'"
153
+ end
154
+
155
+ operator = case type
156
+ when :fill
157
+ 'cs'
158
+ when :stroke
159
+ 'CS'
160
+ else
161
+ raise ArgumentError, "unknown type '#{type}'"
162
+ end
163
+
164
+ add_content "/#{color_space} #{operator}"
165
+ end
166
+
167
+ def set_color(type, color, options = {})
168
+ operator = case type
169
+ when :fill
170
+ 'scn'
171
+ when :stroke
172
+ 'SCN'
173
+ else
174
+ raise ArgumentError, "unknown type '#{type}'"
175
+ end
176
+
177
+ if options[:pattern]
178
+ set_color_space type, :Pattern
179
+ add_content "/#{color} #{operator}"
180
+ else
181
+ set_color_space type, color_space(color)
182
+ color = color_to_s(color)
183
+ add_content "#{color} #{operator}"
184
+ end
185
+ end
186
+
187
+ def set_fill_color
188
+ set_color :fill, @fill_color
189
+ end
190
+
191
+ def set_stroke_color
192
+ set_color :stroke, @stroke_color
193
+ end
194
+
195
+ def update_colors
196
+ @color_space = {}
197
+ @fill_color ||= "000000"
198
+ @stroke_color ||= "000000"
199
+ set_fill_color
200
+ set_stroke_color
201
+ end
202
+ end
203
+ end
204
+ end
205
+