1 <!DOCTYPE HTML PUBLIC
"-//W3C//DTD HTML 4.0 Transitional//EN" "http://www.w3.org/TR/REC-html40/loose.dtd">
3 <!-- SECTION: Programming -->
6 <meta name='keywords' content='Programming'
>
7 <meta name='creator' content='Mini-XML v2.3'
>
8 <style type='text/css'
><!--
9 h1, h2, h3, p { font-family: sans-serif; text-align: justify; }
10 tt, pre a:link, pre a:visited, tt a:link, tt a:visited { font-weight: bold; color: #7f0000; }
11 pre { font-weight: bold; color: #7f0000; margin-left: 2em; }
12 span.info { background: #000000; border: solid thin #000000; color: #ffffff; font-size: 80%; font-style: italic; font-weight: bold; white-space: nowrap; }
13 h3 span.info { float: right; font-size: 100%; }
14 h1.title, h2.title, h3.title { border-bottom: solid 2px #000000; }
19 "$Id: api-ppd.shtml 5138 2006-02-21 10:49:06Z mike $"
21 PPD API introduction for the Common UNIX Printing System (CUPS).
23 Copyright 1997-2006 by Easy Software Products.
25 These coded instructions, statements, and computer programs are the
26 property of Easy Software Products and are protected by Federal
27 copyright law. Distribution and use rights are outlined in the file
28 "LICENSE.txt" which should have been included with this file. If this
29 file is missing or damaged please contact Easy Software Products
32 Attn: CUPS Licensing Information
33 Easy Software Products
34 44141 Airport View Drive, Suite 204
35 Hollywood, Maryland 20636 USA
38 EMail: cups-info@cups.org
39 WWW: http://www.cups.org
42 <h2 class='title'
>Introduction
</h2>
44 <p>The CUPS PPD API provides read-only access the data in
45 PostScript Printer Description (
"PPD") files. With it you can
46 display printer options to users, mark option choices and check
47 for conflicting choices, and output marked choices in PostScript
50 <h2 class='title'
>General Usage
</h2>
52 <p>The
<var><cups/ppd.h
></var> header file must be included
53 to use the
<tt>ppd
</tt> functions.
</p>
55 <p>Programs using these functions must be linked to the CUPS
56 library:
<var>libcups.a
</var>,
<var>libcups.so
.2</var>,
57 <var>libcups
.2.dylib
</var>,
<var>libcups_s.a
</var>, or
58 <var>libcups2.lib
</var> depending on the platform. The following
59 command compiles
<var>myprogram.c
</var> using GCC and the CUPS
63 <kbd>gcc -o myprogram myprogram.c -lcups
</kbd>
66 <h2 class='title'
>Compatibility
</h2>
68 <p>Unless otherwise specified, the PPD API functions require CUPS
70 <h2 class='title'
>Contents
</h2>
72 <li><a href='#ENUMERATIONS'
>Enumerations
</a></li>
73 <li><a href='#FUNCTIONS'
>Functions
</a></li>
74 <li><a href='#STRUCTURES'
>Structures
</a></li>
75 <li><a href='#TYPES'
>Types
</a></li>
76 <li><a href='#UNIONS'
>Unions
</a></li>
79 <h2 class='title'
><a name='ENUMERATIONS'
>Enumerations
</a></h2>
81 <li><a href='#ppd_cptype_e'
><tt>ppd_cptype_e
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
82 <li><a href='#ppd_cs_e'
><tt>ppd_cs_e
</tt></a> </li>
83 <li><a href='#ppd_section_e'
><tt>ppd_section_e
</tt></a> </li>
84 <li><a href='#ppd_status_e'
><tt>ppd_status_e
</tt></a> </li>
85 <li><a href='#ppd_ui_e'
><tt>ppd_ui_e
</tt></a> </li>
88 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppd_cptype_e'
>ppd_cptype_e
</a></h3>
90 <p>Custom Parameter Type
</p>
92 <div class='table'
><table align='center' border='
1' width='
80%'
>
93 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
95 <tr><td><tt>PPD_CUSTOM_CURVE
</tt> </td><td>Curve value for f(x) = x^value
</td></tr>
96 <tr><td><tt>PPD_CUSTOM_INT
</tt> </td><td>Integer number value
</td></tr>
97 <tr><td><tt>PPD_CUSTOM_INVCURVE
</tt> </td><td>Curve value for f(x) = x^(
1/value)
</td></tr>
98 <tr><td><tt>PPD_CUSTOM_PASSCODE
</tt> </td><td>String of (hidden) numbers
</td></tr>
99 <tr><td><tt>PPD_CUSTOM_PASSWORD
</tt> </td><td>String of (hidden) characters
</td></tr>
100 <tr><td><tt>PPD_CUSTOM_POINTS
</tt> </td><td>Measurement value in points
</td></tr>
101 <tr><td><tt>PPD_CUSTOM_REAL
</tt> </td><td>Real number value
</td></tr>
102 <tr><td><tt>PPD_CUSTOM_STRING
</tt> </td><td>String of characters
</td></tr>
103 </tbody></table></div>
105 <h3 class='title'
><a name='ppd_cs_e'
>ppd_cs_e
</a></h3>
109 <div class='table'
><table align='center' border='
1' width='
80%'
>
110 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
112 <tr><td><tt>PPD_CS_CMY
</tt> </td><td>CMY colorspace
</td></tr>
113 <tr><td><tt>PPD_CS_CMYK
</tt> </td><td>CMYK colorspace
</td></tr>
114 <tr><td><tt>PPD_CS_GRAY
</tt> </td><td>Grayscale colorspace
</td></tr>
115 <tr><td><tt>PPD_CS_N
</tt> </td><td>DeviceN colorspace
</td></tr>
116 <tr><td><tt>PPD_CS_RGB
</tt> </td><td>RGB colorspace
</td></tr>
117 <tr><td><tt>PPD_CS_RGBK
</tt> </td><td>RGBK (K = gray) colorspace
</td></tr>
118 </tbody></table></div>
120 <h3 class='title'
><a name='ppd_section_e'
>ppd_section_e
</a></h3>
122 <p>Order dependency sections
</p>
124 <div class='table'
><table align='center' border='
1' width='
80%'
>
125 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
127 <tr><td><tt>PPD_ORDER_ANY
</tt> </td><td>Option code can be anywhere in the file
</td></tr>
128 <tr><td><tt>PPD_ORDER_DOCUMENT
</tt> </td><td>... must be in the DocumentSetup section
</td></tr>
129 <tr><td><tt>PPD_ORDER_EXIT
</tt> </td><td>... must be sent prior to the document
</td></tr>
130 <tr><td><tt>PPD_ORDER_JCL
</tt> </td><td>... must be sent as a JCL command
</td></tr>
131 <tr><td><tt>PPD_ORDER_PAGE
</tt> </td><td>... must be in the PageSetup section
</td></tr>
132 <tr><td><tt>PPD_ORDER_PROLOG
</tt> </td><td>... must be in the Prolog section
</td></tr>
133 </tbody></table></div>
135 <h3 class='title'
><a name='ppd_status_e'
>ppd_status_e
</a></h3>
137 <p>Types and structures...
</p>
139 <div class='table'
><table align='center' border='
1' width='
80%'
>
140 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
142 <tr><td><tt>PPD_ALLOC_ERROR
</tt> </td><td>Memory allocation error
</td></tr>
143 <tr><td><tt>PPD_BAD_CUSTOM_PARAM
</tt> </td><td>Bad custom parameter
</td></tr>
144 <tr><td><tt>PPD_BAD_OPEN_GROUP
</tt> </td><td>Bad OpenGroup
</td></tr>
145 <tr><td><tt>PPD_BAD_OPEN_UI
</tt> </td><td>Bad OpenUI/JCLOpenUI
</td></tr>
146 <tr><td><tt>PPD_BAD_ORDER_DEPENDENCY
</tt> </td><td>Bad OrderDependency
</td></tr>
147 <tr><td><tt>PPD_BAD_UI_CONSTRAINTS
</tt> </td><td>Bad UIConstraints
</td></tr>
148 <tr><td><tt>PPD_FILE_OPEN_ERROR
</tt> </td><td>Unable to open PPD file
</td></tr>
149 <tr><td><tt>PPD_ILLEGAL_CHARACTER
</tt> </td><td>Illegal control character
</td></tr>
150 <tr><td><tt>PPD_ILLEGAL_MAIN_KEYWORD
</tt> </td><td>Illegal main keyword string
</td></tr>
151 <tr><td><tt>PPD_ILLEGAL_OPTION_KEYWORD
</tt> </td><td>Illegal option keyword string
</td></tr>
152 <tr><td><tt>PPD_ILLEGAL_TRANSLATION
</tt> </td><td>Illegal translation string
</td></tr>
153 <tr><td><tt>PPD_ILLEGAL_WHITESPACE
</tt> </td><td>Illegal whitespace character
</td></tr>
154 <tr><td><tt>PPD_INTERNAL_ERROR
</tt> </td><td>Internal error
</td></tr>
155 <tr><td><tt>PPD_LINE_TOO_LONG
</tt> </td><td>Line longer than
255 chars
</td></tr>
156 <tr><td><tt>PPD_MISSING_ASTERISK
</tt> </td><td>Missing asterisk in column
0</td></tr>
157 <tr><td><tt>PPD_MISSING_PPDADOBE4
</tt> </td><td>Missing PPD-Adobe-
4.x header
</td></tr>
158 <tr><td><tt>PPD_MISSING_VALUE
</tt> </td><td>Missing value string
</td></tr>
159 <tr><td><tt>PPD_NESTED_OPEN_GROUP
</tt> </td><td>OpenGroup without a CloseGroup first
</td></tr>
160 <tr><td><tt>PPD_NESTED_OPEN_UI
</tt> </td><td>OpenUI/JCLOpenUI without a CloseUI/JCLCloseUI first
</td></tr>
161 <tr><td><tt>PPD_NULL_FILE
</tt> </td><td>NULL PPD file pointer
</td></tr>
162 <tr><td><tt>PPD_OK
</tt> </td><td>OK
</td></tr>
163 </tbody></table></div>
165 <h3 class='title'
><a name='ppd_ui_e'
>ppd_ui_e
</a></h3>
169 <div class='table'
><table align='center' border='
1' width='
80%'
>
170 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
172 <tr><td><tt>PPD_UI_BOOLEAN
</tt> </td><td>True or False option
</td></tr>
173 <tr><td><tt>PPD_UI_PICKMANY
</tt> </td><td>Pick zero or more from a list
</td></tr>
174 <tr><td><tt>PPD_UI_PICKONE
</tt> </td><td>Pick one from a list
</td></tr>
175 </tbody></table></div>
177 <h2 class='title'
><a name='FUNCTIONS'
>Functions
</a></h2>
179 <li><a href='#ppdClose'
><tt>ppdClose()
</tt></a> </li>
180 <li><a href='#ppdCollect'
><tt>ppdCollect()
</tt></a> </li>
181 <li><a href='#ppdCollect2'
><tt>ppdCollect2()
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
182 <li><a href='#ppdConflicts'
><tt>ppdConflicts()
</tt></a> </li>
183 <li><a href='#ppdEmit'
><tt>ppdEmit()
</tt></a> </li>
184 <li><a href='#ppdEmitAfterOrder'
><tt>ppdEmitAfterOrder()
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
185 <li><a href='#ppdEmitFd'
><tt>ppdEmitFd()
</tt></a> </li>
186 <li><a href='#ppdEmitJCL'
><tt>ppdEmitJCL()
</tt></a> </li>
187 <li><a href='#ppdEmitJCLEnd'
><tt>ppdEmitJCLEnd()
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
188 <li><a href='#ppdEmitString'
><tt>ppdEmitString()
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
189 <li><a href='#ppdErrorString'
><tt>ppdErrorString()
</tt></a> <span class='info'
> CUPS
1.1.19 </span></li>
190 <li><a href='#ppdFindAttr'
><tt>ppdFindAttr()
</tt></a> <span class='info'
> CUPS
1.1.19 </span></li>
191 <li><a href='#ppdFindChoice'
><tt>ppdFindChoice()
</tt></a> </li>
192 <li><a href='#ppdFindMarkedChoice'
><tt>ppdFindMarkedChoice()
</tt></a> </li>
193 <li><a href='#ppdFindNextAttr'
><tt>ppdFindNextAttr()
</tt></a> <span class='info'
> CUPS
1.1.19 </span></li>
194 <li><a href='#ppdFindOption'
><tt>ppdFindOption()
</tt></a> </li>
195 <li><a href='#ppdFirstOption'
><tt>ppdFirstOption()
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
196 <li><a href='#ppdIsMarked'
><tt>ppdIsMarked()
</tt></a> </li>
197 <li><a href='#ppdLastError'
><tt>ppdLastError()
</tt></a> <span class='info'
> CUPS
1.1.19 </span></li>
198 <li><a href='#ppdMarkDefaults'
><tt>ppdMarkDefaults()
</tt></a> </li>
199 <li><a href='#ppdMarkOption'
><tt>ppdMarkOption()
</tt></a> </li>
200 <li><a href='#ppdNextOption'
><tt>ppdNextOption()
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
201 <li><a href='#ppdOpen'
><tt>ppdOpen()
</tt></a> </li>
202 <li><a href='#ppdOpen2'
><tt>ppdOpen2()
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
203 <li><a href='#ppdOpenFd'
><tt>ppdOpenFd()
</tt></a> </li>
204 <li><a href='#ppdOpenFile'
><tt>ppdOpenFile()
</tt></a> </li>
205 <li><a href='#ppdPageLength'
><tt>ppdPageLength()
</tt></a> </li>
206 <li><a href='#ppdPageSize'
><tt>ppdPageSize()
</tt></a> </li>
207 <li><a href='#ppdPageWidth'
><tt>ppdPageWidth()
</tt></a> </li>
208 <li><a href='#ppdSetConformance'
><tt>ppdSetConformance()
</tt></a> <span class='info'
> CUPS
1.1.20 </span></li>
211 <h3 class='title'
><a name='ppdClose'
>ppdClose()
</a></h3>
213 <p>Free all memory used by the PPD file.
</p>
218 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd);
221 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
222 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
224 <tr><td><tt>ppd
</tt></td><td>PPD file record
</td></tr>
225 </tbody></table></div>
229 <h3 class='title'
><a name='ppdCollect'
>ppdCollect()
</a></h3>
231 <p>Collect all marked options that reside in the specified
237 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
238 <a href='#ppd_section_t'
>ppd_section_t
</a> section,
239 <a href='#ppd_choice_t'
>ppd_choice_t
</a> *** choices);
242 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
243 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
245 <tr><td><tt>ppd
</tt></td><td>PPD file data
</td></tr>
246 <tr><td><tt>section
</tt></td><td>Section to collect
</td></tr>
247 <tr><td><tt>choices
</tt></td><td>Pointers to choices
</td></tr>
248 </tbody></table></div>
250 <p>Number of options marked
</p>
252 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppdCollect2'
>ppdCollect2()
</a></h3>
254 <p>Collect all marked options that reside in the
255 specified section and minimum order.
262 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
263 <a href='#ppd_section_t'
>ppd_section_t
</a> section,
265 <a href='#ppd_choice_t'
>ppd_choice_t
</a> *** choices);
268 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
269 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
271 <tr><td><tt>ppd
</tt></td><td>PPD file data
</td></tr>
272 <tr><td><tt>section
</tt></td><td>Section to collect
</td></tr>
273 <tr><td><tt>min_order
</tt></td><td>Minimum OrderDependency value
</td></tr>
274 <tr><td><tt>choices
</tt></td><td>Pointers to choices
</td></tr>
275 </tbody></table></div>
277 <p>Number of options marked
</p>
279 <h3 class='title'
><a name='ppdConflicts'
>ppdConflicts()
</a></h3>
281 <p>Check to see if there are any conflicts.
</p>
286 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd);
289 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
290 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
292 <tr><td><tt>ppd
</tt></td><td>PPD to check
</td></tr>
293 </tbody></table></div>
295 <p>Number of conflicts found
</p>
297 <h3 class='title'
><a name='ppdEmit'
>ppdEmit()
</a></h3>
299 <p>Emit code for marked options to a file.
</p>
304 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
306 <a href='#ppd_section_t'
>ppd_section_t
</a> section);
309 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
310 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
312 <tr><td><tt>ppd
</tt></td><td>PPD file record
</td></tr>
313 <tr><td><tt>fp
</tt></td><td>File to write to
</td></tr>
314 <tr><td><tt>section
</tt></td><td>Section to write
</td></tr>
315 </tbody></table></div>
317 <p>0 on success, -
1 on failure
</p>
319 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppdEmitAfterOrder'
>ppdEmitAfterOrder()
</a></h3>
321 <p>Emit a subset of the code for marked options to a file.
323 When
"limit
" is non-zero, this function only emits options whose
324 OrderDependency value is greater than or equal to
"min_order
".
326 When
"limit
" is zero, this function is identical to ppdEmit().
333 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
335 <a href='#ppd_section_t'
>ppd_section_t
</a> section,
340 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
341 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
343 <tr><td><tt>ppd
</tt></td><td>PPD file record
</td></tr>
344 <tr><td><tt>fp
</tt></td><td>File to write to
</td></tr>
345 <tr><td><tt>section
</tt></td><td>Section to write
</td></tr>
346 <tr><td><tt>limit
</tt></td><td>Non-zero to use min_order
</td></tr>
347 <tr><td><tt>min_order
</tt></td><td>Lowest OrderDependency
</td></tr>
348 </tbody></table></div>
350 <p>0 on success, -
1 on failure
</p>
352 <h3 class='title'
><a name='ppdEmitFd'
>ppdEmitFd()
</a></h3>
354 <p>Emit code for marked options to a file.
</p>
359 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
361 <a href='#ppd_section_t'
>ppd_section_t
</a> section);
364 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
365 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
367 <tr><td><tt>ppd
</tt></td><td>PPD file record
</td></tr>
368 <tr><td><tt>fd
</tt></td><td>File to write to
</td></tr>
369 <tr><td><tt>section
</tt></td><td>Section to write
</td></tr>
370 </tbody></table></div>
372 <p>0 on success, -
1 on failure
</p>
374 <h3 class='title'
><a name='ppdEmitJCL'
>ppdEmitJCL()
</a></h3>
376 <p>Emit code for JCL options to a file.
</p>
381 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
388 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
389 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
391 <tr><td><tt>ppd
</tt></td><td>PPD file record
</td></tr>
392 <tr><td><tt>fp
</tt></td><td>File to write to
</td></tr>
393 <tr><td><tt>job_id
</tt></td><td>Job ID
</td></tr>
394 <tr><td><tt>user
</tt></td><td>Username
</td></tr>
395 <tr><td><tt>title
</tt></td><td>Title
</td></tr>
396 </tbody></table></div>
398 <p>0 on success, -
1 on failure
</p>
400 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppdEmitJCLEnd'
>ppdEmitJCLEnd()
</a></h3>
402 <p>Emit JCLEnd code to a file.
409 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
413 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
414 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
416 <tr><td><tt>ppd
</tt></td><td>PPD file record
</td></tr>
417 <tr><td><tt>fp
</tt></td><td>File to write to
</td></tr>
418 </tbody></table></div>
420 <p>0 on success, -
1 on failure
</p>
422 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppdEmitString'
>ppdEmitString()
</a></h3>
424 <p>Get a string containing the code for marked options.
426 When
"min_order
" is greater than zero, this function only includes options
427 whose OrderDependency value is greater than or equal to
"min_order
".
428 Otherwise, all options in the specified section are included in the
431 The return string is allocated on the heap and should be freed using
432 free() when you are done with it.
439 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
440 <a href='#ppd_section_t'
>ppd_section_t
</a> section,
444 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
445 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
447 <tr><td><tt>ppd
</tt></td><td>PPD file record
</td></tr>
448 <tr><td><tt>section
</tt></td><td>Section to write
</td></tr>
449 <tr><td><tt>min_order
</tt></td><td>Lowest OrderDependency
</td></tr>
450 </tbody></table></div>
452 <p>String containing option code
</p>
454 <h3 class='title'
><span class='info'
> CUPS
1.1.19 </span><a name='ppdErrorString'
>ppdErrorString()
</a></h3>
456 <p>Returns the text assocated with a status.
463 ppd_status_t status);
466 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
467 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
469 <tr><td><tt>status
</tt></td><td>PPD status
</td></tr>
470 </tbody></table></div>
474 <h3 class='title'
><span class='info'
> CUPS
1.1.19 </span><a name='ppdFindAttr'
>ppdFindAttr()
</a></h3>
476 <p>Find the first matching attribute...
481 <a href='#ppd_attr_t'
>ppd_attr_t
</a> *
483 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
488 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
489 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
491 <tr><td><tt>ppd
</tt></td><td>PPD file data
</td></tr>
492 <tr><td><tt>name
</tt></td><td>Attribute name
</td></tr>
493 <tr><td><tt>spec
</tt></td><td>Specifier string or NULL
</td></tr>
494 </tbody></table></div>
496 <p>Attribute or NULL if not found
</p>
498 <h3 class='title'
><a name='ppdFindChoice'
>ppdFindChoice()
</a></h3>
500 <p>Return a pointer to an option choice.
</p>
503 <a href='#ppd_choice_t'
>ppd_choice_t
</a> *
505 <a href='#ppd_option_t'
>ppd_option_t
</a> * o,
506 const char * choice);
509 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
510 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
512 <tr><td><tt>o
</tt></td><td>Pointer to option
</td></tr>
513 <tr><td><tt>choice
</tt></td><td>Name of choice
</td></tr>
514 </tbody></table></div>
516 <p>Choice pointer or NULL
</p>
518 <h3 class='title'
><a name='ppdFindMarkedChoice'
>ppdFindMarkedChoice()
</a></h3>
520 <p>Return the marked choice for the specified option.
</p>
523 <a href='#ppd_choice_t'
>ppd_choice_t
</a> *
525 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
526 const char * option);
529 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
530 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
532 <tr><td><tt>ppd
</tt></td><td>PPD file
</td></tr>
533 <tr><td><tt>option
</tt></td><td>Keyword/option name
</td></tr>
534 </tbody></table></div>
536 <p>Pointer to choice or NULL
</p>
538 <h3 class='title'
><span class='info'
> CUPS
1.1.19 </span><a name='ppdFindNextAttr'
>ppdFindNextAttr()
</a></h3>
540 <p>Find the next matching attribute...
545 <a href='#ppd_attr_t'
>ppd_attr_t
</a> *
547 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
552 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
553 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
555 <tr><td><tt>ppd
</tt></td><td>PPD file data
</td></tr>
556 <tr><td><tt>name
</tt></td><td>Attribute name
</td></tr>
557 <tr><td><tt>spec
</tt></td><td>Specifier string or NULL
</td></tr>
558 </tbody></table></div>
560 <p>Attribute or NULL if not found
</p>
562 <h3 class='title'
><a name='ppdFindOption'
>ppdFindOption()
</a></h3>
564 <p>Return a pointer to the specified option.
</p>
567 <a href='#ppd_option_t'
>ppd_option_t
</a> *
569 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
570 const char * option);
573 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
574 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
576 <tr><td><tt>ppd
</tt></td><td>PPD file data
</td></tr>
577 <tr><td><tt>option
</tt></td><td>Option/Keyword name
</td></tr>
578 </tbody></table></div>
580 <p>Pointer to option or NULL
</p>
582 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppdFirstOption'
>ppdFirstOption()
</a></h3>
584 <p>Return the first option in the PPD file.
586 Options are returned from all groups in sorted order.
591 <a href='#ppd_option_t'
>ppd_option_t
</a> *
593 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd);
596 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
597 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
599 <tr><td><tt>ppd
</tt></td><td>PPD file
</td></tr>
600 </tbody></table></div>
602 <p>First option or NULL
</p>
604 <h3 class='title'
><a name='ppdIsMarked'
>ppdIsMarked()
</a></h3>
606 <p>Check to see if an option is marked...
</p>
611 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
613 const char * choice);
616 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
617 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
619 <tr><td><tt>ppd
</tt></td><td>PPD file data
</td></tr>
620 <tr><td><tt>option
</tt></td><td>Option/Keyword name
</td></tr>
621 <tr><td><tt>choice
</tt></td><td>Choice name
</td></tr>
622 </tbody></table></div>
624 <p>Non-zero if option is marked
</p>
626 <h3 class='title'
><span class='info'
> CUPS
1.1.19 </span><a name='ppdLastError'
>ppdLastError()
</a></h3>
628 <p>Return the status from the last ppdOpen*().
638 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
639 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
641 <tr><td><tt>line
</tt></td><td>Line number
</td></tr>
642 </tbody></table></div>
646 <h3 class='title'
><a name='ppdMarkDefaults'
>ppdMarkDefaults()
</a></h3>
648 <p>Mark all default options in the PPD file.
</p>
653 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd);
656 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
657 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
659 <tr><td><tt>ppd
</tt></td><td>PPD file record
</td></tr>
660 </tbody></table></div>
664 <h3 class='title'
><a name='ppdMarkOption'
>ppdMarkOption()
</a></h3>
666 <p>Mark an option in a PPD file.
670 -
1 is returned if the given option would conflict with any currently
676 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
678 const char * choice);
681 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
682 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
684 <tr><td><tt>ppd
</tt></td><td>PPD file record
</td></tr>
685 <tr><td><tt>option
</tt></td><td>Keyword
</td></tr>
686 <tr><td><tt>choice
</tt></td><td>Option name
</td></tr>
687 </tbody></table></div>
689 <p>Number of conflicts
</p>
691 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppdNextOption'
>ppdNextOption()
</a></h3>
693 <p>Return the next option in the PPD file.
695 Options are returned from all groups in sorted order.
700 <a href='#ppd_option_t'
>ppd_option_t
</a> *
702 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd);
705 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
706 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
708 <tr><td><tt>ppd
</tt></td><td>PPD file
</td></tr>
709 </tbody></table></div>
711 <p>Next option or NULL
</p>
713 <h3 class='title'
><a name='ppdOpen'
>ppdOpen()
</a></h3>
715 <p>Read a PPD file into memory.
</p>
718 <a href='#ppd_file_t'
>ppd_file_t
</a> *
723 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
724 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
726 <tr><td><tt>fp
</tt></td><td>File to read from
</td></tr>
727 </tbody></table></div>
729 <p>PPD file record
</p>
731 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppdOpen2'
>ppdOpen2()
</a></h3>
733 <p>Read a PPD file into memory.
738 <a href='#ppd_file_t'
>ppd_file_t
</a> *
743 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
744 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
746 <tr><td><tt>fp
</tt></td><td>File to read from
</td></tr>
747 </tbody></table></div>
749 <p>PPD file record
</p>
751 <h3 class='title'
><a name='ppdOpenFd'
>ppdOpenFd()
</a></h3>
753 <p>Read a PPD file into memory.
</p>
756 <a href='#ppd_file_t'
>ppd_file_t
</a> *
761 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
762 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
764 <tr><td><tt>fd
</tt></td><td>File to read from
</td></tr>
765 </tbody></table></div>
767 <p>PPD file record
</p>
769 <h3 class='title'
><a name='ppdOpenFile'
>ppdOpenFile()
</a></h3>
771 <p>Read a PPD file into memory.
</p>
774 <a href='#ppd_file_t'
>ppd_file_t
</a> *
776 const char * filename);
779 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
780 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
782 <tr><td><tt>filename
</tt></td><td>File to read from
</td></tr>
783 </tbody></table></div>
785 <p>PPD file record
</p>
787 <h3 class='title'
><a name='ppdPageLength'
>ppdPageLength()
</a></h3>
789 <p>Get the page length for the given size.
</p>
794 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
798 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
799 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
801 <tr><td><tt>ppd
</tt></td><td>PPD file
</td></tr>
802 <tr><td><tt>name
</tt></td><td>Size name
</td></tr>
803 </tbody></table></div>
805 <p>Length of page in points or
0.0</p>
807 <h3 class='title'
><a name='ppdPageSize'
>ppdPageSize()
</a></h3>
809 <p>Get the page size record for the given size.
</p>
812 <a href='#ppd_size_t'
>ppd_size_t
</a> *
814 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
818 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
819 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
821 <tr><td><tt>ppd
</tt></td><td>PPD file record
</td></tr>
822 <tr><td><tt>name
</tt></td><td>Size name
</td></tr>
823 </tbody></table></div>
825 <p>Size record for page or NULL
</p>
827 <h3 class='title'
><a name='ppdPageWidth'
>ppdPageWidth()
</a></h3>
829 <p>Get the page width for the given size.
</p>
834 <a href='#ppd_file_t'
>ppd_file_t
</a> * ppd,
838 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
839 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
841 <tr><td><tt>ppd
</tt></td><td>PPD file record
</td></tr>
842 <tr><td><tt>name
</tt></td><td>Size name
</td></tr>
843 </tbody></table></div>
845 <p>Width of page in points or
0.0</p>
847 <h3 class='title'
><span class='info'
> CUPS
1.1.20 </span><a name='ppdSetConformance'
>ppdSetConformance()
</a></h3>
849 <p>Set the conformance level for PPD files.
856 <a href='#ppd_conform_t'
>ppd_conform_t
</a> c);
859 <div class='table'
><table align='center' border='
1' width='
80%' cellpadding='
5' cellspacing='
0'
>
860 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
862 <tr><td><tt>c
</tt></td><td>Conformance level
</td></tr>
863 </tbody></table></div>
867 <h2 class='title'
><a name='STRUCTURES'
>Structures
</a></h2>
869 <li><a href='#ppd_attr_s'
><tt>ppd_attr_s
</tt></a> <span class='info'
> CUPS
1.1.19 </span></li>
870 <li><a href='#ppd_choice_s'
><tt>ppd_choice_s
</tt></a> </li>
871 <li><a href='#ppd_coption_s'
><tt>ppd_coption_s
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
872 <li><a href='#ppd_cparam_s'
><tt>ppd_cparam_s
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
873 <li><a href='#ppd_emul_s'
><tt>ppd_emul_s
</tt></a> </li>
874 <li><a href='#ppd_file_s'
><tt>ppd_file_s
</tt></a> </li>
875 <li><a href='#ppd_group_s'
><tt>ppd_group_s
</tt></a> </li>
876 <li><a href='#ppd_option_s'
><tt>ppd_option_s
</tt></a> </li>
877 <li><a href='#ppd_profile_s'
><tt>ppd_profile_s
</tt></a> </li>
878 <li><a href='#ppd_size_s'
><tt>ppd_size_s
</tt></a> </li>
881 <h3 class='title'
><span class='info'
> CUPS
1.1.19 </span><a name='ppd_attr_s'
>ppd_attr_s
</a></h3>
883 <p>PPD Attribute Structure
</p>
888 char name[PPD_MAX_NAME];
889 char spec[PPD_MAX_NAME];
890 char text[PPD_MAX_TEXT];
895 <div class='table'
><table align='center' border='
1' width='
80%'
>
896 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
898 <tr><td><tt>name[PPD_MAX_NAME]
</tt> </td><td>Name of attribute (cupsXYZ)
</td></tr>
899 <tr><td><tt>spec[PPD_MAX_NAME]
</tt> </td><td>Specifier string, if any
</td></tr>
900 <tr><td><tt>text[PPD_MAX_TEXT]
</tt> </td><td>Human-readable text, if any
</td></tr>
901 <tr><td><tt>value
</tt> </td><td>Value string
</td></tr>
902 </tbody></table></div>
904 <h3 class='title'
><a name='ppd_choice_s'
>ppd_choice_s
</a></h3>
906 <p>Option choices
</p>
911 char choice[PPD_MAX_NAME];
914 <a href='#ppd_option_t'
>ppd_option_t
</a> * option;
915 char text[PPD_MAX_TEXT];
919 <div class='table'
><table align='center' border='
1' width='
80%'
>
920 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
922 <tr><td><tt>choice[PPD_MAX_NAME]
</tt> </td><td>Computer-readable option name
</td></tr>
923 <tr><td><tt>code
</tt> </td><td>Code to send for this option
</td></tr>
924 <tr><td><tt>marked
</tt> </td><td>0 if not selected,
1 otherwise
</td></tr>
925 <tr><td><tt>option
</tt> </td><td>Pointer to parent option structure
</td></tr>
926 <tr><td><tt>text[PPD_MAX_TEXT]
</tt> </td><td>Human-readable option name
</td></tr>
927 </tbody></table></div>
929 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppd_coption_s'
>ppd_coption_s
</a></h3>
931 <p>Custom Option
</p>
936 char keyword[PPD_MAX_NAME];
938 <a href='#ppd_option_t'
>ppd_option_t
</a> * option;
939 cups_array_t * params;
943 <div class='table'
><table align='center' border='
1' width='
80%'
>
944 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
946 <tr><td><tt>keyword[PPD_MAX_NAME]
</tt> </td><td>Name of option that is being extended...
</td></tr>
947 <tr><td><tt>marked
</tt> </td><td>Extended option is marked
</td></tr>
948 <tr><td><tt>option
</tt> </td><td>Option that is being extended...
</td></tr>
949 <tr><td><tt>params
</tt> </td><td>Parameters
</td></tr>
950 </tbody></table></div>
952 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppd_cparam_s'
>ppd_cparam_s
</a></h3>
954 <p>Custom Parameter
</p>
959 <a href='#ppd_cpvalue_t'
>ppd_cpvalue_t
</a> current;
960 <a href='#ppd_cplimit_t'
>ppd_cplimit_t
</a> minimum, maximum;
961 char name[PPD_MAX_NAME];
963 char text[PPD_MAX_TEXT];
964 <a href='#ppd_cptype_t'
>ppd_cptype_t
</a> type;
968 <div class='table'
><table align='center' border='
1' width='
80%'
>
969 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
971 <tr><td><tt>current
</tt> </td><td>Current value
</td></tr>
972 <tr><td><tt>maximum
</tt> </td><td>Maximum value
</td></tr>
973 <tr><td><tt>name[PPD_MAX_NAME]
</tt> </td><td>Parameter name
</td></tr>
974 <tr><td><tt>order
</tt> </td><td>Order (
0 to N)
</td></tr>
975 <tr><td><tt>text[PPD_MAX_TEXT]
</tt> </td><td>Human-readable text
</td></tr>
976 <tr><td><tt>type
</tt> </td><td>Parameter type
</td></tr>
977 </tbody></table></div>
979 <h3 class='title'
><a name='ppd_emul_s'
>ppd_emul_s
</a></h3>
986 char name[PPD_MAX_NAME];
992 <div class='table'
><table align='center' border='
1' width='
80%'
>
993 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
995 <tr><td><tt>name[PPD_MAX_NAME]
</tt> </td><td>Emulator name
</td></tr>
996 <tr><td><tt>start
</tt> </td><td>Code to switch to this emulation
</td></tr>
997 <tr><td><tt>stop
</tt> </td><td>Code to stop this emulation
</td></tr>
998 </tbody></table></div>
1000 <h3 class='title'
><a name='ppd_file_s'
>ppd_file_s
</a></h3>
1001 <h4>Description
</h4>
1007 int accurate_screens;
1008 <a href='#ppd_attr_t'
>ppd_attr_t
</a> ** attrs;
1010 ppd_cs_t colorspace;
1011 <a href='#ppd_const_t'
>ppd_const_t
</a> * consts;
1013 cups_array_t * coptions;
1015 float custom_margins[
4];
1016 float custom_max[
2];
1017 float custom_min[
2];
1018 <a href='#ppd_emul_t'
>ppd_emul_t
</a> * emulations;
1022 <a href='#ppd_group_t'
>ppd_group_t
</a> * groups;
1027 char * lang_encoding;
1028 char * lang_version;
1031 char * manufacturer;
1043 cups_array_t * options;
1047 <a href='#ppd_profile_t'
>ppd_profile_t
</a> * profiles;
1049 char * shortnickname;
1050 <a href='#ppd_size_t'
>ppd_size_t
</a> * sizes;
1051 cups_array_t * sorted_attrs;
1053 char * ttrasterizer;
1058 <div class='table'
><table align='center' border='
1' width='
80%'
>
1059 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
1061 <tr><td><tt>accurate_screens
</tt> </td><td>1 = supports accurate screens,
0 = not
</td></tr>
1062 <tr><td><tt>attrs
</tt> <span class='info'
> CUPS
1.1.19 </span></td><td>Attributes @private@
</td></tr>
1063 <tr><td><tt>color_device
</tt> </td><td>1 = color device,
0 = grayscale
</td></tr>
1064 <tr><td><tt>colorspace
</tt> </td><td>Default colorspace
</td></tr>
1065 <tr><td><tt>consts
</tt> </td><td>UI/Non-UI constraints
</td></tr>
1066 <tr><td><tt>contone_only
</tt> </td><td>1 = continuous tone only,
0 = not
</td></tr>
1067 <tr><td><tt>coptions
</tt> <span class='info'
> CUPS
1.2 </span></td><td>Custom options array @private@
</td></tr>
1068 <tr><td><tt>cur_attr
</tt> <span class='info'
> CUPS
1.1.19 </span></td><td>Current attribute @private@
</td></tr>
1069 <tr><td><tt>custom_margins[
4]
</tt> </td><td>Margins around page
</td></tr>
1070 <tr><td><tt>custom_max[
2]
</tt> </td><td>Maximum variable page size
</td></tr>
1071 <tr><td><tt>custom_min[
2]
</tt> </td><td>Minimum variable page size
</td></tr>
1072 <tr><td><tt>emulations
</tt> </td><td>Emulations and the code to invoke them
</td></tr>
1073 <tr><td><tt>filters
</tt> </td><td>Filter strings...
</td></tr>
1074 <tr><td><tt>flip_duplex
</tt> <span class='info'
> CUPS
1.1 </span></td><td>1 = Flip page for back sides
</td></tr>
1075 <tr><td><tt>fonts
</tt> </td><td>Pre-loaded fonts
</td></tr>
1076 <tr><td><tt>groups
</tt> </td><td>UI groups
</td></tr>
1077 <tr><td><tt>jcl_begin
</tt> </td><td>Start JCL commands
</td></tr>
1078 <tr><td><tt>jcl_end
</tt> </td><td>End JCL commands
</td></tr>
1079 <tr><td><tt>jcl_ps
</tt> </td><td>Enter PostScript interpreter
</td></tr>
1080 <tr><td><tt>landscape
</tt> </td><td>-
90 or
90</td></tr>
1081 <tr><td><tt>lang_encoding
</tt> </td><td>Language encoding
</td></tr>
1082 <tr><td><tt>lang_version
</tt> </td><td>Language version (English, Spanish, etc.)
</td></tr>
1083 <tr><td><tt>language_level
</tt> </td><td>Language level of device
</td></tr>
1084 <tr><td><tt>manual_copies
</tt> </td><td>1 = Copies done manually,
0 = hardware
</td></tr>
1085 <tr><td><tt>manufacturer
</tt> </td><td>Manufacturer name
</td></tr>
1086 <tr><td><tt>model_number
</tt> </td><td>Device-specific model number
</td></tr>
1087 <tr><td><tt>modelname
</tt> </td><td>Model name (general)
</td></tr>
1088 <tr><td><tt>nickname
</tt> </td><td>Nickname (specific)
</td></tr>
1089 <tr><td><tt>num_attrs
</tt> <span class='info'
> CUPS
1.1.19 </span></td><td>Number of attributes @private@
</td></tr>
1090 <tr><td><tt>num_consts
</tt> </td><td>Number of UI/Non-UI constraints
</td></tr>
1091 <tr><td><tt>num_emulations
</tt> </td><td>Number of emulations supported
</td></tr>
1092 <tr><td><tt>num_filters
</tt> </td><td>Number of filters
</td></tr>
1093 <tr><td><tt>num_fonts
</tt> </td><td>Number of pre-loaded fonts
</td></tr>
1094 <tr><td><tt>num_groups
</tt> </td><td>Number of UI groups
</td></tr>
1095 <tr><td><tt>num_profiles
</tt> </td><td>Number of sRGB color profiles
</td></tr>
1096 <tr><td><tt>num_sizes
</tt> </td><td>Number of page sizes
</td></tr>
1097 <tr><td><tt>options
</tt> <span class='info'
> CUPS
1.2 </span></td><td>Option lookup array @private@
</td></tr>
1098 <tr><td><tt>patches
</tt> </td><td>Patch commands to be sent to printer
</td></tr>
1099 <tr><td><tt>pcfilename
</tt> <span class='info'
> CUPS
1.1.19 </span></td><td>PCFileName string
</td></tr>
1100 <tr><td><tt>product
</tt> </td><td>Product name (from PS RIP/interpreter)
</td></tr>
1101 <tr><td><tt>profiles
</tt> </td><td>sRGB color profiles
</td></tr>
1102 <tr><td><tt>protocols
</tt> <span class='info'
> CUPS
1.1.19 </span></td><td>Protocols (BCP, TBCP) string
</td></tr>
1103 <tr><td><tt>shortnickname
</tt> </td><td>Short version of nickname
</td></tr>
1104 <tr><td><tt>sizes
</tt> </td><td>Page sizes
</td></tr>
1105 <tr><td><tt>sorted_attrs
</tt> <span class='info'
> CUPS
1.2 </span></td><td>Attribute lookup array @private@
</td></tr>
1106 <tr><td><tt>throughput
</tt> </td><td>Pages per minute
</td></tr>
1107 <tr><td><tt>ttrasterizer
</tt> </td><td>Truetype rasterizer
</td></tr>
1108 <tr><td><tt>variable_sizes
</tt> </td><td>1 = supports variable sizes,
0 = doesn't
</td></tr>
1109 </tbody></table></div>
1111 <h3 class='title'
><a name='ppd_group_s'
>ppd_group_s
</a></h3>
1112 <h4>Description
</h4>
1118 char text[PPD_MAX_TEXT - PPD_MAX_NAME];
1119 char name[PPD_MAX_NAME];
1122 <a href='#ppd_option_t'
>ppd_option_t
</a> * options;
1123 struct
<a href='#ppd_group_s'
>ppd_group_s
</a> * subgroups;
1127 <div class='table'
><table align='center' border='
1' width='
80%'
>
1128 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
1130 <tr><td><tt>PPD_MAX_NAME]
</tt> </td><td>Human-readable group name
</td></tr>
1131 <tr><td><tt>name[PPD_MAX_NAME]
</tt> <span class='info'
> CUPS
1.1.18 </span></td><td>Group name
</td></tr>
1132 <tr><td><tt>num_options
</tt> </td><td>Number of options
</td></tr>
1133 <tr><td><tt>num_subgroups
</tt> </td><td>Number of sub-groups
</td></tr>
1134 <tr><td><tt>options
</tt> </td><td>Options
</td></tr>
1135 <tr><td><tt>subgroups
</tt> </td><td>Sub-groups (max depth =
1)
</td></tr>
1136 </tbody></table></div>
1138 <h3 class='title'
><a name='ppd_option_s'
>ppd_option_s
</a></h3>
1139 <h4>Description
</h4>
1145 <a href='#ppd_choice_t'
>ppd_choice_t
</a> * choices;
1147 char defchoice[PPD_MAX_NAME];
1148 char keyword[PPD_MAX_NAME];
1151 <a href='#ppd_section_t'
>ppd_section_t
</a> section;
1152 char text[PPD_MAX_TEXT];
1153 <a href='#ppd_ui_t'
>ppd_ui_t
</a> ui;
1157 <div class='table'
><table align='center' border='
1' width='
80%'
>
1158 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
1160 <tr><td><tt>choices
</tt> </td><td>Option choices
</td></tr>
1161 <tr><td><tt>conflicted
</tt> </td><td>0 if no conflicts exist,
1 otherwise
</td></tr>
1162 <tr><td><tt>defchoice[PPD_MAX_NAME]
</tt> </td><td>Default option choice
</td></tr>
1163 <tr><td><tt>keyword[PPD_MAX_NAME]
</tt> </td><td>Option keyword name (
"PageSize
", etc.)
</td></tr>
1164 <tr><td><tt>num_choices
</tt> </td><td>Number of option choices
</td></tr>
1165 <tr><td><tt>order
</tt> </td><td>Order number
</td></tr>
1166 <tr><td><tt>section
</tt> </td><td>Section for command
</td></tr>
1167 <tr><td><tt>text[PPD_MAX_TEXT]
</tt> </td><td>Human-readable text
</td></tr>
1168 <tr><td><tt>ui
</tt> </td><td>Type of UI option
</td></tr>
1169 </tbody></table></div>
1171 <h3 class='title'
><a name='ppd_profile_s'
>ppd_profile_s
</a></h3>
1172 <h4>Description
</h4>
1173 <p>sRGB Color Profiles
</p>
1176 struct ppd_profile_s
1181 char media_type[PPD_MAX_NAME];
1182 char resolution[PPD_MAX_NAME];
1186 <div class='table'
><table align='center' border='
1' width='
80%'
>
1187 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
1189 <tr><td><tt>density
</tt> </td><td>Ink density to use
</td></tr>
1190 <tr><td><tt>gamma
</tt> </td><td>Gamma correction to use
</td></tr>
1191 <tr><td><tt>matrix[
3][
3]
</tt> </td><td>Transform matrix
</td></tr>
1192 <tr><td><tt>media_type[PPD_MAX_NAME]
</tt> </td><td>Media type or
"-
"</td></tr>
1193 <tr><td><tt>resolution[PPD_MAX_NAME]
</tt> </td><td>Resolution or
"-
"</td></tr>
1194 </tbody></table></div>
1196 <h3 class='title'
><a name='ppd_size_s'
>ppd_size_s
</a></h3>
1197 <h4>Description
</h4>
1207 char name[PPD_MAX_NAME];
1214 <div class='table'
><table align='center' border='
1' width='
80%'
>
1215 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
1217 <tr><td><tt>bottom
</tt> </td><td>Bottom printable margin in points
</td></tr>
1218 <tr><td><tt>left
</tt> </td><td>Left printable margin in points
</td></tr>
1219 <tr><td><tt>length
</tt> </td><td>Length of media in points
</td></tr>
1220 <tr><td><tt>marked
</tt> </td><td>Page size selected?
</td></tr>
1221 <tr><td><tt>name[PPD_MAX_NAME]
</tt> </td><td>Media size option
</td></tr>
1222 <tr><td><tt>right
</tt> </td><td>Right printable margin in points
</td></tr>
1223 <tr><td><tt>top
</tt> </td><td>Top printable margin in points
</td></tr>
1224 <tr><td><tt>width
</tt> </td><td>Width of media in points
</td></tr>
1225 </tbody></table></div>
1227 <h2 class='title'
><a name='TYPES'
>Types
</a></h2>
1229 <li><a href='#ppd_attr_t'
><tt>ppd_attr_t
</tt></a> <span class='info'
> CUPS
1.1.19 </span></li>
1230 <li><a href='#ppd_choice_t'
><tt>ppd_choice_t
</tt></a> </li>
1231 <li><a href='#ppd_const_t'
><tt>ppd_const_t
</tt></a> </li>
1232 <li><a href='#ppd_coption_t'
><tt>ppd_coption_t
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
1233 <li><a href='#ppd_cparam_t'
><tt>ppd_cparam_t
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
1234 <li><a href='#ppd_cplimit_t'
><tt>ppd_cplimit_t
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
1235 <li><a href='#ppd_cptype_t'
><tt>ppd_cptype_t
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
1236 <li><a href='#ppd_cpvalue_t'
><tt>ppd_cpvalue_t
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
1237 <li><a href='#ppd_emul_t'
><tt>ppd_emul_t
</tt></a> </li>
1238 <li><a href='#ppd_file_t'
><tt>ppd_file_t
</tt></a> </li>
1239 <li><a href='#ppd_group_t'
><tt>ppd_group_t
</tt></a> </li>
1240 <li><a href='#ppd_option_t'
><tt>ppd_option_t
</tt></a> </li>
1241 <li><a href='#ppd_profile_t'
><tt>ppd_profile_t
</tt></a> </li>
1242 <li><a href='#ppd_section_t'
><tt>ppd_section_t
</tt></a> </li>
1243 <li><a href='#ppd_size_t'
><tt>ppd_size_t
</tt></a> </li>
1244 <li><a href='#ppd_ui_t'
><tt>ppd_ui_t
</tt></a> </li>
1247 <h3 class='title'
><span class='info'
> CUPS
1.1.19 </span><a name='ppd_attr_t'
>ppd_attr_t
</a></h3>
1248 <h4>Description
</h4>
1249 <p>PPD Attribute Structure
</p>
1252 typedef struct
<a href='#ppd_attr_s'
>ppd_attr_s
</a> ppd_attr_t;
1255 <h3 class='title'
><a name='ppd_choice_t'
>ppd_choice_t
</a></h3>
1256 <h4>Description
</h4>
1257 <p>Option choices
</p>
1260 typedef struct
<a href='#ppd_choice_s'
>ppd_choice_s
</a> ppd_choice_t;
1263 <h3 class='title'
><a name='ppd_const_t'
>ppd_const_t
</a></h3>
1264 <h4>Description
</h4>
1268 typedef struct ppd_const_t;
1271 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppd_coption_t'
>ppd_coption_t
</a></h3>
1272 <h4>Description
</h4>
1273 <p>Custom Option
</p>
1276 typedef struct
<a href='#ppd_coption_s'
>ppd_coption_s
</a> ppd_coption_t;
1279 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppd_cparam_t'
>ppd_cparam_t
</a></h3>
1280 <h4>Description
</h4>
1281 <p>Custom Parameter
</p>
1284 typedef struct
<a href='#ppd_cparam_s'
>ppd_cparam_s
</a> ppd_cparam_t;
1287 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppd_cplimit_t'
>ppd_cplimit_t
</a></h3>
1288 <h4>Description
</h4>
1289 <p>Custom Parameter Limit
</p>
1292 typedef union
<a href='#ppd_cplimit_u'
>ppd_cplimit_u
</a> ppd_cplimit_t;
1295 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppd_cptype_t'
>ppd_cptype_t
</a></h3>
1296 <h4>Description
</h4>
1297 <p>Custom Parameter Type
</p>
1300 typedef enum
<a href='#ppd_cptype_e'
>ppd_cptype_e
</a> ppd_cptype_t;
1303 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppd_cpvalue_t'
>ppd_cpvalue_t
</a></h3>
1304 <h4>Description
</h4>
1305 <p>Custom Parameter Value
</p>
1308 typedef union
<a href='#ppd_cpvalue_u'
>ppd_cpvalue_u
</a> ppd_cpvalue_t;
1311 <h3 class='title'
><a name='ppd_emul_t'
>ppd_emul_t
</a></h3>
1312 <h4>Description
</h4>
1316 typedef struct
<a href='#ppd_emul_s'
>ppd_emul_s
</a> ppd_emul_t;
1319 <h3 class='title'
><a name='ppd_file_t'
>ppd_file_t
</a></h3>
1320 <h4>Description
</h4>
1324 typedef struct
<a href='#ppd_file_s'
>ppd_file_s
</a> ppd_file_t;
1327 <h3 class='title'
><a name='ppd_group_t'
>ppd_group_t
</a></h3>
1328 <h4>Description
</h4>
1332 typedef struct
<a href='#ppd_group_s'
>ppd_group_s
</a> ppd_group_t;
1335 <h3 class='title'
><a name='ppd_option_t'
>ppd_option_t
</a></h3>
1336 <h4>Description
</h4>
1340 typedef struct
<a href='#ppd_option_s'
>ppd_option_s
</a> ppd_option_t;
1343 <h3 class='title'
><a name='ppd_profile_t'
>ppd_profile_t
</a></h3>
1344 <h4>Description
</h4>
1345 <p>sRGB Color Profiles
</p>
1348 typedef struct
<a href='#ppd_profile_s'
>ppd_profile_s
</a> ppd_profile_t;
1351 <h3 class='title'
><a name='ppd_section_t'
>ppd_section_t
</a></h3>
1352 <h4>Description
</h4>
1353 <p>Order dependency sections
</p>
1356 typedef enum
<a href='#ppd_section_e'
>ppd_section_e
</a> ppd_section_t;
1359 <h3 class='title'
><a name='ppd_size_t'
>ppd_size_t
</a></h3>
1360 <h4>Description
</h4>
1364 typedef struct
<a href='#ppd_size_s'
>ppd_size_s
</a> ppd_size_t;
1367 <h3 class='title'
><a name='ppd_ui_t'
>ppd_ui_t
</a></h3>
1368 <h4>Description
</h4>
1372 typedef enum
<a href='#ppd_ui_e'
>ppd_ui_e
</a> ppd_ui_t;
1375 <h2 class='title'
><a name='UNIONS'
>Unions
</a></h2>
1377 <li><a href='#ppd_cplimit_u'
><tt>ppd_cplimit_u
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
1378 <li><a href='#ppd_cpvalue_u'
><tt>ppd_cpvalue_u
</tt></a> <span class='info'
> CUPS
1.2 </span></li>
1381 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppd_cplimit_u'
>ppd_cplimit_u
</a></h3>
1382 <h4>Description
</h4>
1383 <p>Custom Parameter Limit
</p>
1390 float custom_invcurve;
1391 int custom_passcode;
1392 int custom_password;
1393 float custom_points;
1399 <div class='table'
><table align='center' border='
1' width='
80%'
>
1400 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
1402 <tr><td><tt>custom_curve
</tt> </td><td>Gamma value
</td></tr>
1403 <tr><td><tt>custom_int
</tt> </td><td>Integer value
</td></tr>
1404 <tr><td><tt>custom_invcurve
</tt> </td><td>Gamma value
</td></tr>
1405 <tr><td><tt>custom_passcode
</tt> </td><td>Passcode length
</td></tr>
1406 <tr><td><tt>custom_password
</tt> </td><td>Password length
</td></tr>
1407 <tr><td><tt>custom_points
</tt> </td><td>Measurement value
</td></tr>
1408 <tr><td><tt>custom_real
</tt> </td><td>Real value
</td></tr>
1409 <tr><td><tt>custom_string
</tt> </td><td>String length
</td></tr>
1410 </tbody></table></div>
1412 <h3 class='title'
><span class='info'
> CUPS
1.2 </span><a name='ppd_cpvalue_u'
>ppd_cpvalue_u
</a></h3>
1413 <h4>Description
</h4>
1414 <p>Custom Parameter Value
</p>
1421 float custom_invcurve;
1422 char * custom_passcode;
1423 char * custom_password;
1424 float custom_points;
1426 char * custom_string;
1430 <div class='table'
><table align='center' border='
1' width='
80%'
>
1431 <thead><tr><th>Name
</th><th>Description
</th></tr></thead>
1433 <tr><td><tt>custom_curve
</tt> </td><td>Gamma value
</td></tr>
1434 <tr><td><tt>custom_int
</tt> </td><td>Integer value
</td></tr>
1435 <tr><td><tt>custom_invcurve
</tt> </td><td>Gamma value
</td></tr>
1436 <tr><td><tt>custom_passcode
</tt> </td><td>Passcode value
</td></tr>
1437 <tr><td><tt>custom_password
</tt> </td><td>Password value
</td></tr>
1438 <tr><td><tt>custom_points
</tt> </td><td>Measurement value
</td></tr>
1439 <tr><td><tt>custom_real
</tt> </td><td>Real value
</td></tr>
1440 <tr><td><tt>custom_string
</tt> </td><td>String value
</td></tr>
1441 </tbody></table></div>