From 4f63d6cdafa4052f52fa15e8fc97650c558d45b4 Mon Sep 17 00:00:00 2001 From: Michael Sweet Date: Tue, 28 Nov 2017 12:59:45 -0500 Subject: Add support for finishings-col (Issue #5180) - cups/ppd-cache.c: Look for cupsFinishingTemplate option, finishings-col-database attribute. Add finishings-col with finishing-template. - cups/ppd-private.h: Add array of finishing-template names. - scheduler/printers.c: Add finishings-col-database. --- filter/spec-ppd.shtml | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) (limited to 'filter') diff --git a/filter/spec-ppd.shtml b/filter/spec-ppd.shtml index 3b7543082..6f84dbdab 100644 --- a/filter/spec-ppd.shtml +++ b/filter/spec-ppd.shtml @@ -30,6 +30,7 @@ LINE-END = CR / LF / CR LF

CUPS supports several methods of auto-configuration via PPD keywords.

+

macOS 10.5APAutoSetupTool

*APAutoSetupTool: "/LibraryPrinters/vendor/filename"

@@ -45,6 +46,7 @@ LINE-END = CR / LF / CR LF *APAutoSetupTool: "/Library/Printers/vendor/Tools/autosetuptool" +

macOS 10.2/CUPS 1.4?MainKeyword

*?MainKeyword: "
@@ -74,6 +76,7 @@ LINE-END = CR / LF / CR LF *CloseUI: OptionDuplex +

macOS 10.4/CUPS 1.5OIDMainKeyword

*?OIDMainKeyword: ".n.n.n..."
@@ -105,6 +108,7 @@ LINE-END = CR / LF / CR LF +

DeprecatedcupsColorProfile

*cupsColorProfile Resolution/MediaType: "density gamma m00 m01 m02 m10 m11 m12 m20 m21 m22"

@@ -181,6 +185,7 @@ f(x) = density * x gamma *cupsICCQualifier3: Resolution +

macOS 10.4Custom Color Matching Support

*APSupportsCustomColorMatching: true
@@ -282,6 +287,7 @@ f(x) = density * x gamma +

CUPS 1.4/macOS 10.6cupsUIConstraints

*cupsUIConstraints resolver: "*Keyword1 *Keyword2 ..."
@@ -312,6 +318,7 @@ f(x) = density * x gamma *cupsUIConstraints photo: "*OutputMode Photo *MediaType Transparency *Resolution 1200dpi" +

CUPS 1.4/macOS 10.6cupsUIResolver

*cupsUIResolver resolver: "*Keyword1 OptionKeyword1 *Keyword2 OptionKeyword2 ..."

@@ -529,6 +536,7 @@ option value is "1234" then CUPS will output the string "@PJL SET PASSCODE=1234"

The resulting dictionary sets the page device attributes that are sent to your raster driver in the page header.

+

Custom Page Size Code

There are many possible implementations of the CustomPageSize code. For CUPS raster drivers, the following code is recommended:

@@ -542,6 +550,7 @@ option value is "1234" then CUPS will output the string "@PJL SET PASSCODE=1234" *CustomPageSize True: "pop pop pop <</PageSize[5 -2 roll]/ImagingBBox null>>setpagedevice" +

Supported PostScript Operators

CUPS supports the following PostScript operators in addition to the usual PostScript number, string (literal and hex-encoded), boolean, null, and name values:

@@ -601,6 +610,7 @@ PRE B { +

Supported Page Device Attributes

Table 2 shows the supported page device attributes along with PostScript code examples.

@@ -872,6 +882,7 @@ PRE B {

The CUPS media keywords allow drivers to specify alternate custom page size limits based on up to two options.

+

CUPS 1.4/macOS 10.6cupsMediaQualifier2

*cupsMediaQualifier2: MainKeyword

@@ -891,6 +902,7 @@ custom page size limits.

*cupsMinSize ..Photo: "300 300" +

CUPS 1.4/macOS 10.6cupsMediaQualifier3

*cupsMediaQualifier3: MainKeyword

@@ -910,6 +922,7 @@ custom page size limits.

*cupsMinSize ..Photo: "300 300" +

CUPS 1.4/macOS 10.6cupsMinSize

*cupsMinSize .Qualifier2.Qualifier3: "width length"
@@ -933,6 +946,7 @@ are used to identify options to use for matching.

*cupsMinSize ..Photo: "300 300" +

CUPS 1.4/macOS 10.6cupsMaxSize

*cupsMaxSize .Qualifier2.Qualifier3: "width length"
@@ -1070,6 +1084,7 @@ will be ignored.

Also see the related APDuplexRequiresFlippedMargin keyword.

+

CUPS 1.4/macOS 10.6cupsCommands

*cupsCommands: "name name2 ... nameN"

@@ -1101,6 +1116,7 @@ printing is selected. The default value is false.

*cupsEvenDuplex: true +

cupsFax

*cupsFax: boolean

@@ -1113,6 +1129,7 @@ printing is selected. The default value is false.

*cupsFax: true +

cupsFilter

*cupsFilter: "source/type cost program"

@@ -1135,6 +1152,7 @@ the special filter program "-" may be specified.

*cupsFilter: "application/vnd.cups-postscript 0 -" +

CUPS 1.5cupsFilter2

*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 -" + +

CUPS 2.3cupsFinishingTemplate

+ +

*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: ""
+
+ +

DeprecatedcupsFlipDuplex

*cupsFlipDuplex: boolean

@@ -1195,6 +1233,7 @@ Ghostscript can use:

*cupsFlipDuplex: true +

CUPS 1.3/macOS 10.5cupsIPPFinishings

*cupsIPPFinishings number/text: "*Option Choice ..."

@@ -1211,6 +1250,7 @@ values to PPD options and choices.

*cupsIPPFinishings 21/staple-bottom-left: "*StapleLocation SingleLandscape" +

CUPS 1.3/macOS 10.5cupsIPPReason

*cupsIPPReason reason/Reason Text: "optional URIs"

@@ -1251,6 +1291,7 @@ http://www.vendor.com/help" *End +

CUPS 1.5cupsIPPSupplies

*cupsIPPSupplies: boolean

@@ -1352,6 +1393,7 @@ hardware. The default value is false.

*cupsManualCopies: true +

CUPS 1.4/macOS 10.6cupsMarkerName

*cupsMarkerName/Name Text: ""

@@ -1366,6 +1408,7 @@ generated by the driver to human readable text.

*cupsMarkerName cyanToner/Cyan Toner: "" +

CUPS 1.4/macOS 10.6cupsMarkerNotice

*cupsMarkerNotice: "disclaimer text"

@@ -1380,6 +1423,7 @@ are approximate".

*cupsMarkerNotice: "Supply levels are approximate." +

CUPS 1.6/macOS 10.8cupsMaxCopies

*cupsMaxCopies: integer

@@ -1393,6 +1437,7 @@ are approximate".

*cupsMaxCopies: 99 +

cupsModelNumber

*cupsModelNumber: number

@@ -1424,6 +1469,7 @@ assumed.

*cupsPJLCharset: "UTF-8" +

CUPS 1.4/macOS 10.6cupsPJLDisplay

*cupsPJLDisplay: "what"

@@ -1443,6 +1489,7 @@ to use "@PJL RDYMSG DISPLAY". The default is "job".

*cupsPJLDisplay: "none" +

CUPS 1.2/macOS 10.5cupsPortMonitor

*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" +

CUPS 1.3/macOS 10.5cupsPreFilter

*cupsPreFilter: "source/type cost program"

@@ -1518,6 +1566,7 @@ before the filter that accepts the given MIME type.

*CloseUI: *cupsPrintQuality +

CUPS 1.5cupsSingleFile

*cupsSingleFile: Boolean

@@ -1534,6 +1583,7 @@ before the filter that accepts the given MIME type.

*cupsSingleFile: True +

CUPS 1.4/macOS 10.6cupsSNMPSupplies

*cupsSNMPSupplies: boolean

@@ -1549,6 +1599,7 @@ the standard SNMP Printer MIB OIDs for supply levels. The default value is *cupsSNMPSupplies: False +

cupsVersion

*cupsVersion: major.minor

@@ -1607,6 +1658,7 @@ in order to be usable with all applications.

*APDialogExtension: "/Library/Printers/vendor/options.plugin" +

macOS 10.4APDuplexRequiresFlippedMargin

*APDuplexRequiresFlippedMargin: boolean

@@ -1689,6 +1741,7 @@ and the Tumble page attribute.

Also see the related cupsBackSide keyword.

+

APHelpBook

*APHelpBook: "bundle URL"

@@ -1704,6 +1757,7 @@ looking up IPP reason codes for this printer driver. The *APHelpBook: "file:///Library/Printers/vendor/Help.bundle" +

macOS 10.6APICADriver

*APICADriver: boolean

@@ -1718,6 +1772,7 @@ Architecture (ICA) driver for scanning. The default is False.

*APScanAppBundleID: "com.apple.ImageCaptureApp" +

macOS 10.3APPrinterIconPath

*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" +

macOS 10.4APPrinterLowInkTool

*APPrinterLowInkTool: "/Library/Printers/vendor/program"

@@ -1749,6 +1805,7 @@ Technical Note TN2144 for more information.

*APPrinterLowInkTool: "/Library/Printers/vendor/Tools/lowinktool" +

macOS 10.5APPrinterPreset

*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: "" +

macOS 10.3APPrinterUtilityPath

*APPrinterPrinterUtilityPath: "/Library/Printers/vendor/filename.app"

@@ -1834,6 +1892,7 @@ information.

*APPrinterPrinterUtilityPath: "/Library/Printers/vendor/Tools/utility.app" +

macOS 10.6APScannerOnly

*APScannerOnly: boolean

@@ -1848,6 +1907,7 @@ capabilities. The default is False.

*APScannerOnly: True +

macOS 10.3APScanAppBundleID

*APScanAppBundleID: "bundle ID"

@@ -1865,6 +1925,15 @@ the device.

Change History

+

Changes in CUPS 2.3

+ + + +

Changes in CUPS 1.7

+

Changes in CUPS 1.2.8

+

Changes in CUPS 1.2

+

Changes in CUPS 1.1