Release 20040914.
[wine/gsoc-2012-control.git] / documentation / printing.sgml
blobd8122e85e644e5dfabf59bd1a20fbeb4149fb054
1 <sect1 id="config-printing">
2 <title>Printing in Wine</title>
3 <para>How to print documents in Wine...</para>
5 <sect2 id="config-printing-intro">
6 <title>Printing</title>
8 <para>
9 Printing in Wine can be done using the built-in Wine PostScript driver (+ ghostscript to produce
10 output for non-PostScript printers).
11 </para>
12 <para>
13 Note that at the moment WinPrinters (cheap, dumb printers that require
14 the host computer to explicitly control the head) will not work with
15 their Windows printer drivers. It is unclear whether they ever will.
16 </para>
18 <sect3>
19 <title>Built-in Wine PostScript driver</title>
20 <para>
21 Enables printing of PostScript files via a driver built into Wine. See
22 below for installation instructions. The code for the PostScript
23 driver is in <filename>dlls/wineps/</filename>.
24 </para>
25 <para>
26 The driver behaves as if it were a DRV file called
27 <filename>wineps.drv</filename> which at the moment is built into
28 Wine.
29 Although it mimics a 16 bit driver, it will work with both 16 and 32
30 bit apps, just as win9x drivers do.
31 </para>
32 </sect3>
34 <sect3>
35 <title>Spooling</title>
36 <para>
37 Spooling is rather primitive. The [spooler] section of
38 the wine config file maps a port (e.g.
39 <systemitem>LPT1:</systemitem>) to a file or a command via a pipe. For
40 example the following lines
41 </para>
42 <screen>
43 "LPT1:" = "foo.ps"
44 "LPT2:" = "|lpr"
45 </screen>
46 <para>
47 map <systemitem>LPT1:</systemitem> to file <filename>foo.ps</filename>
48 and <systemitem>LPT2:</systemitem> to the <command>lpr</command>
49 command. If a job is sent to an unlisted port, then a file is created
50 with that port's name; e.g. for <systemitem>LPT3:</systemitem> a file
51 called <systemitem>LPT3:</systemitem> would be created.
52 </para>
53 <para>
54 There are now also virtual spool queues called
55 <systemitem>LPR:printername</systemitem>, which send the data
56 to <command>lpr -Pprintername</command>. You do not need to
57 specify those in the config file, they are handled automatically by
58 <filename>dlls/gdi/printdrv.c</filename>.
59 </para>
60 </sect3>
61 </sect2>
63 <sect2 id="config-printing-psdriver">
64 <title>The Wine PostScript Driver</title>
66 <para>
67 This allows Wine to generate PostScript files without
68 needing an external printer driver. Wine in this case uses the
69 system provided PostScript printer filters, which almost all use
70 ghostscript if necessary. Those should be configured during the
71 original system installation or by your system administrator.
72 </para>
74 <sect3>
75 <title>Installation</title>
76 <sect4>
77 <title>Installation of CUPS printers</title>
78 <para>
79 If you are using CUPS, you do not need to configure .ini or
80 registry entries, everything is autodetected.
81 </para>
82 </sect4>
83 <sect4>
84 <title>Installation of LPR /etc/printcap based printers</title>
85 <para>
86 If your system is not yet using CUPS, it probably uses LPRng
87 or a LPR based system with configuration based on <filename>/etc/printcap</filename>.
88 </para>
89 <para>
90 If it does, your printers in <filename>/etc/printcap</filename>
91 are scanned with a heuristic whether they are PostScript capable
92 printers and also configured mostly automatic.
93 </para>
94 <para>
95 Since Wine cannot find out what type of printer this is, you
96 need to specify a PPD file in the [ppd] section of
97 <filename>~/.wine/config</filename>. Either use the shortcut
98 name and make the entry look like:
99 </para>
100 <screen>
101 [ppd]
102 "ps1" = "/usr/lib/wine/ps1.ppd"
103 </screen>
104 <para>
105 Or you can specify a generic PPD file that is to match for all
106 of the remaining printers. A generic PPD file can be found in
107 <filename>documentation/samples/generic.ppd</filename>.
108 </para>
109 </sect4>
110 <sect4>
111 <title>Installation of other printers</title>
112 <para>
113 You do not need to do this if the above 2 sections apply, only if
114 you have a special printer.
115 </para>
116 <screen>
117 Wine PostScript Driver=WINEPS,LPT1:
118 </screen>
119 <para>
120 to the [devices] section and
121 </para>
122 <screen>
123 Wine PostScript Driver=WINEPS,LPT1:,15,45
124 </screen>
125 <para>
126 to the [PrinterPorts] section of <filename>win.ini</filename>,
127 and to set it as the default printer also add
128 </para>
129 <screen>
130 device = Wine PostScript Driver,WINEPS,LPT1:
131 </screen>
132 <para>
133 to the [windows] section of <filename>win.ini</filename>.
134 </para>
135 <para>
136 You also need to add certain entries to the registry.
137 The easiest way to do this is to customize the PostScript
138 driver contents of <filename>wine.inf</filename> (see below) and use the
139 Winelib program <command>programs/regedit/regedit</command>. For
140 example, if you have installed the Wine source tree in
141 <filename>/usr/src/wine</filename>, you could use the following
142 series of commands:
143 <itemizedlist>
144 <listitem>
145 <para>
146 <userinput>#vi /usr/share/wine/wine.inf</userinput>
147 </para>
148 </listitem>
149 <listitem>
150 <para>
151 Edit the copy of <filename>wine.inf</filename> to suit your
152 PostScript printing requirements.
153 At a minimum, you must specify a PPD file for each printer.
154 </para>
155 </listitem>
156 <listitem>
157 <para>
158 <userinput>$wineprefixcreate</userinput>
159 </para>
160 </listitem>
161 </itemizedlist>
162 </para>
163 </sect4>
164 <sect4>
165 <title>Required configuration for all printer types</title>
166 <para>
167 You won't need Adobe Font Metric (AFM) files for the (type 1 PostScript)
168 fonts that you wish to use any more.
169 Wine now has this information built-in.
170 </para>
171 <para>
172 You'll need a PPD file for your printer. This describes
173 certain characteristics of the printer such as which fonts are
174 installed, how to select manual feed etc. Adobe has many of
175 these on its website, have a look in
176 <ulink url="ftp://ftp.adobe.com/pub/adobe/printerdrivers/win/all/">
177 ftp://ftp.adobe.com/pub/adobe/printerdrivers/win/all/</ulink>.
178 See above for information on configuring the driver to use this
179 file.
180 </para>
181 <para>
182 To enable colour printing you need to have the
183 <literal>*ColorDevice</literal> entry in the PPD set to
184 <literal>true</literal>, otherwise the driver will generate
185 greyscale.
186 </para>
187 <para>
188 Note that you need not set <literal>printer=on</literal> in
189 the [wine] section of the wine config file, this
190 enables printing via external printer drivers and does not
191 affect the built-in PostScript driver.
192 </para>
193 <para>
194 If you're lucky you should now be able to produce PS files
195 from Wine!
196 </para>
197 <para>
198 I've tested it with win3.1 notepad/write, Winword6 and
199 Origin4.0 and 32 bit apps such as win98 wordpad, Winword97,
200 Powerpoint2000 with some degree of success - you should be
201 able to get something out, it may not be in the right place.
202 </para>
203 </sect4>
204 </sect3>
206 </sect2>
207 </sect1>
209 <!-- Keep this comment at the end of the file
210 Local variables:
211 mode: sgml
212 sgml-parent-document:("wine-user.sgml" "set" "book" "chapter" "")
213 End: