-<!doctype html>
+<!DOCTYPE html>
<html>
<!-- SECTION: Programming -->
<head>
<title>PPD API (DEPRECATED)</title>
<meta name="keywords" content="Programming">
<meta http-equiv="Content-Type" content="text/html;charset=utf-8">
- <meta name="creator" content="Mini-XML v2.11">
+ <meta name="creator" content="codedoc v3.1">
<meta name="author" content="Unknown">
<meta name="copyright" content="Unknown">
<meta name="version" content="0.0">
font-family: lucida grande, geneva, helvetica, arial, sans-serif;
}
+H1 { font-size: 2em; }
+H2 { font-size: 1.75em; }
+H3 { font-size: 1.5em; }
+H4 { font-size: 1.25em; }
+
KBD {
font-family: monaco, courier, monospace;
font-weight: bold;
blockquote {
border: solid thin gray;
box-shadow: 3px 3px 5px rgba(0,0,0,0.5);
- padding: 0px 10px;
+ padding: 10px 10px 0px;
page-break-inside: avoid;
}
p code, li code, p.code, pre, ul.code li {
background: rgba(127,127,127,0.1);
border: thin dotted gray;
font-family: monospace;
- font-size: 90%;
hyphens: manual;
-webkit-hyphens: manual;
page-break-inside: avoid;
font-weight: bold;
white-space: nowrap;
}
-h3 span.info, h4 span.info {
- border-top-left-radius: 10px;
- border-top-right-radius: 10px;
+h2 span.info, h3 span.info, h4 span.info {
+ border-radius: 10px;
float: right;
+ font-size: 80%;
padding: 3px 6px;
}
+h2.title span.info, h3.title span.info, h4.title span.info {
+ border-bottom-left-radius: 0px;
+ border-bottom-right-radius: 0px;
+}
+h2.title span.info {
+ padding: 4px 6px;
+}
ul.code, ul.contents, ul.subcontents {
list-style-type: none;
margin: 0;
<!--
PPD API header for CUPS.
- Copyright © 2008-2012 by Apple Inc.
+ Copyright © 2008-2019 by Apple Inc.
Licensed under Apache License v2.0. See the file "LICENSE" for more
information.
<h1 class='title'>PPD API (DEPRECATED)</h1>
-<blockquote>The PPD API is deprecated starting in CUPS 1.6/macOS 10.8. Please use the new Job Ticket APIs in the <a href="api-cups.html">CUPS API</a> documentation. These functions will be removed in a future release of CUPS.</blockquote>
+<blockquote><b>Note:</b>
+
+<p>The PPD API was deprecated in CUPS 1.6/macOS 10.8. Please use the new Job Ticket APIs in the <a href="cupspm.html">CUPS Programming Manual</a> documentation. These functions will be removed in a future release of CUPS.</p>
+</blockquote>
<div class='summary'><table summary='General Information'>
<thead>
<tr>
<th>See Also</th>
<td>Programming: <a href='api-overview.html' target='_top'>Introduction to CUPS Programming</a><br>
- Programming: <a href='api-cups.html' target='_top'>CUPS API</a><br>
+ Programming: <a href='cupspm.html' target='_top'>CUPS Programming Manual</a><br>
Specifications: <a href='spec-ppd.html' target='_top'>CUPS PPD Extensions</a></td>
</tr>
</tbody>
<li><a href="#cupsGetPPD3">cupsGetPPD3</a></li>
<li><a href="#cupsGetServerPPD">cupsGetServerPPD</a></li>
<li><a href="#cupsMarkOptions">cupsMarkOptions</a></li>
+ <li><a href="#cupsRasterInterpretPPD">cupsRasterInterpretPPD</a></li>
<li><a href="#cupsResolveConflicts">cupsResolveConflicts</a></li>
<li><a href="#ppdCollect">ppdCollect</a></li>
<li><a href="#ppdCollect2">ppdCollect2</a></li>
<li><a href="#ppdPageWidth">ppdPageWidth</a></li>
</ul></li>
<li><a href="#TYPES">Data Types</a><ul class="subcontents">
+ <li><a href="#cups_interpret_cb_t">cups_interpret_cb_t</a></li>
<li><a href="#ppd_attr_t">ppd_attr_t</a></li>
<li><a href="#ppd_choice_t">ppd_choice_t</a></li>
<li><a href="#ppd_conform_t">ppd_conform_t</a></li>
</ul></li>
<li><a href="#ENUMERATIONS">Enumerations</a><ul class="subcontents">
<li><a href="#ppd_conform_e">ppd_conform_e</a></li>
+ <li><a href="#ppd_cptype_e">ppd_cptype_e</a></li>
<li><a href="#ppd_cs_e">ppd_cs_e</a></li>
<li><a href="#ppd_section_e">ppd_section_e</a></li>
<li><a href="#ppd_status_e">ppd_status_e</a></li>
<!--
PPD API introduction for CUPS.
- Copyright © 2007-2012 by Apple Inc.
+ Copyright © 2007-2019 by Apple Inc.
Copyright © 1997-2006 by Easy Software Products, all rights reserved.
Licensed under Apache License v2.0. See the file "LICENSE" for more
<h2 class='title'><a name='OVERVIEW'>Overview</a></h2>
-<blockquote>The PPD API is deprecated starting in CUPS 1.6/macOS 10.8. Please use the new Job Ticket APIs in the <a href="api-cups.html">CUPS API</a> documentation. These functions will be removed in a future release of CUPS.</blockquote>
+<blockquote><b>Note:</b>
+
+<p>The PPD API was deprecated in CUPS 1.6/macOS 10.8. Please use the new Job Ticket APIs in the <a href="cupspm.html">CUPS Programming Manual</a> documentation. These functions will be removed in a future release of CUPS.</p>
+</blockquote>
<p>The CUPS PPD API provides read-only access the data in PostScript Printer
Description ("PPD") files which are used for all printers with a driver. With
are equivalent to "inputslot" and "upper", respectively.</p>
</blockquote>
+
<h3><a name="LOADING">Loading a PPD File</a></h3>
<p>The <a href="#ppdOpenFile"><code>ppdOpenFile</code></a> function "opens" a
cupsFreeOptions(num_options, options);
</pre>
+
<h3><a name="CONSTRAINTS">Constraints</a></h3>
<p>PPD files support specification of conflict conditions, called
how many of the selected options are incompatible. Since constraints are
normally specified in pairs, the returned value is typically an even number.</p>
+
<h3><a name="PAGE_SIZES">Page Sizes</a></h3>
<p>Page sizes are special options which have physical dimensions and margins
<a href="#ppdPageSize"><code>ppdPageSize</code></a> function will return
<code>NULL</code>.</p>
+
<h3><a name="ATTRIBUTES">Attributes</a></h3>
<p>Every PPD file is composed of one or more attributes. Most of these
"multiple-document-handling", "output-bin", "print-color-mode",
"print-quality", "printer-resolution", and "sides" attributes to their
corresponding PPD options and choices.</p>
+<h3 class="function"><span class="info"> CUPS 1.2/macOS 10.5 </span><a id="cupsRasterInterpretPPD">cupsRasterInterpretPPD</a></h3>
+ <p class="description">Interpret PPD commands to create a page header.</p>
+<p class="code">
+int cupsRasterInterpretPPD(cups_page_header2_t *h, <a href="#ppd_file_t">ppd_file_t</a> *ppd, int num_options, cups_option_t *options, <a href="#cups_interpret_cb_t">cups_interpret_cb_t</a> func);</p>
+<h4 class="parameters">Parameters</h4>
+<table class="list"><tbody>
+<tr><th>h</th>
+ <td class="description">Page header to create</td></tr>
+<tr><th>ppd</th>
+ <td class="description">PPD file</td></tr>
+<tr><th>num_options</th>
+ <td class="description">Number of options</td></tr>
+<tr><th>options</th>
+ <td class="description">Options</td></tr>
+<tr><th>func</th>
+ <td class="description">Optional page header callback (<code>NULL</code> for none)</td></tr>
+</tbody></table>
+<h4 class="returnvalue">Return Value</h4>
+ <p class="description">0 on success, -1 on failure</p>
+<h4 class="discussion">Discussion</h4>
+ <p class="discussion">This function is used by raster image processing (RIP) filters like
+cgpdftoraster and imagetoraster when writing CUPS raster data for a page.
+It is not used by raster printer driver filters which only read CUPS
+raster data.<br>
+<br>
+
+<code>cupsRasterInterpretPPD</code> does not mark the options in the PPD using
+the "num_options" and "options" arguments. Instead, mark the options with
+<code>cupsMarkOptions</code> and <code>ppdMarkOption</code> prior to calling it -
+this allows for per-page options without manipulating the options array.<br>
+<br>
+The "func" argument specifies an optional callback function that is
+called prior to the computation of the final raster data. The function
+can make changes to the <a href="#cups_page_header2_t"><code>cups_page_header2_t</code></a> data as needed to use a
+supported raster format and then returns 0 on success and -1 if the
+requested attributes cannot be supported.<br>
+<br>
+
+<code>cupsRasterInterpretPPD</code> supports a subset of the PostScript language.
+Currently only the <code>[</code>, <code>]</code>, <code><<</code>, <code>>></code>, <code>{</code>,
+<code>}</code>, <code>cleartomark</code>, <code>copy</code>, <code>dup</code>, <code>index</code>,
+<code>pop</code>, <code>roll</code>, <code>setpagedevice</code>, and <code>stopped</code> operators
+are supported.
+
+</p>
<h3 class="function"><span class="info"> CUPS 1.4/macOS 10.6 </span><a id="cupsResolveConflicts">cupsResolveConflicts</a></h3>
<p class="description">Resolve conflicts in a marked PPD.</p>
<p class="code">
<h4 class="returnvalue">Return Value</h4>
<p class="description">Width of page in points or 0.0</p>
<h2 class="title"><a id="TYPES">Data Types</a></h2>
- <h3 class="typedef"><a id="ppd_attr_t"><span class="info"> CUPS 1.1.19/macOS 10.3 </span>ppd_attr_t</a></h3>
+ <h3 class="typedef"><a id="cups_interpret_cb_t">cups_interpret_cb_t</a></h3>
+ <p class="description">cupsRasterInterpretPPD callback function</p>
+ <p class="code">
+typedef int (*cups_interpret_cb_t)(cups_page_header2_t *header, int preferred_bits);
+</p>
+ <h3 class="typedef"><a id="ppd_attr_t"><span class="info"> DEPRECATED </span>ppd_attr_t</a></h3>
<p class="description">PPD Attribute Structure </p>
<p class="code">
typedef struct <a href="#ppd_attr_s">ppd_attr_s</a> ppd_attr_t;
</p>
- <h3 class="typedef"><a id="ppd_choice_t">ppd_choice_t</a></h3>
- <p class="description">Option choices</p>
+ <h3 class="typedef"><a id="ppd_choice_t"><span class="info"> DEPRECATED </span>ppd_choice_t</a></h3>
+ <p class="description">Option choices </p>
<p class="code">
typedef struct <a href="#ppd_choice_s">ppd_choice_s</a> ppd_choice_t;
</p>
- <h3 class="typedef"><a id="ppd_conform_t"><span class="info"> CUPS 1.1.19/macOS 10.3 </span>ppd_conform_t</a></h3>
+ <h3 class="typedef"><a id="ppd_conform_t"><span class="info"> DEPRECATED </span>ppd_conform_t</a></h3>
<p class="description">Conformance Levels </p>
<p class="code">
typedef enum <a href="#ppd_conform_e">ppd_conform_e</a> ppd_conform_t;
</p>
- <h3 class="typedef"><a id="ppd_const_t">ppd_const_t</a></h3>
- <p class="description">Constraints</p>
+ <h3 class="typedef"><a id="ppd_const_t"><span class="info"> DEPRECATED </span>ppd_const_t</a></h3>
+ <p class="description">Constraints </p>
<p class="code">
typedef struct <a href="#ppd_const_s">ppd_const_s</a> ppd_const_t;
</p>
- <h3 class="typedef"><a id="ppd_coption_t"><span class="info"> CUPS 1.2/macOS 10.5 </span>ppd_coption_t</a></h3>
+ <h3 class="typedef"><a id="ppd_coption_t"><span class="info"> DEPRECATED </span>ppd_coption_t</a></h3>
<p class="description">Custom Option </p>
<p class="code">
typedef struct <a href="#ppd_coption_s">ppd_coption_s</a> ppd_coption_t;
</p>
- <h3 class="typedef"><a id="ppd_cparam_t"><span class="info"> CUPS 1.2/macOS 10.5 </span>ppd_cparam_t</a></h3>
+ <h3 class="typedef"><a id="ppd_cparam_t"><span class="info"> DEPRECATED </span>ppd_cparam_t</a></h3>
<p class="description">Custom Parameter </p>
<p class="code">
typedef struct <a href="#ppd_cparam_s">ppd_cparam_s</a> ppd_cparam_t;
</p>
- <h3 class="typedef"><a id="ppd_cplimit_t"><span class="info"> CUPS 1.2/macOS 10.5 </span>ppd_cplimit_t</a></h3>
+ <h3 class="typedef"><a id="ppd_cplimit_t"><span class="info"> DEPRECATED </span>ppd_cplimit_t</a></h3>
<p class="description">Custom Parameter Limit </p>
<p class="code">
typedef union <a href="#ppd_cplimit_u">ppd_cplimit_u</a> ppd_cplimit_t;
</p>
- <h3 class="typedef"><a id="ppd_cptype_t"><span class="info"> CUPS 1.2/macOS 10.5 </span>ppd_cptype_t</a></h3>
+ <h3 class="typedef"><a id="ppd_cptype_t"><span class="info"> DEPRECATED </span>ppd_cptype_t</a></h3>
<p class="description">Custom Parameter Type </p>
<p class="code">
-typedef enum ppd_cptype_e ppd_cptype_t;
+typedef enum <a href="#ppd_cptype_e">ppd_cptype_e</a> ppd_cptype_t;
</p>
- <h3 class="typedef"><a id="ppd_cpvalue_t"><span class="info"> CUPS 1.2/macOS 10.5 </span>ppd_cpvalue_t</a></h3>
+ <h3 class="typedef"><a id="ppd_cpvalue_t"><span class="info"> DEPRECATED </span>ppd_cpvalue_t</a></h3>
<p class="description">Custom Parameter Value </p>
<p class="code">
typedef union <a href="#ppd_cpvalue_u">ppd_cpvalue_u</a> ppd_cpvalue_t;
</p>
- <h3 class="typedef"><a id="ppd_cs_t">ppd_cs_t</a></h3>
- <p class="description">Colorspaces</p>
+ <h3 class="typedef"><a id="ppd_cs_t"><span class="info"> DEPRECATED </span>ppd_cs_t</a></h3>
+ <p class="description">Colorspaces </p>
<p class="code">
typedef enum <a href="#ppd_cs_e">ppd_cs_e</a> ppd_cs_t;
</p>
- <h3 class="typedef"><a id="ppd_emul_t">ppd_emul_t</a></h3>
- <p class="description">Emulators</p>
+ <h3 class="typedef"><a id="ppd_emul_t"><span class="info"> DEPRECATED </span>ppd_emul_t</a></h3>
+ <p class="description">Emulators </p>
<p class="code">
typedef struct <a href="#ppd_emul_s">ppd_emul_s</a> ppd_emul_t;
</p>
- <h3 class="typedef"><a id="ppd_file_t">ppd_file_t</a></h3>
- <p class="description">PPD File</p>
+ <h3 class="typedef"><a id="ppd_file_t"><span class="info"> DEPRECATED </span>ppd_file_t</a></h3>
+ <p class="description">PPD File </p>
<p class="code">
typedef struct <a href="#ppd_file_s">ppd_file_s</a> ppd_file_t;
</p>
- <h3 class="typedef"><a id="ppd_group_t">ppd_group_t</a></h3>
- <p class="description">Groups</p>
+ <h3 class="typedef"><a id="ppd_group_t"><span class="info"> DEPRECATED </span>ppd_group_t</a></h3>
+ <p class="description">Groups </p>
<p class="code">
typedef struct <a href="#ppd_group_s">ppd_group_s</a> ppd_group_t;
</p>
- <h3 class="typedef"><a id="ppd_option_t">ppd_option_t</a></h3>
- <p class="description">Options</p>
+ <h3 class="typedef"><a id="ppd_option_t"><span class="info"> DEPRECATED </span>ppd_option_t</a></h3>
+ <p class="description">Options </p>
<p class="code">
typedef struct <a href="#ppd_option_s">ppd_option_s</a> ppd_option_t;
</p>
- <h3 class="typedef"><a id="ppd_profile_t">ppd_profile_t</a></h3>
- <p class="description">sRGB Color Profiles</p>
+ <h3 class="typedef"><a id="ppd_profile_t"><span class="info"> DEPRECATED </span>ppd_profile_t</a></h3>
+ <p class="description">sRGB Color Profiles </p>
<p class="code">
typedef struct <a href="#ppd_profile_s">ppd_profile_s</a> ppd_profile_t;
</p>
- <h3 class="typedef"><a id="ppd_section_t">ppd_section_t</a></h3>
- <p class="description">Order dependency sections</p>
+ <h3 class="typedef"><a id="ppd_section_t"><span class="info"> DEPRECATED </span>ppd_section_t</a></h3>
+ <p class="description">Order dependency sections </p>
<p class="code">
typedef enum <a href="#ppd_section_e">ppd_section_e</a> ppd_section_t;
</p>
- <h3 class="typedef"><a id="ppd_size_t">ppd_size_t</a></h3>
- <p class="description">Page Sizes</p>
+ <h3 class="typedef"><a id="ppd_size_t"><span class="info"> DEPRECATED </span>ppd_size_t</a></h3>
+ <p class="description">Page Sizes </p>
<p class="code">
typedef struct <a href="#ppd_size_s">ppd_size_s</a> ppd_size_t;
</p>
- <h3 class="typedef"><a id="ppd_status_t"><span class="info"> CUPS 1.1.19/macOS 10.3 </span>ppd_status_t</a></h3>
+ <h3 class="typedef"><a id="ppd_status_t"><span class="info"> DEPRECATED </span>ppd_status_t</a></h3>
<p class="description">Status Codes </p>
<p class="code">
typedef enum <a href="#ppd_status_e">ppd_status_e</a> ppd_status_t;
</p>
- <h3 class="typedef"><a id="ppd_ui_t">ppd_ui_t</a></h3>
- <p class="description">UI Types</p>
+ <h3 class="typedef"><a id="ppd_ui_t"><span class="info"> DEPRECATED </span>ppd_ui_t</a></h3>
+ <p class="description">UI Types </p>
<p class="code">
typedef enum <a href="#ppd_ui_e">ppd_ui_e</a> ppd_ui_t;
</p>
<h2 class="title"><a id="STRUCTURES">Structures</a></h2>
-<h3 class="struct"><span class="info"> 
CUPS 1.1.19/macOS 10.3 </span><a id="ppd_attr_s">ppd_attr_s</a></h3>
+<h3 class="struct"><span class="info"> 
DEPRECATED </span><a id="ppd_attr_s">ppd_attr_s</a></h3>
<p class="description">PPD Attribute Structure </p>
<p class="code">struct ppd_attr_s {<br>
    char name[PPD_MAX_NAME];<br>
<tr><th>value </th>
<td class="description">Value string</td></tr>
</tbody></table>
-<h3 class="struct"><a id="ppd_choice_s">ppd_choice_s</a></h3>
- <p class="description">Option choices</p>
+<h3 class="struct"><span class="info"> DEPRECATED </span><a id="ppd_choice_s">ppd_choice_s</a></h3>
+ <p class="description">Option choices </p>
<p class="code">struct ppd_choice_s {<br>
    char choice[PPD_MAX_NAME];<br>
    char *code;<br>
<tr><th>text[PPD_MAX_TEXT] </th>
<td class="description">Human-readable option name</td></tr>
</tbody></table>
-<h3 class="struct"><a id="ppd_const_s">ppd_const_s</a></h3>
- <p class="description">Constraints</p>
+<h3 class="struct"><span class="info"> DEPRECATED </span><a id="ppd_const_s">ppd_const_s</a></h3>
+ <p class="description">Constraints </p>
<p class="code">struct ppd_const_s {<br>
    char choice1[PPD_MAX_NAME];<br>
    char choice2[PPD_MAX_NAME];<br>
<tr><th>option2[PPD_MAX_NAME] </th>
<td class="description">Second keyword</td></tr>
</tbody></table>
-<h3 class="struct"><span class="info"> 
CUPS 1.2/macOS 10.5 </span><a id="ppd_coption_s">ppd_coption_s</a></h3>
+<h3 class="struct"><span class="info"> 
DEPRECATED </span><a id="ppd_coption_s">ppd_coption_s</a></h3>
<p class="description">Custom Option </p>
<p class="code">struct ppd_coption_s {<br>
    char keyword[PPD_MAX_NAME];<br>
<tr><th>params </th>
<td class="description">Parameters</td></tr>
</tbody></table>
-<h3 class="struct"><span class="info"> 
CUPS 1.2/macOS 10.5 </span><a id="ppd_cparam_s">ppd_cparam_s</a></h3>
+<h3 class="struct"><span class="info"> 
DEPRECATED </span><a id="ppd_cparam_s">ppd_cparam_s</a></h3>
<p class="description">Custom Parameter </p>
<p class="code">struct ppd_cparam_s {<br>
    <a href="#ppd_cpvalue_t">ppd_cpvalue_t</a> current;<br>
<tr><th>type </th>
<td class="description">Parameter type</td></tr>
</tbody></table>
-<h3 class="struct"><a id="ppd_emul_s">ppd_emul_s</a></h3>
- <p class="description">Emulators</p>
+<h3 class="struct"><span class="info"> DEPRECATED </span><a id="ppd_emul_s">ppd_emul_s</a></h3>
+ <p class="description">Emulators </p>
<p class="code">struct ppd_emul_s {<br>
    char name[PPD_MAX_NAME];<br>
    char *start;<br>
<tr><th>stop </th>
<td class="description">Code to stop this emulation</td></tr>
</tbody></table>
-<h3 class="struct"><a id="ppd_file_s">ppd_file_s</a></h3>
- <p class="description">PPD File</p>
+<h3 class="struct"><span class="info"> DEPRECATED </span><a id="ppd_file_s">ppd_file_s</a></h3>
+ <p class="description">PPD File </p>
<p class="code">struct ppd_file_s {<br>
    int accurate_screens;<br>
    int color_device;<br>
    float custom_margins[4];<br>
    float custom_max[2];<br>
    float custom_min[2];<br>
-    <a href="#ppd_emul_t">ppd_emul_t</a> *emulations;<br>
    char **filters;<br>
    int flip_duplex;<br>
    char **fonts;<br>
    char *modelname;<br>
    char *nickname;<br>
    int num_consts;<br>
-    int num_emulations;<br>
    int num_filters;<br>
    int num_fonts;<br>
    int num_groups;<br>
<td class="description">Maximum variable page size</td></tr>
<tr><th>custom_min[2] </th>
<td class="description">Minimum variable page size</td></tr>
-<tr><th>emulations </th>
- <td class="description">Emulations and the code to invoke them</td></tr>
<tr><th>filters </th>
<td class="description">Filter strings...</td></tr>
<tr><th>flip_duplex <span class="info"> DEPRECATED </span></th>
<td class="description">Nickname (specific)</td></tr>
<tr><th>num_consts </th>
<td class="description">Number of UI/Non-UI constraints</td></tr>
-<tr><th>num_emulations </th>
- <td class="description">Number of emulations supported</td></tr>
<tr><th>num_filters </th>
<td class="description">Number of filters</td></tr>
<tr><th>num_fonts </th>
<tr><th>variable_sizes </th>
<td class="description">1 = supports variable sizes, 0 = doesn't</td></tr>
</tbody></table>
-<h3 class="struct"><a id="ppd_group_s">ppd_group_s</a></h3>
- <p class="description">Groups</p>
+<h3 class="struct"><span class="info"> DEPRECATED </span><a id="ppd_group_s">ppd_group_s</a></h3>
+ <p class="description">Groups </p>
<p class="code">struct ppd_group_s {<br>
    char text[PPD_MAX_TEXT - PPD_MAX_NAME];<br>
    char name[PPD_MAX_NAME];<br>
<tr><th>subgroups </th>
<td class="description">Sub-groups (max depth = 1)</td></tr>
</tbody></table>
-<h3 class="struct"><a id="ppd_option_s">ppd_option_s</a></h3>
- <p class="description">Options</p>
+<h3 class="struct"><span class="info"> DEPRECATED </span><a id="ppd_option_s">ppd_option_s</a></h3>
+ <p class="description">Options </p>
<p class="code">struct ppd_option_s {<br>
    <a href="#ppd_choice_t">ppd_choice_t</a> *choices;<br>
    char conflicted;<br>
<tr><th>ui </th>
<td class="description">Type of UI option</td></tr>
</tbody></table>
-<h3 class="struct"><a id="ppd_profile_s">ppd_profile_s</a></h3>
- <p class="description">sRGB Color Profiles</p>
+<h3 class="struct"><span class="info"> DEPRECATED </span><a id="ppd_profile_s">ppd_profile_s</a></h3>
+ <p class="description">sRGB Color Profiles </p>
<p class="code">struct ppd_profile_s {<br>
    float density;<br>
    float gamma;<br>
<tr><th>resolution[PPD_MAX_NAME] </th>
<td class="description">Resolution or "-"</td></tr>
</tbody></table>
-<h3 class="struct"><a id="ppd_size_s">ppd_size_s</a></h3>
- <p class="description">Page Sizes</p>
+<h3 class="struct"><span class="info"> DEPRECATED </span><a id="ppd_size_s">ppd_size_s</a></h3>
+ <p class="description">Page Sizes </p>
<p class="code">struct ppd_size_s {<br>
    float bottom;<br>
    float left;<br>
<td class="description">Width of media in points</td></tr>
</tbody></table>
<h2 class="title"><a id="UNIONS">Unions</a></h2>
-<h3 class="union"><span class="info"> 
CUPS 1.2/macOS 10.5 </span><a id="ppd_cplimit_u">ppd_cplimit_u</a></h3>
+<h3 class="union"><span class="info"> 
DEPRECATED </span><a id="ppd_cplimit_u">ppd_cplimit_u</a></h3>
<p class="description">Custom Parameter Limit </p>
<p class="code">union ppd_cplimit_u {<br>
    float custom_curve;<br>
<tr><th>custom_string </th>
<td class="description">String length</td></tr>
</tbody></table>
-<h3 class="union"><span class="info"> 
CUPS 1.2/macOS 10.5 </span><a id="ppd_cpvalue_u">ppd_cpvalue_u</a></h3>
+<h3 class="union"><span class="info"> 
DEPRECATED </span><a id="ppd_cpvalue_u">ppd_cpvalue_u</a></h3>
<p class="description">Custom Parameter Value </p>
<p class="code">union ppd_cpvalue_u {<br>
    float custom_curve;<br>
<td class="description">String value</td></tr>
</tbody></table>
<h2 class="title"><a id="ENUMERATIONS">Constants</a></h2>
- <h3 class="enumeration"><a id="ppd_conform_e"><span class="info"> CUPS 1.1.19/macOS 10.3 </span>ppd_conform_e</a></h3>
+ <h3 class="enumeration"><a id="ppd_conform_e"><span class="info"> DEPRECATED </span>ppd_conform_e</a></h3>
<p class="description">Conformance Levels </p>
<h4 class="constants">Constants</h4>
<table class="list"><tbody>
<tr><th>PPD_CONFORM_RELAXED </th> <td class="description">Relax whitespace and control char</td></tr>
<tr><th>PPD_CONFORM_STRICT </th> <td class="description">Require strict conformance</td></tr>
</tbody></table>
- <h3 class="enumeration"><a id="ppd_cs_e">ppd_cs_e</a></h3>
- <p class="description">Colorspaces</p>
+ <h3 class="enumeration"><a id="ppd_cptype_e"><span class="info"> DEPRECATED </span>ppd_cptype_e</a></h3>
+ <p class="description">Custom Parameter Type </p>
+ <h4 class="constants">Constants</h4>
+ <table class="list"><tbody>
+ <tr><th>PPD_CUSTOM_CURVE </th> <td class="description">Curve value for f(x) = x^value</td></tr>
+ <tr><th>PPD_CUSTOM_INT </th> <td class="description">Integer number value</td></tr>
+ <tr><th>PPD_CUSTOM_INVCURVE </th> <td class="description">Curve value for f(x) = x^(1/value)</td></tr>
+ <tr><th>PPD_CUSTOM_PASSCODE </th> <td class="description">String of (hidden) numbers</td></tr>
+ <tr><th>PPD_CUSTOM_PASSWORD </th> <td class="description">String of (hidden) characters</td></tr>
+ <tr><th>PPD_CUSTOM_POINTS </th> <td class="description">Measurement value in points</td></tr>
+ <tr><th>PPD_CUSTOM_REAL </th> <td class="description">Real number value</td></tr>
+ <tr><th>PPD_CUSTOM_STRING </th> <td class="description">String of characters</td></tr>
+ <tr><th>PPD_CUSTOM_UNKNOWN </th> <td class="description">Unknown type (error)</td></tr>
+</tbody></table>
+ <h3 class="enumeration"><a id="ppd_cs_e"><span class="info"> DEPRECATED </span>ppd_cs_e</a></h3>
+ <p class="description">Colorspaces </p>
<h4 class="constants">Constants</h4>
<table class="list"><tbody>
<tr><th>PPD_CS_CMY </th> <td class="description">CMY colorspace</td></tr>
<tr><th>PPD_CS_RGB </th> <td class="description">RGB colorspace</td></tr>
<tr><th>PPD_CS_RGBK </th> <td class="description">RGBK (K = gray) colorspace</td></tr>
</tbody></table>
- <h3 class="enumeration"><a id="ppd_section_e">ppd_section_e</a></h3>
- <p class="description">Order dependency sections</p>
+ <h3 class="enumeration"><a id="ppd_section_e"><span class="info"> DEPRECATED </span>ppd_section_e</a></h3>
+ <p class="description">Order dependency sections </p>
<h4 class="constants">Constants</h4>
<table class="list"><tbody>
<tr><th>PPD_ORDER_ANY </th> <td class="description">Option code can be anywhere in the file</td></tr>
<tr><th>PPD_ORDER_PAGE </th> <td class="description">... must be in the PageSetup section</td></tr>
<tr><th>PPD_ORDER_PROLOG </th> <td class="description">... must be in the Prolog section</td></tr>
</tbody></table>
- <h3 class="enumeration"><a id="ppd_status_e"><span class="info"> CUPS 1.1.19/macOS 10.3 </span>ppd_status_e</a></h3>
+ <h3 class="enumeration"><a id="ppd_status_e"><span class="info"> DEPRECATED </span>ppd_status_e</a></h3>
<p class="description">Status Codes </p>
<h4 class="constants">Constants</h4>
<table class="list"><tbody>
<tr><th>PPD_ALLOC_ERROR </th> <td class="description">Memory allocation error</td></tr>
+ <tr><th>PPD_BAD_CLOSE_UI </th> <td class="description">Bad CloseUI/JCLCloseUI</td></tr>
<tr><th>PPD_BAD_CUSTOM_PARAM </th> <td class="description">Bad custom parameter</td></tr>
<tr><th>PPD_BAD_OPEN_GROUP </th> <td class="description">Bad OpenGroup</td></tr>
<tr><th>PPD_BAD_OPEN_UI </th> <td class="description">Bad OpenUI/JCLOpenUI</td></tr>
<tr><th>PPD_LINE_TOO_LONG </th> <td class="description">Line longer than 255 chars</td></tr>
<tr><th>PPD_MISSING_ASTERISK </th> <td class="description">Missing asterisk in column 0</td></tr>
<tr><th>PPD_MISSING_CLOSE_GROUP </th> <td class="description">Missing CloseGroup</td></tr>
+ <tr><th>PPD_MISSING_CLOSE_UI </th> <td class="description">Missing CloseUI/JCLCloseUI</td></tr>
<tr><th>PPD_MISSING_OPTION_KEYWORD </th> <td class="description">Missing option keyword</td></tr>
<tr><th>PPD_MISSING_PPDADOBE4 </th> <td class="description">Missing PPD-Adobe-4.x header</td></tr>
<tr><th>PPD_MISSING_VALUE </th> <td class="description">Missing value string</td></tr>
<tr><th>PPD_NULL_FILE </th> <td class="description">NULL PPD file pointer</td></tr>
<tr><th>PPD_OK </th> <td class="description">OK</td></tr>
</tbody></table>
- <h3 class="enumeration"><a id="ppd_ui_e">ppd_ui_e</a></h3>
- <p class="description">UI Types</p>
+ <h3 class="enumeration"><a id="ppd_ui_e"><span class="info"> DEPRECATED </span>ppd_ui_e</a></h3>
+ <p class="description">UI Types </p>
<h4 class="constants">Constants</h4>
<table class="list"><tbody>
<tr><th>PPD_UI_BOOLEAN </th> <td class="description">True or False option</td></tr>
projects / thirdparty / cups.git / blobdiff