prawn 0.15.0 → 1.0.0.rc1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (269) hide show
  1. data/COPYING +2 -2
  2. data/LICENSE +1 -1
  3. data/README.md +96 -0
  4. data/Rakefile +27 -30
  5. data/data/fonts/Action Man.dfont +0 -0
  6. data/data/fonts/Activa.ttf +0 -0
  7. data/data/fonts/Chalkboard.ttf +0 -0
  8. data/data/fonts/DejaVuSans.ttf +0 -0
  9. data/data/fonts/Dustismo_Roman.ttf +0 -0
  10. data/data/fonts/comicsans.ttf +0 -0
  11. data/data/fonts/gkai00mp.ttf +0 -0
  12. data/data/images/16bit.alpha +0 -0
  13. data/data/images/16bit.dat +0 -0
  14. data/data/images/dice.alpha +0 -0
  15. data/data/images/dice.dat +0 -0
  16. data/data/images/page_white_text.alpha +0 -0
  17. data/data/images/page_white_text.dat +0 -0
  18. data/data/images/rails.dat +0 -0
  19. data/data/images/rails.png +0 -0
  20. data/data/pdfs/nested_pages.pdf +13 -13
  21. data/lib/prawn.rb +21 -85
  22. data/lib/prawn/compatibility.rb +51 -0
  23. data/lib/prawn/core.rb +85 -0
  24. data/lib/prawn/core/annotations.rb +61 -0
  25. data/lib/prawn/core/byte_string.rb +9 -0
  26. data/lib/prawn/core/destinations.rb +90 -0
  27. data/lib/prawn/core/document_state.rb +78 -0
  28. data/lib/prawn/core/literal_string.rb +16 -0
  29. data/lib/prawn/core/name_tree.rb +177 -0
  30. data/lib/prawn/core/object_store.rb +264 -0
  31. data/lib/prawn/core/page.rb +215 -0
  32. data/lib/prawn/core/pdf_object.rb +108 -0
  33. data/lib/prawn/core/reference.rb +115 -0
  34. data/lib/prawn/core/text.rb +268 -0
  35. data/lib/prawn/core/text/formatted/arranger.rb +294 -0
  36. data/lib/prawn/core/text/formatted/line_wrap.rb +273 -0
  37. data/lib/prawn/core/text/formatted/wrap.rb +153 -0
  38. data/lib/prawn/document.rb +122 -155
  39. data/lib/prawn/document/bounding_box.rb +7 -36
  40. data/lib/prawn/document/column_box.rb +10 -38
  41. data/lib/prawn/document/graphics_state.rb +74 -11
  42. data/lib/prawn/document/internals.rb +23 -24
  43. data/lib/prawn/document/page_geometry.rb +136 -0
  44. data/lib/prawn/document/snapshot.rb +6 -7
  45. data/lib/prawn/document/span.rb +10 -12
  46. data/lib/prawn/encoding.rb +10 -9
  47. data/lib/prawn/errors.rb +30 -15
  48. data/lib/prawn/font.rb +104 -136
  49. data/lib/prawn/font/afm.rb +44 -46
  50. data/lib/prawn/font/dfont.rb +3 -4
  51. data/lib/prawn/font/ttf.rb +50 -31
  52. data/lib/prawn/graphics.rb +57 -302
  53. data/lib/prawn/graphics/cap_style.rb +3 -4
  54. data/lib/prawn/graphics/color.rb +5 -13
  55. data/lib/prawn/graphics/dash.rb +31 -53
  56. data/lib/prawn/graphics/gradient.rb +84 -0
  57. data/lib/prawn/graphics/join_style.rb +7 -9
  58. data/lib/prawn/graphics/transformation.rb +9 -10
  59. data/lib/prawn/graphics/transparency.rb +1 -3
  60. data/lib/prawn/images.rb +59 -69
  61. data/lib/prawn/images/image.rb +22 -6
  62. data/lib/prawn/images/jpg.rb +14 -20
  63. data/lib/prawn/images/png.rb +118 -61
  64. data/lib/prawn/layout.rb +15 -10
  65. data/lib/prawn/layout/grid.rb +54 -66
  66. data/lib/prawn/measurement_extensions.rb +6 -10
  67. data/lib/prawn/measurements.rb +21 -27
  68. data/lib/prawn/outline.rb +308 -6
  69. data/lib/prawn/repeater.rb +8 -10
  70. data/lib/prawn/security.rb +33 -55
  71. data/lib/prawn/security/arcfour.rb +0 -1
  72. data/lib/prawn/stamp.rb +3 -5
  73. data/lib/prawn/table.rb +60 -188
  74. data/lib/prawn/table/cell.rb +44 -272
  75. data/lib/prawn/table/cell/image.rb +3 -2
  76. data/lib/prawn/table/cell/in_table.rb +2 -4
  77. data/lib/prawn/table/cell/subtable.rb +2 -2
  78. data/lib/prawn/table/cell/text.rb +18 -41
  79. data/lib/prawn/table/cells.rb +48 -142
  80. data/lib/prawn/text.rb +25 -32
  81. data/lib/prawn/text/box.rb +6 -12
  82. data/lib/prawn/text/formatted.rb +4 -5
  83. data/lib/prawn/text/formatted/box.rb +59 -96
  84. data/lib/prawn/text/formatted/fragment.rb +23 -34
  85. data/lib/prawn/text/formatted/parser.rb +5 -15
  86. data/prawn.gemspec +13 -24
  87. data/spec/annotations_spec.rb +32 -16
  88. data/spec/bounding_box_spec.rb +17 -119
  89. data/spec/cell_spec.rb +42 -112
  90. data/spec/destinations_spec.rb +5 -5
  91. data/spec/document_spec.rb +111 -155
  92. data/spec/extensions/mocha.rb +0 -1
  93. data/spec/font_spec.rb +99 -149
  94. data/spec/formatted_text_arranger_spec.rb +43 -43
  95. data/spec/formatted_text_box_spec.rb +44 -43
  96. data/spec/formatted_text_fragment_spec.rb +8 -8
  97. data/spec/graphics_spec.rb +68 -151
  98. data/spec/grid_spec.rb +15 -26
  99. data/spec/images_spec.rb +30 -51
  100. data/spec/inline_formatted_text_parser_spec.rb +20 -69
  101. data/spec/jpg_spec.rb +4 -4
  102. data/spec/line_wrap_spec.rb +28 -28
  103. data/spec/measurement_units_spec.rb +6 -6
  104. data/spec/name_tree_spec.rb +112 -0
  105. data/spec/object_store_spec.rb +106 -17
  106. data/spec/outline_spec.rb +63 -103
  107. data/spec/pdf_object_spec.rb +170 -0
  108. data/spec/png_spec.rb +25 -25
  109. data/spec/reference_spec.rb +65 -8
  110. data/spec/repeater_spec.rb +10 -10
  111. data/spec/security_spec.rb +12 -44
  112. data/spec/snapshot_spec.rb +7 -7
  113. data/spec/span_spec.rb +15 -10
  114. data/spec/spec_helper.rb +8 -32
  115. data/spec/stamp_spec.rb +30 -29
  116. data/spec/stroke_styles_spec.rb +18 -36
  117. data/spec/table_spec.rb +111 -706
  118. data/spec/template_spec.rb +297 -0
  119. data/spec/text_at_spec.rb +33 -19
  120. data/spec/text_box_spec.rb +64 -100
  121. data/spec/text_rendering_mode_spec.rb +5 -5
  122. data/spec/text_spacing_spec.rb +4 -4
  123. data/spec/text_spec.rb +64 -84
  124. data/spec/transparency_spec.rb +5 -5
  125. metadata +290 -463
  126. checksums.yaml +0 -7
  127. data/.yardopts +0 -10
  128. data/Gemfile +0 -11
  129. data/data/images/16bit.color +0 -0
  130. data/data/images/dice.color +0 -0
  131. data/data/images/indexed_color.dat +0 -0
  132. data/data/images/indexed_color.png +0 -0
  133. data/data/images/page_white_text.color +0 -0
  134. data/lib/prawn/font_metric_cache.rb +0 -47
  135. data/lib/prawn/graphics/patterns.rb +0 -138
  136. data/lib/prawn/image_handler.rb +0 -36
  137. data/lib/prawn/soft_mask.rb +0 -96
  138. data/lib/prawn/table/cell/span_dummy.rb +0 -93
  139. data/lib/prawn/table/column_width_calculator.rb +0 -61
  140. data/lib/prawn/text/formatted/arranger.rb +0 -290
  141. data/lib/prawn/text/formatted/line_wrap.rb +0 -266
  142. data/lib/prawn/text/formatted/wrap.rb +0 -150
  143. data/lib/prawn/utilities.rb +0 -46
  144. data/manual/basic_concepts/adding_pages.rb +0 -27
  145. data/manual/basic_concepts/basic_concepts.rb +0 -34
  146. data/manual/basic_concepts/creation.rb +0 -39
  147. data/manual/basic_concepts/cursor.rb +0 -33
  148. data/manual/basic_concepts/measurement.rb +0 -25
  149. data/manual/basic_concepts/origin.rb +0 -38
  150. data/manual/basic_concepts/other_cursor_helpers.rb +0 -40
  151. data/manual/bounding_box/bounding_box.rb +0 -39
  152. data/manual/bounding_box/bounds.rb +0 -49
  153. data/manual/bounding_box/canvas.rb +0 -24
  154. data/manual/bounding_box/creation.rb +0 -23
  155. data/manual/bounding_box/indentation.rb +0 -46
  156. data/manual/bounding_box/nesting.rb +0 -45
  157. data/manual/bounding_box/russian_boxes.rb +0 -40
  158. data/manual/bounding_box/stretchy.rb +0 -31
  159. data/manual/document_and_page_options/background.rb +0 -27
  160. data/manual/document_and_page_options/document_and_page_options.rb +0 -32
  161. data/manual/document_and_page_options/metadata.rb +0 -23
  162. data/manual/document_and_page_options/page_margins.rb +0 -38
  163. data/manual/document_and_page_options/page_size.rb +0 -34
  164. data/manual/document_and_page_options/print_scaling.rb +0 -20
  165. data/manual/example_file.rb +0 -111
  166. data/manual/example_helper.rb +0 -411
  167. data/manual/example_package.rb +0 -53
  168. data/manual/example_section.rb +0 -46
  169. data/manual/graphics/circle_and_ellipse.rb +0 -22
  170. data/manual/graphics/color.rb +0 -24
  171. data/manual/graphics/common_lines.rb +0 -30
  172. data/manual/graphics/fill_and_stroke.rb +0 -42
  173. data/manual/graphics/fill_rules.rb +0 -37
  174. data/manual/graphics/gradients.rb +0 -37
  175. data/manual/graphics/graphics.rb +0 -58
  176. data/manual/graphics/helper.rb +0 -24
  177. data/manual/graphics/line_width.rb +0 -35
  178. data/manual/graphics/lines_and_curves.rb +0 -41
  179. data/manual/graphics/polygon.rb +0 -29
  180. data/manual/graphics/rectangle.rb +0 -21
  181. data/manual/graphics/rotate.rb +0 -28
  182. data/manual/graphics/scale.rb +0 -41
  183. data/manual/graphics/soft_masks.rb +0 -46
  184. data/manual/graphics/stroke_cap.rb +0 -31
  185. data/manual/graphics/stroke_dash.rb +0 -48
  186. data/manual/graphics/stroke_join.rb +0 -30
  187. data/manual/graphics/translate.rb +0 -29
  188. data/manual/graphics/transparency.rb +0 -35
  189. data/manual/images/absolute_position.rb +0 -23
  190. data/manual/images/fit.rb +0 -21
  191. data/manual/images/horizontal.rb +0 -25
  192. data/manual/images/images.rb +0 -40
  193. data/manual/images/plain_image.rb +0 -18
  194. data/manual/images/scale.rb +0 -22
  195. data/manual/images/vertical.rb +0 -28
  196. data/manual/images/width_and_height.rb +0 -25
  197. data/manual/layout/boxes.rb +0 -27
  198. data/manual/layout/content.rb +0 -25
  199. data/manual/layout/layout.rb +0 -28
  200. data/manual/layout/simple_grid.rb +0 -23
  201. data/manual/manual/cover.rb +0 -36
  202. data/manual/manual/foreword.rb +0 -85
  203. data/manual/manual/how_to_read_this_manual.rb +0 -41
  204. data/manual/manual/manual.rb +0 -34
  205. data/manual/outline/add_subsection_to.rb +0 -61
  206. data/manual/outline/insert_section_after.rb +0 -47
  207. data/manual/outline/outline.rb +0 -32
  208. data/manual/outline/sections_and_pages.rb +0 -67
  209. data/manual/repeatable_content/page_numbering.rb +0 -54
  210. data/manual/repeatable_content/repeatable_content.rb +0 -31
  211. data/manual/repeatable_content/repeater.rb +0 -55
  212. data/manual/repeatable_content/stamp.rb +0 -41
  213. data/manual/security/encryption.rb +0 -31
  214. data/manual/security/permissions.rb +0 -38
  215. data/manual/security/security.rb +0 -28
  216. data/manual/syntax_highlight.rb +0 -52
  217. data/manual/table/basic_block.rb +0 -53
  218. data/manual/table/before_rendering_page.rb +0 -26
  219. data/manual/table/cell_border_lines.rb +0 -24
  220. data/manual/table/cell_borders_and_bg.rb +0 -31
  221. data/manual/table/cell_dimensions.rb +0 -30
  222. data/manual/table/cell_text.rb +0 -38
  223. data/manual/table/column_widths.rb +0 -30
  224. data/manual/table/content_and_subtables.rb +0 -39
  225. data/manual/table/creation.rb +0 -27
  226. data/manual/table/filtering.rb +0 -36
  227. data/manual/table/flow_and_header.rb +0 -17
  228. data/manual/table/image_cells.rb +0 -33
  229. data/manual/table/position.rb +0 -29
  230. data/manual/table/row_colors.rb +0 -20
  231. data/manual/table/span.rb +0 -30
  232. data/manual/table/style.rb +0 -22
  233. data/manual/table/table.rb +0 -52
  234. data/manual/table/width.rb +0 -27
  235. data/manual/text/alignment.rb +0 -44
  236. data/manual/text/color.rb +0 -24
  237. data/manual/text/column_box.rb +0 -32
  238. data/manual/text/fallback_fonts.rb +0 -37
  239. data/manual/text/font.rb +0 -41
  240. data/manual/text/font_size.rb +0 -45
  241. data/manual/text/font_style.rb +0 -23
  242. data/manual/text/formatted_callbacks.rb +0 -60
  243. data/manual/text/formatted_text.rb +0 -54
  244. data/manual/text/free_flowing_text.rb +0 -51
  245. data/manual/text/group.rb +0 -31
  246. data/manual/text/inline.rb +0 -43
  247. data/manual/text/kerning_and_character_spacing.rb +0 -39
  248. data/manual/text/leading.rb +0 -25
  249. data/manual/text/line_wrapping.rb +0 -41
  250. data/manual/text/paragraph_indentation.rb +0 -26
  251. data/manual/text/positioned_text.rb +0 -38
  252. data/manual/text/registering_families.rb +0 -48
  253. data/manual/text/rendering_and_color.rb +0 -37
  254. data/manual/text/right_to_left_text.rb +0 -43
  255. data/manual/text/rotation.rb +0 -43
  256. data/manual/text/single_usage.rb +0 -37
  257. data/manual/text/text.rb +0 -75
  258. data/manual/text/text_box_excess.rb +0 -32
  259. data/manual/text/text_box_extensions.rb +0 -45
  260. data/manual/text/text_box_overflow.rb +0 -44
  261. data/manual/text/utf8.rb +0 -28
  262. data/manual/text/win_ansi_charset.rb +0 -59
  263. data/spec/acceptance/png.rb +0 -23
  264. data/spec/column_box_spec.rb +0 -65
  265. data/spec/extensions/encoding_helpers.rb +0 -9
  266. data/spec/font_metric_cache_spec.rb +0 -52
  267. data/spec/image_handler_spec.rb +0 -54
  268. data/spec/soft_mask_spec.rb +0 -117
  269. data/spec/table/span_dummy_spec.rb +0 -17
checksums.yaml DELETED
@@ -1,7 +0,0 @@
1
- ---
2
- SHA1:
3
- metadata.gz: 97e70822529ce4c7edb736c4c57f2c6a015ddb02
4
- data.tar.gz: 685b8386302414f80c7ac7a7c714987e0a8d2ff9
5
- SHA512:
6
- metadata.gz: dad2cab43e9fdda28fa1a4c364507fd7ecff16d2120a65b3c8ab9a07130d8c6fd73a6a9ae44a98be6faad680b20e894e9d6d1d8b88a870b824f08b9a5a28e527
7
- data.tar.gz: 3c61667b13c7ed6aa815728ec777e8d12b04f7219184682d8b2b37d9fe046c942529c957f35597c3ccfe2a48131c701834d209a5cd77a454be9395e695450be3
data/.yardopts DELETED
@@ -1,10 +0,0 @@
1
- --charset UTF-8
2
- --main README.md
3
- --title 'Prawn Documentation'
4
- --no-private
5
- lib/prawn/**/*.rb
6
- -
7
- CONTRIBUTING.md
8
- COPYING
9
- LICENSE
10
- README.md
data/Gemfile DELETED
@@ -1,11 +0,0 @@
1
- source "https://rubygems.org"
2
-
3
- gemspec
4
-
5
- if ENV["CI"]
6
- platforms :rbx do
7
- gem "rubysl-singleton", "~> 2.0"
8
- gem "rubysl-digest", "~> 2.0"
9
- gem "rubysl-enumerator", "~> 2.0"
10
- end
11
- end
Binary file
Binary file
Binary file
Binary file
Binary file
@@ -1,47 +0,0 @@
1
- # encoding: utf-8
2
- #
3
- # font_metric_cache.rb : The Prawn font class
4
- #
5
- # Copyright Dec 2012, Kenneth Kalmer. All Rights Reserved.
6
- #
7
- # This is free software. Please see the LICENSE and COPYING files for details.
8
- #
9
-
10
- module Prawn
11
-
12
- # Cache used internally by Prawn::Document instances to calculate the width
13
- # of various strings for layout purposes.
14
- #
15
- # @private
16
- class FontMetricCache
17
-
18
- CacheEntry = Struct.new( :font, :options, :string )
19
-
20
- def initialize( document )
21
- @document = document
22
-
23
- @cache = {}
24
- end
25
-
26
- def width_of( string, options )
27
- f = if options[:style]
28
- # override style with :style => :bold
29
- @document.find_font(@document.font ? @document.font.name : 'Helvetica',
30
- :style => options[:style])
31
- else
32
- @document.font
33
- end
34
-
35
- key = CacheEntry.new( f, options, string )
36
-
37
- unless length = @cache[ key ]
38
- length = @cache[ key ] = f.compute_width_of(string, options)
39
- end
40
-
41
- length +
42
- (@document.character_spacing * @document.font.character_count(string))
43
- end
44
-
45
- end
46
-
47
- end
@@ -1,138 +0,0 @@
1
- # encoding: utf-8
2
-
3
- # patterns.rb : Implements axial & radial gradients
4
- #
5
- # Originally implemented by Wojciech Piekutowski. November, 2009
6
- # Copyright September 2012, Alexander Mankuta. All Rights Reserved.
7
- #
8
- # This is free software. Please see the LICENSE and COPYING files for details.
9
- #
10
- module Prawn
11
- module Graphics
12
- module Patterns
13
- # @group Stable API
14
-
15
- # Sets the fill gradient from color1 to color2.
16
- # old arguments: point, width, height, color1, color2, options = {}
17
- # new arguments: from, to, color1, color1
18
- # or from, r1, to, r2, color1, color2
19
- def fill_gradient(*args)
20
- if args[1].is_a?(Array) || args[2].is_a?(Array)
21
- set_gradient(:fill, *args)
22
- else
23
- warn "[DEPRECATION] 'fill_gradient(point, width, height,...)' is deprecated in favor of 'fill_gradient(from, to,...)'. " +
24
- "Old arguments will be removed in release 1.1"
25
- set_gradient :fill, args[0], [args[0].first, args[0].last - args[2]], args[3], args[4]
26
- end
27
- end
28
-
29
- # Sets the stroke gradient from color1 to color2.
30
- # old arguments: point, width, height, color1, color2, options = {}
31
- # new arguments: from, to, color1, color2
32
- # or from, r1, to, r2, color1, color2
33
- def stroke_gradient(*args)
34
- if args[1].is_a?(Array) || args[2].is_a?(Array)
35
- set_gradient(:stroke, *args)
36
- else
37
- warn "[DEPRECATION] 'stroke_gradient(point, width, height,...)' is deprecated in favor of 'stroke_gradient(from, to,...)'. " +
38
- "Old arguments will be removed in release 1.1"
39
- set_gradient :stroke, args[0], [args[0].first, args[0].last - args[2]], args[3], args[4]
40
- end
41
- end
42
-
43
- private
44
-
45
- def set_gradient(type, *grad)
46
- patterns = page.resources[:Pattern] ||= {}
47
-
48
- registry_key = gradient_registry_key grad
49
-
50
- if patterns["SP#{registry_key}"]
51
- shading = patterns["SP#{registry_key}"]
52
- else
53
- unless shading = gradient_registry[registry_key]
54
- shading = gradient(*grad)
55
- gradient_registry[registry_key] = shading
56
- end
57
-
58
- patterns["SP#{registry_key}"] = shading
59
- end
60
-
61
- operator = case type
62
- when :fill
63
- 'scn'
64
- when :stroke
65
- 'SCN'
66
- else
67
- raise ArgumentError, "unknown type '#{type}'"
68
- end
69
-
70
- set_color_space type, :Pattern
71
- add_content "/SP#{registry_key} #{operator}"
72
- end
73
-
74
- def gradient_registry_key(gradient)
75
- if gradient[1].is_a?(Array) # axial
76
- [
77
- map_to_absolute(gradient[0]),
78
- map_to_absolute(gradient[1]),
79
- gradient[2], gradient[3]
80
- ]
81
- else # radial
82
- [
83
- map_to_absolute(gradient[0]),
84
- gradient[1],
85
- map_to_absolute(gradient[2]),
86
- gradient[3],
87
- gradient[4], gradient[5]
88
- ]
89
- end.hash
90
- end
91
-
92
- def gradient_registry
93
- @gradient_registry ||= {}
94
- end
95
-
96
- def gradient(*args)
97
- if args.length != 4 && args.length != 6
98
- raise ArgumentError, "Unknown type of gradient: #{args.inspect}"
99
- end
100
-
101
- color1 = normalize_color(args[-2]).dup.freeze
102
- color2 = normalize_color(args[-1]).dup.freeze
103
-
104
- if color_type(color1) != color_type(color2)
105
- raise ArgumentError, "Both colors must be of the same color space: #{color1.inspect} and #{color2.inspect}"
106
- end
107
-
108
- process_color color1
109
- process_color color2
110
-
111
- shader = ref!({
112
- :FunctionType => 2,
113
- :Domain => [0.0, 1.0],
114
- :C0 => color1,
115
- :C1 => color2,
116
- :N => 1.0,
117
- })
118
-
119
- shading = ref!({
120
- :ShadingType => args.length == 4 ? 2 : 3, # axial : radial shading
121
- :ColorSpace => color_space(color1),
122
- :Coords => args.length == 4 ?
123
- [0, 0, args[1].first - args[0].first, args[1].last - args[0].last] :
124
- [0, 0, args[1], args[2].first - args[0].first, args[2].last - args[0].last, args[3]],
125
- :Function => shader,
126
- :Extend => [true, true],
127
- })
128
-
129
- ref!({
130
- :PatternType => 2, # shading pattern
131
- :Shading => shading,
132
- :Matrix => [1, 0,
133
- 0, 1] + map_to_absolute(args[0]),
134
- })
135
- end
136
- end
137
- end
138
- end
@@ -1,36 +0,0 @@
1
- module Prawn
2
- # @group Extension API
3
-
4
- def self.image_handler
5
- @image_handler ||= ImageHandler.new
6
- end
7
-
8
- class ImageHandler
9
- def initialize
10
- @handlers = []
11
- end
12
-
13
- def register(handler)
14
- @handlers.delete(handler)
15
- @handlers.push handler
16
- end
17
-
18
- def register!(handler)
19
- @handlers.delete(handler)
20
- @handlers.unshift handler
21
- end
22
-
23
- def unregister(handler)
24
- @handlers.reject!{ |h| h == handler }
25
- end
26
-
27
- def find(image_blob)
28
- handler = @handlers.find{ |h| h.can_render? image_blob }
29
-
30
- return handler if handler
31
-
32
- raise Prawn::Errors::UnsupportedImageType,
33
- "image file is an unrecognised format"
34
- end
35
- end
36
- end
@@ -1,96 +0,0 @@
1
- # encoding: utf-8
2
- #
3
- # soft_mask.rb : Implements soft-masking
4
- #
5
- # Copyright September 2012, Alexander Mankuta. All Rights Reserved.
6
- #
7
- # This is free software. Please see the LICENSE and COPYING files for details.
8
- #
9
-
10
- module Prawn
11
-
12
- # The Prawn::SoftMask module is used to create arbitrary transparency in
13
- # document. Using a soft mask allows creating more visually rich documents.
14
- #
15
- # You must group soft mask and graphics it's applied to under
16
- # save_graphics_state because soft mask is a part of graphic state in PDF.
17
- #
18
- # Example:
19
- # pdf.save_graphics_state do
20
- # pdf.soft_mask do
21
- # pdf.fill_color "444444"
22
- # pdf.fill_polygon [0, 40], [60, 10], [120, 40], [60, 68]
23
- # end
24
- # pdf.fill_color '000000'
25
- # pdf.fill_rectangle [0, 50], 120, 68
26
- # end
27
- #
28
- module SoftMask
29
- # @group Stable API
30
-
31
- def soft_mask(&block)
32
- min_version(1.4)
33
-
34
- group_attrs = ref!({
35
- :Type => :Group,
36
- :S => :Transparency,
37
- :CS => :DeviceRGB,
38
- :I => false,
39
- :K => false
40
- })
41
-
42
- group = ref!({
43
- :Type => :XObject,
44
- :Subtype => :Form,
45
- :BBox => state.page.dimensions,
46
- :Group => group_attrs,
47
- })
48
-
49
- state.page.stamp_stream(group, &block)
50
-
51
- mask = ref!({
52
- :Type => :Mask,
53
- :S => :Luminosity,
54
- :G => group
55
- })
56
-
57
- g_state = ref!({
58
- :Type => :ExtGState,
59
- :SMask => mask,
60
-
61
- :AIS => false,
62
- :BM => :Normal,
63
- :OP => false,
64
- :op => false,
65
- :OPM => 1,
66
- :SA => true,
67
- })
68
-
69
- registry_key = {
70
- :bbox => state.page.dimensions,
71
- :mask => [group.stream.filters.normalized, group.stream.filtered_stream],
72
- :page => state.page_count,
73
- }.hash
74
-
75
- if soft_mask_registry[registry_key]
76
- [g_state, mask, group, group_attrs].each { |ref| ref.live = false }
77
-
78
- add_content "/#{soft_mask_registry[registry_key]} gs"
79
- else
80
- masks = page.resources[:ExtGState] ||= {}
81
- id = masks.empty? ? 'GS1' : masks.keys.sort.last.succ
82
- masks[id] = g_state
83
-
84
- soft_mask_registry[registry_key] = id
85
-
86
- add_content "/#{id} gs"
87
- end
88
- end
89
-
90
- private
91
-
92
- def soft_mask_registry
93
- @soft_mask_registry ||= {}
94
- end
95
- end
96
- end
@@ -1,93 +0,0 @@
1
- # encoding: utf-8
2
-
3
- # span_dummy.rb: Placeholder for non-master spanned cells.
4
- #
5
- # Copyright December 2011, Brad Ediger. All Rights Reserved.
6
- #
7
- # This is free software. Please see the LICENSE and COPYING files for details.
8
- module Prawn
9
- class Table
10
- class Cell
11
-
12
- # A Cell object used to represent all but the topmost cell in a span
13
- # group.
14
- #
15
- # @private
16
- class SpanDummy < Cell
17
- def initialize(pdf, master_cell)
18
- super(pdf, [0, pdf.cursor])
19
- @master_cell = master_cell
20
- @padding = [0, 0, 0, 0]
21
- end
22
-
23
- # By default, a span dummy will never increase the height demand.
24
- #
25
- def natural_content_height
26
- 0
27
- end
28
-
29
- # By default, a span dummy will never increase the width demand.
30
- #
31
- def natural_content_width
32
- 0
33
- end
34
-
35
- def avg_spanned_min_width
36
- @master_cell.avg_spanned_min_width
37
- end
38
-
39
- # Dummy cells have nothing to draw.
40
- #
41
- def draw_borders(pt)
42
- end
43
-
44
- # Dummy cells have nothing to draw.
45
- #
46
- def draw_bounded_content(pt)
47
- end
48
-
49
- def padding_right=(val)
50
- @master_cell.padding_right = val if rightmost?
51
- end
52
-
53
- def padding_bottom=(val)
54
- @master_cell.padding_bottom = val if bottommost?
55
- end
56
-
57
- def border_right_color=(val)
58
- @master_cell.border_right_color = val if rightmost?
59
- end
60
-
61
- def border_bottom_color=(val)
62
- @master_cell.border_bottom_color = val if bottommost?
63
- end
64
-
65
- def border_right_width=(val)
66
- @master_cell.border_right_width = val if rightmost?
67
- end
68
-
69
- def border_bottom_width=(val)
70
- @master_cell.border_bottom_width = val if bottommost?
71
- end
72
-
73
- def background_color
74
- @master_cell.background_color
75
- end
76
-
77
- private
78
-
79
- # Are we on the right border of the span?
80
- #
81
- def rightmost?
82
- @column == @master_cell.column + @master_cell.colspan - 1
83
- end
84
-
85
- # Are we on the bottom border of the span?
86
- #
87
- def bottommost?
88
- @row == @master_cell.row + @master_cell.rowspan - 1
89
- end
90
- end
91
- end
92
- end
93
- end