]>
Commit | Line | Data |
---|---|---|
ef416fc2 | 1 | <!-- |
c07d5b2d | 2 | "$Id: api-ppd.shtml 177 2006-06-21 00:20:03Z jlovell $" |
ef416fc2 | 3 | |
4 | PPD API introduction for the Common UNIX Printing System (CUPS). | |
5 | ||
ecdc0628 | 6 | Copyright 1997-2006 by Easy Software Products. |
ef416fc2 | 7 | |
8 | These coded instructions, statements, and computer programs are the | |
9 | property of Easy Software Products and are protected by Federal | |
10 | copyright law. Distribution and use rights are outlined in the file | |
11 | "LICENSE.txt" which should have been included with this file. If this | |
12 | file is missing or damaged please contact Easy Software Products | |
13 | at: | |
14 | ||
15 | Attn: CUPS Licensing Information | |
16 | Easy Software Products | |
17 | 44141 Airport View Drive, Suite 204 | |
18 | Hollywood, Maryland 20636 USA | |
19 | ||
20 | Voice: (301) 373-9600 | |
21 | EMail: cups-info@cups.org | |
22 | WWW: http://www.cups.org | |
23 | --> | |
24 | ||
25 | <h2 class='title'>Introduction</h2> | |
26 | ||
ecdc0628 | 27 | <p>The CUPS PPD API provides read-only access the data in |
28 | PostScript Printer Description ("PPD") files. With it you can | |
29 | display printer options to users, mark option choices and check | |
30 | for conflicting choices, and output marked choices in PostScript | |
31 | output.</p> | |
ef416fc2 | 32 | |
33 | <h2 class='title'>General Usage</h2> | |
34 | ||
35 | <p>The <var><cups/ppd.h></var> header file must be included | |
36 | to use the <tt>ppd</tt> functions.</p> | |
37 | ||
38 | <p>Programs using these functions must be linked to the CUPS | |
39 | library: <var>libcups.a</var>, <var>libcups.so.2</var>, | |
40 | <var>libcups.2.dylib</var>, <var>libcups_s.a</var>, or | |
41 | <var>libcups2.lib</var> depending on the platform. The following | |
42 | command compiles <var>myprogram.c</var> using GCC and the CUPS | |
43 | library:</p> | |
44 | ||
45 | <pre class='command'> | |
46 | <kbd>gcc -o myprogram myprogram.c -lcups</kbd> | |
47 | </pre> | |
48 | ||
49 | <h2 class='title'>Compatibility</h2> | |
50 | ||
51 | <p>Unless otherwise specified, the PPD API functions require CUPS | |
52 | 1.1 or higher.</p> |