From 4f63d6cdafa4052f52fa15e8fc97650c558d45b4 Mon Sep 17 00:00:00 2001
From: Michael Sweet CUPS supports several methods of auto-configuration via PPD keywords. *APAutoSetupTool: "/LibraryPrinters/vendor/filename" *?MainKeyword: " *?OIDMainKeyword: ".n.n.n..." *cupsColorProfile Resolution/MediaType: "density gamma m00 m01 m02 m10 m11 m12 m20 m21 m22" *APSupportsCustomColorMatching: true *cupsUIConstraints resolver: "*Keyword1 *Keyword2 ..." *cupsUIResolver resolver: "*Keyword1 OptionKeyword1 *Keyword2 OptionKeyword2 ..." The resulting dictionary sets the page device attributes that are sent to your raster driver in the page header. There are many possible implementations of the CustomPageSize code. For CUPS raster drivers, the following code is recommended: CUPS supports the following PostScript operators in addition to the usual PostScript number, string (literal and hex-encoded), boolean, null, and name values: Table 2 shows the supported page device attributes along with PostScript code examples. The CUPS media keywords allow drivers to specify alternate custom page
size limits based on up to two options. *cupsMediaQualifier2: MainKeywordmacOS 10.5APAutoSetupTool
macOS 10.2/CUPS 1.4?MainKeyword
@@ -74,6 +76,7 @@ LINE-END = CR / LF / CR LF
*CloseUI: OptionDuplex
+
macOS 10.4/CUPS 1.5OIDMainKeyword
@@ -105,6 +108,7 @@ LINE-END = CR / LF / CR LF
+
DeprecatedcupsColorProfile
macOS 10.4Custom Color Matching Support
@@ -282,6 +287,7 @@ f(x) = density * x gamma
+
CUPS 1.4/macOS 10.6cupsUIConstraints
@@ -312,6 +318,7 @@ f(x) = density * x gamma
*cupsUIConstraints photo: "*OutputMode Photo *MediaType Transparency *Resolution 1200dpi"
+
CUPS 1.4/macOS 10.6cupsUIResolver
Custom Page Size Code
Supported PostScript Operators
Supported Page Device Attributes
CUPS 1.4/macOS 10.6cupsMediaQualifier2
*cupsMediaQualifier3: MainKeyword
@@ -910,6 +922,7 @@ custom page size limits. *cupsMinSize ..Photo: "300 300" +*cupsMinSize .Qualifier2.Qualifier3: "width length"
@@ -933,6 +946,7 @@ are used to identify options to use for matching.
*cupsMaxSize .Qualifier2.Qualifier3: "width length"
@@ -1070,6 +1084,7 @@ will be ignored.
Also see the related APDuplexRequiresFlippedMargin keyword.
+*cupsCommands: "name name2 ... nameN"
@@ -1101,6 +1116,7 @@ printing is selected. The default value isfalse
.
*cupsEvenDuplex: true
+
*cupsFax: boolean
@@ -1113,6 +1129,7 @@ printing is selected. The default value isfalse
.
*cupsFax: true
+
*cupsFilter: "source/type cost program"
@@ -1135,6 +1152,7 @@ the special filter program "-" may be specified. *cupsFilter: "application/vnd.cups-postscript 0 -" +*cupsFilter2: "source/type destination/type cost program"
@@ -1160,6 +1178,26 @@ the special filter program "-" may be specified. *cupsFilter2: "application/vnd.cups-postscript application/postscript 0 -" + +*cupsFinishingTemplate name/text: ""
+ +This option keyword specifies a finishing template (preset) that applies zero or more finishing processes to a job. Unlike cupsIPPFinishings, only one template can be selected by the user. PPD files also generally apply a constraint between this option and other finishing options like Booklet, FoldType, PunchMedia, and StapleWhen.
+ +Examples:
+ ++*cupsFinishingTemplate none/None: "" +*cupsFinishingTemplate fold/Letter Fold: "" +*cupsFinishingTemplate punch/2/3-Hole Punch: "" +*cupsFinishingTemplate staple/Corner Staple: "" +*cupsFinishingTemplate staple-dual/Double Staple: "" +*cupsFinishingTemplate staple-and-fold/Corner Staple and Letter Fold: "" +*cupsFinishingTemplate staple-and-punch/Corner Staple and 2/3-Hole Punch: "" ++ +
*cupsFlipDuplex: boolean
@@ -1195,6 +1233,7 @@ Ghostscript can use: *cupsFlipDuplex: true +*cupsIPPFinishings number/text: "*Option Choice ..."
@@ -1211,6 +1250,7 @@ values to PPD options and choices. *cupsIPPFinishings 21/staple-bottom-left: "*StapleLocation SingleLandscape" +*cupsIPPReason reason/Reason Text: "optional URIs"
@@ -1251,6 +1291,7 @@ http://www.vendor.com/help" *End +*cupsIPPSupplies: boolean
@@ -1352,6 +1393,7 @@ hardware. The default value isfalse
.
*cupsManualCopies: true
+
*cupsMarkerName/Name Text: ""
@@ -1366,6 +1408,7 @@ generated by the driver to human readable text. *cupsMarkerName cyanToner/Cyan Toner: "" +*cupsMarkerNotice: "disclaimer text"
@@ -1380,6 +1423,7 @@ are approximate". *cupsMarkerNotice: "Supply levels are approximate." +*cupsMaxCopies: integer
@@ -1393,6 +1437,7 @@ are approximate". *cupsMaxCopies: 99 +*cupsModelNumber: number
@@ -1424,6 +1469,7 @@ assumed. *cupsPJLCharset: "UTF-8" +*cupsPJLDisplay: "what"
@@ -1443,6 +1489,7 @@ to use "@PJL RDYMSG DISPLAY". The default is "job". *cupsPJLDisplay: "none" +*cupsPortMonitor urischeme/Descriptive Text: "port monitor"
@@ -1475,6 +1522,7 @@ to disable the port monitor for the given URI scheme. *cupsPortMonitor usb/USB Status Monitor: "epson-usb" +*cupsPreFilter: "source/type cost program"
@@ -1518,6 +1566,7 @@ before the filter that accepts the given MIME type. *CloseUI: *cupsPrintQuality +*cupsSingleFile: Boolean
@@ -1534,6 +1583,7 @@ before the filter that accepts the given MIME type. *cupsSingleFile: True +*cupsSNMPSupplies: boolean
@@ -1549,6 +1599,7 @@ the standard SNMP Printer MIB OIDs for supply levels. The default value is *cupsSNMPSupplies: False +*cupsVersion: major.minor
@@ -1607,6 +1658,7 @@ in order to be usable with all applications. *APDialogExtension: "/Library/Printers/vendor/options.plugin" +*APDuplexRequiresFlippedMargin: boolean
@@ -1689,6 +1741,7 @@ and the Tumble page attribute.Also see the related cupsBackSide keyword.
+*APHelpBook: "bundle URL"
@@ -1704,6 +1757,7 @@ looking up IPP reason codes for this printer driver. The *APHelpBook: "file:///Library/Printers/vendor/Help.bundle" +*APICADriver: boolean
@@ -1718,6 +1772,7 @@ Architecture (ICA) driver for scanning. The default is False. *APScanAppBundleID: "com.apple.ImageCaptureApp" +*APPrinterIconPath: "/Library/Printers/vendor/filename.icns"
@@ -1732,6 +1787,7 @@ displaying the printer. The file must be in the Apple icon format. *APPrinterIconPath: "/Library/Printers/vendor/Icons/filename.icns" +*APPrinterLowInkTool: "/Library/Printers/vendor/program"
@@ -1749,6 +1805,7 @@ Technical Note TN2144 for more information. *APPrinterLowInkTool: "/Library/Printers/vendor/Tools/lowinktool" +*APPrinterPreset name/text: "*Option Choice ..."
@@ -1819,6 +1876,7 @@ choice (*MainKeyword OptionKeyword) or a preset identifier and value *fr.APPrinterPreset Photo_on_Photo_Paper/Photo sur papier photographique: "" +*APPrinterPrinterUtilityPath: "/Library/Printers/vendor/filename.app"
@@ -1834,6 +1892,7 @@ information. *APPrinterPrinterUtilityPath: "/Library/Printers/vendor/Tools/utility.app" +*APScannerOnly: boolean
@@ -1848,6 +1907,7 @@ capabilities. The default is False. *APScannerOnly: True +*APScanAppBundleID: "bundle ID"
@@ -1865,6 +1925,15 @@ the device.