kavu-prawn-core 0.4.99
Sign up to get free protection for your applications and to get access to all the features.
- data/COPYING +340 -0
- data/LICENSE +56 -0
- data/README +40 -0
- data/Rakefile +73 -0
- data/data/encodings/win_ansi.txt +29 -0
- data/data/fonts/Action Man.dfont +0 -0
- data/data/fonts/Activa.ttf +0 -0
- data/data/fonts/Chalkboard.ttf +0 -0
- data/data/fonts/Courier-Bold.afm +342 -0
- data/data/fonts/Courier-BoldOblique.afm +342 -0
- data/data/fonts/Courier-Oblique.afm +342 -0
- data/data/fonts/Courier.afm +342 -0
- data/data/fonts/DejaVuSans.ttf +0 -0
- data/data/fonts/Dustismo_Roman.ttf +0 -0
- data/data/fonts/Helvetica-Bold.afm +2827 -0
- data/data/fonts/Helvetica-BoldOblique.afm +2827 -0
- data/data/fonts/Helvetica-Oblique.afm +3051 -0
- data/data/fonts/Helvetica.afm +3051 -0
- data/data/fonts/MustRead.html +19 -0
- data/data/fonts/Symbol.afm +213 -0
- data/data/fonts/Times-Bold.afm +2588 -0
- data/data/fonts/Times-BoldItalic.afm +2384 -0
- data/data/fonts/Times-Italic.afm +2667 -0
- data/data/fonts/Times-Roman.afm +2419 -0
- data/data/fonts/ZapfDingbats.afm +225 -0
- data/data/fonts/comicsans.ttf +0 -0
- data/data/fonts/gkai00mp.ttf +0 -0
- data/data/images/arrow.png +0 -0
- data/data/images/arrow2.png +0 -0
- data/data/images/barcode_issue.png +0 -0
- data/data/images/dice.alpha +0 -0
- data/data/images/dice.dat +0 -0
- data/data/images/dice.png +0 -0
- data/data/images/fractal.jpg +0 -0
- data/data/images/letterhead.jpg +0 -0
- data/data/images/page_white_text.alpha +0 -0
- data/data/images/page_white_text.dat +0 -0
- data/data/images/page_white_text.png +0 -0
- data/data/images/pigs.jpg +0 -0
- data/data/images/rails.dat +0 -0
- data/data/images/rails.png +0 -0
- data/data/images/ruport.png +0 -0
- data/data/images/ruport_data.dat +0 -0
- data/data/images/ruport_transparent.png +0 -0
- data/data/images/ruport_type0.png +0 -0
- data/data/images/stef.jpg +0 -0
- data/data/images/web-links.dat +1 -0
- data/data/images/web-links.png +0 -0
- data/data/shift_jis_text.txt +1 -0
- data/examples/bounding_box/bounding_boxes.rb +44 -0
- data/examples/bounding_box/russian_boxes.rb +37 -0
- data/examples/general/background.rb +20 -0
- data/examples/general/canvas.rb +16 -0
- data/examples/general/measurement_units.rb +52 -0
- data/examples/general/multi_page_layout.rb +17 -0
- data/examples/general/page_geometry.rb +32 -0
- data/examples/graphics/basic_images.rb +27 -0
- data/examples/graphics/cmyk.rb +13 -0
- data/examples/graphics/curves.rb +12 -0
- data/examples/graphics/hexagon.rb +14 -0
- data/examples/graphics/image_fit.rb +16 -0
- data/examples/graphics/image_flow.rb +38 -0
- data/examples/graphics/image_position.rb +18 -0
- data/examples/graphics/line.rb +33 -0
- data/examples/graphics/png_types.rb +23 -0
- data/examples/graphics/polygons.rb +17 -0
- data/examples/graphics/remote_images.rb +12 -0
- data/examples/graphics/ruport_style_helpers.rb +20 -0
- data/examples/graphics/stroke_bounds.rb +21 -0
- data/examples/m17n/chinese_text_wrapping.rb +20 -0
- data/examples/m17n/euro.rb +16 -0
- data/examples/m17n/sjis.rb +29 -0
- data/examples/m17n/utf8.rb +14 -0
- data/examples/m17n/win_ansi_charset.rb +55 -0
- data/examples/text/alignment.rb +19 -0
- data/examples/text/dfont.rb +49 -0
- data/examples/text/family_based_styling.rb +25 -0
- data/examples/text/font_calculations.rb +92 -0
- data/examples/text/font_size.rb +34 -0
- data/examples/text/kerning.rb +31 -0
- data/examples/text/simple_text.rb +18 -0
- data/examples/text/simple_text_ttf.rb +18 -0
- data/examples/text/span.rb +30 -0
- data/examples/text/text_box.rb +26 -0
- data/examples/text/text_flow.rb +68 -0
- data/lib/prawn/compatibility.rb +38 -0
- data/lib/prawn/document/annotations.rb +63 -0
- data/lib/prawn/document/bounding_box.rb +263 -0
- data/lib/prawn/document/destinations.rb +81 -0
- data/lib/prawn/document/internals.rb +126 -0
- data/lib/prawn/document/page_geometry.rb +79 -0
- data/lib/prawn/document/span.rb +55 -0
- data/lib/prawn/document/text/box.rb +76 -0
- data/lib/prawn/document/text/wrapping.rb +59 -0
- data/lib/prawn/document/text.rb +185 -0
- data/lib/prawn/document.rb +309 -0
- data/lib/prawn/encoding.rb +121 -0
- data/lib/prawn/errors.rb +45 -0
- data/lib/prawn/font/afm.rb +202 -0
- data/lib/prawn/font/dfont.rb +31 -0
- data/lib/prawn/font/ttf.rb +326 -0
- data/lib/prawn/font.rb +288 -0
- data/lib/prawn/graphics/color.rb +141 -0
- data/lib/prawn/graphics.rb +257 -0
- data/lib/prawn/images/jpg.rb +45 -0
- data/lib/prawn/images/png.rb +199 -0
- data/lib/prawn/images.rb +336 -0
- data/lib/prawn/literal_string.rb +14 -0
- data/lib/prawn/measurement_extensions.rb +46 -0
- data/lib/prawn/measurements.rb +71 -0
- data/lib/prawn/name_tree.rb +165 -0
- data/lib/prawn/pdf_object.rb +73 -0
- data/lib/prawn/reference.rb +59 -0
- data/lib/prawn.rb +70 -0
- data/spec/annotations_spec.rb +90 -0
- data/spec/bounding_box_spec.rb +141 -0
- data/spec/destinations_spec.rb +15 -0
- data/spec/document_spec.rb +163 -0
- data/spec/font_spec.rb +241 -0
- data/spec/graphics_spec.rb +209 -0
- data/spec/images_spec.rb +68 -0
- data/spec/jpg_spec.rb +25 -0
- data/spec/measurement_units_spec.rb +23 -0
- data/spec/name_tree_spec.rb +103 -0
- data/spec/pdf_object_spec.rb +112 -0
- data/spec/png_spec.rb +196 -0
- data/spec/reference_spec.rb +42 -0
- data/spec/spec_helper.rb +23 -0
- data/spec/text_spec.rb +178 -0
- metadata +259 -0
@@ -0,0 +1,141 @@
|
|
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 the fill color.
|
14
|
+
#
|
15
|
+
# If a single argument is provided, it should be a 6 digit HTML color
|
16
|
+
# code.
|
17
|
+
#
|
18
|
+
# pdf.fill_color "f0ffc1"
|
19
|
+
#
|
20
|
+
# If 4 arguments are provided, the color is assumed to be a CMYK value
|
21
|
+
# Values range from 0 - 100.
|
22
|
+
#
|
23
|
+
# pdf.fill_color 0, 99, 95, 0
|
24
|
+
#
|
25
|
+
def fill_color(*color)
|
26
|
+
return @fill_color if color.empty?
|
27
|
+
@fill_color = process_color(*color)
|
28
|
+
set_fill_color
|
29
|
+
end
|
30
|
+
|
31
|
+
alias_method :fill_color=, :fill_color
|
32
|
+
|
33
|
+
# Sets the line stroking color. 6 digit HTML color codes are used.
|
34
|
+
#
|
35
|
+
# If a single argument is provided, it should be a 6 digit HTML color
|
36
|
+
# code.
|
37
|
+
#
|
38
|
+
# pdf.fill_color "f0ffc1"
|
39
|
+
#
|
40
|
+
# If 4 arguments are provided, the color is assumed to be a CMYK value
|
41
|
+
# Values range from 0 - 100.
|
42
|
+
#
|
43
|
+
# pdf.fill_color 0, 99, 95, 0
|
44
|
+
#
|
45
|
+
def stroke_color(*color)
|
46
|
+
return @stroke_color if color.empty?
|
47
|
+
@stroke_color = process_color(*color)
|
48
|
+
set_stroke_color
|
49
|
+
end
|
50
|
+
|
51
|
+
alias_method :stroke_color=, :stroke_color
|
52
|
+
|
53
|
+
# Provides the following shortcuts:
|
54
|
+
#
|
55
|
+
# stroke_some_method(*args) #=> some_method(*args); stroke
|
56
|
+
# fill_some_method(*args) #=> some_method(*args); fill
|
57
|
+
# fill_and_stroke_some_method(*args) #=> some_method(*args); fill_and_stroke
|
58
|
+
#
|
59
|
+
def method_missing(id,*args,&block)
|
60
|
+
case(id.to_s)
|
61
|
+
when /^fill_and_stroke_(.*)/
|
62
|
+
send($1,*args,&block); fill_and_stroke
|
63
|
+
when /^stroke_(.*)/
|
64
|
+
send($1,*args,&block); stroke
|
65
|
+
when /^fill_(.*)/
|
66
|
+
send($1,*args,&block); fill
|
67
|
+
else
|
68
|
+
super
|
69
|
+
end
|
70
|
+
end
|
71
|
+
|
72
|
+
module_function
|
73
|
+
|
74
|
+
# Converts RGB value array to hex string suitable for use with fill_color
|
75
|
+
# and stroke_color
|
76
|
+
#
|
77
|
+
# >> Prawn::Graphics::Color.rgb2hex([255,120,8])
|
78
|
+
# => "ff7808"
|
79
|
+
#
|
80
|
+
def rgb2hex(rgb)
|
81
|
+
rgb.map { |e| "%02x" % e }.join
|
82
|
+
end
|
83
|
+
|
84
|
+
# Converts hex string into RGB value array:
|
85
|
+
#
|
86
|
+
# >> Prawn::Graphics::Color.hex2rgb("ff7808")
|
87
|
+
# => [255, 120, 8]
|
88
|
+
#
|
89
|
+
def hex2rgb(hex)
|
90
|
+
r,g,b = hex[0..1], hex[2..3], hex[4..5]
|
91
|
+
[r,g,b].map { |e| e.to_i(16) }
|
92
|
+
end
|
93
|
+
|
94
|
+
private
|
95
|
+
|
96
|
+
def process_color(*color)
|
97
|
+
case(color.size)
|
98
|
+
when 1
|
99
|
+
color[0]
|
100
|
+
when 4
|
101
|
+
color
|
102
|
+
else
|
103
|
+
raise ArgumentError, 'wrong number of arguments supplied'
|
104
|
+
end
|
105
|
+
end
|
106
|
+
|
107
|
+
def set_fill_color
|
108
|
+
case @fill_color
|
109
|
+
when String
|
110
|
+
r,g,b = hex2rgb(@fill_color)
|
111
|
+
add_content "%.3f %.3f %.3f rg" %
|
112
|
+
[r / 255.0, g / 255.0, b / 255.0]
|
113
|
+
when Array
|
114
|
+
c,m,y,k = *@fill_color
|
115
|
+
add_content "%.3f %.3f %.3f %.3f k" %
|
116
|
+
[c / 100.0, m / 100.0, y / 100.0, k / 100.0]
|
117
|
+
end
|
118
|
+
end
|
119
|
+
|
120
|
+
def set_stroke_color
|
121
|
+
case @stroke_color
|
122
|
+
when String
|
123
|
+
r,g,b = hex2rgb(@stroke_color)
|
124
|
+
add_content "%.3f %.3f %.3f RG" %
|
125
|
+
[r / 255.0, g / 255.0, b / 255.0]
|
126
|
+
when Array
|
127
|
+
c,m,y,k = *@stroke_color
|
128
|
+
add_content "%.3f %.3f %.3f %.3f K" %
|
129
|
+
[c / 100.0, m / 100.0, y / 100.0, k / 100.0]
|
130
|
+
end
|
131
|
+
end
|
132
|
+
|
133
|
+
def update_colors
|
134
|
+
@fill_color ||= "000000"
|
135
|
+
@stroke_color ||= "000000"
|
136
|
+
set_fill_color
|
137
|
+
set_stroke_color
|
138
|
+
end
|
139
|
+
end
|
140
|
+
end
|
141
|
+
end
|
@@ -0,0 +1,257 @@
|
|
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 "enumerator"
|
10
|
+
require "prawn/graphics/color"
|
11
|
+
|
12
|
+
module Prawn
|
13
|
+
|
14
|
+
# Implements the drawing facilities for Prawn::Document.
|
15
|
+
# Use this to draw the most beautiful imaginable things.
|
16
|
+
#
|
17
|
+
# This file lifts and modifies several of PDF::Writer's graphics functions
|
18
|
+
# ruby-pdf.rubyforge.org
|
19
|
+
#
|
20
|
+
module Graphics
|
21
|
+
|
22
|
+
include Color
|
23
|
+
|
24
|
+
#######################################################################
|
25
|
+
# Low level drawing operations must translate to absolute coords! #
|
26
|
+
#######################################################################
|
27
|
+
|
28
|
+
# Moves the drawing position to a given point. The point can be
|
29
|
+
# specified as a tuple or a flattened argument list
|
30
|
+
#
|
31
|
+
# pdf.move_to [100,50]
|
32
|
+
# pdf.move_to(100,50)
|
33
|
+
#
|
34
|
+
def move_to(*point)
|
35
|
+
x,y = translate(point)
|
36
|
+
add_content("%.3f %.3f m" % [ x, y ])
|
37
|
+
end
|
38
|
+
|
39
|
+
# Draws a line from the current drawing position to the specified point.
|
40
|
+
# The destination may be described as a tuple or a flattened list:
|
41
|
+
#
|
42
|
+
# pdf.line_to [50,50]
|
43
|
+
# pdf.line_to(50,50)
|
44
|
+
#
|
45
|
+
def line_to(*point)
|
46
|
+
x,y = translate(point)
|
47
|
+
add_content("%.3f %.3f l" % [ x, y ])
|
48
|
+
end
|
49
|
+
|
50
|
+
# Draws a Bezier curve from the current drawing position to the
|
51
|
+
# specified point, bounded by two additional points.
|
52
|
+
#
|
53
|
+
# pdf.curve_to [100,100], :bounds => [[90,90],[75,75]]
|
54
|
+
#
|
55
|
+
def curve_to(dest,options={})
|
56
|
+
options[:bounds] or raise Prawn::Errors::InvalidGraphicsPath,
|
57
|
+
"Bounding points for bezier curve must be specified "+
|
58
|
+
"as :bounds => [[x1,y1],[x2,y2]]"
|
59
|
+
|
60
|
+
curve_points = (options[:bounds] << dest).map { |e| translate(e) }
|
61
|
+
add_content("%.3f %.3f %.3f %.3f %.3f %.3f c" %
|
62
|
+
curve_points.flatten )
|
63
|
+
end
|
64
|
+
|
65
|
+
# Draws a rectangle given <tt>point</tt>, <tt>width</tt> and
|
66
|
+
# <tt>height</tt>. The rectangle is bounded by its upper-left corner.
|
67
|
+
#
|
68
|
+
# pdf.rectangle [300,300], 100, 200
|
69
|
+
#
|
70
|
+
def rectangle(point,width,height)
|
71
|
+
x,y = translate(point)
|
72
|
+
add_content("%.3f %.3f %.3f %.3f re" % [ x, y - height, width, height ])
|
73
|
+
end
|
74
|
+
|
75
|
+
###########################################################
|
76
|
+
# Higher level functions: May use relative coords #
|
77
|
+
###########################################################
|
78
|
+
|
79
|
+
# Sets line thickness to the <tt>width</tt> specified.
|
80
|
+
#
|
81
|
+
def line_width=(width)
|
82
|
+
@line_width = width
|
83
|
+
add_content("#{width} w")
|
84
|
+
end
|
85
|
+
|
86
|
+
# When called without an argument, returns the current line thickness.
|
87
|
+
# When called with an argument, sets the line thickness to the specified
|
88
|
+
# value (in PDF points)
|
89
|
+
#
|
90
|
+
# pdf.line_width #=> 1
|
91
|
+
# pdf.line_width(5)
|
92
|
+
# pdf.line_width #=> 5
|
93
|
+
#
|
94
|
+
def line_width(width=nil)
|
95
|
+
if width
|
96
|
+
self.line_width = width
|
97
|
+
else
|
98
|
+
@line_width || 1
|
99
|
+
end
|
100
|
+
end
|
101
|
+
|
102
|
+
# Draws a line from one point to another. Points may be specified as
|
103
|
+
# tuples or flattened argument list:
|
104
|
+
#
|
105
|
+
# pdf.line [100,100], [200,250]
|
106
|
+
# pdf.line(100,100,200,250)
|
107
|
+
#
|
108
|
+
def line(*points)
|
109
|
+
x0,y0,x1,y1 = points.flatten
|
110
|
+
move_to(x0, y0)
|
111
|
+
line_to(x1, y1)
|
112
|
+
end
|
113
|
+
|
114
|
+
# Draws a horizontal line from <tt>x1</tt> to <tt>x2</tt> at the
|
115
|
+
# current <tt>y</tt> position, or the position specified by the :at option.
|
116
|
+
#
|
117
|
+
# # draw a line from [25, 75] to [100, 75]
|
118
|
+
# horizontal_line 25, 100, :at => 75
|
119
|
+
#
|
120
|
+
def horizontal_line(x1,x2,options={})
|
121
|
+
if options[:at]
|
122
|
+
y1 = options[:at]
|
123
|
+
else
|
124
|
+
y1 = y - bounds.absolute_bottom
|
125
|
+
end
|
126
|
+
|
127
|
+
line(x1,y1,x2,y1)
|
128
|
+
end
|
129
|
+
|
130
|
+
# Draws a horizontal line from the left border to the right border of the
|
131
|
+
# bounding box at the current <tt>y</tt> position.
|
132
|
+
#
|
133
|
+
def horizontal_rule
|
134
|
+
horizontal_line(bounds.left, bounds.right)
|
135
|
+
end
|
136
|
+
|
137
|
+
# Draws a vertical line at the x cooordinate given by :at from y1 to y2.
|
138
|
+
#
|
139
|
+
# # draw a line from [25, 100] to [25, 300]
|
140
|
+
# vertical_line 100, 300, :at => 25
|
141
|
+
#
|
142
|
+
def vertical_line(y1,y2,params)
|
143
|
+
line(params[:at],y1,params[:at],y2)
|
144
|
+
end
|
145
|
+
|
146
|
+
# Draws a Bezier curve between two points, bounded by two additional
|
147
|
+
# points
|
148
|
+
#
|
149
|
+
# pdf.curve [50,100], [100,100], :bounds => [[90,90],[75,75]]
|
150
|
+
#
|
151
|
+
def curve(origin,dest, options={})
|
152
|
+
move_to(*origin)
|
153
|
+
curve_to(dest,options)
|
154
|
+
end
|
155
|
+
|
156
|
+
# This constant is used to approximate a symmetrical arc using a cubic
|
157
|
+
# Bezier curve.
|
158
|
+
#
|
159
|
+
KAPPA = 4.0 * ((Math.sqrt(2) - 1.0) / 3.0)
|
160
|
+
|
161
|
+
# Draws a circle of radius <tt>:radius</tt> with the centre-point at <tt>point</tt>
|
162
|
+
# as a complete subpath. The drawing point will be moved to the
|
163
|
+
# centre-point upon completion of the drawing the circle.
|
164
|
+
#
|
165
|
+
# pdf.circle_at [100,100], :radius => 25
|
166
|
+
#
|
167
|
+
def circle_at(point, options)
|
168
|
+
x,y = point
|
169
|
+
ellipse_at [x, y], options[:radius]
|
170
|
+
end
|
171
|
+
|
172
|
+
# Draws an ellipse of +x+ radius <tt>r1</tt> and +y+ radius <tt>r2</tt>
|
173
|
+
# with the centre-point at <tt>point</tt> as a complete subpath. The
|
174
|
+
# drawing point will be moved to the centre-point upon completion of the
|
175
|
+
# drawing the ellipse.
|
176
|
+
#
|
177
|
+
# # draws an ellipse with x-radius 25 and y-radius 50
|
178
|
+
# pdf.ellipse_at [100,100], 25, 50
|
179
|
+
#
|
180
|
+
def ellipse_at(point, r1, r2 = r1)
|
181
|
+
x, y = point
|
182
|
+
l1 = r1 * KAPPA
|
183
|
+
l2 = r2 * KAPPA
|
184
|
+
|
185
|
+
move_to(x + r1, y)
|
186
|
+
|
187
|
+
# Upper right hand corner
|
188
|
+
curve_to [x, y + r2],
|
189
|
+
:bounds => [[x + r1, y + l1], [x + l2, y + r2]]
|
190
|
+
|
191
|
+
# Upper left hand corner
|
192
|
+
curve_to [x - r1, y],
|
193
|
+
:bounds => [[x - l2, y + r2], [x - r1, y + l1]]
|
194
|
+
|
195
|
+
# Lower left hand corner
|
196
|
+
curve_to [x, y - r2],
|
197
|
+
:bounds => [[x - r1, y - l1], [x - l2, y - r2]]
|
198
|
+
|
199
|
+
# Lower right hand corner
|
200
|
+
curve_to [x + r1, y],
|
201
|
+
:bounds => [[x + l2, y - r2], [x + r1, y - l1]]
|
202
|
+
|
203
|
+
move_to(x, y)
|
204
|
+
end
|
205
|
+
|
206
|
+
# Draws a polygon from the specified points.
|
207
|
+
#
|
208
|
+
# # draws a snazzy triangle
|
209
|
+
# pdf.polygon [100,100], [100,200], [200,200]
|
210
|
+
#
|
211
|
+
def polygon(*points)
|
212
|
+
move_to points[0]
|
213
|
+
(points[1..-1] << points[0]).each do |point|
|
214
|
+
line_to(*point)
|
215
|
+
end
|
216
|
+
end
|
217
|
+
|
218
|
+
# Strokes and closes the current path. See Graphic::Color for color details
|
219
|
+
#
|
220
|
+
def stroke
|
221
|
+
yield if block_given?
|
222
|
+
add_content "S"
|
223
|
+
end
|
224
|
+
|
225
|
+
# Draws and strokes a rectangle represented by the current bounding box
|
226
|
+
#
|
227
|
+
def stroke_bounds
|
228
|
+
stroke_rectangle bounds.top_left, bounds.width, bounds.height
|
229
|
+
end
|
230
|
+
|
231
|
+
# Fills and closes the current path. See Graphic::Color for color details
|
232
|
+
#
|
233
|
+
def fill
|
234
|
+
yield if block_given?
|
235
|
+
add_content "f"
|
236
|
+
end
|
237
|
+
|
238
|
+
# Fills, strokes, and closes the current path. See Graphic::Color for color details
|
239
|
+
#
|
240
|
+
def fill_and_stroke
|
241
|
+
yield if block_given?
|
242
|
+
add_content "b"
|
243
|
+
end
|
244
|
+
|
245
|
+
private
|
246
|
+
|
247
|
+
def translate(*point)
|
248
|
+
x,y = point.flatten
|
249
|
+
[@bounding_box.absolute_left + x, @bounding_box.absolute_bottom + y]
|
250
|
+
end
|
251
|
+
|
252
|
+
def translate!(point)
|
253
|
+
point.replace(translate(point))
|
254
|
+
end
|
255
|
+
|
256
|
+
end
|
257
|
+
end
|
@@ -0,0 +1,45 @@
|
|
1
|
+
# encoding: ASCII-8BIT
|
2
|
+
|
3
|
+
# jpg.rb : Extracts the data from a JPG that is needed for embedding
|
4
|
+
#
|
5
|
+
# Copyright April 2008, James Healy. All Rights Reserved.
|
6
|
+
#
|
7
|
+
# This is free software. Please see the LICENSE and COPYING files for details.
|
8
|
+
|
9
|
+
require 'stringio'
|
10
|
+
|
11
|
+
module Prawn
|
12
|
+
module Images
|
13
|
+
# A convenience class that wraps the logic for extracting the parts
|
14
|
+
# of a PNG image that we need to embed them in a PDF
|
15
|
+
class JPG
|
16
|
+
attr_reader :width, :height, :bits, :channels
|
17
|
+
attr_accessor :scaled_width, :scaled_height
|
18
|
+
|
19
|
+
JPEG_SOF_BLOCKS = %W(\xc0 \xc1 \xc2 \xc3 \xc5 \xc6 \xc7 \xc9 \xca \xcb \xcd \xce \xcf)
|
20
|
+
JPEG_APP_BLOCKS = %W(\xe0 \xe1 \xe2 \xe3 \xe4 \xe5 \xe6 \xe7 \xe8 \xe9 \xea \xeb \xec \xed \xee \xef)
|
21
|
+
|
22
|
+
# Process a new JPG image
|
23
|
+
#
|
24
|
+
# <tt>:data</tt>:: A string containing a full PNG file
|
25
|
+
#
|
26
|
+
def initialize(data)
|
27
|
+
data = StringIO.new(data.dup)
|
28
|
+
|
29
|
+
c_marker = "\xff" # Section marker.
|
30
|
+
data.read(2) # Skip the first two bytes of JPEG identifier.
|
31
|
+
loop do
|
32
|
+
marker, code, length = data.read(4).unpack('aan')
|
33
|
+
raise "JPEG marker not found!" if marker != c_marker
|
34
|
+
|
35
|
+
if JPEG_SOF_BLOCKS.include?(code)
|
36
|
+
@bits, @height, @width, @channels = data.read(6).unpack("CnnC")
|
37
|
+
break
|
38
|
+
end
|
39
|
+
|
40
|
+
buffer = data.read(length - 2)
|
41
|
+
end
|
42
|
+
end
|
43
|
+
end
|
44
|
+
end
|
45
|
+
end
|
@@ -0,0 +1,199 @@
|
|
1
|
+
# encoding: ASCII-8BIT
|
2
|
+
|
3
|
+
# png.rb : Extracts the data from a PNG that is needed for embedding
|
4
|
+
#
|
5
|
+
# Based on some similar code in PDF::Writer by Austin Ziegler
|
6
|
+
#
|
7
|
+
# Copyright April 2008, James Healy. All Rights Reserved.
|
8
|
+
#
|
9
|
+
# This is free software. Please see the LICENSE and COPYING files for details.
|
10
|
+
|
11
|
+
require 'stringio'
|
12
|
+
|
13
|
+
module Prawn
|
14
|
+
module Images
|
15
|
+
# A convenience class that wraps the logic for extracting the parts
|
16
|
+
# of a PNG image that we need to embed them in a PDF
|
17
|
+
class PNG
|
18
|
+
attr_reader :palette, :img_data, :transparency
|
19
|
+
attr_reader :width, :height, :bits
|
20
|
+
attr_reader :color_type, :compression_method, :filter_method
|
21
|
+
attr_reader :interlace_method, :alpha_channel
|
22
|
+
attr_accessor :scaled_width, :scaled_height
|
23
|
+
|
24
|
+
# Process a new PNG image
|
25
|
+
#
|
26
|
+
# <tt>data</tt>:: A string containing a full PNG file
|
27
|
+
#
|
28
|
+
def initialize(data)
|
29
|
+
data = StringIO.new(data.dup)
|
30
|
+
|
31
|
+
data.read(8) # Skip the default header
|
32
|
+
|
33
|
+
@palette = ""
|
34
|
+
@img_data = ""
|
35
|
+
@transparency = {}
|
36
|
+
|
37
|
+
loop do
|
38
|
+
chunk_size = data.read(4).unpack("N")[0]
|
39
|
+
section = data.read(4)
|
40
|
+
case section
|
41
|
+
when 'IHDR'
|
42
|
+
# we can grab other interesting values from here (like width,
|
43
|
+
# height, etc)
|
44
|
+
values = data.read(chunk_size).unpack("NNCCCCC")
|
45
|
+
|
46
|
+
@width = values[0]
|
47
|
+
@height = values[1]
|
48
|
+
@bits = values[2]
|
49
|
+
@color_type = values[3]
|
50
|
+
@compression_method = values[4]
|
51
|
+
@filter_method = values[5]
|
52
|
+
@interlace_method = values[6]
|
53
|
+
when 'PLTE'
|
54
|
+
@palette << data.read(chunk_size)
|
55
|
+
when 'IDAT'
|
56
|
+
@img_data << data.read(chunk_size)
|
57
|
+
when 'tRNS'
|
58
|
+
# This chunk can only occur once and it must occur after the
|
59
|
+
# PLTE chunk and before the IDAT chunk
|
60
|
+
@transparency = {}
|
61
|
+
case @color_type
|
62
|
+
when 3
|
63
|
+
# Indexed colour, RGB. Each byte in this chunk is an alpha for
|
64
|
+
# the palette index in the PLTE ("palette") chunk up until the
|
65
|
+
# last non-opaque entry. Set up an array, stretching over all
|
66
|
+
# palette entries which will be 0 (opaque) or 1 (transparent).
|
67
|
+
@transparency[:indexed] = data.read(chunk_size).unpack("C*")
|
68
|
+
short = 255 - @transparency[:indexed].size
|
69
|
+
@transparency[:indexed] += ([255] * short) if short > 0
|
70
|
+
when 0
|
71
|
+
# Greyscale. Corresponding to entries in the PLTE chunk.
|
72
|
+
# Grey is two bytes, range 0 .. (2 ^ bit-depth) - 1
|
73
|
+
grayval = data.read(chunk_size).unpack("n").first
|
74
|
+
@transparency[:grayscale] = grayval
|
75
|
+
when 2
|
76
|
+
# True colour with proper alpha channel.
|
77
|
+
@transparency[:rgb] = data.read(chunk_size).unpack("nnn")
|
78
|
+
end
|
79
|
+
when 'IEND'
|
80
|
+
# we've got everything we need, exit the loop
|
81
|
+
break
|
82
|
+
else
|
83
|
+
# unknown (or un-important) section, skip over it
|
84
|
+
data.seek(data.pos + chunk_size)
|
85
|
+
end
|
86
|
+
|
87
|
+
data.read(4) # Skip the CRC
|
88
|
+
end
|
89
|
+
|
90
|
+
# if our img_data contains alpha channel data, split it out
|
91
|
+
unfilter_image_data if alpha_channel?
|
92
|
+
end
|
93
|
+
|
94
|
+
def pixel_bytes
|
95
|
+
@pixel_bytes ||= case @color_type
|
96
|
+
when 0, 3, 4 then 1
|
97
|
+
when 1, 2, 6 then 3
|
98
|
+
end
|
99
|
+
end
|
100
|
+
|
101
|
+
private
|
102
|
+
|
103
|
+
def alpha_channel?
|
104
|
+
@color_type == 4 || @color_type == 6
|
105
|
+
end
|
106
|
+
|
107
|
+
def unfilter_image_data
|
108
|
+
data = Zlib::Inflate.inflate(@img_data).unpack 'C*'
|
109
|
+
@img_data = ""
|
110
|
+
@alpha_channel = ""
|
111
|
+
|
112
|
+
# each pixel has the color bytes, plus a byte of alpha channel
|
113
|
+
pixel_length = pixel_bytes + 1
|
114
|
+
scanline_length = pixel_length * @width + 1 # for filter
|
115
|
+
row = 0
|
116
|
+
pixels = []
|
117
|
+
paeth, pa, pb, pc = nil
|
118
|
+
until data.empty? do
|
119
|
+
row_data = data.slice! 0, scanline_length
|
120
|
+
filter = row_data.shift
|
121
|
+
case filter
|
122
|
+
when 0 # None
|
123
|
+
when 1 # Sub
|
124
|
+
row_data.each_with_index do |byte, index|
|
125
|
+
left = index < pixel_length ? 0 : row_data[index - pixel_length]
|
126
|
+
row_data[index] = (byte + left) % 256
|
127
|
+
#p [byte, left, row_data[index]]
|
128
|
+
end
|
129
|
+
when 2 # Up
|
130
|
+
row_data.each_with_index do |byte, index|
|
131
|
+
col = index / pixel_length
|
132
|
+
upper = row == 0 ? 0 : pixels[row-1][col][index % pixel_length]
|
133
|
+
row_data[index] = (upper + byte) % 256
|
134
|
+
end
|
135
|
+
when 3 # Average
|
136
|
+
row_data.each_with_index do |byte, index|
|
137
|
+
col = index / pixel_length
|
138
|
+
upper = row == 0 ? 0 : pixels[row-1][col][index % pixel_length]
|
139
|
+
left = index < pixel_length ? 0 : row_data[index - pixel_length]
|
140
|
+
|
141
|
+
row_data[index] = (byte + ((left + upper)/2).floor) % 256
|
142
|
+
end
|
143
|
+
when 4 # Paeth
|
144
|
+
left = upper = upper_left = nil
|
145
|
+
row_data.each_with_index do |byte, index|
|
146
|
+
col = index / pixel_length
|
147
|
+
|
148
|
+
left = index < pixel_length ? 0 : row_data[index - pixel_length]
|
149
|
+
if row.zero?
|
150
|
+
upper = upper_left = 0
|
151
|
+
else
|
152
|
+
upper = pixels[row-1][col][index % pixel_length]
|
153
|
+
upper_left = col.zero? ? 0 :
|
154
|
+
pixels[row-1][col-1][index % pixel_length]
|
155
|
+
end
|
156
|
+
|
157
|
+
p = left + upper - upper_left
|
158
|
+
pa = (p - left).abs
|
159
|
+
pb = (p - upper).abs
|
160
|
+
pc = (p - upper_left).abs
|
161
|
+
|
162
|
+
paeth = if pa <= pb && pa <= pc
|
163
|
+
left
|
164
|
+
elsif pb <= pc
|
165
|
+
upper
|
166
|
+
else
|
167
|
+
upper_left
|
168
|
+
end
|
169
|
+
|
170
|
+
row_data[index] = (byte + paeth) % 256
|
171
|
+
#p [byte, paeth, row_data[index]]
|
172
|
+
end
|
173
|
+
else
|
174
|
+
raise ArgumentError, "Invalid filter algorithm #{filter}"
|
175
|
+
end
|
176
|
+
|
177
|
+
s = []
|
178
|
+
row_data.each_slice pixel_length do |slice|
|
179
|
+
s << slice
|
180
|
+
end
|
181
|
+
pixels << s
|
182
|
+
row += 1
|
183
|
+
end
|
184
|
+
|
185
|
+
# convert the pixel data to seperate strings for colours and alpha
|
186
|
+
pixels.each do |row|
|
187
|
+
row.each do |pixel|
|
188
|
+
@img_data << pixel[0,pixel_bytes].pack("C*")
|
189
|
+
@alpha_channel << pixel.last
|
190
|
+
end
|
191
|
+
end
|
192
|
+
|
193
|
+
# compress the data
|
194
|
+
@img_data = Zlib::Deflate.deflate(@img_data)
|
195
|
+
@alpha_channel = Zlib::Deflate.deflate(@alpha_channel)
|
196
|
+
end
|
197
|
+
end
|
198
|
+
end
|
199
|
+
end
|