From 28b9d139c05c6edd6ebc25f466792b8e806d0fa6 Mon Sep 17 00:00:00 2001 From: msweet Date: Fri, 17 Oct 2008 22:12:14 +0000 Subject: [PATCH] Merge changes from CUPS 1.4svn-r8067 (tentative CUPS 1.4b1) git-svn-id: svn+ssh://src.apple.com/svn/cups/easysw/current@1021 a1ca3aef-8c08-0410-bb20-df032aa958be --- CHANGES-1.3.txt | 7 + Makefile | 2 +- backend/usb-darwin.c | 2 +- cups/conflicts.c | 316 +++++----- data/utf-8 | 22 +- doc/Makefile | 11 +- doc/cups-printable.css | 96 ++- doc/cups.css | 9 +- doc/help/postscript-driver.html | 255 ++++++++ doc/help/ppd-compiler.html | 839 +++++++++++++++++++++++++++ doc/help/ref-ppdcfile.html | 2 +- doc/images/cups-command-chain.png | Bin 0 -> 14902 bytes doc/images/cups-command-chain.svg | 439 ++++++++++++++ doc/images/cups-postscript-chain.png | Bin 0 -> 17498 bytes doc/images/cups-postscript-chain.svg | 531 +++++++++++++++++ doc/images/cups-raster-chain.png | Bin 0 -> 16916 bytes doc/images/cups-raster-chain.svg | 534 +++++++++++++++++ examples/Makefile | 128 ++++ examples/color.drv | 44 ++ examples/constraint.drv | 48 ++ examples/custom.drv | 41 ++ examples/grouping.drv | 36 ++ examples/laserjet-basic.drv | 88 +++ examples/laserjet-pjl.drv | 101 ++++ examples/minimum.drv | 26 + examples/postscript.drv | 46 ++ examples/r300-basic.drv | 75 +++ examples/r300-colorman.drv | 85 +++ examples/r300-remote.drv | 85 +++ filter/bannertops.c | 2 +- filter/image-png.c | 4 +- filter/pstext.c | 3 + man/drv.man.in | 2 +- packaging/cups.list.in | 9 +- 34 files changed, 3690 insertions(+), 198 deletions(-) create mode 100644 doc/help/postscript-driver.html create mode 100644 doc/help/ppd-compiler.html create mode 100644 doc/images/cups-command-chain.png create mode 100644 doc/images/cups-command-chain.svg create mode 100644 doc/images/cups-postscript-chain.png create mode 100644 doc/images/cups-postscript-chain.svg create mode 100644 doc/images/cups-raster-chain.png create mode 100644 doc/images/cups-raster-chain.svg create mode 100644 examples/Makefile create mode 100644 examples/color.drv create mode 100644 examples/constraint.drv create mode 100644 examples/custom.drv create mode 100644 examples/grouping.drv create mode 100644 examples/laserjet-basic.drv create mode 100644 examples/laserjet-pjl.drv create mode 100644 examples/minimum.drv create mode 100644 examples/postscript.drv create mode 100644 examples/r300-basic.drv create mode 100644 examples/r300-colorman.drv create mode 100644 examples/r300-remote.drv diff --git a/CHANGES-1.3.txt b/CHANGES-1.3.txt index 173fbfe2a..c97869573 100644 --- a/CHANGES-1.3.txt +++ b/CHANGES-1.3.txt @@ -1,6 +1,13 @@ CHANGES-1.3.txt --------------- +CHANGES IN CUPS V1.3.10 + + - SECURITY: The PNG image reading code did not validate the + image size properly, leading to a potential buffer overflow + (STR #2974) + + CHANGES IN CUPS V1.3.9 - SECURITY: The HP-GL/2 filter did not range check pen numbers diff --git a/Makefile b/Makefile index cd19f8358..44beff0a3 100644 --- a/Makefile +++ b/Makefile @@ -30,7 +30,7 @@ include Makedefs DIRS = cups filter backend berkeley cgi-bin driver locale man monitor \ notifier ppdc scheduler systemv test \ $(PHPDIR) \ - conf data doc $(FONTS) templates + conf data doc examples $(FONTS) templates # diff --git a/backend/usb-darwin.c b/backend/usb-darwin.c index 3f12405f8..f25fbe017 100644 --- a/backend/usb-darwin.c +++ b/backend/usb-darwin.c @@ -1712,7 +1712,7 @@ static void setup_cfLanguage(void) lang[0] = CFStringCreateWithCString(kCFAllocatorDefault, requestedLang, kCFStringEncodingUTF8); langArray = CFArrayCreate(kCFAllocatorDefault, (const void **)lang, sizeof(lang) / sizeof(lang[0]), &kCFTypeArrayCallBacks); - CFPreferencesSetAppValue(CFSTR("AppleLanguages"), langArray, kCFPreferencesCurrentApplication); + CFPreferencesSetValue(CFSTR("AppleLanguages"), langArray, kCFPreferencesCurrentApplication, kCFPreferencesAnyUser, kCFPreferencesAnyHost); fprintf(stderr, "DEBUG: usb: AppleLanguages=\"%s\"\n", requestedLang); CFRelease(lang[0]); diff --git a/cups/conflicts.c b/cups/conflicts.c index aab26d1e7..b05ecd57d 100644 --- a/cups/conflicts.c +++ b/cups/conflicts.c @@ -544,213 +544,205 @@ ppd_load_constraints(ppd_file_t *ppd) /* I - PPD file */ installable = NULL; /* - * See what kind of constraint data we have in the PPD... + * Load old-style [Non]UIConstraints data... */ - if ((constattr = ppdFindAttr(ppd, "cupsUIConstraints", NULL)) != NULL) + for (i = ppd->num_consts, oldconst = ppd->consts; i > 0; i --, oldconst ++) { /* - * Load new-style cupsUIConstraints data... + * Weed out nearby duplicates, since the PPD spec requires that you + * define both "*Foo foo *Bar bar" and "*Bar bar *Foo foo"... */ - for (; constattr; - constattr = ppdFindNextAttr(ppd, "cupsUIConstraints", NULL)) - { - if (!constattr->value) - { - DEBUG_puts("ppd_load_constraints: Bad cupsUIConstraints value!"); - continue; - } + if (i > 1 && + !strcasecmp(oldconst[0].option1, oldconst[1].option2) && + !strcasecmp(oldconst[0].choice1, oldconst[1].choice2) && + !strcasecmp(oldconst[0].option2, oldconst[1].option1) && + !strcasecmp(oldconst[0].choice2, oldconst[1].choice1)) + continue; - for (i = 0, vptr = strchr(constattr->value, '*'); - vptr; - i ++, vptr = strchr(vptr + 1, '*')); + /* + * Allocate memory... + */ - if (i == 0) - { - DEBUG_puts("ppd_load_constraints: Bad cupsUIConstraints value!"); - continue; - } + if ((consts = calloc(1, sizeof(_ppd_cups_uiconsts_t))) == NULL) + { + DEBUG_puts("ppd_load_constraints: Unable to allocate memory for " + "UIConstraints!"); + return; + } - if ((consts = calloc(1, sizeof(_ppd_cups_uiconsts_t))) == NULL) - { - DEBUG_puts("ppd_load_constraints: Unable to allocate memory for " - "cupsUIConstraints!"); - return; - } + if ((constptr = calloc(2, sizeof(_ppd_cups_uiconst_t))) == NULL) + { + free(consts); + DEBUG_puts("ppd_load_constraints: Unable to allocate memory for " + "UIConstraints!"); + return; + } - if ((constptr = calloc(i, sizeof(_ppd_cups_uiconst_t))) == NULL) - { - free(consts); - DEBUG_puts("ppd_load_constraints: Unable to allocate memory for " - "cupsUIConstraints!"); - return; - } + /* + * Fill in the information... + */ - consts->num_constraints = i; - consts->constraints = constptr; + consts->num_constraints = 2; + consts->constraints = constptr; - strlcpy(consts->resolver, constattr->spec, sizeof(consts->resolver)); + if (!strncasecmp(oldconst->option1, "Custom", 6) && + !strcasecmp(oldconst->choice1, "True")) + { + constptr[0].option = ppdFindOption(ppd, oldconst->option1 + 6); + constptr[0].choice = ppdFindChoice(constptr[0].option, "Custom"); + constptr[0].installable = 0; + } + else + { + constptr[0].option = ppdFindOption(ppd, oldconst->option1); + constptr[0].choice = ppdFindChoice(constptr[0].option, + oldconst->choice1); + constptr[0].installable = ppd_is_installable(installable, + oldconst->option1); + } - for (i = 0, vptr = strchr(constattr->value, '*'); - vptr; - i ++, vptr = strchr(vptr, '*'), constptr ++) - { - /* - * Extract "*Option Choice" or just "*Option"... - */ + if (!constptr[0].option || (!constptr[0].choice && oldconst->choice1[0])) + { + DEBUG_printf(("ppd_load_constraints: Unknown option *%s %s!\n", + oldconst->option1, oldconst->choice1)); + free(consts->constraints); + free(consts); + continue; + } - for (vptr ++, ptr = option; *vptr && !isspace(*vptr & 255); vptr ++) - if (ptr < (option + sizeof(option) - 1)) - *ptr++ = *vptr; + if (!strncasecmp(oldconst->option2, "Custom", 6) && + !strcasecmp(oldconst->choice2, "True")) + { + constptr[1].option = ppdFindOption(ppd, oldconst->option2 + 6); + constptr[1].choice = ppdFindChoice(constptr[1].option, "Custom"); + constptr[1].installable = 0; + } + else + { + constptr[1].option = ppdFindOption(ppd, oldconst->option2); + constptr[1].choice = ppdFindChoice(constptr[1].option, + oldconst->choice2); + constptr[1].installable = ppd_is_installable(installable, + oldconst->option2); + } - *ptr = '\0'; + if (!constptr[1].option || (!constptr[1].choice && oldconst->choice2[0])) + { + DEBUG_printf(("ppd_load_constraints: Unknown option *%s %s!\n", + oldconst->option2, oldconst->choice2)); + free(consts->constraints); + free(consts); + continue; + } - while (isspace(*vptr & 255)) - vptr ++; + consts->installable = constptr[0].installable || constptr[1].installable; - if (*vptr == '*') - choice[0] = '\0'; - else - { - for (ptr = choice; *vptr && !isspace(*vptr & 255); vptr ++) - if (ptr < (choice + sizeof(choice) - 1)) - *ptr++ = *vptr; + /* + * Add it to the constraints array... + */ - *ptr = '\0'; - } + cupsArrayAdd(ppd->cups_uiconstraints, consts); + } - if (!strncasecmp(option, "Custom", 6) && !strcasecmp(choice, "True")) - { - _cups_strcpy(option, option + 6); - strcpy(choice, "Custom"); - } + /* + * Then load new-style constraints... + */ - constptr->option = ppdFindOption(ppd, option); - constptr->choice = ppdFindChoice(constptr->option, choice); - constptr->installable = ppd_is_installable(installable, option); - consts->installable |= constptr->installable; + for (constattr = ppdFindAttr(ppd, "cupsUIConstraints", NULL); + constattr; + constattr = ppdFindNextAttr(ppd, "cupsUIConstraints", NULL)) + { + if (!constattr->value) + { + DEBUG_puts("ppd_load_constraints: Bad cupsUIConstraints value!"); + continue; + } - if (!constptr->option || (!constptr->choice && choice[0])) - { - DEBUG_printf(("ppd_load_constraints: Unknown option *%s %s!\n", - option, choice)); - break; - } - } + for (i = 0, vptr = strchr(constattr->value, '*'); + vptr; + i ++, vptr = strchr(vptr + 1, '*')); - if (!vptr) - cupsArrayAdd(ppd->cups_uiconstraints, consts); - else - { - free(consts->constraints); - free(consts); - } + if (i == 0) + { + DEBUG_puts("ppd_load_constraints: Bad cupsUIConstraints value!"); + continue; } - } - else - { - /* - * Load old-style [Non]UIConstraints data... - */ - for (i = ppd->num_consts, oldconst = ppd->consts; i > 0; i --, oldconst ++) + if ((consts = calloc(1, sizeof(_ppd_cups_uiconsts_t))) == NULL) { - /* - * Weed out nearby duplicates, since the PPD spec requires that you - * define both "*Foo foo *Bar bar" and "*Bar bar *Foo foo"... - */ - - if (i > 1 && - !strcasecmp(oldconst[0].option1, oldconst[1].option2) && - !strcasecmp(oldconst[0].choice1, oldconst[1].choice2) && - !strcasecmp(oldconst[0].option2, oldconst[1].option1) && - !strcasecmp(oldconst[0].choice2, oldconst[1].choice1)) - continue; + DEBUG_puts("ppd_load_constraints: Unable to allocate memory for " + "cupsUIConstraints!"); + return; + } - /* - * Allocate memory... - */ + if ((constptr = calloc(i, sizeof(_ppd_cups_uiconst_t))) == NULL) + { + free(consts); + DEBUG_puts("ppd_load_constraints: Unable to allocate memory for " + "cupsUIConstraints!"); + return; + } - if ((consts = calloc(1, sizeof(_ppd_cups_uiconsts_t))) == NULL) - { - DEBUG_puts("ppd_load_constraints: Unable to allocate memory for " - "UIConstraints!"); - return; - } + consts->num_constraints = i; + consts->constraints = constptr; - if ((constptr = calloc(2, sizeof(_ppd_cups_uiconst_t))) == NULL) - { - free(consts); - DEBUG_puts("ppd_load_constraints: Unable to allocate memory for " - "UIConstraints!"); - return; - } + strlcpy(consts->resolver, constattr->spec, sizeof(consts->resolver)); + for (i = 0, vptr = strchr(constattr->value, '*'); + vptr; + i ++, vptr = strchr(vptr, '*'), constptr ++) + { /* - * Fill in the information... + * Extract "*Option Choice" or just "*Option"... */ - consts->num_constraints = 2; - consts->constraints = constptr; + for (vptr ++, ptr = option; *vptr && !isspace(*vptr & 255); vptr ++) + if (ptr < (option + sizeof(option) - 1)) + *ptr++ = *vptr; - if (!strncasecmp(oldconst->option1, "Custom", 6) && - !strcasecmp(oldconst->choice1, "True")) - { - constptr[0].option = ppdFindOption(ppd, oldconst->option1 + 6); - constptr[0].choice = ppdFindChoice(constptr[0].option, "Custom"); - constptr[0].installable = 0; - } - else - { - constptr[0].option = ppdFindOption(ppd, oldconst->option1); - constptr[0].choice = ppdFindChoice(constptr[0].option, - oldconst->choice1); - constptr[0].installable = ppd_is_installable(installable, - oldconst->option1); - } + *ptr = '\0'; - if (!constptr[0].option || (!constptr[0].choice && oldconst->choice1[0])) - { - DEBUG_printf(("ppd_load_constraints: Unknown option *%s %s!\n", - oldconst->option1, oldconst->choice1)); - free(consts->constraints); - free(consts); - continue; - } + while (isspace(*vptr & 255)) + vptr ++; - if (!strncasecmp(oldconst->option2, "Custom", 6) && - !strcasecmp(oldconst->choice2, "True")) - { - constptr[1].option = ppdFindOption(ppd, oldconst->option2 + 6); - constptr[1].choice = ppdFindChoice(constptr[1].option, "Custom"); - constptr[1].installable = 0; - } + if (*vptr == '*') + choice[0] = '\0'; else { - constptr[1].option = ppdFindOption(ppd, oldconst->option2); - constptr[1].choice = ppdFindChoice(constptr[1].option, - oldconst->choice2); - constptr[1].installable = ppd_is_installable(installable, - oldconst->option2); + for (ptr = choice; *vptr && !isspace(*vptr & 255); vptr ++) + if (ptr < (choice + sizeof(choice) - 1)) + *ptr++ = *vptr; + + *ptr = '\0'; } - if (!constptr[1].option || (!constptr[1].choice && oldconst->choice2[0])) + if (!strncasecmp(option, "Custom", 6) && !strcasecmp(choice, "True")) { - DEBUG_printf(("ppd_load_constraints: Unknown option *%s %s!\n", - oldconst->option2, oldconst->choice2)); - free(consts->constraints); - free(consts); - continue; + _cups_strcpy(option, option + 6); + strcpy(choice, "Custom"); } - consts->installable = constptr[0].installable || constptr[1].installable; + constptr->option = ppdFindOption(ppd, option); + constptr->choice = ppdFindChoice(constptr->option, choice); + constptr->installable = ppd_is_installable(installable, option); + consts->installable |= constptr->installable; - /* - * Add it to the constraints array... - */ + if (!constptr->option || (!constptr->choice && choice[0])) + { + DEBUG_printf(("ppd_load_constraints: Unknown option *%s %s!\n", + option, choice)); + break; + } + } + if (!vptr) cupsArrayAdd(ppd->cups_uiconstraints, consts); + else + { + free(consts->constraints); + free(consts); } } } diff --git a/data/utf-8 b/data/utf-8 index 6a1667a9d..044691b46 100644 --- a/data/utf-8 +++ b/data/utf-8 @@ -27,14 +27,14 @@ charset utf8 # Each font that is listed will be downloaded to the printer when used. # -0000 00FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique -0100 01FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique -0200 02FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique -0300 03FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique -0400 04FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique -1E00 1EFF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique -2000 20FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique -2300 23FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique -2400 24FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique -2500 25FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique -2600 26FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-Bold-Oblique +0000 00FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique +0100 01FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique +0200 02FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique +0300 03FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique +0400 04FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique +1E00 1EFF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique +2000 20FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique +2300 23FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique +2400 24FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique +2500 25FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique +2600 26FF ltor single Monospace Monospace-Bold Monospace-Oblique Monospace-BoldOblique diff --git a/doc/Makefile b/doc/Makefile index 92a397f93..016b1d201 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -54,13 +54,10 @@ HELPFILES = \ help/man-cupsaccept.html \ help/man-backend.html \ help/man-cancel.html \ - help/man-classes.conf.html \ - help/man-client.conf.html \ help/man-cups-config.html \ help/man-cups-lpd.html \ help/man-cups-polld.html \ help/man-cupsaddsmb.html \ - help/man-cupsd.conf.html \ help/man-cupsd.html \ help/man-cupsenable.html \ help/man-cupstestdsc.html \ @@ -80,11 +77,17 @@ HELPFILES = \ help/man-lpstat.html \ help/man-mime.convs.html \ help/man-mime.types.html \ - help/man-printers.conf.html \ + help/man-ppdc.html \ + help/man-ppdhtml.html \ + help/man-ppdi.html \ + help/man-ppdmerge.html \ + help/man-ppdpo.html \ help/network.html \ help/options.html \ help/overview.html \ help/policies.html \ + help/postscript-driver.html \ + help/ppd-compiler.html \ help/ref-access_log.html \ help/ref-classes-conf.html \ help/ref-client-conf.html \ diff --git a/doc/cups-printable.css b/doc/cups-printable.css index 5256cae38..e4ad1fbff 100644 --- a/doc/cups-printable.css +++ b/doc/cups-printable.css @@ -19,6 +19,11 @@ PRE.command { margin-left: 36pt; } +P.example { + font-style: italic; + margin-left: 36pt; +} + PRE.example { background: #eeeeee; border: dotted thin #999999; @@ -46,6 +51,16 @@ BLOCKQUOTE { padding: 10pt; } +A IMG { + border: none; +} + +A:link:hover IMG { + background: #f0f0f0; + border-radius: 10px; + -moz-border-radius: 10px; +} + A:link, A:visited { font-weight: normal; text-decoration: none; @@ -59,6 +74,19 @@ SUB, SUP { font-size: 50%; } +TR.data, TD.data, TR.data TD { + margin-top: 10pt; + padding: 5pt; + border-bottom: solid 1pt #999999; +} + +TR.data TH { + border-bottom: solid 1pt #999999; + padding-top: 10pt; + padding-left: 5pt; + text-align: left; +} + DIV.table TABLE { border: solid thin #999999; border-collapse: collapse; @@ -102,19 +130,23 @@ DIV.figure CAPTION { } TH.label { - padding-top: 5pt; text-align: right; vertical-align: top; } +TH.sublabel { + text-align: right; + font-weight: normal; +} + HR { border: solid thin; } SPAN.info { - background: #000000; - border: thin solid #000000; - color: #ffffff; + background: black; + border: thin solid black; + color: white; font-size: 80%; font-style: italic; font-weight: bold; @@ -130,6 +162,57 @@ H2.title, H3.title { border-bottom: solid 2pt #000000; } +DIV.indent, TABLE.indent { + margin-top: 2em; + margin-left: auto; + margin-right: auto; + width: 90%; +} + +TABLE.indent { + border-collapse: collapse; +} + +TABLE.indent TD, TABLE.indent TH { + padding: 0; +} + +TABLE.list { + border-collapse: collapse; + margin-left: auto; + margin-right: auto; + width: 90%; +} + +TABLE.list TH { + background: white; + border-bottom: solid thin #cccccc; + color: #444444; + padding-top: 10pt; + padding-left: 5pt; + text-align: left; + vertical-align: bottom; + white-space: nowrap; +} + +TABLE.list TH A { + color: #4444cc; +} + +TABLE.list TD { + border-bottom: solid thin #eeeeee; + padding-top: 5pt; + padding-left: 5pt; +} + +TABLE.list TR:nth-child(even) { + background: #f8f8f8; +} + +TABLE.list TR:nth-child(odd) { + background: #f4f4f4; +} + DT { margin-left: 36pt; margin-top: 12pt; @@ -148,11 +231,6 @@ P.summary { font-family: monaco, courier, monospace; } -SPAN.message { - font-style: italic; - font-size: smaller; -} - DIV.summary TABLE { border: solid thin #999999; border-collapse: collapse; diff --git a/doc/cups.css b/doc/cups.css index 44f8f7c65..a12db9ca8 100644 --- a/doc/cups.css +++ b/doc/cups.css @@ -23,6 +23,11 @@ PRE.command { margin-left: 36pt; } +P.example { + font-style: italic; + margin-left: 36pt; +} + PRE.example { background: white; border: dotted thin #999999; @@ -322,11 +327,9 @@ DIV.sidebar P.l2 { TABLE.inset { background: #f0f0f0; border: thin solid #e0e0e0; - margin-left: auto; - margin-right: auto; margin-top: 1em; padding: 0; - width: 90%; + width: 100%; /* These are not implemented by all browsers, but that's OK */ border-radius: 5px; -moz-border-radius: 5px; diff --git a/doc/help/postscript-driver.html b/doc/help/postscript-driver.html new file mode 100644 index 000000000..89f2df99b --- /dev/null +++ b/doc/help/postscript-driver.html @@ -0,0 +1,255 @@ + + + + Developing PostScript Printer Drivers + + + +

This document describes how to develop printer drivers for PostScript printers. Topics include: printer driver basics, creating new PPD files, importing existing PPD files, using custom filters, implementing color management, adding Mac OS X features, and deploying your driver.

+ +
+ + + + + + +
See AlsoProgramming: Developing Raster Printer Drivers
+ Programming: Filter and Backend Programming
+ Programming: Introduction to the PPD Compiler
+ Programming: Raster API
+ References: PPD Compiler Driver Information File Reference
+ Specifications: CUPS PPD Extensions
+ + +

Printer Driver Basics

+ +

A CUPS PostScript printer driver consists of a PostScript Printer Description (PPD) file that describes the features and capabilities of the device, zero or more filter programs that prepare print data for the device, and zero or more support files for color management, online help, and so forth. The PPD file includes references to all of the filters and support files used by the driver.

+ +

Every time a user prints something the scheduler program, cupsd(8), determines the format of the print job and the programs required to convert that job into something the printer understands. CUPS includes filter programs for many common formats, for example to convert Portable Document Format (PDF) files into device-independent PostScript, and then from device-independent PostScript to device-dependent PostScript. Figure 1 shows the data flow of a typical print job.

+ +
+ + +
Figure 1: PostScript Filter Chain
PostScript Filter Chain
+ +

The optional PostScript filter can be provided to add printer-specific commands to the PostScript output that cannot be represented in the PPD file or to reorganize the output for special printer features. Typically this is used to support advanced job management or finishing functions on the printer. CUPS includes a generic PostScript filter that handles all PPD-defined commands.

+ +

The optional port monitor handles interface-specific protocol or encoding issues. For example, many PostScript printers support the Binary Communications Protocol (BCP) and Tagged Binary Communications Protocol (TBCP) to allow applications to print 8-bit ("binary") PostScript jobs. CUPS includes port monitors for BCP and TBCP, and you can supply your own port monitors as needed.

+ +

The backend handles communications with the printer, sending print data from the last filter to the printer and relaying back-channel data from the printer to the upstream filters. CUPS includes backend programs for common direct-connect interfaces and network protocols, and you can provide your own backend to support custom interfaces and protocols.

+ +

The scheduler also supports a special "command" file format for sending maintenance commands and status queries to a printer or printer driver. Command print jobs typically use a single command filter program defined in the PPD file to generate the appropriate printer commands and handle any responses from the printer. Figure 2 shows the data flow of a typical command job.

+ +
+ + +
Figure 2: Command Filter Chain
Command Filter Chain
+ +

PostScript printer drivers typically do not require their own command filter since CUPS includes a generic PostScript command filter that supports all of the standard functions using PPD-defined commands.

+ + +

Creating New PPD Files

+ +

We recommend using the CUPS PPD compiler, ppdc(1), to create new PPD files since it manages many of the tedious (and error-prone!) details of paper sizes and localization for you. It also allows you to easily support multiple devices from a single source file. For more information see the "Introduction to the PPD Compiler" document. Listing 1 shows a driver information file for a black-and-white PostScript printer.

+ +

Listing 1: "examples/postscript.drv"

+ +
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// Specify this is a PostScript printer driver
+DriverType ps
+
+// List the fonts that are supported, in this case all standard fonts
+Font *
+
+// Manufacturer, model name, and version
+Manufacturer "Foo"
+ModelName "Foo LaserProofer 2000"
+Version 1.0
+
+// PostScript printer attributes
+Attribute DefaultColorSpace "" Gray
+Attribute LandscapeOrientation "" Minus90
+Attribute LanguageLevel "" "3"
+Attribute Product "" "(Foo LaserProofer 2000)"
+Attribute PSVersion "" "(3010) 0"
+Attribute TTRasterizer "" Type42
+
+// Supported page sizes
+*MediaSize Letter
+MediaSize Legal
+MediaSize A4
+
+// Query command for page size
+Attribute "?PageSize" "" "
+      save
+      currentpagedevice /PageSize get aload pop
+      2 copy gt {exch} if (Unknown)
+      23 dict
+              dup [612 792] (Letter) put
+              dup [612 1008] (Legal) put
+              dup [595 842] (A4) put
+              {exch aload pop 4 index sub abs 5 le exch 
+               5 index sub abs 5 le and
+              {exch pop exit} {pop} ifelse
+      } bind forall = flush pop pop
+      restore"
+
+// Specify the name of the PPD file we want to generate
+PCFileName "fooproof.ppd"
+
+ +

Required Attributes

+ +

PostScript drivers require the attributes listed in Table 1. If not specified, the defaults for CUPS drivers are used. A typical PostScript driver information file would include the following attributes:

+ +
+Attribute DefaultColorSpace "" Gray
+Attribute LandscapeOrientation "" Minus90
+Attribute LanguageLevel "" "3"
+Attribute Product "" "(Foo LaserProofer 2000)"
+Attribute PSVersion "" "(3010) 0"
+Attribute TTRasterizer "" Type42
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1: Required PostScript Printer Driver Attributes
AttributeDescription
DefaultColorSpaceThe default colorspace: + Gray, RGB, CMY, or + CMYK. If not specified, then RGB is + assumed.
LandscapeOrientationThe preferred landscape + orientation: Plus90, Minus90, or + Any. If not specified, Plus90 is + assumed.
LanguageLevelThe PostScript language + level supported by the device: 1, 2, or 3. If not + specified, 2 is assumed.
ProductThe string returned by + the PostScript product operator, which + must include parenthesis to conform with + PostScript syntax rules for strings. Multiple + Product attributes may be specified to support + multiple products with the same PPD file. If not + specified, "(ESP Ghostscript)" and "(GNU Ghostscript)" + are assumed.
PSVersionThe PostScript + interpreter version numbers as returned by the + version and revision operators. The + required format is "(version) revision". Multiple + PSVersion attributes may be specified to + support multiple interpreter version numbers. If not + specified, "(3010) 705" and "(3010) 707" are + assumed.
TTRasterizerThe type of TrueType + font rasterizer supported by the device, if any. The + supported values are None, Accept68k, + Type42, and TrueImage. If not + specified, None is assumed.
+ +

Query Commands

+ +

Most PostScript printer PPD files include query commands (?PageSize, etc.) that allow applications to query the printer for its current settings and configuration. Query commands are included in driver information files as attributes. For example, the example in Listing 1 uses the following definition for the PageSize query command:

+ +
+Attribute "?PageSize" "" "
+      save
+      currentpagedevice /PageSize get aload pop
+      2 copy gt {exch} if (Unknown)
+      23 dict
+              dup [612 792] (Letter) put
+              dup [612 1008] (Legal) put
+              dup [595 842] (A4) put
+              {exch aload pop 4 index sub abs 5 le exch 
+               5 index sub abs 5 le and
+              {exch pop exit} {pop} ifelse
+      } bind forall = flush pop pop
+      restore"
+
+ +

Query commands can span multiple lines, however no single line may contain more than 255 characters.

+ +

Importing Existing PPD Files

+ +

CUPS includes a utility called ppdi(1) +which allows you to import existing PPD files into the driver information file +format used by the PPD compiler ppdc(1). Once +imported, you can modify, localize, and regenerate the PPD files easily. Type +the following command to import the PPD file mydevice.ppd into the +driver information file mydevice.drv:

+ +
+ppdi -o mydevice.drv mydevice.ppd
+
+ +

If you have a whole directory of PPD files that you would like to import, +you can list multiple filenames or use shell wildcards to import more than one +PPD file on the command-line:

+ +
+ppdi -o mydevice.drv mydevice1.ppd mydevice2.ppd
+ppdi -o mydevice.drv *.ppd
+
+ +

If the driver information file already exists, the new PPD +file entries are appended to the end of the file. Each PPD file +is placed in its own group of curly braces within the driver +information file.

+ + +

Using Custom Filters

+ +

Normally a PostScript printer driver will not utilize any additional print filters. For drivers that provide additional filters such as a CUPS command file filter for doing printer maintenance, you must also list the following Filter directive to handle printing PostScript files:

+ +
+Filter application/vnd.cups-postscript 0 -
+
+ + +

Implementing Color Management

+ +

Talk about ICC color profiles and sRGB as two best options.

+ + +

Adding Mac OS X Features

+ +

Talk about help books, icons, and PDEs.

+ + +

Deploying Your Driver

+ +

Talk about install locations, etc.

+ + + + diff --git a/doc/help/ppd-compiler.html b/doc/help/ppd-compiler.html new file mode 100644 index 000000000..aa52b8821 --- /dev/null +++ b/doc/help/ppd-compiler.html @@ -0,0 +1,839 @@ + + + + Introduction to the PPD Compiler + + + +

This document describes how to use the CUPS PostScript Printer Description +(PPD) file compiler. The PPD compiler generates PPD files from simple text files +that describe the features and capabilities of one or more printers.

+ +
+ + + + + + +
See AlsoProgramming: Developing Raster Printer Drivers
+ Programming: Developing PostScript Printer Drivers
+ Programming: Filter and Backend Programming
+ Programming: Raster API
+ References: PPD Compiler Driver Information File Reference
+ Specifications: CUPS PPD Extensions
+ + +

The Basics

+ +

The PPD compiler, ppdc(1), is a +simple command-line tool that takes a single driver information file, +which by convention uses the extension .drv, and produces one or more +PPD files that may be distributed with your printer drivers for use with CUPS. +For example, you would run the following command to create the English language +PPD files defined by the driver information file mydrivers.drv:

+ +
+ppdc mydrivers.drv
+
+ +

The PPD files are placed in a subdirectory called +ppd. The -d option is used to put the PPD +files in a different location, for example:

+ +
+ppdc -d myppds mydrivers.drv
+
+ +

places the PPD files in a subdirectory named +myppds. Finally, use the -l option to +specify the language localization for the PPD files that are +created, for example:

+ +
+ppdc -d myppds/de -l de mydrivers.drv
+ppdc -d myppds/en -l en mydrivers.drv
+ppdc -d myppds/es -l es mydrivers.drv
+ppdc -d myppds/fr -l fr mydrivers.drv
+ppdc -d myppds/it -l it mydrivers.drv
+
+ +

creates PPD files in German (de), English (en), Spanish (es), +French (fr), and Italian (it) in the corresponding +subdirectories. Specify multiple languages (separated by commas) to produce +"globalized" PPD files:

+ +
+ppdc -d myppds -l de,en,es,fr,it mydrivers.drv
+
+ + +

Driver Information Files

+ +

The driver information files accepted by the PPD compiler are +plain text files that define the various attributes and options +that are included in the PPD files that are generated. A driver +information file can define the information for one or more printers and +their corresponding PPD files.

+ +

Listing 1: "examples/minimum.drv"

+ +
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// List the fonts that are supported, in this case all standard fonts...
+Font *
+
+// Manufacturer, model name, and version
+Manufacturer "Foo"
+ModelName "FooJet 2000"
+Version 1.0
+
+// Each filter provided by the driver...
+Filter application/vnd.cups-raster 100 rastertofoo
+
+// Supported page sizes
+*MediaSize Letter
+MediaSize A4
+
+// Supported resolutions
+*Resolution k 8 0 0 0 "600dpi/600 DPI"
+
+// Specify the name of the PPD file we want to generate...
+PCFileName "foojet2k.ppd"
+
+ + +

A Simple Example

+ +

The example in Listing 1 shows a driver information +file which defines the minimum required attributes to provide a valid PPD file. +The first part of the file includes standard definition files for fonts and +media sizes:

+ +
+#include <font.defs>
+#include <media.defs>
+
+ +

The #include directive works just like the C/C++ include directive; +files included using the angle brackets (<filename>) are found +in any of the standard include directories and files included using quotes +("filename") are found in the same directory as the source or include +file. The <font.defs> include file defines the standard fonts +which are included with GPL Ghostscript and the Apple PDF RIP, while the +<media.defs> include file defines the standard media sizes +listed in Appendix B of the Adobe PostScript Printer Description File Format +Specification.

+ +

CUPS provides several other standard include files:

+ + + +

Next we list all of the fonts that are available in the driver; for CUPS +raster drivers, the following line is all that is usually supplied:

+ +
+Font *
+
+ +

The Font directive specifies the name of a single font or the +asterisk to specify all fonts. For example, you would use the following line to +define an additional bar code font that you are supplying with your printer +driver:

+ +
+//   name         encoding  version  charset  status
+Font Barcode-Foo  Special   "(1.0)"  Special  ROM
+
+ +

The name of the font is Barcode-Foo. Since it is not a standard +text font, the encoding and charset name Special is used. The version +number is 1.0 and the status (where the font is located) is +ROM to indicate that the font does not need to be embedded in +documents that use the font for this printer.

+ +

Third comes the manufacturer, model name, and version number information +strings:

+ +
+Manufacturer "Foo"
+ModelName "FooJet 2000"
+Version 1.0
+
+ +

These strings are used when the user (or auto-configuration program) selects +the printer driver for a newly connected device.

+ +

The list of filters comes after the information strings; for the example in +Listing 1, we have a single filter that takes CUPS +raster data:

+ +
+Filter application/vnd.cups-raster 100 rastertofoo
+
+ +

Each filter specified in the driver information file is the equivalent of a +printer driver for that format; if a user submits a print job in a different +format, CUPS figures out the sequence of commands that will produce a supported +format for the least relative cost.

+ +

Once we have defined the driver information we specify the supported options. +For the example driver we support a single resolution of 600 dots per inch and +two media sizes, A4 and Letter:

+ +
+*MediaSize Letter
+MediaSize A4
+
+*Resolution k 8 0 0 0 "600dpi/600 DPI"
+
+ +

The asterisk in front of the MediaSize and Resolution +directives specify that those option choices are the default. The +MediaSize directive is followed by a media size name which is normally +defined in the <media.defs> file and corresponds to a standard +Adobe media size name. If the default media size is Letter, the PPD +compiler will override it to be A4 for non-English localizations for +you automatically.

+ +

The Resolution directive accepts several values after it as +follows:

+ +
    + +
  1. Colorspace for this resolution, if any. In the example file, the + colorspace k is used which corresponds to black. For printer + drivers that support color printing, this field is usually specified as + "-" for "no change".
    2. + +
  2. Bits per color. In the example file, we define 8 bits per color, for + a continuous-tone grayscale output. All versions of CUPS support 1 and + 8 bits per color. CUPS 1.2 and higher (Mac OS X 10.5 and higher) also + supports 16 bits per color.
    3. + +
  3. Rows per band. In the example file, we define 0 rows per band to + indicate that our printer driver does not process the page in + bands.
    4. + +
  4. Row feed. In the example, we define the feed value to be 0 to + indicate that our printer driver does not interleave the output.
    5. + +
  5. Row step. In the example, we define the step value to be 0 to + indicate that our printer driver does not interleave the output. This + value normally indicates the spacing between the nozzles of an inkjet + printer - when combined with the previous two values, it informs the + driver how to stagger the output on the page to produce interleaved + lines on the page for higher-resolution output.
    6. + +
  6. Choice name and text. In the example, we define the choice name and + text to be "600dpi/600 DPI". The name and text are separated by + slash (/) character; if no text is specified, then the name is + used as the text. The PPD compiler parses the name to determine the + actual resolution; the name can be of the form + RESOLUTIONdpi for resolutions that are equal + horizontally and vertically or HRESxVRESdpi for + isometric resolutions. Only integer resolution values are supported, so + a resolution name of 300dpi is valid while 300.1dpi is + not.
    7. + +
+ +

Finally, the PCFileName directive specifies that the named PPD file +should be written for the current driver definitions:

+ +
+PCFileName "foojet2k.ppd"
+
+ +

The filename follows the directive and must conform to the Adobe +filename requirements in the Adobe Postscript Printer Description File Format +Specification. Specifically, the filename may not exceed 8 characters followed +by the extension .ppd. The FileName directive can be used to +specify longer filenames:

+ +
+FileName "FooJet 2000"
+
+ + +

Grouping and Inheritance

+ +

The previous example created a single PPD file. Driver information files can +also define multiple printers by using the PPD compiler grouping functionality. +Directives are grouped using the curly braces ({ and }) and +every group that uses the PCFileName or FileName directives +produces a PPD file with that name. Listing 2 shows a +variation of the original example that uses two groups to define two printers +that share the same printer driver filter but provide two different resolution +options.

+ +

Listing 2: "examples/grouping.drv"

+ +
+
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// List the fonts that are supported, in this case all standard fonts...
+Font *
+
+// Manufacturer and version
+Manufacturer "Foo"
+Version 1.0
+
+// Each filter provided by the driver...
+Filter application/vnd.cups-raster 100 rastertofoo
+
+// Supported page sizes
+*MediaSize Letter
+MediaSize A4
+
+{
+  // Supported resolutions
+  *Resolution k 8 0 0 0 "600dpi/600 DPI"
+
+  // Specify the model name and filename...
+  ModelName "FooJet 2000"
+  PCFileName "foojet2k.ppd"
+}
+
+{
+  // Supported resolutions
+  *Resolution k 8 0 0 0 "1200dpi/1200 DPI"
+
+  // Specify the model name and filename...
+  ModelName "FooJet 2001"
+  PCFileName "foojt2k1.ppd"
+}
+
+ +

The second example is essentially the same as the first, except that each +printer model is defined inside of a pair of curly braces. For example, the +first printer is defined using:

+ +
+{
+  // Supported resolutions
+  *Resolution k 8 0 0 0 "600dpi/600 DPI"
+
+  // Specify the model name and filename...
+  ModelName "FooJet 2000"
+  PCFileName "foojet2k.ppd"
+}
+
+ +

The printer inherits all of the definitions from the parent group (the +top part of the file) and adds the additional definitions inside the curly +braces for that printer driver. When we define the second group, it also +inherits the same definitions from the parent group but none of the +definitions from the first driver. Groups can be nested to any number of levels +to support variations of similar models without duplication of information.

+ + +

Color Support

+ +

For printer drivers that support color printing, the +ColorDevice and ColorModel directives should be +used to tell the printing system that color output is desired +and in what formats. Listing 3 shows a +variation of the previous example which includes a color printer +that supports printing at 300 and 600 DPI.

+ +

The key changes are the addition of the ColorDevice +directive:

+ +
+ColorDevice true
+
+ +

which tells the printing system that the printer supports +color printing, and the ColorModel directives:

+ +
+ColorModel Gray/Grayscale w chunky 0
+*ColorModel RGB/Color rgb chunky 0
+
+ +

which tell the printing system which colorspaces are supported by the printer +driver for color printing. Each of the ColorModel directives is +followed by the option name and text (Gray/Grayscale and +RGB/Color), the colorspace name (w and rgb), the +color organization (chunky), and the compression mode number +(0) to be passed to the driver. The option name can be any of the +standard Adobe ColorModel names:

+ + + +

Custom names can be used, however it is recommended that you use your vendor +prefix for any custom names, for example "fooName".

+ +

The colorspace name can be any of the following universally supported +colorspaces:

+ + + +

The color organization can be any of the following values:

+ + + +

The compression mode value is passed to the driver in the +cupsCompression attribute. It is traditionally used to select an +appropriate compression mode for the color model but can be used for any +purpose, such as specifying a photo mode vs. standard mode.

+ +

Listing 3: "examples/color.drv"

+ +
+
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// List the fonts that are supported, in this case all standard fonts...
+Font *
+
+// Manufacturer and version
+Manufacturer "Foo"
+Version 1.0
+
+// Each filter provided by the driver...
+Filter application/vnd.cups-raster 100 rastertofoo
+
+// Supported page sizes
+*MediaSize Letter
+MediaSize A4
+
+{
+  // Supported resolutions
+  *Resolution k 8 0 0 0 "600dpi/600 DPI"
+
+  // Specify the model name and filename...
+  ModelName "FooJet 2000"
+  PCFileName "foojet2k.ppd"
+}
+
+{
+  // Supports color printing
+  ColorDevice true
+
+  // Supported colorspaces
+  ColorModel Gray/Grayscale w chunky 0
+  *ColorModel RGB/Color rgb chunky 0
+
+  // Supported resolutions
+  *Resolution - 8 0 0 0 "300dpi/300 DPI"
+  Resolution - 8 0 0 0 "600dpi/600 DPI"
+
+  // Specify the model name and filename...
+  ModelName "FooJet Color"
+  PCFileName "foojetco.ppd"
+}
+
+ + +

Defining Custom Options and Option Groups

+ +

The Group, Option, and Choice +directives are used to define or select a group, option, or +choice. Listing 4 shows a variation of +the first example that provides two custom options in a group +named "Footasm".

+ +

Listing 4: "examples/custom.drv"

+ +
+
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// List the fonts that are supported, in this case all standard fonts...
+Font *
+
+// Manufacturer, model name, and version
+Manufacturer "Foo"
+ModelName "FooJet 2000"
+Version 1.0
+
+// Each filter provided by the driver...
+Filter application/vnd.cups-raster 100 rastertofoo
+
+// Supported page sizes
+*MediaSize Letter
+MediaSize A4
+
+// Supported resolutions
+*Resolution k 8 0 0 0 "600dpi/600 DPI"
+
+// Option Group
+Group "Footasm"
+
+  // Boolean option
+  Option "fooEnhance/Resolution Enhancement" Boolean AnySetup 10
+    *Choice True/Yes "<</cupsCompression 1>>setpagedevice"
+    Choice False/No "<</cupsCompression 0>>setpagedevice"
+
+  // Multiple choice option
+  Option "fooOutputType/Output Quality" PickOne AnySetup 10
+    *Choice "Auto/Automatic Selection"
+            "<</OutputType(Auto)>>setpagedevice""
+    Choice "Text/Optimize for Text"
+            "<</OutputType(Text)>>setpagedevice""
+    Choice "Graph/Optimize for Graphics"
+            "<</OutputType(Graph)>>setpagedevice""
+    Choice "Photo/Optimize for Photos"
+            "<</OutputType(Photo)>>setpagedevice""
+
+// Specify the name of the PPD file we want to generate...
+PCFileName "foojet2k.ppd"
+
+ +

The custom group is introduced by the Group +directive which is followed by the name and optionally text for +the user:

+ +
+Group "Footasm/Footastic Options"
+
+ +

The group name must conform to the PPD specification and +cannot exceed 40 characters in length. If you specify user text, +it cannot exceed 80 characters in length. The groups +General, Extra, and +InstallableOptions are predefined by CUPS; the general +and extra groups are filled by the UI options defined by the PPD +specification. The InstallableOptions group is reserved +for options that define whether accessories for the printer +(duplexer unit, finisher, stapler, etc.) are installed.

+ +

Once the group is specified, the Option directive is +used to introduce a new option:

+ +
+Option "fooEnhance/Resolution Enhancement" Boolean AnySetup 10
+
+ +

The directive is followed by the name of the option and any +optional user text, the option type, the PostScript document group, and +the sort order number. The option name must conform to the PPD specification +and cannot exceed 40 characters in length. If you specify user text, it +cannot exceed 80 characters in length.

+ +

The option type can be Boolean for true/false +selections, PickOne for picking one of many choices, or +PickMany for picking zero or more choices. Boolean +options can have at most two choices with the names +False and True. Pick options can have any +number of choices, although for Windows compatibility reasons +the number of choices should not exceed 255.

+ +

The PostScript document group is typically AnySetup, +meaning that the option can be introduced at any point in the +PostScript document. Other values include PageSetup to +include the option before each page and DocumentSetup +to include the option once at the beginning of the document.

+ +

The sort order number is used to sort the printer commands +associated with each option choice within the PostScript +document. This allows you to setup certain options before others +as required by the printer. For most CUPS raster printer +drivers, the value 10 can be used for all options.

+ +

Once the option is specified, each option choice can be +listed using the Choice directive:

+ +
+*Choice True/Yes "<</cupsCompression 1>>setpagedevice"
+Choice False/No "<</cupsCompression 0>>setpagedevice"
+
+ +

The directive is followed by the choice name and optionally +user text, and the PostScript commands that should be inserted +when printing a file to this printer. The option name must +conform to the PPD specification and cannot exceed 40 characters +in length. If you specify user text, it cannot exceed 80 +characters in length.

+ +

The PostScript commands are also interpreted by any RIP +filters, so these commands typically must be present for all +option choices. Most commands take the form:

+ +
+<</name value>>setpagedevice
+
+ +

where name is the name of the PostScript page device +attribute and value is the numeric or string value for +that attribute.

+ + +

Defining Constants

+ +

Sometimes you will want to define constants for your drivers +so that you can share values in different groups within the same +driver information file, or to share values between different +driver information files using the #include directive. +The #define directive is used to define constants for +use in your printer definitions:

+ +
+#define NAME value
+
+ +

The NAME is any sequence of letters, numbers, and +the underscore. The value is a number or string; if the +value contains spaces you must put double quotes around it, for +example:

+ +
+#define FOO "My String Value"
+
+ +

Constants can also be defined on the command-line using the -D +option:

+ +
+ppdc -DNAME="value" filename.drv
+
+ +

Once defined, you use the notation $NAME to substitute the value of +the constant in the file, for example:

+ +
+#define MANUFACTURER "Foo"
+#define FOO_600      0
+#define FOO_1200     1
+
+{
+  Manufacturer "$MANUFACTURER"
+  ModelNumber $FOO_600
+  ModelName "FooJet 2000"
+  ...
+}
+
+{
+  Manufacturer "$MANUFACTURER"
+  ModelNumber $FOO_1200
+  ModelName "FooJet 2001"
+  ...
+}
+
+ +

Numeric constants can be bitwise OR'd together by placing the constants +inside parenthesis, for example:

+ +
+// ModelNumber capability bits
+#define DUPLEX 1
+#define COLOR  2
+
+...
+
+{
+  // Define a model number specifying the capabilities of the printer...
+  ModelNumber ($DUPLEX $COLOR)
+  ...
+}
+
+ + +

Conditional Statements

+ +

The PPD compiler supports conditional compilation using the #if, +#elif, #else, and #endif directives. The #if +and #elif directives are followed by a constant name or an expression. +For example, to include a group of options when "ADVANCED" is defined:

+ +
+#if ADVANCED
+Group "Advanced/Advanced Options"
+  Option "fooCyanAdjust/Cyan Adjustment"
+    Choice "plus10/+10%" ""
+    Choice "plus5/+5%" ""
+    *Choice "none/No Adjustment" ""
+    Choice "minus5/-5%" ""
+    Choice "minus10/-10%" ""
+  Option "fooMagentaAdjust/Magenta Adjustment"
+    Choice "plus10/+10%" ""
+    Choice "plus5/+5%" ""
+    *Choice "none/No Adjustment" ""
+    Choice "minus5/-5%" ""
+    Choice "minus10/-10%" ""
+  Option "fooYellowAdjust/Yellow Adjustment"
+    Choice "plus10/+10%" ""
+    Choice "plus5/+5%" ""
+    *Choice "none/No Adjustment" ""
+    Choice "minus5/-5%" ""
+    Choice "minus10/-10%" ""
+  Option "fooBlackAdjust/Black Adjustment"
+    Choice "plus10/+10%" ""
+    Choice "plus5/+5%" ""
+    *Choice "none/No Adjustment" ""
+    Choice "minus5/-5%" ""
+    Choice "minus10/-10%" ""
+#endif
+
+ + +

Defining Constraints

+ +

Constraints are strings that are used to specify that one or more option +choices are incompatible, for example two-sided printing on transparency media. +Constraints are also used to prevent the use of uninstalled features such as the +duplexer unit, additional media trays, and so forth.

+ +

The UIConstraints directive is used to specify a constraint that is +placed in the PPD file. The directive is followed by a string using one of the +following formats:

+ +
+UIConstraints "*Option1 *Option2"
+UIConstraints "*Option1 Choice1 *Option2"
+UIConstraints "*Option1 *Option2 Choice2"
+UIConstraints "*Option1 Choice1 *Option2 Choice2"
+
+ +

Each option name is preceded by the asterisk (*). If no choice is +given for an option, then all choices except False and +None will conflict with the other option and choice(s). Since the PPD +compiler automatically adds reciprocal constraints (option A conflicts with +option B, so therefore option B conflicts with option A), you need only specify +the constraint once.

+ +

Listing 5: "examples/constraint.drv"

+ +
+
+// Include standard font and media definitions
+#include <font.defs>
+#include <media.defs>
+
+// List the fonts that are supported, in this case all standard fonts...
+Font *
+
+// Manufacturer, model name, and version
+Manufacturer "Foo"
+ModelName "FooJet 2000"
+Version 1.0
+
+// Each filter provided by the driver...
+Filter application/vnd.cups-raster 100 rastertofoo
+
+// Supported page sizes
+*MediaSize Letter
+MediaSize A4
+
+// Supported resolutions
+*Resolution k 8 0 0 0 "600dpi/600 DPI"
+
+// Installable Option Group
+Group "InstallableOptions/Options Installed"
+
+  // Duplexing unit option
+  Option "OptionDuplexer/Duplexing Unit" Boolean AnySetup 10
+    Choice True/Installed ""
+    *Choice "False/Not Installed" ""
+
+// General Option Group
+Group General
+
+  // Duplexing option
+  Option "Duplex/Two-Sided Printing" PickOne AnySetup 10
+    *Choice "None/No" "<</Duplex false>>setpagedevice""
+    Choice "DuplexNoTumble/Long Edge Binding"
+           "<</Duplex true/Tumble false>>setpagedevice""
+    Choice "DuplexTumble/Short Edge Binding"
+           "<</Duplex true/Tumble true>>setpagedevice""
+
+// Only allow duplexing if the duplexer is installed
+UIConstraints "*Duplex *OptionDuplexer False"
+
+// Specify the name of the PPD file we want to generate...
+PCFileName "foojet2k.ppd"
+
+ +

Listing 5 shows a variation of the first example with +an added Duplex option and installable option for the duplexer, +OptionDuplex. A constraint is added at the end to specify that any +choice of the Duplex option that is not None is incompatible +with the "Duplexer Installed" option set to "Not Installed" +(False):

+ +
+UIConstraints "*Duplex *OptionDuplexer False"
+
+ +

Enhanced Constraints

+ +

CUPS 1.4 supports constraints between 2 or more options using the +Attribute directive. cupsUIConstraints attributes define +the constraints, while cupsUIResolver attributes define option changes +to resolve constraints. For example, we can specify the previous duplex +constraint with a resolver that turns off duplexing with the following two +lines:

+ +
+Attribute cupsUIConstraints DuplexOff "*Duplex *OptionDuplexer False"
+Attribute cupsUIResolver DuplexOff "*Duplex None"
+
+ + + diff --git a/doc/help/ref-ppdcfile.html b/doc/help/ref-ppdcfile.html index 86619e3ef..4549586b6 100644 --- a/doc/help/ref-ppdcfile.html +++ b/doc/help/ref-ppdcfile.html @@ -2404,7 +2404,7 @@ supported keywords for each type.


* = This color order is not supported by the current Apple RIP filters and should not be used when developing printer drivers for - MacOS X 10.2 or 10.3. + Mac OS X. diff --git a/doc/images/cups-command-chain.png b/doc/images/cups-command-chain.png new file mode 100644 index 0000000000000000000000000000000000000000..a7218e5ce45e57783db68fb655cdd0de11d91749 GIT binary patch literal 14902 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 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + PPD + + + + OptionalCommandFilter + + + + + + + + + CommandFile + + + + + + Printer + + + + + OptionalPortMonitor + + + + + Backend + + + diff --git a/doc/images/cups-postscript-chain.png b/doc/images/cups-postscript-chain.png new file mode 100644 index 0000000000000000000000000000000000000000..41f8bced8af249d2c233771248a36633ea5a8889 GIT binary patch literal 17498 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 B#y9`~ literal 0 Hc-jL100001 diff --git a/doc/images/cups-postscript-chain.svg b/doc/images/cups-postscript-chain.svg new file mode 100644 index 000000000..d1e2d3e84 --- /dev/null +++ b/doc/images/cups-postscript-chain.svg @@ -0,0 +1,531 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + PPD + + + + + Printer + + + + + OptionalPortMonitor + + + + + Backend + + + + OptionalPostScriptFilter + + OptionalPostScriptFilter + + + + + + + + + + + + PrintFile + + + + + + + CUPSFilters + + + CUPSFilters + + + + + diff --git a/doc/images/cups-raster-chain.png b/doc/images/cups-raster-chain.png new file mode 100644 index 0000000000000000000000000000000000000000..5349bd9f573c0ffd8e630deb29a1c24f593da68c GIT binary patch literal 16916 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 literal 0 Hc-jL100001 diff --git a/doc/images/cups-raster-chain.svg b/doc/images/cups-raster-chain.svg new file mode 100644 index 000000000..5130c8191 --- /dev/null +++ b/doc/images/cups-raster-chain.svg @@ -0,0 +1,534 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + PPD + + + + + Printer + + + + + OptionalPortMonitor + + + + + Backend + + + + OptionalPostScriptFilter + + + RequiredRasterFilter + + + + + + + + + + + + + PrintFile + + + + + + + CUPSFilters + + + CUPSFilters + + + + + diff --git a/examples/Makefile b/examples/Makefile new file mode 100644 index 000000000..928d71c15 --- /dev/null +++ b/examples/Makefile @@ -0,0 +1,128 @@ +# +# "$Id$" +# +# PPD compiler example makefile for the Common UNIX Printing System (CUPS). +# +# Copyright 2007-2008 by Apple Inc. +# Copyright 2002-2005 by Easy Software Products. +# +# These coded instructions, statements, and computer programs are the +# property of Apple Inc. and are protected by Federal copyright +# law. Distribution and use rights are outlined in the file "LICENSE.txt" +# which should have been included with this file. If this file is +# file is missing or damaged, see the license at "http://www.cups.org/". +# + +# +# Include standard definitions... +# + +include ../Makedefs + + +# +# Examples... +# + +EXAMPLES = \ + color.drv \ + constraint.drv \ + custom.drv \ + grouping.drv \ + laserjet-basic.drv \ + laserjet-pjl.drv \ + minimum.drv \ + postscript.drv \ + r300-basic.drv \ + r300-colorman.drv \ + r300-remote.drv + + +# +# Make everything... +# + +all: + + +# +# Make library targets... +# + +libs: + + +# +# Make unit tests... +# + +unittests: + + +# +# Clean everything... +# + +clean: + + +# +# Dummy depend... +# + +depend: + + +# +# Install all targets... +# + +install: all install-data install-headers install-libs install-exec + + +# +# Install data files... +# + +install-data: + $(INSTALL_DIR) $(DATADIR)/examples + for file in $(EXAMPLES); do \ + $(INSTALL_DATA) $$file $(DATADIR)/examples; \ + done + + +# +# Install programs... +# + +install-exec: + + +# +# Install headers... +# + +install-headers: + + +# +# Install libraries... +# + +install-libs: + + +# +# Uninstall files... +# + +uninstall: + for file in $(EXAMPLES); do \ + $(RM) $(DATADIR)/examples/$$file; \ + done + -$(RMDIR) $(DATADIR)/examples + + +# +# End of "$Id$". +# diff --git a/examples/color.drv b/examples/color.drv new file mode 100644 index 000000000..69984c4b9 --- /dev/null +++ b/examples/color.drv @@ -0,0 +1,44 @@ +// Include standard font and media definitions +#include +#include + +// List the fonts that are supported, in this case all standard +// fonts... +Font * + +// Manufacturer and version +Manufacturer "Foo" +Version 1.0 + +// Each filter provided by the driver... +Filter application/vnd.cups-raster 100 rastertofoo + +// Supported page sizes +*MediaSize Letter +MediaSize A4 + +{ + // Supported resolutions + *Resolution k 8 0 0 0 "600dpi/600 DPI" + + // Specify the model name and filename... + ModelName "FooJet 2000" + PCFileName "foojet2k.ppd" +} + +{ + // Supports color printing + ColorDevice true + + // Supported colorspaces + ColorModel Gray/Grayscale w chunky 0 + *ColorModel RGB/Color rgb chunky 0 + + // Supported resolutions + *Resolution - 8 0 0 0 "300dpi/300 DPI" + Resolution - 8 0 0 0 "600dpi/600 DPI" + + // Specify the model name and filename... + ModelName "FooJet Color" + PCFileName "foojetco.ppd" +} diff --git a/examples/constraint.drv b/examples/constraint.drv new file mode 100644 index 000000000..6acb7f106 --- /dev/null +++ b/examples/constraint.drv @@ -0,0 +1,48 @@ +// Include standard font and media definitions +#include +#include + +// List the fonts that are supported, in this case all standard +// fonts... +Font * + +// Manufacturer, model name, and version +Manufacturer "Foo" +ModelName "FooJet 2000" +Version 1.0 + +// Each filter provided by the driver... +Filter application/vnd.cups-raster 100 rastertofoo + +// Supported page sizes +*MediaSize Letter +MediaSize A4 + +// Supported resolutions +*Resolution k 8 0 0 0 "600dpi/600 DPI" + +// Installable Option Group +Group "InstallableOptions/Options Installed" + + // Duplexing unit option + Option "Option1/Duplexing Unit" Boolean AnySetup 10 + Choice True/Installed "" + *Choice "False/Not Installed" "" + +// General Option Group +Group General + + // Duplexing option + Option "Duplex/Two-Sided Printing" PickOne AnySetup 10 + *Choice "None/No" "<>setpagedevice" + Choice "DuplexNoTumble/Long Edge Binding" + "<>setpagedevice" + Choice "DuplexTumble/Short Edge Binding" + "<>setpagedevice" + +// Only allow duplexing if the duplexer is installed +UIConstraints "*Duplex *Option1 False" + +// Specify the name of the PPD file we want to generate... +PCFileName "foojet2k.ppd" + diff --git a/examples/custom.drv b/examples/custom.drv new file mode 100644 index 000000000..1001c4fc1 --- /dev/null +++ b/examples/custom.drv @@ -0,0 +1,41 @@ +// Include standard font and media definitions +#include +#include + +// List the fonts that are supported, in this case all standard +// fonts... +Font * + +// Manufacturer, model name, and version +Manufacturer "Foo" +ModelName "FooJet 2000" +Version 1.0 + +// Each filter provided by the driver... +Filter application/vnd.cups-raster 100 rastertofoo + +// Supported page sizes +*MediaSize Letter +MediaSize A4 + +// Supported resolutions +*Resolution k 8 0 0 0 "600dpi/600 DPI" + +// Option Group +Group "Footasm" + + // Boolean option + Option "fooEnhance/Resolution Enhancement" Boolean AnySetup 10 + *Choice True/Yes "<>setpagedevice" + Choice False/No "<>setpagedevice" + + // Multiple choice option + Option "fooOutputType/Output Quality" PickOne AnySetup 10 + *Choice "Auto/Automatic Selection" "<>setpagedevice" + Choice "Text/Optimize for Text" "<>setpagedevice" + Choice "Graph/Optimize for Graphics" "<>setpagedevice" + Choice "Photo/Optimize for Photos" "<>setpagedevice" + +// Specify the name of the PPD file we want to generate... +PCFileName "foojet2k.ppd" + diff --git a/examples/grouping.drv b/examples/grouping.drv new file mode 100644 index 000000000..da66d74fc --- /dev/null +++ b/examples/grouping.drv @@ -0,0 +1,36 @@ +// Include standard font and media definitions +#include +#include + +// List the fonts that are supported, in this case all standard +// fonts... +Font * + +// Manufacturer and version +Manufacturer "Foo" +Version 1.0 + +// Each filter provided by the driver... +Filter application/vnd.cups-raster 100 rastertofoo + +// Supported page sizes +*MediaSize Letter +MediaSize A4 + +{ + // Supported resolutions + *Resolution k 8 0 0 0 "600dpi/600 DPI" + + // Specify the model name and filename... + ModelName "FooJet 2000" + PCFileName "foojet2k.ppd" +} + +{ + // Supported resolutions + *Resolution k 8 0 0 0 "1200dpi/1200 DPI" + + // Specify the model name and filename... + ModelName "FooJet 2001" + PCFileName "foojt2k1.ppd" +} diff --git a/examples/laserjet-basic.drv b/examples/laserjet-basic.drv new file mode 100644 index 000000000..6924ed7b8 --- /dev/null +++ b/examples/laserjet-basic.drv @@ -0,0 +1,88 @@ +// Include standard font and media definitions +#include +#include + +// Include HP-PCL driver definitions +#include + +// Specify that this driver uses the HP-PCL driver... +DriverType pcl + +// Specify the driver options via the model number... +ModelNumber ($PCL_PAPER_SIZE $PCL_PJL $PCL_PJL_RESOLUTION) + +// List the fonts that are supported, in this case all standard +// fonts... +Font * + +// Manufacturer and driver version +Manufacturer "HP" +Version 1.0 + +// Supported page sizes and their margins +HWMargins 18 12 18 12 +*MediaSize Letter +MediaSize Legal +MediaSize Executive +MediaSize Monarch +MediaSize Statement +MediaSize FanFoldGermanLegal + +HWMargins 18 12.72 18 12.72 +MediaSize Env10 + +HWMargins 9.72 12 9.72 12 +MediaSize A4 +MediaSize A5 +MediaSize B5 +MediaSize EnvC5 +MediaSize EnvDL +MediaSize EnvISOB5 +MediaSize Postcard +MediaSize DoublePostcard + +// Only black-and-white output with mode 3 compression... +ColorModel Gray k chunky 3 + +// Supported resolutions +Resolution - 1 0 0 0 "300dpi/300 DPI" +*Resolution - 8 0 0 0 "600dpi/600 DPI" + +// Supported input slots +*InputSlot 7 "Auto/Automatic Selection" +InputSlot 2 "Manual/Tray 1 - Manual Feed" +InputSlot 4 "Upper/Tray 1" +InputSlot 1 "Lower/Tray 2" +InputSlot 5 "LargeCapacity/Tray 3" + +// Tray 3 is an option... +Installable "OptionLargeCapacity/Tray 3 Installed" +UIConstraints "*OptionLargeCapacity False *InputSlot LargeCapacity" + +{ + // HP LaserJet 2100 Series + Throughput 10 + ModelName "LaserJet 2100 Series" + PCFileName "hpljt211.ppd" +} + +{ + // LaserJet 2200 and 2300 series have duplexer option... + Duplex normal + Installable "OptionDuplex/Duplexer Installed" + UIConstraints "*OptionDuplex False *Duplex" + + { + // HP LaserJet 2200 Series + Throughput 19 + ModelName "LaserJet 2200 Series" + PCFileName "hpljt221.ppd" + } + + { + // HP LaserJet 2300 Series + Throughput 25 + ModelName "LaserJet 2300 Series" + PCFileName "hpljt231.ppd" + } +} diff --git a/examples/laserjet-pjl.drv b/examples/laserjet-pjl.drv new file mode 100644 index 000000000..32a0bc4f0 --- /dev/null +++ b/examples/laserjet-pjl.drv @@ -0,0 +1,101 @@ +// Include standard font and media definitions +#include +#include + +// Include HP-PCL driver definitions +#include + +// Specify that this driver uses the HP-PCL driver... +DriverType pcl + +// Specify the driver options via the model number... +ModelNumber ($PCL_PAPER_SIZE $PCL_PJL $PCL_PJL_RESOLUTION) + +// List the fonts that are supported, in this case all standard +// fonts... +Font * + +// Manufacturer and driver version +Manufacturer "HP" +Version 2.0 + +// Supported page sizes and their margins +HWMargins 18 12 18 12 +*MediaSize Letter +MediaSize Legal +MediaSize Executive +MediaSize Monarch +MediaSize Statement +MediaSize FanFoldGermanLegal + +HWMargins 18 12.72 18 12.72 +MediaSize Env10 + +HWMargins 9.72 12 9.72 12 +MediaSize A4 +MediaSize A5 +MediaSize B5 +MediaSize EnvC5 +MediaSize EnvDL +MediaSize EnvISOB5 +MediaSize Postcard +MediaSize DoublePostcard + +// Only black-and-white output with mode 3 compression... +ColorModel Gray k chunky 3 + +// Supported resolutions +Resolution - 1 0 0 0 "300dpi/300 DPI" +*Resolution - 8 0 0 0 "600dpi/600 DPI" + +// Supported input slots +*InputSlot 7 "Auto/Automatic Selection" +InputSlot 2 "Manual/Tray 1 - Manual Feed" +InputSlot 4 "Upper/Tray 1" +InputSlot 1 "Lower/Tray 2" +InputSlot 5 "LargeCapacity/Tray 3" + +// Tray 3 is an option... +Installable "OptionLargeCapacity/Tray 3 Installed" +UIConstraints "*OptionLargeCapacity False *InputSlot LargeCapacity" + +// PJL options +Attribute cupsPJL cupsRET "@PJL SET SMOOTHING=%?False:OFF;%?True:ON;%n" + +Option "cupsRET/Smoothing" Boolean DocumentSetup 10 + Choice "False/Off" "" + *Choice "True/On" "" + +Attribute cupsPJL cupsTonerSave "@PJL SET ECONOMODE=%?False:OFF;%?True:ON;%n" + +Option "cupsTonerSave/Save Toner" Boolean DocumentSetup 10 + *Choice "False/No" "" + Choice "True/Yes" "" + +{ + // HP LaserJet 2100 Series + Throughput 10 + ModelName "LaserJet 2100 Series PJL" + PCFileName "hpljt212.ppd" +} + +{ + // LaserJet 2200 and 2300 series have duplexer option... + Duplex normal + Installable "OptionDuplex/Duplexer Installed" + UIConstraints "*OptionDuplex False *Duplex" + + { + // HP LaserJet 2200 Series + Throughput 19 + ModelName "LaserJet 2200 Series PJL" + PCFileName "hpljt222.ppd" + } + + { + // HP LaserJet 2300 Series + Throughput 25 + ModelName "LaserJet 2300 Series PJL" + PCFileName "hpljt232.ppd" + } +} diff --git a/examples/minimum.drv b/examples/minimum.drv new file mode 100644 index 000000000..ac6e38db0 --- /dev/null +++ b/examples/minimum.drv @@ -0,0 +1,26 @@ +// Include standard font and media definitions +#include +#include + +// List the fonts that are supported, in this case all standard +// fonts... +Font * + +// Manufacturer, model name, and version +Manufacturer "Foo" +ModelName "FooJet 2000" +Version 1.0 + +// Each filter provided by the driver... +Filter application/vnd.cups-raster 100 rastertofoo + +// Supported page sizes +*MediaSize Letter +MediaSize A4 + +// Supported resolutions +*Resolution k 8 0 0 0 "600dpi/600 DPI" + +// Specify the name of the PPD file we want to generate... +PCFileName "foojet2k.ppd" + diff --git a/examples/postscript.drv b/examples/postscript.drv new file mode 100644 index 000000000..ebb02f8a0 --- /dev/null +++ b/examples/postscript.drv @@ -0,0 +1,46 @@ +// Include standard font and media definitions +#include +#include + +// Specify this is a PostScript printer driver +DriverType ps + +// List the fonts that are supported, in this case all standard fonts +Font * + +// Manufacturer, model name, and version +Manufacturer "Foo" +ModelName "Foo LaserProofer 2000" +Version 1.0 + +// PostScript printer attributes +Attribute DefaultColorSpace "" Gray +Attribute LandscapeOrientation "" Minus90 +Attribute LanguageLevel "" "3" +Attribute Product "" "(Foo LaserProofer 2000)" +Attribute PSVersion "" "(3010) 0" +Attribute TTRasterizer "" Type42 + +// Supported page sizes +*MediaSize Letter +MediaSize Legal +MediaSize A4 + +// Query command for page size +Attribute "?PageSize" "" " + save + currentpagedevice /PageSize get aload pop + 2 copy gt {exch} if (Unknown) + 23 dict + dup [612 792] (Letter) put + dup [612 1008] (Legal) put + dup [595 842] (A4) put + {exch aload pop 4 index sub abs 5 le exch + 5 index sub abs 5 le and + {exch pop exit} {pop} ifelse + } bind forall = flush pop pop + restore" + +// Specify the name of the PPD file we want to generate +PCFileName "fooproof.ppd" + diff --git a/examples/r300-basic.drv b/examples/r300-basic.drv new file mode 100644 index 000000000..e203d511d --- /dev/null +++ b/examples/r300-basic.drv @@ -0,0 +1,75 @@ +// Include standard font and media definitions +#include +#include + +// Include ESC/P driver definitions +#include + +// Specify that this driver uses the ESC/P driver... +DriverType escp + +// Specify the driver options via the model number... +ModelNumber ($ESCP_ESCK $ESCP_EXT_UNITS $ESCP_EXT_MARGINS $ESCP_USB + $ESCP_PAGE_SIZE $ESCP_RASTER_ESCI) + +// List the fonts that are supported, in this case all standard +// fonts... +Font * + +// Manufacturer and driver version +Manufacturer "Epson" +Version 1.0 + +// Supported page sizes and their margins +HWMargins 8.4 0 8.4 0 +*MediaSize Letter +MediaSize Legal +MediaSize Executive +MediaSize Statement +MediaSize A4 +MediaSize A5 +MediaSize A6 +MediaSize B5 +MediaSize Env10 +MediaSize EnvC5 +MediaSize EnvDL +MediaSize EnvISOB5 +MediaSize Postcard +MediaSize DoublePostcard + +VariablePaperSize Yes +MinSize 1in 4in +MaxSize 8.5in 44in + +// Four color modes are supported... +ColorModel Gray/Grayscale w chunky 1 +ColorModel Black k chunky 1 +*ColorModel RGB/Color rgb chunky 1 +ColorModel CMYK cmyk chunky 1 + +// Supported resolutions +Resolution - 8 90 0 103 "360dpi/360 DPI" +*Resolution - 8 90 0 206 "720dpi/720 DPI" +Resolution - 8 90 0 412 "1440dpi/1440 DPI" + +// Very basic dithering settings +Attribute cupsInkChannels "" 6 +Attribute cupsInkLimit "" 2.0 + +Attribute cupsCyanLtDk "" "0.5 1.0" +Attribute cupsMagentaLtDk "" "0.5 1.0" + +Attribute cupsAllDither 360dpi "0.5 0.75 1.0" +Attribute cupsAllDither 720dpi "0.6 0.9 1.2" +Attribute cupsAllDither 1440dpi "0.9 1.35" + +Attribute cupsESCPDotSize 360dpi 16 +Attribute cupsESCPDotSize 720dpi 17 +Attribute cupsESCPDotSize 1440dpi 18 + +{ + // EPSON Stylus Photo R300 Series + Throughput 1 + ModelName "Stylus Photo R300" + PCFileName "epspr301.ppd" +} diff --git a/examples/r300-colorman.drv b/examples/r300-colorman.drv new file mode 100644 index 000000000..ddaf58ec7 --- /dev/null +++ b/examples/r300-colorman.drv @@ -0,0 +1,85 @@ +// Include standard font and media definitions +#include +#include + +// Include ESC/P driver definitions +#include + +// Specify that this driver uses the ESC/P driver... +DriverType escp + +// Specify the driver options via the model number... +ModelNumber ($ESCP_ESCK $ESCP_EXT_UNITS $ESCP_EXT_MARGINS $ESCP_USB + $ESCP_PAGE_SIZE $ESCP_RASTER_ESCI $ESCP_REMOTE) + +// List the fonts that are supported, in this case all standard +// fonts... +Font * + +// Manufacturer and driver version +Manufacturer "Epson" +Version 3.0 + +// Supported page sizes and their margins +HWMargins 0 0 0 0 +*MediaSize Letter +MediaSize Legal +MediaSize Executive +MediaSize Statement +MediaSize A4 +MediaSize A5 +MediaSize A6 +MediaSize B5 +MediaSize Env10 +MediaSize EnvC5 +MediaSize EnvDL +MediaSize EnvISOB5 +MediaSize Postcard +MediaSize DoublePostcard + +VariablePaperSize Yes +MinSize 1in 4in +MaxSize 8.5in 44in + +// Borderless printing offset... +Attribute cupsESCPFP "" 0 + +// Four color modes are supported... +ColorModel Gray/Grayscale w chunky 1 +ColorModel Black k chunky 1 +*ColorModel RGB/Color rgb chunky 1 +ColorModel CMYK cmyk chunky 1 + +// Supported resolutions +Resolution - 8 90 0 103 "360dpi/360 DPI" +*Resolution - 8 90 0 206 "720dpi/720 DPI" +Resolution - 8 90 0 412 "1440dpi/1440 DPI" + +// Paper trays... +*InputSlot 0 "Auto/Auto Select" +InputSlot 1 "Manual/Manual Feed" + +Attribute cupsESCPPP 0 "1 255" +Attribute cupsESCPPP 1 "2 1" + +// Very basic dithering settings +Attribute cupsInkChannels "" 6 +Attribute cupsInkLimit "" 3.0 + +Attribute cupsCyanLtDk "" "0.5 1.0" +Attribute cupsMagentaLtDk "" "0.5 1.0" + +Attribute cupsAllDither 360dpi "0.5 0.75 1.0" +Attribute cupsAllDither 720dpi "0.6 0.9 1.2" +Attribute cupsAllDither 1440dpi "0.9 1.35" + +Attribute cupsESCPDotSize 360dpi 16 +Attribute cupsESCPDotSize 720dpi 17 +Attribute cupsESCPDotSize 1440dpi 18 + +{ + // EPSON Stylus Photo R300 Series + Throughput 1 + ModelName "Epson Stylus Photo R300" + PCFileName "epspr303.ppd" +} diff --git a/examples/r300-remote.drv b/examples/r300-remote.drv new file mode 100644 index 000000000..c3065d00c --- /dev/null +++ b/examples/r300-remote.drv @@ -0,0 +1,85 @@ +// Include standard font and media definitions +#include +#include + +// Include ESC/P driver definitions +#include + +// Specify that this driver uses the ESC/P driver... +DriverType escp + +// Specify the driver options via the model number... +ModelNumber ($ESCP_ESCK $ESCP_EXT_UNITS $ESCP_EXT_MARGINS $ESCP_USB + $ESCP_PAGE_SIZE $ESCP_RASTER_ESCI $ESCP_REMOTE) + +// List the fonts that are supported, in this case all standard +// fonts... +Font * + +// Manufacturer and driver version +Manufacturer "Epson" +Version 2.0 + +// Supported page sizes and their margins +HWMargins 0 0 0 0 +*MediaSize Letter +MediaSize Legal +MediaSize Executive +MediaSize Statement +MediaSize A4 +MediaSize A5 +MediaSize A6 +MediaSize B5 +MediaSize Env10 +MediaSize EnvC5 +MediaSize EnvDL +MediaSize EnvISOB5 +MediaSize Postcard +MediaSize DoublePostcard + +VariablePaperSize Yes +MinSize 1in 4in +MaxSize 8.5in 44in + +// Borderless printing offset... +Attribute cupsESCPFP "" -80 + +// Four color modes are supported... +ColorModel Gray/Grayscale w chunky 1 +ColorModel Black k chunky 1 +*ColorModel RGB/Color rgb chunky 1 +ColorModel CMYK cmyk chunky 1 + +// Supported resolutions +Resolution - 8 90 0 103 "360dpi/360 DPI" +*Resolution - 8 90 0 206 "720dpi/720 DPI" +Resolution - 8 90 0 412 "1440dpi/1440 DPI" + +// Paper trays... +*InputSlot 0 "Auto/Auto Select" +InputSlot 1 "Manual/Manual Feed" + +Attribute cupsESCPPP 0 "1 255" +Attribute cupsESCPPP 1 "2 1" + +// Very basic dithering settings +Attribute cupsInkChannels "" 6 +Attribute cupsInkLimit "" 2.0 + +Attribute cupsCyanLtDk "" "0.5 1.0" +Attribute cupsMagentaLtDk "" "0.5 1.0" + +Attribute cupsAllDither 360dpi "0.5 0.75 1.0" +Attribute cupsAllDither 720dpi "0.6 0.9 1.2" +Attribute cupsAllDither 1440dpi "0.9 1.35" + +Attribute cupsESCPDotSize 360dpi 16 +Attribute cupsESCPDotSize 720dpi 17 +Attribute cupsESCPDotSize 1440dpi 18 + +{ + // EPSON Stylus Photo R300 Series + Throughput 1 + ModelName "Epson Stylus Photo R300" + PCFileName "epspr302.ppd" +} diff --git a/filter/bannertops.c b/filter/bannertops.c index ab27adec0..70342b1ac 100644 --- a/filter/bannertops.c +++ b/filter/bannertops.c @@ -587,7 +587,7 @@ write_banner(banner_file_t *banner, /* I - Banner file */ * Start the page... */ - printf("%%Page: %s %d\n", i == 1 ? "coverpage" : "coverback", i); + printf("%%%%Page: %s %d\n", i == 1 ? "coverpage" : "coverback", i); puts("gsave"); printf("%.1f %.1f translate\n", PageLeft, PageBottom); puts("0 setgray"); diff --git a/filter/image-png.c b/filter/image-png.c index 95cc9eacd..c2f3c493c 100644 --- a/filter/image-png.c +++ b/filter/image-png.c @@ -178,7 +178,7 @@ _cupsImageReadPNG( { bufsize = img->xsize * img->ysize; - if ((bufsize / img->ysize) != img->xsize) + if ((bufsize / img->xsize) != img->ysize) { fprintf(stderr, "DEBUG: PNG image dimensions (%ux%u) too large!\n", (unsigned)width, (unsigned)height); @@ -190,7 +190,7 @@ _cupsImageReadPNG( { bufsize = img->xsize * img->ysize * 3; - if ((bufsize / (img->ysize * 3)) != img->xsize) + if ((bufsize / (img->xsize * 3)) != img->ysize) { fprintf(stderr, "DEBUG: PNG image dimensions (%ux%u) too large!\n", (unsigned)width, (unsigned)height); diff --git a/filter/pstext.c b/filter/pstext.c index e809e40ff..1517a608b 100644 --- a/filter/pstext.c +++ b/filter/pstext.c @@ -84,6 +84,9 @@ psTextEmbedFonts(ps_text_t *fonts) /* I - Font data */ fclose(fp); } + else + fprintf(stderr, "DEBUG: Unable to open font file \"%s\" - %s\n", + filename, strerror(errno)); puts("\n%%EndResource"); } diff --git a/man/drv.man.in b/man/drv.man.in index 6e553adbd..504f662f6 100644 --- a/man/drv.man.in +++ b/man/drv.man.in @@ -11,7 +11,7 @@ .\" which should have been included with this file. If this file is .\" file is missing or damaged, see the license at "http://www.cups.org/". .\" -.TH ppdc 1 "Common UNIX Printing System" "20 May 2008" "Apple Inc." +.TH drv 1 "Common UNIX Printing System" "20 May 2008" "Apple Inc." .SH NAME drv \- cups driver interface for ppd compiler files .SH SYNOPSIS diff --git a/packaging/cups.list.in b/packaging/cups.list.in index 5678d4d89..196677851 100644 --- a/packaging/cups.list.in +++ b/packaging/cups.list.in @@ -548,9 +548,11 @@ f 0644 root sys $DATADIR/data/testprint data/testprint d 0755 root sys $DATADIR/drv - f 0644 root sys $DATADIR/drv/sample.drv ppdc/sample.drv +d 0755 root sys $DATADIR/examples - +f 0644 root sys $DATADIR/examples examples/*.drv + d 0755 root sys $DATADIR/fonts - -f 0644 root sys $DATADIR/fonts fonts/Courier* -f 0644 root sys $DATADIR/fonts/Symbol fonts/Symbol +f 0644 root sys $DATADIR/fonts fonts/Monospace* d 0755 root sys $DATADIR/mime - f 0644 root sys $DATADIR/mime/mime.convs conf/mime.convs @@ -640,6 +642,9 @@ f 0644 root sys $LIBDIR/libcupsppdc.a ppdc/libcupsppdc.a d 0755 root sys $DOCDIR/help - f 0644 root sys $DOCDIR/help doc/help/api*.html +f 0644 root sys $DOCDIR/help/postscript-driver.html doc/help/postscript-driver.html +f 0644 root sys $DOCDIR/help/ppd-compiler.html doc/help/ppd-compiler.html +f 0644 root sys $DOCDIR/help/raster-driver.html doc/help/raster-driver.html f 0644 root sys $DOCDIR/help doc/help/spec*.html %subpackage -- 2.39.2