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 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426
|
/* Copyright (C) 2001-2012 Artifex Software, Inc.
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 the license contained in the file LICENSE in this distribution.
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.
*/
/* PDF 1.4 blending functions */
#ifndef gxblend_INCLUDED
# define gxblend_INCLUDED
#include "gxcindex.h"
#include "gxcvalue.h"
#include "gxfrac.h"
#include "gxdevcli.h"
/* Visual trace options : set one to 1. */
#define VD_PAINT_MASK 0
#define VD_PAINT_COLORS 0
#define VD_PAINT_ALPHA 1
#define RAW_DUMP 0
#define RAW_DUMP_AS_PAM 0
/* Useful bash fragment to batch convert pams to pngs:
* for f in *.pam; do g=${f%.*}; echo $g; convert $g.pam $g.png ; done
*/
/* #define DUMP_TO_PNG */
#define PDF14_MAX_PLANES GX_DEVICE_COLOR_MAX_COMPONENTS+3 /* Needed for alpha channel, shape, group alpha */
typedef bits16 ArtPixMaxDepth;
#define ART_MAX_CHAN GX_DEVICE_COLOR_MAX_COMPONENTS
#ifndef pdf14_device_DEFINED
# define pdf14_device_DEFINED
typedef struct pdf14_device_s pdf14_device;
#endif
#ifndef pdf14_buf_DEFINED
# define pdf14_buf_DEFINED
typedef struct pdf14_buf_s pdf14_buf;
#endif
#ifndef gx_device_DEFINED
# define gx_device_DEFINED
typedef struct gx_device_s gx_device;
#endif
#ifndef gs_separations_DEFINED
# define gs_separations_DEFINED
typedef struct gs_separations_s gs_separations;
#endif
/*
* This structure contains procedures for processing which differ
* between the different blending color spaces.
*
* The Luminosity, Color, Saturation, and Hue blend modes depend
* upon the blending color space. Currently the blending color space
* matches the process color model of the compositing device. We need
* two routines to implement the four 'non separable' blend modes.
*/
typedef struct {
/*
* Perform luminosity and color blending. (Also used for hue blending.)
*/
void (* blend_luminosity)(int n_chan, byte *dst,
const byte *backdrop, const byte *src);
/*
* Perform saturation blending. (Also used for hue blending.)
*/
void (* blend_saturation)(int n_chan, byte *dst,
const byte *backdrop, const byte *src);
} pdf14_nonseparable_blending_procs_s;
typedef pdf14_nonseparable_blending_procs_s
pdf14_nonseparable_blending_procs_t;
/* This is used to so that we can change procedures based
* upon the Smask color space. previously we always
* went to the device space */
typedef struct {
pdf14_nonseparable_blending_procs_t device_procs;
gx_device_procs color_mapping_procs;
} pdf14_parent_cs_params_s;
typedef pdf14_parent_cs_params_s pdf14_parent_cs_params_t;
/* This function is used for mapping Smask CMYK or RGB data to a monochrome alpha buffer */
void smask_luminosity_mapping(int num_rows, int num_cols, int n_chan, int row_stride,
int plane_stride, byte *src, const byte *des, bool isadditive,
gs_transparency_mask_subtype_t SMask_SubType);
void smask_blend(byte *src, int width, int height, int rowstride,
int planestride);
void smask_copy(int num_rows, int num_cols, int row_stride,
byte *src, const byte *des);
void smask_icc(gx_device *dev, int num_rows, int num_cols, int n_chan,
int row_stride, int plane_stride, byte *src, const byte *des,
gsicc_link_t *icclink);
/**
* 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.
* @pblend_procs: Procs for handling non separable blending modes.
*
* 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,
const pdf14_nonseparable_blending_procs_t * pblend_procs);
/**
* 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.
* @pblend_procs: Procs for handling non separable blending modes.
*
* 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,
const pdf14_nonseparable_blending_procs_t * pblend_procs);
/**
* 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.
* @pblend_procs: Procs for handling non separable blending modes.
*
* 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,
const pdf14_nonseparable_blending_procs_t * pblend_procs);
/**
* 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.
* @blend_mode: Blend mode for compositing.
* @pblend_procs: Procs for handling non separable blending modes.
*
* 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 *dst_alpha_g,
const byte *src, int n_chan, byte alpha, gs_blend_mode_t blend_mode,
const pdf14_nonseparable_blending_procs_t * pblend_procs);
/**
* 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,
byte *dst_tag,
const byte *src, byte tag,
int n_chan, byte opacity);
/**
* art_pdf_knockoutisolated_group_8: Knockout for isolated group.
* @dst: Destination pixel.
* @src: Source pixel.
* @n_chan: Number of channels.
*
* This function handles the simple case with an isolated knockout group.
**/
void
art_pdf_knockoutisolated_group_8(byte *dst, const byte *src, int n_chan);
/**
* art_pdf_composite_knockout_isolated_8: Simple knockout compositing.
* @dst: Destination pixel.
* @dst_shape: Shape associated with @dst.
* @dst_tag: Tag associated with @dst.
* @src: Source pixel.
* @n_chan: Number of channels.
* @shape: Shape.
* @shape: Tag.
* @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,
byte *dst_tag,
const byte *src,
int n_chan,
byte shape,
byte tag,
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.
* @pblend_procs: Procs for handling non separable blending modes.
*
* 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,
const pdf14_nonseparable_blending_procs_t * pblend_procs);
/*
* Routines for handling the non separable blending modes.
*/
/* RGB blending color space */
void art_blend_luminosity_rgb_8(int n_chan, byte *dst, const byte *backdrop,
const byte *src);
void art_blend_saturation_rgb_8(int n_chan, byte *dst, const byte *backdrop,
const byte *src);
/* CMYK and CMYK + spot blending color space */
void art_blend_saturation_cmyk_8(int n_chan, byte *dst, const byte *backdrop,
const byte *src);
void art_blend_luminosity_cmyk_8(int n_chan, byte *dst, const byte *backdrop,
const byte *src);
/* 'Custom' i.e. unknown blending color space. */
void art_blend_luminosity_custom_8(int n_chan, byte *dst, const byte *backdrop,
const byte *src);
void art_blend_saturation_custom_8(int n_chan, byte *dst, const byte *backdrop,
const byte *src);
void pdf14_unpack_additive(int num_comp, gx_color_index color,
pdf14_device * p14dev, byte * out);
void pdf14_unpack_subtractive(int num_comp, gx_color_index color,
pdf14_device * p14dev, byte * out);
void pdf14_unpack_compressed(int num_comp, gx_color_index color,
pdf14_device * p14dev, byte * out);
void pdf14_unpack_custom(int num_comp, gx_color_index color,
pdf14_device * p14dev, byte * out);
void pdf14_preserve_backdrop(pdf14_buf *buf, pdf14_buf *tos, bool has_shape);
void pdf14_compose_group(pdf14_buf *tos, pdf14_buf *nos, pdf14_buf *maskbuf,
int x0, int x1, int y0, int y1, int n_chan, bool additive,
const pdf14_nonseparable_blending_procs_t * pblend_procs);
gx_color_index pdf14_encode_color(gx_device *dev, const gx_color_value colors[]);
gx_color_index pdf14_encode_color_tag(gx_device *dev, const gx_color_value colors[]);
int pdf14_decode_color(gx_device * dev, gx_color_index color, gx_color_value * out);
gx_color_index pdf14_compressed_encode_color(gx_device *dev, const gx_color_value colors[]);
int pdf14_compressed_decode_color(gx_device * dev, gx_color_index color,
gx_color_value * out);
void pdf14_gray_cs_to_cmyk_cm(gx_device * dev, frac gray, frac out[]);
void pdf14_rgb_cs_to_cmyk_cm(gx_device * dev, const gs_imager_state *pis,
frac r, frac g, frac b, frac out[]);
void pdf14_cmyk_cs_to_cmyk_cm(gx_device * dev, frac c, frac m, frac y, frac k, frac out[]);
void gx_build_blended_image_row(byte *buf_ptr, int y, int planestride,
int width, int num_comp, byte bg, byte *linebuf);
void gx_blend_image_buffer(byte *buf_ptr, int width, int height,
int rowstride, int planestride, int num_comp, byte bg);
int gx_put_blended_image_cmykspot(gx_device *target, byte *buf_ptr,
int planestride, int rowstride,
int x0, int y0, int width, int height, int num_comp, byte bg,
bool has_tags, gs_int_rect rect, gs_separations *pseparations);
int gx_put_blended_image_custom(gx_device *target, byte *buf_ptr,
int planestride, int rowstride,
int x0, int y0, int width, int height, int num_comp, byte bg);
#if RAW_DUMP
void dump_raw_buffer(int num_rows, int width, int n_chan,
int plane_stride, int rowstride,
char filename[],byte *Buffer);
#endif
#endif /* gxblend_INCLUDED */
|