2 * Raster file definitions for CUPS.
4 * Copyright 2007-2016 by Apple Inc.
5 * Copyright 1997-2006 by Easy Software Products.
7 * This file is part of the CUPS Imaging library.
9 * Licensed under Apache License v2.0. See the file "LICENSE" for more information.
12 #ifndef _CUPS_RASTER_H_
13 # define _CUPS_RASTER_H_
16 * Include necessary headers...
24 # endif /* __cplusplus */
27 * Every non-PostScript printer driver that supports raster images
28 * should use the application/vnd.cups-raster image file format.
29 * Since both the PostScript RIP (pstoraster, based on GNU/GPL
30 * Ghostscript) and Image RIP (imagetoraster, located in the filter
31 * directory) use it, using this format saves you a lot of work.
32 * Also, the PostScript RIP passes any printer options that are in
33 * a PS file to your driver this way as well...
40 # define CUPS_RASTER_SYNC 0x52615333 /* RaS3 */
41 # define CUPS_RASTER_REVSYNC 0x33536152 /* 3SaR */
43 # define CUPS_RASTER_SYNCv1 0x52615374 /* RaSt */
44 # define CUPS_RASTER_REVSYNCv1 0x74536152 /* tSaR */
46 # define CUPS_RASTER_SYNCv2 0x52615332 /* RaS2 */
47 # define CUPS_RASTER_REVSYNCv2 0x32536152 /* 2SaR */
49 # define CUPS_RASTER_SYNCapple 0x554E4952 /* UNIR */
50 # define CUPS_RASTER_REVSYNCapple 0x52494E55 /* RINU */
52 # define CUPS_RASTER_SYNC_PWG CUPS_RASTER_SYNCv2
55 * The following definition can be used to determine if the
56 * colorimetric colorspaces (CIEXYZ, CIELAB, and ICCn) are
60 # define CUPS_RASTER_HAVE_COLORIMETRIC 1
63 * The following definition can be used to determine if the
64 * device colorspaces (DEVICEn) are defined...
67 # define CUPS_RASTER_HAVE_DEVICE 1
70 * The following definition can be used to determine if PWG Raster is supported.
73 # define CUPS_RASTER_HAVE_PWGRASTER 1
76 * The following definition can be used to determine if Apple Raster is
80 # define CUPS_RASTER_HAVE_APPLERASTER 1
83 * The following PWG 5102.4 definitions specify indices into the
84 * cupsInteger[] array in the raster header.
87 # define CUPS_RASTER_PWG_TotalPageCount 0
88 # define CUPS_RASTER_PWG_CrossFeedTransform 1
89 # define CUPS_RASTER_PWG_FeedTransform 2
90 # define CUPS_RASTER_PWG_ImageBoxLeft 3
91 # define CUPS_RASTER_PWG_ImageBoxTop 4
92 # define CUPS_RASTER_PWG_ImageBoxRight 5
93 # define CUPS_RASTER_PWG_ImageBoxBottom 6
94 # define CUPS_RASTER_PWG_AlternatePrimary 7
95 # define CUPS_RASTER_PWG_PrintQuality 8
96 # define CUPS_RASTER_PWG_VendorIdentifier 14
97 # define CUPS_RASTER_PWG_VendorLength 15
106 typedef enum cups_adv_e
/**** AdvanceMedia attribute values ****/
108 CUPS_ADVANCE_NONE
= 0, /* Never advance the roll */
109 CUPS_ADVANCE_FILE
= 1, /* Advance the roll after this file */
110 CUPS_ADVANCE_JOB
= 2, /* Advance the roll after this job */
111 CUPS_ADVANCE_SET
= 3, /* Advance the roll after this set */
112 CUPS_ADVANCE_PAGE
= 4 /* Advance the roll after this page */
115 typedef enum cups_bool_e
/**** Boolean type ****/
117 CUPS_FALSE
= 0, /* Logical false */
118 CUPS_TRUE
= 1 /* Logical true */
121 typedef enum cups_cspace_e
/**** cupsColorSpace attribute values ****/
123 CUPS_CSPACE_W
= 0, /* Luminance (DeviceGray, gamma 2.2 by default) */
124 CUPS_CSPACE_RGB
= 1, /* Red, green, blue (DeviceRGB, sRGB by default) */
125 CUPS_CSPACE_RGBA
= 2, /* Red, green, blue, alpha (DeviceRGB, sRGB by default) */
126 CUPS_CSPACE_K
= 3, /* Black (DeviceK) */
127 CUPS_CSPACE_CMY
= 4, /* Cyan, magenta, yellow (DeviceCMY) */
128 CUPS_CSPACE_YMC
= 5, /* Yellow, magenta, cyan @deprecated@ */
129 CUPS_CSPACE_CMYK
= 6, /* Cyan, magenta, yellow, black (DeviceCMYK) */
130 CUPS_CSPACE_YMCK
= 7, /* Yellow, magenta, cyan, black @deprecated@ */
131 CUPS_CSPACE_KCMY
= 8, /* Black, cyan, magenta, yellow @deprecated@ */
132 CUPS_CSPACE_KCMYcm
= 9, /* Black, cyan, magenta, yellow, light-cyan, light-magenta @deprecated@ */
133 CUPS_CSPACE_GMCK
= 10, /* Gold, magenta, yellow, black @deprecated@ */
134 CUPS_CSPACE_GMCS
= 11, /* Gold, magenta, yellow, silver @deprecated@ */
135 CUPS_CSPACE_WHITE
= 12, /* White ink (as black) @deprecated@ */
136 CUPS_CSPACE_GOLD
= 13, /* Gold foil @deprecated@ */
137 CUPS_CSPACE_SILVER
= 14, /* Silver foil @deprecated@ */
139 CUPS_CSPACE_CIEXYZ
= 15, /* CIE XYZ @since CUPS 1.1.19/macOS 10.3@ */
140 CUPS_CSPACE_CIELab
= 16, /* CIE Lab @since CUPS 1.1.19/macOS 10.3@ */
141 CUPS_CSPACE_RGBW
= 17, /* Red, green, blue, white (DeviceRGB, sRGB by default) @since CUPS 1.2/macOS 10.5@ */
142 CUPS_CSPACE_SW
= 18, /* Luminance (gamma 2.2) @since CUPS 1.4.5@ */
143 CUPS_CSPACE_SRGB
= 19, /* Red, green, blue (sRGB) @since CUPS 1.4.5@ */
144 CUPS_CSPACE_ADOBERGB
= 20, /* Red, green, blue (Adobe RGB) @since CUPS 1.4.5@ */
146 CUPS_CSPACE_ICC1
= 32, /* ICC-based, 1 color @since CUPS 1.1.19/macOS 10.3@ */
147 CUPS_CSPACE_ICC2
= 33, /* ICC-based, 2 colors @since CUPS 1.1.19/macOS 10.3@ */
148 CUPS_CSPACE_ICC3
= 34, /* ICC-based, 3 colors @since CUPS 1.1.19/macOS 10.3@ */
149 CUPS_CSPACE_ICC4
= 35, /* ICC-based, 4 colors @since CUPS 1.1.19/macOS 10.3@ */
150 CUPS_CSPACE_ICC5
= 36, /* ICC-based, 5 colors @since CUPS 1.1.19/macOS 10.3@ */
151 CUPS_CSPACE_ICC6
= 37, /* ICC-based, 6 colors @since CUPS 1.1.19/macOS 10.3@ */
152 CUPS_CSPACE_ICC7
= 38, /* ICC-based, 7 colors @since CUPS 1.1.19/macOS 10.3@ */
153 CUPS_CSPACE_ICC8
= 39, /* ICC-based, 8 colors @since CUPS 1.1.19/macOS 10.3@ */
154 CUPS_CSPACE_ICC9
= 40, /* ICC-based, 9 colors @since CUPS 1.1.19/macOS 10.3@ */
155 CUPS_CSPACE_ICCA
= 41, /* ICC-based, 10 colors @since CUPS 1.1.19/macOS 10.3@ */
156 CUPS_CSPACE_ICCB
= 42, /* ICC-based, 11 colors @since CUPS 1.1.19/macOS 10.3@ */
157 CUPS_CSPACE_ICCC
= 43, /* ICC-based, 12 colors @since CUPS 1.1.19/macOS 10.3@ */
158 CUPS_CSPACE_ICCD
= 44, /* ICC-based, 13 colors @since CUPS 1.1.19/macOS 10.3@ */
159 CUPS_CSPACE_ICCE
= 45, /* ICC-based, 14 colors @since CUPS 1.1.19/macOS 10.3@ */
160 CUPS_CSPACE_ICCF
= 46, /* ICC-based, 15 colors @since CUPS 1.1.19/macOS 10.3@ */
162 CUPS_CSPACE_DEVICE1
= 48, /* DeviceN, 1 color @since CUPS 1.4.5@ */
163 CUPS_CSPACE_DEVICE2
= 49, /* DeviceN, 2 colors @since CUPS 1.4.5@ */
164 CUPS_CSPACE_DEVICE3
= 50, /* DeviceN, 3 colors @since CUPS 1.4.5@ */
165 CUPS_CSPACE_DEVICE4
= 51, /* DeviceN, 4 colors @since CUPS 1.4.5@ */
166 CUPS_CSPACE_DEVICE5
= 52, /* DeviceN, 5 colors @since CUPS 1.4.5@ */
167 CUPS_CSPACE_DEVICE6
= 53, /* DeviceN, 6 colors @since CUPS 1.4.5@ */
168 CUPS_CSPACE_DEVICE7
= 54, /* DeviceN, 7 colors @since CUPS 1.4.5@ */
169 CUPS_CSPACE_DEVICE8
= 55, /* DeviceN, 8 colors @since CUPS 1.4.5@ */
170 CUPS_CSPACE_DEVICE9
= 56, /* DeviceN, 9 colors @since CUPS 1.4.5@ */
171 CUPS_CSPACE_DEVICEA
= 57, /* DeviceN, 10 colors @since CUPS 1.4.5@ */
172 CUPS_CSPACE_DEVICEB
= 58, /* DeviceN, 11 colors @since CUPS 1.4.5@ */
173 CUPS_CSPACE_DEVICEC
= 59, /* DeviceN, 12 colors @since CUPS 1.4.5@ */
174 CUPS_CSPACE_DEVICED
= 60, /* DeviceN, 13 colors @since CUPS 1.4.5@ */
175 CUPS_CSPACE_DEVICEE
= 61, /* DeviceN, 14 colors @since CUPS 1.4.5@ */
176 CUPS_CSPACE_DEVICEF
= 62 /* DeviceN, 15 colors @since CUPS 1.4.5@ */
179 typedef enum cups_cut_e
/**** CutMedia attribute values ****/
181 CUPS_CUT_NONE
= 0, /* Never cut the roll */
182 CUPS_CUT_FILE
= 1, /* Cut the roll after this file */
183 CUPS_CUT_JOB
= 2, /* Cut the roll after this job */
184 CUPS_CUT_SET
= 3, /* Cut the roll after this set */
185 CUPS_CUT_PAGE
= 4 /* Cut the roll after this page */
188 typedef enum cups_edge_e
/**** LeadingEdge attribute values ****/
190 CUPS_EDGE_TOP
= 0, /* Leading edge is the top of the page */
191 CUPS_EDGE_RIGHT
= 1, /* Leading edge is the right of the page */
192 CUPS_EDGE_BOTTOM
= 2, /* Leading edge is the bottom of the page */
193 CUPS_EDGE_LEFT
= 3 /* Leading edge is the left of the page */
196 typedef enum cups_jog_e
/**** Jog attribute values ****/
198 CUPS_JOG_NONE
= 0, /* Never move pages */
199 CUPS_JOG_FILE
= 1, /* Move pages after this file */
200 CUPS_JOG_JOB
= 2, /* Move pages after this job */
201 CUPS_JOG_SET
= 3 /* Move pages after this set */
204 enum cups_mode_e
/**** cupsRasterOpen modes ****/
206 CUPS_RASTER_READ
= 0, /* Open stream for reading */
207 CUPS_RASTER_WRITE
= 1, /* Open stream for writing */
208 CUPS_RASTER_WRITE_COMPRESSED
= 2, /* Open stream for compressed writing @since CUPS 1.3/macOS 10.5@ */
209 CUPS_RASTER_WRITE_PWG
= 3, /* Open stream for compressed writing in PWG Raster mode @since CUPS 1.5/macOS 10.7@ */
210 CUPS_RASTER_WRITE_APPLE
= 4 /* Open stream for compressed writing in AppleRaster mode (beta) @private@ */
213 typedef enum cups_mode_e cups_mode_t
; /**** cupsRasterOpen modes ****/
215 typedef enum cups_order_e
/**** cupsColorOrder attribute values ****/
217 CUPS_ORDER_CHUNKED
= 0, /* CMYK CMYK CMYK ... */
218 CUPS_ORDER_BANDED
= 1, /* CCC MMM YYY KKK ... */
219 CUPS_ORDER_PLANAR
= 2 /* CCC ... MMM ... YYY ... KKK ... */
222 typedef enum cups_orient_e
/**** Orientation attribute values ****/
224 CUPS_ORIENT_0
= 0, /* Don't rotate the page */
225 CUPS_ORIENT_90
= 1, /* Rotate the page counter-clockwise */
226 CUPS_ORIENT_180
= 2, /* Turn the page upside down */
227 CUPS_ORIENT_270
= 3 /* Rotate the page clockwise */
232 * The page header structure contains the standard PostScript page device
233 * dictionary, along with some CUPS-specific parameters that are provided
236 * The API supports a "version 1" (from CUPS 1.0 and 1.1) and a "version 2"
237 * (from CUPS 1.2 and higher) page header, for binary compatibility.
240 typedef struct cups_page_header_s
/**** Version 1 page header @deprecated@ ****/
242 /**** Standard Page Device Dictionary String Values ****/
243 char MediaClass
[64]; /* MediaClass string */
244 char MediaColor
[64]; /* MediaColor string */
245 char MediaType
[64]; /* MediaType string */
246 char OutputType
[64]; /* OutputType string */
248 /**** Standard Page Device Dictionary Integer Values ****/
249 unsigned AdvanceDistance
; /* AdvanceDistance value in points */
250 cups_adv_t AdvanceMedia
; /* AdvanceMedia value (@link cups_adv_t@) */
251 cups_bool_t Collate
; /* Collated copies value */
252 cups_cut_t CutMedia
; /* CutMedia value (@link cups_cut_t@) */
253 cups_bool_t Duplex
; /* Duplexed (double-sided) value */
254 unsigned HWResolution
[2]; /* Resolution in dots-per-inch */
255 unsigned ImagingBoundingBox
[4]; /* Pixel region that is painted (points, left, bottom, right, top) */
256 cups_bool_t InsertSheet
; /* InsertSheet value */
257 cups_jog_t Jog
; /* Jog value (@link cups_jog_t@) */
258 cups_edge_t LeadingEdge
; /* LeadingEdge value (@link cups_edge_t@) */
259 unsigned Margins
[2]; /* Lower-lefthand margins in points */
260 cups_bool_t ManualFeed
; /* ManualFeed value */
261 unsigned MediaPosition
; /* MediaPosition value */
262 unsigned MediaWeight
; /* MediaWeight value in grams/m^2 */
263 cups_bool_t MirrorPrint
; /* MirrorPrint value */
264 cups_bool_t NegativePrint
; /* NegativePrint value */
265 unsigned NumCopies
; /* Number of copies to produce */
266 cups_orient_t Orientation
; /* Orientation value (@link cups_orient_t@) */
267 cups_bool_t OutputFaceUp
; /* OutputFaceUp value */
268 unsigned PageSize
[2]; /* Width and length of page in points */
269 cups_bool_t Separations
; /* Separations value */
270 cups_bool_t TraySwitch
; /* TraySwitch value */
271 cups_bool_t Tumble
; /* Tumble value */
273 /**** CUPS Page Device Dictionary Values ****/
274 unsigned cupsWidth
; /* Width of page image in pixels */
275 unsigned cupsHeight
; /* Height of page image in pixels */
276 unsigned cupsMediaType
; /* Media type code */
277 unsigned cupsBitsPerColor
; /* Number of bits for each color */
278 unsigned cupsBitsPerPixel
; /* Number of bits for each pixel */
279 unsigned cupsBytesPerLine
; /* Number of bytes per line */
280 cups_order_t cupsColorOrder
; /* Order of colors */
281 cups_cspace_t cupsColorSpace
; /* True colorspace */
282 unsigned cupsCompression
; /* Device compression to use */
283 unsigned cupsRowCount
; /* Rows per band */
284 unsigned cupsRowFeed
; /* Feed between bands */
285 unsigned cupsRowStep
; /* Spacing between lines */
286 } cups_page_header_t
;
288 /**** New in CUPS 1.2 ****/
289 typedef struct cups_page_header2_s
/**** Version 2 page header @since CUPS 1.2/macOS 10.5@ ****/
291 /**** Standard Page Device Dictionary String Values ****/
292 char MediaClass
[64]; /* MediaClass string */
293 char MediaColor
[64]; /* MediaColor string */
294 char MediaType
[64]; /* MediaType string */
295 char OutputType
[64]; /* OutputType string */
297 /**** Standard Page Device Dictionary Integer Values ****/
298 unsigned AdvanceDistance
; /* AdvanceDistance value in points */
299 cups_adv_t AdvanceMedia
; /* AdvanceMedia value (@link cups_adv_t@) */
300 cups_bool_t Collate
; /* Collated copies value */
301 cups_cut_t CutMedia
; /* CutMedia value (@link cups_cut_t@) */
302 cups_bool_t Duplex
; /* Duplexed (double-sided) value */
303 unsigned HWResolution
[2]; /* Resolution in dots-per-inch */
304 unsigned ImagingBoundingBox
[4]; /* Pixel region that is painted (points, left, bottom, right, top) */
305 cups_bool_t InsertSheet
; /* InsertSheet value */
306 cups_jog_t Jog
; /* Jog value (@link cups_jog_t@) */
307 cups_edge_t LeadingEdge
; /* LeadingEdge value (@link cups_edge_t@) */
308 unsigned Margins
[2]; /* Lower-lefthand margins in points */
309 cups_bool_t ManualFeed
; /* ManualFeed value */
310 unsigned MediaPosition
; /* MediaPosition value */
311 unsigned MediaWeight
; /* MediaWeight value in grams/m^2 */
312 cups_bool_t MirrorPrint
; /* MirrorPrint value */
313 cups_bool_t NegativePrint
; /* NegativePrint value */
314 unsigned NumCopies
; /* Number of copies to produce */
315 cups_orient_t Orientation
; /* Orientation value (@link cups_orient_t@) */
316 cups_bool_t OutputFaceUp
; /* OutputFaceUp value */
317 unsigned PageSize
[2]; /* Width and length of page in points */
318 cups_bool_t Separations
; /* Separations value */
319 cups_bool_t TraySwitch
; /* TraySwitch value */
320 cups_bool_t Tumble
; /* Tumble value */
322 /**** CUPS Page Device Dictionary Values ****/
323 unsigned cupsWidth
; /* Width of page image in pixels */
324 unsigned cupsHeight
; /* Height of page image in pixels */
325 unsigned cupsMediaType
; /* Media type code */
326 unsigned cupsBitsPerColor
; /* Number of bits for each color */
327 unsigned cupsBitsPerPixel
; /* Number of bits for each pixel */
328 unsigned cupsBytesPerLine
; /* Number of bytes per line */
329 cups_order_t cupsColorOrder
; /* Order of colors */
330 cups_cspace_t cupsColorSpace
; /* True colorspace */
331 unsigned cupsCompression
; /* Device compression to use */
332 unsigned cupsRowCount
; /* Rows per band */
333 unsigned cupsRowFeed
; /* Feed between bands */
334 unsigned cupsRowStep
; /* Spacing between lines */
336 /**** Version 2 Dictionary Values ****/
337 unsigned cupsNumColors
; /* Number of color compoents @since CUPS 1.2/macOS 10.5@ */
338 float cupsBorderlessScalingFactor
;
339 /* Scaling that was applied to page data @since CUPS 1.2/macOS 10.5@ */
340 float cupsPageSize
[2]; /* Floating point PageSize (scaling *
341 * factor not applied) @since CUPS 1.2/macOS 10.5@ */
342 float cupsImagingBBox
[4]; /* Floating point ImagingBoundingBox
343 * (scaling factor not applied, left,
344 * bottom, right, top) @since CUPS 1.2/macOS 10.5@ */
345 unsigned cupsInteger
[16]; /* User-defined integer values @since CUPS 1.2/macOS 10.5@ */
346 float cupsReal
[16]; /* User-defined floating-point values @since CUPS 1.2/macOS 10.5@ */
347 char cupsString
[16][64]; /* User-defined string values @since CUPS 1.2/macOS 10.5@ */
348 char cupsMarkerType
[64]; /* Ink/toner type @since CUPS 1.2/macOS 10.5@ */
349 char cupsRenderingIntent
[64];/* Color rendering intent @since CUPS 1.2/macOS 10.5@ */
350 char cupsPageSizeName
[64]; /* PageSize name @since CUPS 1.2/macOS 10.5@ */
351 } cups_page_header2_t
;
353 typedef struct _cups_raster_s cups_raster_t
;
354 /**** Raster stream data ****/
356 typedef int (*cups_interpret_cb_t
)(cups_page_header2_t
*header
, int preferred_bits
);
357 /**** cupsRasterInterpretPPD callback function
359 * This function is called by
360 * @link cupsRasterInterpretPPD@ to
361 * validate (and update, as needed)
362 * the page header attributes. The
363 * "preferred_bits" argument provides
365 * @code cupsPreferredBitsPerColor@
366 * key from the PostScript page device
367 * dictionary and is 0 if undefined.
370 /**** New in CUPS 1.5 ****/
371 typedef ssize_t (*cups_raster_iocb_t
)(void *ctx
, unsigned char *buffer
, size_t length
);
372 /**** cupsRasterOpenIO callback function
374 * This function is specified when
375 * creating a raster stream with
376 * @link cupsRasterOpenIO@ and handles
377 * generic reading and writing of raster
378 * data. It must return -1 on error or
379 * the number of bytes specified by
380 * "length" on success.
388 extern void cupsRasterClose(cups_raster_t
*r
);
389 extern cups_raster_t
*cupsRasterOpen(int fd
, cups_mode_t mode
);
390 extern unsigned cupsRasterReadHeader(cups_raster_t
*r
,
391 cups_page_header_t
*h
) _CUPS_DEPRECATED_MSG("Use cupsRasterReadHeader2 instead.");
392 extern unsigned cupsRasterReadPixels(cups_raster_t
*r
,
393 unsigned char *p
, unsigned len
);
394 extern unsigned cupsRasterWriteHeader(cups_raster_t
*r
,
395 cups_page_header_t
*h
) _CUPS_DEPRECATED_MSG("Use cupsRasterWriteHeader2 instead.");
396 extern unsigned cupsRasterWritePixels(cups_raster_t
*r
,
397 unsigned char *p
, unsigned len
);
399 /**** New in CUPS 1.2 ****/
400 extern unsigned cupsRasterReadHeader2(cups_raster_t
*r
,
401 cups_page_header2_t
*h
) _CUPS_API_1_2
;
402 extern unsigned cupsRasterWriteHeader2(cups_raster_t
*r
,
403 cups_page_header2_t
*h
) _CUPS_API_1_2
;
405 /**** New in CUPS 1.3 ****/
406 extern const char *cupsRasterErrorString(void) _CUPS_API_1_3
;
408 /**** New in CUPS 1.5 ****/
409 extern cups_raster_t
*cupsRasterOpenIO(cups_raster_iocb_t iocb
, void *ctx
,
412 /**** New in CUPS 2.2/macOS 10.12 ****/
413 extern int cupsRasterInitPWGHeader(cups_page_header2_t
*h
, pwg_media_t
*media
, const char *type
, int xdpi
, int ydpi
, const char *sides
, const char *sheet_back
) _CUPS_API_2_2
;
417 # endif /* __cplusplus */
419 #endif /* !_CUPS_RASTER_H_ */