diff options
author | Michael Sweet <michael.r.sweet@gmail.com> | 2017-11-28 12:59:45 -0500 |
---|---|---|
committer | Michael Sweet <michael.r.sweet@gmail.com> | 2017-11-28 12:59:45 -0500 |
commit | 4f63d6cdafa4052f52fa15e8fc97650c558d45b4 (patch) | |
tree | 15c75a74a4f770d695dbb20098d36c6933f21f1d /filter | |
parent | 27ee2c4dd70f4fc47d075b31ce37d1b1cacaa40e (diff) | |
download | cups-4f63d6cdafa4052f52fa15e8fc97650c558d45b4.tar.gz |
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.
Diffstat (limited to 'filter')
-rw-r--r-- | filter/spec-ppd.shtml | 72 |
1 files changed, 72 insertions, 0 deletions
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 <p>CUPS supports several methods of auto-configuration via PPD keywords.</p> + <h3><span class='info'>macOS 10.5</span><a name='APAutoSetupTool'>APAutoSetupTool</a></h3> <p class='summary'>*APAutoSetupTool: "/LibraryPrinters/vendor/filename"</p> @@ -45,6 +46,7 @@ LINE-END = CR / LF / CR LF *APAutoSetupTool: "/Library/Printers/vendor/Tools/autosetuptool" </pre> + <h3><span class='info'>macOS 10.2/CUPS 1.4</span><a name='QUERYKEYWORD'>?MainKeyword</a></h3> <p class='summary'>*?<i>MainKeyword</i>: "<br> @@ -74,6 +76,7 @@ LINE-END = CR / LF / CR LF *CloseUI: OptionDuplex </pre> + <h3><span class='info'>macOS 10.4/CUPS 1.5</span><a name='OID'>OIDMainKeyword</a></h3> <p class='summary'>*?OID<i>MainKeyword</i>: ".n.n.n..."<br> @@ -105,6 +108,7 @@ LINE-END = CR / LF / CR LF </blockquote> + <h3><span class='info'>Deprecated</span><a name='cupsColorProfile'>cupsColorProfile</a></h3> <p class='summary'>*cupsColorProfile Resolution/MediaType: "density gamma m00 m01 m02 m10 m11 m12 m20 m21 m22"</p> @@ -181,6 +185,7 @@ f(x) = density * x <sup style='font-size: 100%'>gamma</sup> *cupsICCQualifier3: Resolution </pre> + <h3><span class='info'>macOS 10.4</span><a name='APCustom'>Custom Color Matching Support</a></h3> <p class='summary'>*<a href='#APSupportsCustomColorMatching'>APSupportsCustomColorMatching</a>: true<br> @@ -282,6 +287,7 @@ f(x) = density * x <sup style='font-size: 100%'>gamma</sup> </blockquote> + <h3><span class='info'>CUPS 1.4/macOS 10.6</span><a name='cupsUIConstraints'>cupsUIConstraints</a></h3> <p class='summary'>*cupsUIConstraints resolver: "*Keyword1 *Keyword2 ..."<br> @@ -312,6 +318,7 @@ f(x) = density * x <sup style='font-size: 100%'>gamma</sup> *cupsUIConstraints photo: "*OutputMode Photo *MediaType Transparency *Resolution 1200dpi" </pre> + <h3><span class='info'>CUPS 1.4/macOS 10.6</span><a name='cupsUIResolver'>cupsUIResolver</a></h3> <p class='summary'>*cupsUIResolver resolver: "*Keyword1 OptionKeyword1 *Keyword2 OptionKeyword2 ..."</p> @@ -529,6 +536,7 @@ option value is "1234" then CUPS will output the string "@PJL SET PASSCODE=1234" <p>The resulting dictionary sets the page device attributes that are sent to your raster driver in the page header.</p> + <h3>Custom Page Size Code</h3> <p>There are many possible implementations of the <tt>CustomPageSize</tt> code. For CUPS raster drivers, the following code is recommended:</p> @@ -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" </pre> + <h3>Supported PostScript Operators</h3> <p>CUPS supports the following PostScript operators in addition to the usual PostScript number, string (literal and hex-encoded), boolean, null, and name values:</p> @@ -601,6 +610,7 @@ PRE B { </blockquote> + <h3>Supported Page Device Attributes</h3> <p>Table 2 shows the supported page device attributes along with PostScript code examples.</p> @@ -872,6 +882,7 @@ PRE B { <p>The CUPS media keywords allow drivers to specify alternate custom page size limits based on up to two options.</p> + <h3><span class='info'>CUPS 1.4/macOS 10.6</span><a name='cupsMediaQualifier2'>cupsMediaQualifier2</a></h3> <p class='summary'>*cupsMediaQualifier2: MainKeyword</p> @@ -891,6 +902,7 @@ custom page size limits.</p> *cupsMinSize ..Photo: "300 300" </pre> + <h3><span class='info'>CUPS 1.4/macOS 10.6</span><a name='cupsMediaQualifier3'>cupsMediaQualifier3</a></h3> <p class='summary'>*cupsMediaQualifier3: MainKeyword</p> @@ -910,6 +922,7 @@ custom page size limits.</p> *cupsMinSize ..Photo: "300 300" </pre> + <h3><span class='info'>CUPS 1.4/macOS 10.6</span><a name='cupsMinSize'>cupsMinSize</a></h3> <p class='summary'>*cupsMinSize .Qualifier2.Qualifier3: "width length"<br> @@ -933,6 +946,7 @@ are used to identify options to use for matching.</p> *cupsMinSize ..Photo: "300 300" </pre> + <h3><span class='info'>CUPS 1.4/macOS 10.6</span><a name='cupsMaxSize'>cupsMaxSize</a></h3> <p class='summary'>*cupsMaxSize .Qualifier2.Qualifier3: "width length"<br> @@ -1070,6 +1084,7 @@ will be ignored.</p> <p>Also see the related <a href='#APDuplexRequiresFlippedMargin'><tt>APDuplexRequiresFlippedMargin</tt></a> keyword.</p> + <h3><span class='info'>CUPS 1.4/macOS 10.6</span><a name='cupsCommands'>cupsCommands</a></h3> <p class='summary'>*cupsCommands: "name name2 ... nameN"</p> @@ -1101,6 +1116,7 @@ printing is selected. The default value is <code>false</code>.</p> *cupsEvenDuplex: true </pre> + <h3><a name='cupsFax'>cupsFax</a></h3> <p class='summary'>*cupsFax: boolean</p> @@ -1113,6 +1129,7 @@ printing is selected. The default value is <code>false</code>.</p> *cupsFax: true </pre> + <h3><a name='cupsFilter'>cupsFilter</a></h3> <p class='summary'>*cupsFilter: "source/type cost program"</p> @@ -1135,6 +1152,7 @@ the special filter program "-" may be specified.</p> *cupsFilter: "application/vnd.cups-postscript 0 -" </pre> + <h3><span class='info'>CUPS 1.5</span><a name='cupsFilter2'>cupsFilter2</a></h3> <p class='summary'>*cupsFilter2: "source/type destination/type cost program"</p> @@ -1160,6 +1178,26 @@ the special filter program "-" may be specified.</p> *cupsFilter2: "application/vnd.cups-postscript application/postscript 0 -" </pre> + +<h3><span class='info'>CUPS 2.3</span><a name='cupsFinishingTemplate'>cupsFinishingTemplate</a></h3> + +<p class='summary'>*cupsFinishingTemplate name/text: ""</p> + +<p>This option keyword specifies a finishing template (preset) that applies zero or more finishing processes to a job. Unlike <a href="#cupsIPPFinishings"><tt>cupsIPPFinishings</tt></a>, only one template can be selected by the user. PPD files also generally apply a constraint between this option and other finishing options like <tt>Booklet</tt>, <tt>FoldType</tt>, <tt>PunchMedia</tt>, and <tt>StapleWhen</tt>.</p> + +<p>Examples:</p> + +<pre class='command'> +*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: "" +</pre> + + <h3><span class='info'>Deprecated</span><a name='cupsFlipDuplex'>cupsFlipDuplex</a></h3> <p class='summary'>*cupsFlipDuplex: boolean</p> @@ -1195,6 +1233,7 @@ Ghostscript can use:</p> *cupsFlipDuplex: true </pre></blockquote> + <h3><span class='info'>CUPS 1.3/macOS 10.5</span><a name='cupsIPPFinishings'>cupsIPPFinishings</a></h3> <p class='summary'>*cupsIPPFinishings number/text: "*Option Choice ..."</p> @@ -1211,6 +1250,7 @@ values to PPD options and choices.</p> *cupsIPPFinishings 21/staple-bottom-left: "*StapleLocation SingleLandscape" </pre> + <h3><span class='info'>CUPS 1.3/macOS 10.5</span><a name='cupsIPPReason'>cupsIPPReason</a></h3> <p class='summary'>*cupsIPPReason reason/Reason Text: "optional URIs"</p> @@ -1251,6 +1291,7 @@ http://www.vendor.com/help" *End </pre> + <h3><span class='info'>CUPS 1.5</span><a name='cupsIPPSupplies'>cupsIPPSupplies</a></h3> <p class='summary'>*cupsIPPSupplies: boolean</p> @@ -1352,6 +1393,7 @@ hardware. The default value is <code>false</code>.</p> *cupsManualCopies: true </pre> + <h3><span class='info'>CUPS 1.4/macOS 10.6</span><a name='cupsMarkerName'>cupsMarkerName</a></h3> <p class='summary'>*cupsMarkerName/Name Text: ""</p> @@ -1366,6 +1408,7 @@ generated by the driver to human readable text.</p> *cupsMarkerName cyanToner/Cyan Toner: "" </pre> + <h3><span class='info'>CUPS 1.4/macOS 10.6</span><a name='cupsMarkerNotice'>cupsMarkerNotice</a></h3> <p class='summary'>*cupsMarkerNotice: "disclaimer text"</p> @@ -1380,6 +1423,7 @@ are approximate".</p> *cupsMarkerNotice: "Supply levels are approximate." </pre> + <h3><span class='info'>CUPS 1.6/macOS 10.8</span><a name='cupsMaxCopies'>cupsMaxCopies</a></h3> <p class='summary'>*cupsMaxCopies: integer</p> @@ -1393,6 +1437,7 @@ are approximate".</p> *cupsMaxCopies: 99 </pre> + <h3><a name='cupsModelNumber'>cupsModelNumber</a></h3> <p class='summary'>*cupsModelNumber: number</p> @@ -1424,6 +1469,7 @@ assumed.</p> *cupsPJLCharset: "UTF-8" </pre> + <h3><span class='info'>CUPS 1.4/macOS 10.6</span><a name='cupsPJLDisplay'>cupsPJLDisplay</a></h3> <p class='summary'>*cupsPJLDisplay: "what"</p> @@ -1443,6 +1489,7 @@ to use "@PJL RDYMSG DISPLAY". The default is "job".</p> *cupsPJLDisplay: "none" </pre> + <h3><span class='info'>CUPS 1.2/macOS 10.5</span><a name='cupsPortMonitor'>cupsPortMonitor</a></h3> <p class='summary'>*cupsPortMonitor urischeme/Descriptive Text: "port monitor"</p> @@ -1475,6 +1522,7 @@ to disable the port monitor for the given URI scheme.</p> *cupsPortMonitor usb/USB Status Monitor: "epson-usb" </pre> + <h3><span class='info'>CUPS 1.3/macOS 10.5</span><a name='cupsPreFilter'>cupsPreFilter</a></h3> <p class='summary'>*cupsPreFilter: "source/type cost program"</p> @@ -1518,6 +1566,7 @@ before the filter that accepts the given MIME type.</p> *CloseUI: *cupsPrintQuality </pre> + <h3><span class='info'>CUPS 1.5</span><a name='cupsSingleFile'>cupsSingleFile</a></h3> <p class='summary'>*cupsSingleFile: Boolean</p> @@ -1534,6 +1583,7 @@ before the filter that accepts the given MIME type.</p> *cupsSingleFile: True </pre> + <h3><span class='info'>CUPS 1.4/macOS 10.6</span><a name='cupsSNMPSupplies'>cupsSNMPSupplies</a></h3> <p class='summary'>*cupsSNMPSupplies: boolean</p> @@ -1549,6 +1599,7 @@ the standard SNMP Printer MIB OIDs for supply levels. The default value is *cupsSNMPSupplies: False </pre> + <h3><a name='cupsVersion'>cupsVersion</a></h3> <p class='summary'>*cupsVersion: major.minor</p> @@ -1607,6 +1658,7 @@ in order to be usable with all applications.</p> *APDialogExtension: "/Library/Printers/vendor/options.plugin" </pre> + <h3><span class='info'>macOS 10.4</span><a name='APDuplexRequiresFlippedMargin'>APDuplexRequiresFlippedMargin</a></h3> <p class='summary'>*APDuplexRequiresFlippedMargin: boolean</p> @@ -1689,6 +1741,7 @@ and the <tt>Tumble</tt> page attribute.</p> <p>Also see the related <a href='#cupsBackSide'><tt>cupsBackSide</tt></a> keyword.</p> + <h3><a name='APHelpBook'>APHelpBook</a></h3> <p class='summary'>*APHelpBook: "bundle URL"</p> @@ -1704,6 +1757,7 @@ looking up IPP reason codes for this printer driver. The *APHelpBook: "file:///Library/Printers/vendor/Help.bundle" </pre> + <h3><span class='info'>macOS 10.6</span><a name='APICADriver'>APICADriver</a></h3> <p class='summary'>*APICADriver: boolean</p> @@ -1718,6 +1772,7 @@ Architecture (ICA) driver for scanning. The default is <tt>False</tt>.</p> *APScanAppBundleID: "com.apple.ImageCaptureApp" </pre> + <h3><span class='info'>macOS 10.3</span><a name='APPrinterIconPath'>APPrinterIconPath</a></h3> <p class='summary'>*APPrinterIconPath: "/Library/Printers/vendor/filename.icns"</p> @@ -1732,6 +1787,7 @@ displaying the printer. The file must be in the Apple icon format.</p> *APPrinterIconPath: "/Library/Printers/vendor/Icons/filename.icns" </pre> + <h3><span class='info'>macOS 10.4</span><a name='APPrinterLowInkTool'>APPrinterLowInkTool</a></h3> <p class='summary'>*APPrinterLowInkTool: "/Library/Printers/vendor/program"</p> @@ -1749,6 +1805,7 @@ Technical Note TN2144</a> for more information.</p> *APPrinterLowInkTool: "/Library/Printers/vendor/Tools/lowinktool" </pre> + <h3><span class='info'>macOS 10.5</span><a name='APPrinterPreset'>APPrinterPreset</a></h3> <p class='summary'>*APPrinterPreset name/text: "*Option Choice ..."</p> @@ -1819,6 +1876,7 @@ choice (*MainKeyword OptionKeyword) or a preset identifier and value *fr.APPrinterPreset Photo_on_Photo_Paper/Photo sur papier photographique: "" </pre> + <h3><span class='info'>macOS 10.3</span><a name='APPrinterUtilityPath'>APPrinterUtilityPath</a></h3> <p class='summary'>*APPrinterPrinterUtilityPath: "/Library/Printers/vendor/filename.app"</p> @@ -1834,6 +1892,7 @@ information.</p> *APPrinterPrinterUtilityPath: "/Library/Printers/vendor/Tools/utility.app" </pre> + <h3><span class='info'>macOS 10.6</span><a name='APScannerOnly'>APScannerOnly</a></h3> <p class='summary'>*APScannerOnly: boolean</p> @@ -1848,6 +1907,7 @@ capabilities. The default is <tt>False</tt>.</p> *APScannerOnly: True </pre> + <h3><span class='info'>macOS 10.3</span><a name='APScanAppBundleID'>APScanAppBundleID</a></h3> <p class='summary'>*APScanAppBundleID: "bundle ID"</p> @@ -1865,6 +1925,15 @@ the device.</p> <h2 class='title'><a name='HISTORY'>Change History</a></h2> +<h3>Changes in CUPS 2.3</h3> + +<ul> + + <li>Added <a href="#cupsFinishingTemplate"><tt>cupsFinishingTemplate</tt></a> option.</li> + +</ul> + + <h3>Changes in CUPS 1.7</h3> <ul> @@ -1981,6 +2050,7 @@ the device.</p> </ul> + <h3>Changes in CUPS 1.2.8</h3> <ul> @@ -1990,6 +2060,7 @@ the device.</p> </ul> + <h3>Changes in CUPS 1.2</h3> <ul> @@ -2015,6 +2086,7 @@ the device.</p> </ul> + <h3>Changes in CUPS 1.1</h3> <ul> |