X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=doc%2Fhelp%2Fspec-ppd.html;h=3782eb7cab083b922a5c9ac887b4b776287c21bd;hb=5da48e461472590caea416fda443c3c8be3373c4;hp=d68b67c3f39cf6a2aa9ea1eec3f64c2e274c209d;hpb=9c0e8e5d83879f36c798e1d84a4a947109bc0204;p=thirdparty%2Fcups.git diff --git a/doc/help/spec-ppd.html b/doc/help/spec-ppd.html index d68b67c3f..3782eb7ca 100644 --- a/doc/help/spec-ppd.html +++ b/doc/help/spec-ppd.html @@ -1,12 +1,15 @@ - + -
-The PPD format is text-based and uses lines of up to 255 characters terminated by a carriage return, linefeed, or combination of carriage return and line feed. The following ABNF definition [RFC5234] defines the general format of lines in a PPD file:
@@ -476,11 +585,12 @@ LINE-END = CR / LF / CR LFCUPS supports several methods of auto-configuration via PPD keywords.
-*APAutoSetupTool: "/LibraryPrinters/vendor/filename"
-This OS X keyword defines a program that sets the default option choices. It is run when a printer is added from the Add Printer window or the Nearby Printers list in the Print dialog.
+This macOS keyword defines a program that sets the default option choices. It is run when a printer is added from the Add Printer window or the Nearby Printers list in the Print dialog.
The program is provided with two arguments: the printer's device URI and the PPD file to be used for the printer. The program must write an updated PPD file to stdout.
@@ -491,7 +601,8 @@ LINE-END = CR / LF / CR LF *APAutoSetupTool: "/Library/Printers/vendor/Tools/autosetuptool" -*?MainKeyword: "
PostScript query code that writes a message using the = operator...
@@ -520,7 +631,8 @@ LINE-END = CR / LF / CR LF
*CloseUI: OptionDuplex
-
*?OIDMainKeyword: ".n.n.n..."
*OIDMainKeyword OptionKeyword1: "value"
@@ -543,7 +655,7 @@ LINE-END = CR / LF / CR LF
CUPS supports three types of color profiles. The first type is based on sRGB and is used by the standard CUPS raster filters and GPL Ghostscript. The second type is based on ICC profiles and is used by the Quartz-based filters on MacOS X. The final type is based on well-known colorspaces such as sRGB and Adobe RGB.
+CUPS supports three types of color profiles. The first type is based on sRGB and is used by the standard CUPS raster filters and GPL Ghostscript. The second type is based on ICC profiles and is used by the Quartz-based filters on macOS. The final type is based on well-known colorspaces such as sRGB and Adobe RGB.
Note: @@ -551,11 +663,12 @@ LINE-END = CR / LF / CR LF-
*cupsColorProfile Resolution/MediaType: "density gamma m00 m01 m02 m10 m11 m12 m20 m21 m22"
-This string keyword specifies an sRGB-based color profile consisting of gamma and density controls and a 3x3 CMY color transform matrix. This keyword is not supported on OS X.
+This string keyword specifies an sRGB-based color profile consisting of gamma and density controls and a 3x3 CMY color transform matrix. This keyword is not supported on macOS.
The Resolution and MediaType values may be "-" to act as a wildcard. Otherwise they must match one of the Resolution or MediaType option keywords defined in the PPD file.
@@ -588,7 +701,7 @@ f(x) = density * x gamma -*cupsICCProfile ColorModel.MediaType.Resolution/Description: "filename"
@@ -609,7 +722,7 @@ f(x) = density * x gamma *cupsICCProfile ../Default: "/Library/Printers/vendor/Profiles/foo-default.icc" -The ColorModel, MediaType, and Resolution main keywords can be reassigned to different main keywords, allowing drivers to do color profile selection based on different parameters. The cupsICCQualifier1, cupsICCQualifier2, and cupsICCQualifier3 keywords define the mapping from selector to main keyword:
@@ -627,22 +740,23 @@ f(x) = density * x gamma *cupsICCQualifier3: Resolution -*APSupportsCustomColorMatching: true
*APCustomColorMatchingName name/text: ""
*APCustomColorMatchingProfile: profile
*APDefaultCustomColorMatchingProfile: profile
These keywords tell the OS X raster filters that the printer driver provides its own custom color matching and that generic color profiles should be used when generating 1-, 3-, and 4-component raster data as requested by the driver. The APCustomColorMatchingProfile and APDefaultColorMatchingProfile keywords specify alternate color profiles (sRGB or AdobeRGB) to use for 3-color (RGB) raster data.
+These keywords tell the macOS raster filters that the printer driver provides its own custom color matching and that generic color profiles should be used when generating 1-, 3-, and 4-component raster data as requested by the driver. The APCustomColorMatchingProfile and APDefaultColorMatchingProfile keywords specify alternate color profiles (sRGB or AdobeRGB) to use for 3-color (RGB) raster data.
Note: --Prior to OS X 10.6, the default RGB color space was Apple's "GenericRGB". The new default in OS X 10.6 and later is "sRGB". For more information, see "OS X v10.6: About gamma 2.2" on Apple's support site.
+Prior to macOS 10.6, the default RGB color space was Apple's "GenericRGB". The new default in macOS 10.6 and later is "sRGB". For more information, see "macOS v10.6: About gamma 2.2" on Apple's support site.
*APCustomColorMatchingName name/text: ""
@@ -656,7 +770,7 @@ f(x) = density * x gamma *fr.APCustomColorMatchingName name/La AcmeColor(tm): "" -*APCustomColorMatchingProfile: name
@@ -678,7 +792,7 @@ f(x) = density * x gamma *APCustomColorMatchingProfile: AdobeRGB -*APDefaultCustomColorMatchingProfile: name
@@ -692,7 +806,7 @@ f(x) = density * x gamma *APDefaultCustomColorMatchingProfile: sRGB -*APSupportsCustomColorMatching: boolean
@@ -728,7 +842,8 @@ f(x) = density * x gamma -*cupsUIConstraints resolver: "*Keyword1 *Keyword2 ..."
*cupsUIConstraints resolver: "*Keyword1 OptionKeyword1 *Keyword2 ..."
@@ -758,7 +873,8 @@ f(x) = density * x gamma
*cupsUIConstraints photo: "*OutputMode Photo *MediaType Transparency *Resolution 1200dpi"
-
*cupsUIResolver resolver: "*Keyword1 OptionKeyword1 *Keyword2 OptionKeyword2 ..."
@@ -860,7 +976,7 @@ f(x) = density * x gamma -CUPS supports custom options using an extension of the CustomPageSize and ParamCustomPageSize syntax:
@@ -975,7 +1091,8 @@ 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.
-There are many possible implementations of the CustomPageSize code. For CUPS raster drivers, the following code is recommended:
@@ -988,7 +1105,8 @@ 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" -CUPS supports the following PostScript operators in addition to the usual PostScript number, string (literal and hex-encoded), boolean, null, and name values:
@@ -1047,7 +1165,8 @@ PRE B { -Table 2 shows the supported page device attributes along with PostScript code examples.
@@ -1318,7 +1437,8 @@ PRE B {The CUPS media keywords allow drivers to specify alternate custom page size limits based on up to two options.
-*cupsMediaQualifier2: MainKeyword
@@ -1337,7 +1457,8 @@ custom page size limits. *cupsMinSize ..Photo: "300 300" -*cupsMediaQualifier3: MainKeyword
@@ -1356,7 +1477,8 @@ custom page size limits. *cupsMinSize ..Photo: "300 300" -*cupsMinSize .Qualifier2.Qualifier3: "width length"
*cupsMinSize .Qualifier2.: "width length"
@@ -1379,7 +1501,8 @@ are used to identify options to use for matching.
*cupsMaxSize .Qualifier2.Qualifier3: "width length"
*cupsMaxSize .Qualifier2.: "width length"
@@ -1403,11 +1526,11 @@ are used to identify options to use for matching.
*cupsPageSizeCategory name/text: "name name2 ... nameN"
-This keyword lists related paper size names that should be grouped together in the Print or Page Setup dialogs. The "name" portion of the keyword specifies the root/default size for the grouping. On OS X the grouped paper sizes are shown in a submenu of the main paper size. When omitted, sizes with the same dimensions are automatically grouped together, for example "Letter" and "Letter.Borderless".
+This keyword lists related paper size names that should be grouped together in the Print or Page Setup dialogs. The "name" portion of the keyword specifies the root/default size for the grouping. On macOS the grouped paper sizes are shown in a submenu of the main paper size. When omitted, sizes with the same dimensions are automatically grouped together, for example "Letter" and "Letter.Borderless".
Example:
@@ -1420,7 +1543,7 @@ are used to identify options to use for matching.*cupsBackSide: keyword
@@ -1496,7 +1619,7 @@ will be ignored.* - Not supported in OS X 10.5.x and earlier
+* - Not supported in macOS 10.5.x and earlier