1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
|
/* Copyright (C) 2001-2006 artofcode LLC.
All Rights Reserved.
This software is provided AS-IS with no warranty, either express or
implied.
This software is distributed under license and may not be copied, modified
or distributed except as expressly authorized under the terms of that
license. Refer to licensing information at http://www.artifex.com/
or contact Artifex Software, Inc., 7 Mt. Lassen Drive - Suite A-134,
San Rafael, CA 94903, U.S.A., +1(415)492-9861, for further information.
*/
/* $Id$ */
/* PDF 1.4 blending functions */
#ifndef gxblend_INCLUDED
# define gxblend_INCLUDED
typedef bits16 ArtPixMaxDepth;
#define ART_MAX_CHAN 16
/**
* art_blend_pixel: Compute PDF 1.4 blending function.
* @dst: Where to store resulting pixel.
* @backdrop: Backdrop pixel color.
* @src: Source pixel color.
* @n_chan: Number of channels.
* @blend_mode: Blend mode.
*
* Computes the blend of two pixels according the PDF 1.4 transparency
* spec (section 3.2, Blend Mode). A few things to keep in mind about
* this implementation:
*
* 1. This is a reference implementation, not a high-performance one.
* Blending using this function will incur a function call and switch
* statement per pixel, and will also incur the extra cost of 16 bit
* math.
*
* 2. Zero is black, one is white. In a subtractive color space such
* as CMYK, all pixels should be represented as "complemented", as
* described in section 3.1 (Blending Color Space) of the PDF 1.4
* transparency spec.
*
* 3. I haven't really figured out how to handle the Compatible blend
* mode. I wouldn't be surprised if it required an API change.
**/
void
art_blend_pixel(ArtPixMaxDepth * dst, const ArtPixMaxDepth * backdrop,
const ArtPixMaxDepth * src, int n_chan,
gs_blend_mode_t blend_mode);
/**
* art_blend_pixel_8: Compute PDF 1.4 blending function on 8-bit pixels.
* @dst: Where to store resulting pixel.
* @backdrop: Backdrop pixel color.
* @src: Source pixel color.
* @n_chan: Number of channels.
* @blend_mode: Blend mode.
*
* Computes the blend of two pixels according the PDF 1.4 transparency
* spec (section 3.2, Blend Mode). A few things to keep in mind about
* this implementation:
*
* 1. This is a reference implementation, not a high-performance one.
* Blending using this function will incur a function call and switch
* statement per pixel, and will also incur the extra cost of 16 bit
* math.
*
* 2. Zero is black, one is white. In a subtractive color space such
* as CMYK, all pixels should be represented as "complemented", as
* described in section 3.1 (Blending Color Space) of the PDF 1.4
* transparency spec.
*
* 3. I haven't really figured out how to handle the Compatible blend
* mode. I wouldn't be surprised if it required an API change.
**/
void
art_blend_pixel_8(byte *dst, const byte *backdrop,
const byte *src, int n_chan, gs_blend_mode_t blend_mode);
/**
* art_pdf_union_8: Union together two alpha values.
* @alpha1: One alpha value.
* @alpha2: Another alpha value.
*
* Return value: Union (@alpha1, @alpha2).
**/
byte art_pdf_union_8(byte alpha1, byte alpha2);
/**
* art_pdf_union_mul_8: Union together two alpha values, with mask.
* @alpha1: One alpha value.
* @alpha2: Another alpha value.
* @alpha_mask: A mask alpha value;
*
* Return value: Union (@alpha1, @alpha2 * @alpha_mask).
**/
byte art_pdf_union_mul_8(byte alpha1, byte alpha2, byte alpha_mask);
/**
* art_pdf_composite_pixel_alpha_8: Composite two alpha pixels.
* @dst: Where to store resulting pixel, also initially backdrop color.
* @src: Source pixel color.
* @n_chan: Number of channels.
* @blend_mode: Blend mode.
*
* Composites two pixels using the basic compositing operation. A few
* things to keep in mind:
*
* 1. This is a reference implementation, not a high-performance one.
*
* 2. All pixels are assumed to have a single alpha channel.
*
* 3. Zero is black, one is white.
*
* Also note that src and dst are expected to be allocated aligned to
* 32 bit boundaries, ie bytes from [0] to [(n_chan + 3) & -4] may
* be accessed.
**/
void
art_pdf_composite_pixel_alpha_8(byte *dst, const byte *src, int n_chan,
gs_blend_mode_t blend_mode);
/**
* art_pdf_uncomposite_group_8: Uncomposite group pixel.
* @dst: Where to store uncomposited pixel.
* @backdrop: Backdrop.
* @src: Composited source pixel.
* @src_alpha_g: alpha_g value associated with @src.
* @n_chan: Number of channels.
*
* Performs uncompositing operation as described in 5.3 of the Adobe spec.
**/
void
art_pdf_uncomposite_group_8(byte *dst,
const byte *backdrop,
const byte *src, byte src_alpha_g, int n_chan);
/**
* art_pdf_recomposite_group_8: Recomposite group pixel.
* @dst: Where to store pixel, also initial backdrop of group.
* @dst_alpha_g: Optional pointer to alpha g value associated with @dst.
* @alpha: Alpha mask value.
* @src_alpha_g: alpha_g value associated with @src.
* @blend_mode: Blend mode for compositing.
*
* Note: this is only for non-isolated groups. This covers only the
* single-alpha case. A separate function is needed for dual-alpha,
* and that probably needs to treat knockout separately.
*
* @src_alpha_g corresponds to $\alpha g_n$ in the Adobe notation.
*
* @alpha corresponds to $fk_i \cdot fm_i \cdot qk_i \cdot qm_i$.
**/
void
art_pdf_recomposite_group_8(byte *dst, byte *dst_alpha_g,
const byte *src, byte src_alpha_g,
int n_chan,
byte alpha, gs_blend_mode_t blend_mode);
/**
* art_pdf_composite_group_8: Composite group pixel.
* @dst: Where to store pixel, also initial backdrop of group.
* @dst_alpha_g: Optional pointer to alpha g value.
* @alpha: Alpha mask value.
*
* Note: this is only for isolated groups. This covers only the
* single-alpha case. A separate function is needed for dual-alpha,
* and that probably needs to treat knockout separately.
*
* @alpha corresponds to $fk_i \cdot fm_i \cdot qk_i \cdot qm_i$.
**/
void
art_pdf_composite_group_8(byte *dst, byte *alpha_g,
const byte *src,
int n_chan, byte alpha, gs_blend_mode_t blend_mode);
/**
* art_pdf_composite_knockout_simple_8: Simple knockout compositing.
* @dst: Destination pixel.
* @dst_shape: Shape associated with @dst.
* @src: Source pixel.
* @n_chan: Number of channels.
* @opacity: Opacity.
*
* This function handles the simplest knockout case: an isolated
* knockout group, and an elementary shape. The alpha channel of @src
* is interpreted as shape.
**/
void
art_pdf_composite_knockout_simple_8(byte *dst,
byte *dst_shape,
const byte *src,
int n_chan, byte opacity);
/**
* art_pdf_composite_knockout_isolated_8: Simple knockout compositing.
* @dst: Destination pixel.
* @dst_shape: Shape associated with @dst.
* @src: Source pixel.
* @n_chan: Number of channels.
* @shape: Shape.
* @alpha_mask: Alpha mask.
* @shape_mask: Shape mask.
*
* This function handles compositin in an isolated knockout case. The
* alpha channel of @src is interpreted as alpha.
**/
void
art_pdf_composite_knockout_isolated_8(byte *dst,
byte *dst_shape,
const byte *src,
int n_chan,
byte shape,
byte alpha_mask, byte shape_mask);
/**
* art_pdf_composite_knockout_8: General knockout compositing.
* @dst: Destination pixel.
* @dst_alpha_g: Pointer to alpha g value associated with @dst.
* @backdrop: Backdrop pixel (initial backdrop of knockout group).
* @src: Source pixel.
* @n_chan: Number of channels.
* @shape: Shape.
* @alpha_mask: Alpha mask.
* @shape_mask: Shape mask.
* @blend_mode: Blend mode for compositing.
*
* This function handles compositing in the case where the knockout
* group is non-isolated. If the @src pixels themselves come from a
* non-isolated group, they should be uncomposited before calling this
* routine.
**/
void
art_pdf_composite_knockout_8(byte *dst,
byte *dst_alpha_g,
const byte *backdrop,
const byte *src,
int n_chan,
byte shape,
byte alpha_mask,
byte shape_mask, gs_blend_mode_t blend_mode);
#endif /* gxblend_INCLUDED */
|
