2 * PostScript Printer Description definitions for CUPS.
4 * THESE APIS ARE DEPRECATED. TO COMPILE WITHOUT WARNINGS ADD
5 * -D_PPD_DEPRECATED="" TO YOUR COMPILE OPTIONS. THIS HEADER AND THESE
6 * FUNCTIONS WILL BE REMOVED IN A FUTURE RELEASE OF CUPS.
8 * Copyright 2007-2015 by Apple Inc.
9 * Copyright 1997-2007 by Easy Software Products, all rights reserved.
11 * Licensed under Apache License v2.0. See the file "LICENSE" for more information.
13 * PostScript is a trademark of Adobe Systems, Inc.
15 * This code and any derivative of it may be used and distributed
16 * freely under the terms of the GNU General Public License when
17 * used with GNU Ghostscript or its derivatives. Use of the code
18 * (or any derivative of it) with software other than GNU
19 * GhostScript (or its derivatives) is governed by the CUPS license
27 * Include necessary headers...
43 # endif /* __cplusplus */
47 * Define _PPD_DEPRECATED to silence the warnings about PPD functions being
51 # ifndef _PPD_DEPRECATED
52 # define _PPD_DEPRECATED _CUPS_DEPRECATED_1_6_MSG("Use cupsCopyDestInfo and friends instead.")
53 # endif /* !_PPD_DEPRECATED */
60 # define PPD_VERSION 4.3 /* Kept in sync with Adobe version number */
64 * PPD size limits (defined in Adobe spec)
67 # define PPD_MAX_NAME 41 /* Maximum size of name + 1 for nul */
68 # define PPD_MAX_TEXT 81 /* Maximum size of text + 1 for nul */
69 # define PPD_MAX_LINE 256 /* Maximum size of line + 1 for nul */
73 * Types and structures...
76 typedef enum ppd_ui_e
/**** UI Types ****/
78 PPD_UI_BOOLEAN
, /* True or False option */
79 PPD_UI_PICKONE
, /* Pick one from a list */
80 PPD_UI_PICKMANY
/* Pick zero or more from a list */
83 typedef enum ppd_section_e
/**** Order dependency sections ****/
85 PPD_ORDER_ANY
, /* Option code can be anywhere in the file */
86 PPD_ORDER_DOCUMENT
, /* ... must be in the DocumentSetup section */
87 PPD_ORDER_EXIT
, /* ... must be sent prior to the document */
88 PPD_ORDER_JCL
, /* ... must be sent as a JCL command */
89 PPD_ORDER_PAGE
, /* ... must be in the PageSetup section */
90 PPD_ORDER_PROLOG
/* ... must be in the Prolog section */
93 typedef enum ppd_cs_e
/**** Colorspaces ****/
95 PPD_CS_CMYK
= -4, /* CMYK colorspace */
96 PPD_CS_CMY
, /* CMY colorspace */
97 PPD_CS_GRAY
= 1, /* Grayscale colorspace */
98 PPD_CS_RGB
= 3, /* RGB colorspace */
99 PPD_CS_RGBK
, /* RGBK (K = gray) colorspace */
100 PPD_CS_N
/* DeviceN colorspace */
103 typedef enum ppd_status_e
/**** Status Codes @since CUPS 1.1.19/macOS 10.3@ ****/
106 PPD_FILE_OPEN_ERROR
, /* Unable to open PPD file */
107 PPD_NULL_FILE
, /* NULL PPD file pointer */
108 PPD_ALLOC_ERROR
, /* Memory allocation error */
109 PPD_MISSING_PPDADOBE4
, /* Missing PPD-Adobe-4.x header */
110 PPD_MISSING_VALUE
, /* Missing value string */
111 PPD_INTERNAL_ERROR
, /* Internal error */
112 PPD_BAD_OPEN_GROUP
, /* Bad OpenGroup */
113 PPD_NESTED_OPEN_GROUP
, /* OpenGroup without a CloseGroup first */
114 PPD_BAD_OPEN_UI
, /* Bad OpenUI/JCLOpenUI */
115 PPD_NESTED_OPEN_UI
, /* OpenUI/JCLOpenUI without a CloseUI/JCLCloseUI first */
116 PPD_BAD_ORDER_DEPENDENCY
, /* Bad OrderDependency */
117 PPD_BAD_UI_CONSTRAINTS
, /* Bad UIConstraints */
118 PPD_MISSING_ASTERISK
, /* Missing asterisk in column 0 */
119 PPD_LINE_TOO_LONG
, /* Line longer than 255 chars */
120 PPD_ILLEGAL_CHARACTER
, /* Illegal control character */
121 PPD_ILLEGAL_MAIN_KEYWORD
, /* Illegal main keyword string */
122 PPD_ILLEGAL_OPTION_KEYWORD
, /* Illegal option keyword string */
123 PPD_ILLEGAL_TRANSLATION
, /* Illegal translation string */
124 PPD_ILLEGAL_WHITESPACE
, /* Illegal whitespace character */
125 PPD_BAD_CUSTOM_PARAM
, /* Bad custom parameter */
126 PPD_MISSING_OPTION_KEYWORD
, /* Missing option keyword */
127 PPD_BAD_VALUE
, /* Bad value string */
128 PPD_MISSING_CLOSE_GROUP
, /* Missing CloseGroup */
129 PPD_MAX_STATUS
/* @private@ */
132 enum ppd_conform_e
/**** Conformance Levels @since CUPS 1.1.19/macOS 10.3@ ****/
134 PPD_CONFORM_RELAXED
, /* Relax whitespace and control char */
135 PPD_CONFORM_STRICT
/* Require strict conformance */
138 typedef enum ppd_conform_e ppd_conform_t
;
139 /**** Conformance Levels @since CUPS 1.1.19/macOS 10.3@ ****/
141 typedef struct ppd_attr_s
/**** PPD Attribute Structure @since CUPS 1.1.19/macOS 10.3@ ****/
143 char name
[PPD_MAX_NAME
]; /* Name of attribute (cupsXYZ) */
144 char spec
[PPD_MAX_NAME
]; /* Specifier string, if any */
145 char text
[PPD_MAX_TEXT
]; /* Human-readable text, if any */
146 char *value
; /* Value string */
149 typedef struct ppd_option_s ppd_option_t
;
152 typedef struct ppd_choice_s
/**** Option choices ****/
154 char marked
; /* 0 if not selected, 1 otherwise */
155 char choice
[PPD_MAX_NAME
]; /* Computer-readable option name */
156 char text
[PPD_MAX_TEXT
]; /* Human-readable option name */
157 char *code
; /* Code to send for this option */
158 ppd_option_t
*option
; /* Pointer to parent option structure */
161 struct ppd_option_s
/**** Options ****/
163 char conflicted
; /* 0 if no conflicts exist, 1 otherwise */
164 char keyword
[PPD_MAX_NAME
]; /* Option keyword name ("PageSize", etc.) */
165 char defchoice
[PPD_MAX_NAME
];/* Default option choice */
166 char text
[PPD_MAX_TEXT
]; /* Human-readable text */
167 ppd_ui_t ui
; /* Type of UI option */
168 ppd_section_t section
; /* Section for command */
169 float order
; /* Order number */
170 int num_choices
; /* Number of option choices */
171 ppd_choice_t
*choices
; /* Option choices */
174 typedef struct ppd_group_s
/**** Groups ****/
176 /**** Group text strings are limited to 39 chars + nul in order to
177 **** preserve binary compatibility and allow applications to get
178 **** the group's keyword name.
180 char text
[PPD_MAX_TEXT
- PPD_MAX_NAME
];
181 /* Human-readable group name */
182 char name
[PPD_MAX_NAME
]; /* Group name @since CUPS 1.1.18/macOS 10.3@ */
183 int num_options
; /* Number of options */
184 ppd_option_t
*options
; /* Options */
185 int num_subgroups
; /* Number of sub-groups */
186 struct ppd_group_s
*subgroups
; /* Sub-groups (max depth = 1) */
189 typedef struct ppd_const_s
/**** Constraints ****/
191 char option1
[PPD_MAX_NAME
]; /* First keyword */
192 char choice1
[PPD_MAX_NAME
]; /* First option/choice (blank for all) */
193 char option2
[PPD_MAX_NAME
]; /* Second keyword */
194 char choice2
[PPD_MAX_NAME
]; /* Second option/choice (blank for all) */
197 typedef struct ppd_size_s
/**** Page Sizes ****/
199 int marked
; /* Page size selected? */
200 char name
[PPD_MAX_NAME
]; /* Media size option */
201 float width
; /* Width of media in points */
202 float length
; /* Length of media in points */
203 float left
; /* Left printable margin in points */
204 float bottom
; /* Bottom printable margin in points */
205 float right
; /* Right printable margin in points */
206 float top
; /* Top printable margin in points */
209 typedef struct ppd_emul_s
/**** Emulators ****/
211 char name
[PPD_MAX_NAME
]; /* Emulator name */
212 char *start
; /* Code to switch to this emulation */
213 char *stop
; /* Code to stop this emulation */
216 typedef struct ppd_profile_s
/**** sRGB Color Profiles ****/
218 char resolution
[PPD_MAX_NAME
];
219 /* Resolution or "-" */
220 char media_type
[PPD_MAX_NAME
];
221 /* Media type or "-" */
222 float density
; /* Ink density to use */
223 float gamma
; /* Gamma correction to use */
224 float matrix
[3][3]; /* Transform matrix */
227 /**** New in CUPS 1.2/macOS 10.5 ****/
228 typedef enum ppd_cptype_e
/**** Custom Parameter Type @since CUPS 1.2/macOS 10.5@ ****/
230 PPD_CUSTOM_CURVE
, /* Curve value for f(x) = x^value */
231 PPD_CUSTOM_INT
, /* Integer number value */
232 PPD_CUSTOM_INVCURVE
, /* Curve value for f(x) = x^(1/value) */
233 PPD_CUSTOM_PASSCODE
, /* String of (hidden) numbers */
234 PPD_CUSTOM_PASSWORD
, /* String of (hidden) characters */
235 PPD_CUSTOM_POINTS
, /* Measurement value in points */
236 PPD_CUSTOM_REAL
, /* Real number value */
237 PPD_CUSTOM_STRING
/* String of characters */
240 typedef union ppd_cplimit_u
/**** Custom Parameter Limit @since CUPS 1.2/macOS 10.5@ ****/
242 float custom_curve
; /* Gamma value */
243 int custom_int
; /* Integer value */
244 float custom_invcurve
; /* Gamma value */
245 int custom_passcode
; /* Passcode length */
246 int custom_password
; /* Password length */
247 float custom_points
; /* Measurement value */
248 float custom_real
; /* Real value */
249 int custom_string
; /* String length */
252 typedef union ppd_cpvalue_u
/**** Custom Parameter Value @since CUPS 1.2/macOS 10.5@ ****/
254 float custom_curve
; /* Gamma value */
255 int custom_int
; /* Integer value */
256 float custom_invcurve
; /* Gamma value */
257 char *custom_passcode
; /* Passcode value */
258 char *custom_password
; /* Password value */
259 float custom_points
; /* Measurement value */
260 float custom_real
; /* Real value */
261 char *custom_string
; /* String value */
264 typedef struct ppd_cparam_s
/**** Custom Parameter @since CUPS 1.2/macOS 10.5@ ****/
266 char name
[PPD_MAX_NAME
]; /* Parameter name */
267 char text
[PPD_MAX_TEXT
]; /* Human-readable text */
268 int order
; /* Order (0 to N) */
269 ppd_cptype_t type
; /* Parameter type */
270 ppd_cplimit_t minimum
, /* Minimum value */
271 maximum
; /* Maximum value */
272 ppd_cpvalue_t current
; /* Current value */
275 typedef struct ppd_coption_s
/**** Custom Option @since CUPS 1.2/macOS 10.5@ ****/
277 char keyword
[PPD_MAX_NAME
]; /* Name of option that is being extended... */
278 ppd_option_t
*option
; /* Option that is being extended... */
279 int marked
; /* Extended option is marked */
280 cups_array_t
*params
; /* Parameters */
283 typedef struct _ppd_cache_s _ppd_cache_t
;
284 /**** PPD cache and mapping data @since CUPS 1.5/macOS 10.7@ @private@ ****/
286 typedef struct ppd_file_s
/**** PPD File ****/
288 int language_level
; /* Language level of device */
289 int color_device
; /* 1 = color device, 0 = grayscale */
290 int variable_sizes
; /* 1 = supports variable sizes, 0 = doesn't */
291 int accurate_screens
; /* 1 = supports accurate screens, 0 = not */
292 int contone_only
; /* 1 = continuous tone only, 0 = not */
293 int landscape
; /* -90 or 90 */
294 int model_number
; /* Device-specific model number */
295 int manual_copies
; /* 1 = Copies done manually, 0 = hardware */
296 int throughput
; /* Pages per minute */
297 ppd_cs_t colorspace
; /* Default colorspace */
298 char *patches
; /* Patch commands to be sent to printer */
299 int num_emulations
; /* Number of emulations supported */
300 ppd_emul_t
*emulations
; /* Emulations and the code to invoke them */
301 char *jcl_begin
; /* Start JCL commands */
302 char *jcl_ps
; /* Enter PostScript interpreter */
303 char *jcl_end
; /* End JCL commands */
304 char *lang_encoding
; /* Language encoding */
305 char *lang_version
; /* Language version (English, Spanish, etc.) */
306 char *modelname
; /* Model name (general) */
307 char *ttrasterizer
; /* Truetype rasterizer */
308 char *manufacturer
; /* Manufacturer name */
309 char *product
; /* Product name (from PS RIP/interpreter) */
310 char *nickname
; /* Nickname (specific) */
311 char *shortnickname
; /* Short version of nickname */
312 int num_groups
; /* Number of UI groups */
313 ppd_group_t
*groups
; /* UI groups */
314 int num_sizes
; /* Number of page sizes */
315 ppd_size_t
*sizes
; /* Page sizes */
316 float custom_min
[2]; /* Minimum variable page size */
317 float custom_max
[2]; /* Maximum variable page size */
318 float custom_margins
[4]; /* Margins around page */
319 int num_consts
; /* Number of UI/Non-UI constraints */
320 ppd_const_t
*consts
; /* UI/Non-UI constraints */
321 int num_fonts
; /* Number of pre-loaded fonts */
322 char **fonts
; /* Pre-loaded fonts */
323 int num_profiles
; /* Number of sRGB color profiles @deprecated@ */
324 ppd_profile_t
*profiles
; /* sRGB color profiles @deprecated@ */
325 int num_filters
; /* Number of filters */
326 char **filters
; /* Filter strings... */
328 /**** New in CUPS 1.1 ****/
329 int flip_duplex
; /* 1 = Flip page for back sides @deprecated@ */
331 /**** New in CUPS 1.1.19 ****/
332 char *protocols
; /* Protocols (BCP, TBCP) string @since CUPS 1.1.19/macOS 10.3@ */
333 char *pcfilename
; /* PCFileName string @since CUPS 1.1.19/macOS 10.3@ */
334 int num_attrs
; /* Number of attributes @since CUPS 1.1.19/macOS 10.3@ @private@ */
335 int cur_attr
; /* Current attribute @since CUPS 1.1.19/macOS 10.3@ @private@ */
336 ppd_attr_t
**attrs
; /* Attributes @since CUPS 1.1.19/macOS 10.3@ @private@ */
338 /**** New in CUPS 1.2/macOS 10.5 ****/
339 cups_array_t
*sorted_attrs
; /* Attribute lookup array @since CUPS 1.2/macOS 10.5@ @private@ */
340 cups_array_t
*options
; /* Option lookup array @since CUPS 1.2/macOS 10.5@ @private@ */
341 cups_array_t
*coptions
; /* Custom options array @since CUPS 1.2/macOS 10.5@ @private@ */
343 /**** New in CUPS 1.3/macOS 10.5 ****/
344 cups_array_t
*marked
; /* Marked choices @since CUPS 1.3/macOS 10.5@ @private@ */
346 /**** New in CUPS 1.4/macOS 10.6 ****/
347 cups_array_t
*cups_uiconstraints
; /* cupsUIConstraints @since CUPS 1.4/macOS 10.6@ @private@ */
349 /**** New in CUPS 1.5 ****/
350 _ppd_cache_t
*cache
; /* PPD cache and mapping data @since CUPS 1.5/macOS 10.7@ @private@ */
358 extern const char *cupsGetPPD(const char *name
) _PPD_DEPRECATED
;
359 extern const char *cupsGetPPD2(http_t
*http
, const char *name
) _PPD_DEPRECATED
;
360 extern http_status_t
cupsGetPPD3(http_t
*http
, const char *name
, time_t *modtime
, char *buffer
, size_t bufsize
) _PPD_DEPRECATED
;
361 extern char *cupsGetServerPPD(http_t
*http
, const char *name
) _PPD_DEPRECATED
;
362 extern int cupsMarkOptions(ppd_file_t
*ppd
, int num_options
, cups_option_t
*options
) _PPD_DEPRECATED
;
364 extern void ppdClose(ppd_file_t
*ppd
) _PPD_DEPRECATED
;
365 extern int ppdCollect(ppd_file_t
*ppd
, ppd_section_t section
,
366 ppd_choice_t
***choices
) _PPD_DEPRECATED
;
367 extern int ppdConflicts(ppd_file_t
*ppd
) _PPD_DEPRECATED
;
368 extern int ppdEmit(ppd_file_t
*ppd
, FILE *fp
,
369 ppd_section_t section
) _PPD_DEPRECATED
;
370 extern int ppdEmitFd(ppd_file_t
*ppd
, int fd
,
371 ppd_section_t section
) _PPD_DEPRECATED
;
372 extern int ppdEmitJCL(ppd_file_t
*ppd
, FILE *fp
, int job_id
,
373 const char *user
, const char *title
)
375 extern ppd_choice_t
*ppdFindChoice(ppd_option_t
*o
, const char *option
)
377 extern ppd_choice_t
*ppdFindMarkedChoice(ppd_file_t
*ppd
,
380 extern ppd_option_t
*ppdFindOption(ppd_file_t
*ppd
, const char *keyword
)
382 extern int ppdIsMarked(ppd_file_t
*ppd
, const char *keyword
,
383 const char *option
) _PPD_DEPRECATED
;
384 extern void ppdMarkDefaults(ppd_file_t
*ppd
) _PPD_DEPRECATED
;
385 extern int ppdMarkOption(ppd_file_t
*ppd
, const char *keyword
,
386 const char *option
) _PPD_DEPRECATED
;
387 extern ppd_file_t
*ppdOpen(FILE *fp
) _PPD_DEPRECATED
;
388 extern ppd_file_t
*ppdOpenFd(int fd
) _PPD_DEPRECATED
;
389 extern ppd_file_t
*ppdOpenFile(const char *filename
) _PPD_DEPRECATED
;
390 extern float ppdPageLength(ppd_file_t
*ppd
, const char *name
)
392 extern ppd_size_t
*ppdPageSize(ppd_file_t
*ppd
, const char *name
)
394 extern float ppdPageWidth(ppd_file_t
*ppd
, const char *name
)
397 /**** New in CUPS 1.1.19 ****/
398 extern const char *ppdErrorString(ppd_status_t status
) _PPD_DEPRECATED
;
399 extern ppd_attr_t
*ppdFindAttr(ppd_file_t
*ppd
, const char *name
,
400 const char *spec
) _PPD_DEPRECATED
;
401 extern ppd_attr_t
*ppdFindNextAttr(ppd_file_t
*ppd
, const char *name
,
402 const char *spec
) _PPD_DEPRECATED
;
403 extern ppd_status_t
ppdLastError(int *line
) _PPD_DEPRECATED
;
405 /**** New in CUPS 1.1.20 ****/
406 extern void ppdSetConformance(ppd_conform_t c
) _PPD_DEPRECATED
;
408 /**** New in CUPS 1.2 ****/
409 extern int cupsRasterInterpretPPD(cups_page_header2_t
*h
,
412 cups_option_t
*options
,
413 cups_interpret_cb_t func
) _PPD_DEPRECATED
;
414 extern int ppdCollect2(ppd_file_t
*ppd
, ppd_section_t section
,
415 float min_order
, ppd_choice_t
***choices
)
417 extern int ppdEmitAfterOrder(ppd_file_t
*ppd
, FILE *fp
,
418 ppd_section_t section
, int limit
,
419 float min_order
) _PPD_DEPRECATED
;
420 extern int ppdEmitJCLEnd(ppd_file_t
*ppd
, FILE *fp
)
422 extern char *ppdEmitString(ppd_file_t
*ppd
, ppd_section_t section
,
423 float min_order
) _PPD_DEPRECATED
;
424 extern ppd_coption_t
*ppdFindCustomOption(ppd_file_t
*ppd
,
427 extern ppd_cparam_t
*ppdFindCustomParam(ppd_coption_t
*opt
,
428 const char *name
) _PPD_DEPRECATED
;
429 extern ppd_cparam_t
*ppdFirstCustomParam(ppd_coption_t
*opt
)
431 extern ppd_option_t
*ppdFirstOption(ppd_file_t
*ppd
) _PPD_DEPRECATED
;
432 extern ppd_cparam_t
*ppdNextCustomParam(ppd_coption_t
*opt
) _PPD_DEPRECATED
;
433 extern ppd_option_t
*ppdNextOption(ppd_file_t
*ppd
) _PPD_DEPRECATED
;
434 extern int ppdLocalize(ppd_file_t
*ppd
) _PPD_DEPRECATED
;
435 extern ppd_file_t
*ppdOpen2(cups_file_t
*fp
) _PPD_DEPRECATED
;
437 /**** New in CUPS 1.3/macOS 10.5 ****/
438 extern const char *ppdLocalizeIPPReason(ppd_file_t
*ppd
,
442 size_t bufsize
) _PPD_DEPRECATED
;
444 /**** New in CUPS 1.4/macOS 10.6 ****/
445 extern int cupsGetConflicts(ppd_file_t
*ppd
, const char *option
,
447 cups_option_t
**options
)
449 extern int cupsResolveConflicts(ppd_file_t
*ppd
,
453 cups_option_t
**options
)
455 extern int ppdInstallableConflict(ppd_file_t
*ppd
,
459 extern ppd_attr_t
*ppdLocalizeAttr(ppd_file_t
*ppd
, const char *keyword
,
460 const char *spec
) _PPD_DEPRECATED
;
461 extern const char *ppdLocalizeMarkerName(ppd_file_t
*ppd
,
464 extern int ppdPageSizeLimits(ppd_file_t
*ppd
,
466 ppd_size_t
*maximum
) _PPD_DEPRECATED
;
475 # endif /* __cplusplus */
476 #endif /* !_CUPS_PPD_H_ */