Lines Matching +full:- +full:- +full:must +full:- +full:staple
3 <!-- SECTION: Specifications -->
7 <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
12 <style type="text/css"><!--
14 font-family: lucida grande, geneva, helvetica, arial, sans-serif;
18 font-family: lucida grande, geneva, helvetica, arial, sans-serif;
21 H1 { font-size: 2em; }
22 H2 { font-size: 1.75em; }
23 H3 { font-size: 1.5em; }
24 H4 { font-size: 1.25em; }
27 font-family: monaco, courier, monospace;
28 font-weight: bold;
32 font-family: monaco, courier, monospace;
36 border-left: solid 2px #777;
42 margin-left: -1em;
56 font-style: italic;
57 margin-left: 36pt;
61 margin-left: 5em;
65 margin-left: 0;
73 font-family: lucida grande, geneva, helvetica, arial, sans-serif;
77 font-family: monaco, courier, monospace;
78 margin-left: 36pt;
82 font-style: italic;
83 margin-left: 36pt;
92 border-radius: 10px;
93 -moz-border-radius: 10px;
97 font-weight: inherit;
98 text-decoration: none;
102 text-decoration: underline;
106 font-size: 50%;
110 margin-top: 10pt;
112 border-bottom: solid 1pt #999999;
116 border-bottom: solid 1pt #999999;
117 padding-top: 10pt;
118 padding-left: 5pt;
119 text-align: left;
124 border-collapse: collapse;
125 border-spacing: 0;
126 margin-left: auto;
127 margin-right: auto;
131 caption-side: top;
132 font-size: 120%;
133 font-style: italic;
134 font-weight: bold;
135 margin-left: auto;
136 margin-right: auto;
147 border-bottom: solid thin #999999;
151 margin-left: auto;
152 margin-right: auto;
156 caption-side: bottom;
157 font-size: 120%;
158 font-style: italic;
159 font-weight: bold;
160 margin-left: auto;
161 margin-right: auto;
165 text-align: right;
166 vertical-align: top;
170 text-align: right;
171 font-weight: normal;
182 font-size: 80%;
183 font-style: italic;
184 font-weight: bold;
185 white-space: nowrap;
190 font-size: 100%;
197 border-bottom: solid 2pt #000000;
201 margin-top: 2em;
202 margin-left: auto;
203 margin-right: auto;
208 border-collapse: collapse;
216 border-collapse: collapse;
217 margin-left: auto;
218 margin-right: auto;
224 border-bottom: solid thin #cccccc;
226 padding-top: 10pt;
227 padding-left: 5pt;
228 text-align: left;
229 vertical-align: bottom;
230 white-space: nowrap;
238 border-bottom: solid thin #eeeeee;
239 padding-top: 5pt;
240 padding-left: 5pt;
243 TABLE.list TR:nth-child(even) {
247 TABLE.list TR:nth-child(odd) {
252 margin-left: 36pt;
253 margin-top: 12pt;
257 margin-left: 54pt;
261 font-weight: bold;
265 margin-left: 36pt;
266 font-family: monaco, courier, monospace;
271 border-collapse: collapse;
272 border-spacing: 0;
279 text-align: left;
280 vertical-align: top;
289 font-size: 250%;
290 font-weight: bold;
294 font-size: 250%;
295 margin-top: 1.5em;
298 font-size: 150%;
299 margin-bottom: 0.5em;
300 margin-top: 1.5em;
303 font-size: 110%;
304 margin-bottom: 0.5em;
305 margin-top: 1.5em;
308 font-size: 100%;
309 margin-bottom: 0.5em;
310 margin-top: 1.5em;
318 font-size: 110%;
321 font-size: 100%;
324 font-size: 80%;
327 border-bottom: solid 2px gray;
332 margin-top: 0.5em;
337 border-bottom: solid 2px gray;
340 border-bottom: solid 2px gray;
341 margin-bottom: 0;
352 border-bottom: solid 2px gray;
355 border-bottom: solid 2px gray;
358 border-bottom: solid 2px gray;
363 page-break-inside: avoid;
367 box-shadow: 3px 3px 5px rgba(0,0,0,0.5);
369 page-break-inside: avoid;
374 font-family: monospace;
376 -webkit-hyphens: manual;
377 page-break-inside: avoid;
386 text-decoration: none;
392 font-size: 80%;
393 font-style: italic;
394 font-weight: bold;
395 white-space: nowrap;
398 border-radius: 10px;
400 font-size: 80%;
404 border-bottom-left-radius: 0px;
405 border-bottom-right-radius: 0px;
411 list-style-type: none;
413 padding-left: 0;
419 margin-top: 1em;
422 padding-left: 2em;
425 border-collapse: collapse;
428 table.list tr:nth-child(even) {
431 border-right: 2px solid gray;
432 font-family: monospace;
434 text-align: right;
435 vertical-align: top;
439 text-align: left;
440 vertical-align: top;
445 border-bottom: solid 2px black;
448 border-bottom: solid 2px black;
450 --></style>
453 <!--
456 Copyright © 2007-2011 by Apple Inc.
457 Copyright © 1997-2007 by Easy Software Products.
461 -->
465 …ibe the capabilities of each printer and are used by CUPS to support printer-specific features and…
471 <td>Programming: <a href='postscript-driver.html'>Developing PostScript Printer Drivers</a><br>
472 Programming: <a href='raster-driver.html'>Developing Raster Printer Drivers</a><br>
473 Programming: <a href='api-filter.html'>Filter and Backend Programming</a><br>
474 Programming: <a href='ppd-compiler.html'>Introduction to the PPD Compiler</a><br>
475 Programming: <a href='api-raster.html'>Raster API</a><br>
476 References: <a href='ref-ppdcfile.html'>PPD Compiler Driver Information File Reference</a></td>
484 <li><a href="#AUTOCONFIG">Auto-Configuration</a><ul class="subcontents">
558 <p>The PPD format is text-based and uses lines of up to 255 characters terminated by a carriage ret…
561 PPD-FILE = HEADER +(DATA / COMMENT / LINE-END)
563 HEADER = "*PPD-Adobe:" *WSP DQUOTE VERSION DQUOTE LINE-END
567 COMMENT = "*%" *TCHAR LINE-END
570 1*(*WSP VALUE) LINE-END
574 KCHAR = ALPHA / DIGIT / "_" / "." / "-"
576 SCHAR = LINE-END / WSP / %x21.23-7E.A0-FF
578 TCHAR = %x20-7E.A0-FF
580 LINE-END = CR / LF / CR LF
584 <h2 class='title'><a name='AUTOCONFIG'>Auto-Configuration</a></h2>
586 <p>CUPS supports several methods of auto-configuration via PPD keywords.</p>
595 …ter's device URI and the PPD file to be used for the printer. The program must write an updated PP…
642 …words define a mapping from OID value to option keyword. Since SNMP is an IP-based network protoco…
658 … based on ICC profiles and is used by the Quartz-based filters on macOS. The final type is based o…
671 <p>This string keyword specifies an sRGB-based color profile consisting of gamma and density contro…
673 …<i>Resolution</i> and <i>MediaType</i> values may be "-" to act as a wildcard. Otherwise they must…
679 f(x) = density * x <sup style='font-size: 100%'>gamma</sup>
694 *cupsColorProfile 360dpi/-: "1.0 1.5 1.0 0.0 -0.2 -0.4 1.0 0.0 -0.2 0.0 1.0"
697 *cupsColorProfile 720dpi/Glossy: "1.0 2.5 1.0 0.0 -0.2 -0.4 1.0 0.0 -0.2 0.0 1.0"
700 *cupsColorProfile -/-: "0.9 2.0 1.0 0.0 -0.2 -0.4 1.0 0.0 -0.2 0.0 1.0"
710 <p>The <tt>Description</tt> specifies human-readable text that is associated with the color profile…
716 *cupsICCProfile CMYK..360dpi/360dpi CMYK: "/Library/Printers/vendor/Profiles/foo-360-cmyk.icc"
719 …Profile RGB.Glossy.720dpi/720dpi Glossy: "/Library/Printers/vendor/Profiles/foo-720-glossy-rgb.icc"
722 *cupsICCProfile ../Default: "/Library/Printers/vendor/Profiles/foo-default.icc"
751 …-, 3-, and 4-component raster data as requested by the driver. The <tt>APCustomColorMatchingProfil…
813 …-off colorspace will be GenericGray, GenericRGB, or GenericCMYK depending on the number of compone…
827 …choices that are not allowed by the driver or device, for example printing 2-sided transparencies.…
830 *% Do not allow 2-sided printing on transparency media
841 …files that contain constraints, it is very important to use the <a href="man-cupstestppd.html">cup…
859 <em>*% Specify that 2-sided printing cannot happen on transparencies</em>
881 …- only the first N selections will be used, where N is the minimum number of selections required. …
886 <em>*% Specify the options to change for the 2-sided transparency constraint</em>
905 <li>The <tt>LanguageVersion</tt> MUST be <tt>English</tt></li>
907 <li>The <tt>LanguageEncoding</tt> MUST be <tt>ISOLatin1</tt></li>
909 …<li>The <tt>cupsLanguages</tt> keyword MUST be provided and list each of the supported locales in …
911 …<li>Main and option keywords MUST NOT exceed 34 (instead of 40) characters to allow room for the l…
913 <li>The main keyword "Translation" MUST NOT be used</li>
915 … keywords MUST NOT contain characters outside the ASCII subset of ISOLatin1 and UTF-8; developers …
917 …refix of the form "ll" or "ll_CC." where "ll" is the 2-letter ISO language code and "CC" is the 2-…
918 …<li>A generic language translation ("ll") SHOULD be provided with country-specific differences ("l…
922 <li>Locale-specific translation strings MUST be encoded using UTF-8.</li>
924 <li>Main keywords MUST be localized using one of the following forms:
928 <li>Option keywords MUST be localized using one of the following forms:
954 *cupsIPPReason com.vendor-error/A serious error occurred: "/help/com.vendor/error.html"
955 <em>*% Localize printer-state-reason for French and German</em>
956 *fr_CA.cupsIPPReason com.vendor-error/Une erreur sèrieuse s'est produite: "/help/com.vendor/…
957 *de.cupsIPPReason com.vendor-error/Eine ernste Störung trat: "/help/com.vendor/error.html"
991 … numbered parameter. The CUPS API handles any necessary value quoting for HP-PJL commands. For exa…
994 <p>For non-<tt>JCLSetup</tt> options, the "order" value is a number from 1 to N and specifies the o…
1000 …<li><tt>curve</tt> - a real value from "minimum" to "maximum" representing a gamma correction curv…
1002 <li><tt>int</tt> - an integer value from "minimum" to "maximum"</li>
1004 …<li><tt>invcurve</tt> - a real value from "minimum" to "maximum" representing a gamma correction c…
1006 …<li><tt>passcode</tt> - a string of numbers value with a minimum of "minimum" numbers and a maximu…
1008 …<li><tt>password</tt> - a string value with a minimum of "minimum" characters and a maximum of "ma…
1010 <li><tt>points</tt> - a measurement value in points from "minimum" to "maximum"</li>
1012 <li><tt>real</tt> - a real value from "minimum" to "maximum"</li>
1014 …<li><tt>string</tt> - a string value with a minimum of "minimum" characters and a maximum of "maxi…
1045 *CustomWatermarkText True: "<</cupsString1 3 -1 roll>>setpagedevice"
1059 *CustomGammaDensity True: "<</cupsReal1 3 -1 roll/cupsReal2 5 -1>>setpagedevice"
1067 <p>PPD files are used for both PostScript and non-PostScript printers. For CUPS raster drivers, you…
1076 *CustomWatermarkText True: "<</cupsString1 3 -1 roll>>setpagedevice"
1083 <</cupsString1 3 -1 roll>>setpagedevice
1100 *ParamCustomPageSize Width: 1 points <i>min-width max-width</i>
1101 *ParamCustomPageSize Height: 2 points <i>min-height max-height</i>
1105 *CustomPageSize True: "pop pop pop <</PageSize[5 -2 roll]/ImagingBBox null>>setpagedevi…
1111 …perators in addition to the usual PostScript number, string (literal and hex-encoded), boolean, nu…
1115 <li><tt><<</tt> - Start a dictionary.</li>
1117 <li><tt>>></tt> - End a dictionary.</li>
1119 <li><tt>[</tt> - Start an array.</li>
1121 <li><tt>]</tt> - End an array.</li>
1123 <li><tt>copy</tt> - Copy the top N objects on the stack.</li>
1125 <li><tt>dup</tt> - Copy the top object on the stack.</li>
1127 <li><tt>index</tt> - Copy the Nth from the top object on the stack.</li>
1129 <li><tt>pop</tt> - Pop the top object on the stack.</li>
1131 <li><tt>roll</tt> - Shift the top N objects on the stack.</li>
1133 …<li><tt>setpagedevice</tt> - Set the page header values according to the key/value dictionary on t…
1148 <style type='text/css'><!--
1154 --></style>
1212 <td>Specifies whether 2-sided printing is required.</td>
1296 …tation of the output: 0 = portrait, 1 = landscape rotated counter-clockwise, 2 = upside-down, 3 = …
1302 <td>Specifies whether to place the media face-up in the output bin/tray.</td>
1538 <em>*% Specify grouping of borderless/non-borderless sizes</em>
1551 when doing duplexed (2-sided) output. <a href='#TABLE_1'>Table 1</a>
1556 each line going right-to-left instead of left-to-right. The default value is
1562 keyword - if <tt>cupsBackSide</tt> is specified, <tt>cupsFlipDuplex</tt>
1581 <td>Left-to-right, top-to-bottom</td>
1586 <td>Left-to-right, top-to-bottom</td>
1591 <td>Left-to-right, top-to-bottom</td>
1596 <td>Right-to-left, bottom-to-top</td>
1601 <td>Right-to-left, bottom-to-top</td>
1606 <td>Right-to-left, top-to-bottom</td>
1611 <td>Left-to-right, bottom-to-top</td>
1616 <td>Right-to-left, top-to-bottom</td>
1622 <p><em>* - Not supported in macOS 10.5.x and earlier</em></p>
1664 destination printer requires an even number of pages when 2-sided
1695 the special filter program "-" may be specified.</p>
1701 *cupsFilter: "application/vnd.cups-raster 100 rastertofoo"
1706 <em>*% Pass-through filter for PostScript printers</em>
1707 *cupsFilter: "application/vnd.cups-postscript 0 -"
1715 …If a printer supports the source type directly, the special filter program "-" may be specified. T…
1727 *cupsFilter2: "application/vnd.cups-raster application/vnd.foo 100 rastertofoo"
1732 <em>*% Pass-through filter for PostScript printers</em>
1733 *cupsFilter2: "application/vnd.cups-postscript application/postscript 0 -"
1748 *cupsFinishingTemplate punch/2/3-Hole Punch: ""
1749 *cupsFinishingTemplate staple/Corner Staple: ""
1750 *cupsFinishingTemplate staple-dual/Double Staple: ""
1751 *cupsFinishingTemplate staple-and-fold/Corner Staple and Letter Fold: ""
1752 *cupsFinishingTemplate staple-and-punch/Corner Staple and 2/3-Hole Punch: ""
1802 *cupsIPPFinishings 4/staple: "*StapleLocation SinglePortrait"
1804 *cupsIPPFinishings 20/staple-top-left: "*StapleLocation SinglePortrait"
1805 *cupsIPPFinishings 21/staple-bottom-left: "*StapleLocation SingleLandscape"
1814 <code>printer-state-reasons</code> keywords that are generated by
1823 …racters by the PPD specification, longer text strings can be included by URI-encoding the text wit…
1828 <em>*% Map com.vendor-error to text but no page</em>
1829 *cupsIPPReason com.vendor-error/A serious error occurred: ""
1831 <em>*% Map com.vendor-error to more than 80 characters of text but no page</em>
1832 *cupsIPPReason com.vendor-error/A serious error occurred: "text:Now%20is%20the%20time
1835 <em>*% Map com.vendor-error to text and a local page</em>
1836 *cupsIPPReason com.vendor-error/A serious error occurred: "/help/com.vendor/error.html"
1838 <em>*% Map com.vendor-error to text and a remote page</em>
1839 *cupsIPPReason com.vendor-error/A serious error occurred: "http://www.vendor.com/help"
1841 <em>*% Map com.vendor-error to text and a local, Apple help book, and remote page</em>
1843 *cupsIPPReason com.vendor-error/A serious error occurred: "/help/com.vendor/error.html
1844 help:anchor='com.vendor-error'%20bookID=Vendor%20Help
1854 <p>This keyword tells the IPP backend whether it should report the current marker-xxx supply attrib…
1859 <em>*% Do not use IPP marker-xxx attributes to report supply levels</em>
1868 <p>This keyword defines whether the printer accepts the job-account-id IPP attribute.</p>
1873 <em>*% Specify the printer accepts the job-account-id IPP attribute.</em>
1882 <p>This keyword defines whether the printer accepts the job-accounting-user-id IPP attribute.</p>
1887 <em>*% Specify the printer accepts the job-accounting-user-id IPP attribute.</em>
1896 <p>This keyword defines the format of the "job-password" IPP attribute, if supported by the printer…
1905 <li><code>*</code>: Any Unicode (utf-8) character.</li>
1909 password string. For example, "1111" indicated a 4-digit US ASCII PIN code.</p>
1914 <em>*% Specify the printer supports 4-digit PIN codes.</em>
1924 included in the PPD. The "locale list" string is a space-delimited
1939 <p>This keyword defines a list of IPP attributes that must be provided when submitting a print job …
1944 <em>*% Specify that the user must supply a job-password</em>
1945 *cupsMandatory: "job-password job-password-encryption"
1969 <p>This optional keyword maps <code>marker-names</code> strings that are
2013 <p>This integer keyword specifies a printer-specific model
2020 <em>*% Specify an integer for a driver-specific model number</em>
2030 for strings in PJL commands. If not specified, US-ASCII is
2036 <em>*% Specify UTF-8 is used in PJL strings</em>
2037 *cupsPJLCharset: "UTF-8"
2065 <p>This string keyword specifies printer-specific "port
2071 <tt>port-monitor-supported</tt> keyword.</p>
2075 pre-select a particular port monitor for each type of connection that
2089 <em>*% Specify a printer-specific port monitor for an Epson USB printer</em>
2090 *cupsPortMonitor usb/USB Status Monitor: "epson-usb"
2098 <p>This string keyword provides a pre-filter rule. The pre-filter
2105 <em>*% PDF pre-filter</em>
2108 <em>*% PNG pre-filter</em>
2117 …he IPP "print-quality" job template keyword. Standard keyword values are "Draft", "Normal", and "H…
2121 …ined in this document, <code>cupsPrintQuality</code> is a UI keyword that MUST be enclosed inside …
2176 PPD file extensions was used. Currently it must be the string
2191 <p>This keyword provides the JCL command to insert a PDF job file into a printer-ready data stream.…
2211 plug-ins.</p>
2217 10.12, system level security features prevent print dialog plug-ins from being
2353 displaying the printer. The file must be in the Apple icon format.</p>
2393 …<li><code>General_with_Paper_Auto-Detect</code>; Normal quality general printing with auto-detecte…
2395 …<li><code>General_with_Paper_Auto-Detect_-_Draft</code>; Draft quality general printing with auto-…
2399 …<li><code>General_on_Plain_Paper_-_Draft</code>; Draft quality general printing on plain paper.</l…
2401 …<li><code>Photo_with_Paper_Auto-Detect</code>; Normal quality photo printing with auto-detected me…
2403 …<li><code>Photo_with_Paper_Auto-Detect_-_Fine</code>; High quality photo printing with auto-detect…
2407 <li><code>Photo_on_Plain_Paper_-_Fine</code>; High quality photo printing on plain paper.</li>
2411 …<li><code>Photo_on_Photo_Paper_-_Fine</code>; High quality photo printing on glossy photo paper.</…
2415 <li><code>Photo_on_Matte_Paper_-_Fine</code>; High quality photo printing on matte paper.</li>
2425 ….graphicsType</code>; specifies the type of printing used for this printing - "General" for genera…
2427 ….preset.media-front-coating</code>; specifies the media type selected by this preset - "none" (pla…
2429 …<li><code>com.apple.print.preset.output-mode</code>; specifies the output mode for this preset - "…
2431 …quality</code>; specifies the overall print quality selected by this preset - "low" (draft), "mid"…
2446 com.apple.print.preset.media-front-coating glossy"
2597 <li>Added section on auto-configuration including the