Should include commdlg.h.
[wine] / documentation / psdriver
1 Wine PostScript Driver
2 ======================
3
4 When complete this will allow Wine to generate PostScript files without needing
5 an external printer driver. It should be possible to print to a non PostScript
6 printer by filtering the output through ghostscript.
7
8
9 Installation
10 ------------
11
12 The driver behaves as if it were a DRV file called WINEPS.DRV which at the
13 moment is built into Wine.  Although it mimics a 16 bit driver it will work
14 with both 16 and 32 bit apps, just as win9x drivers do.
15
16 To install it add
17
18 Wine PostScript Driver=WINEPS,LPT1:
19
20 to the [devices] section of win.ini and to set it as the default printer also
21 add
22
23 device=Wine PostScript Driver,WINEPS,LPT1:
24
25 to the [windows] section of win.ini and
26
27
28 To run 32 bit apps (and 16 bit apps using the builtin commdlg) you also need to
29 add certain entries to the registry.  The easiest way to do that at the moment
30 is to use the winelib program programs/regapi/regapi with the file
31 documentation/psdrv.reg .  To do this cd to programs/regapi/regapi and type
32 `make' to actually make the program, then type
33 `./regapi setValue <../../documentation/psdrv.reg' .  You can obviously edit
34 psdrv.reg to suit your requirements.
35
36 You will need Adobe Font Metric (AFM) files for the (type 1 PostScript) fonts
37 that you wish to use. You can get these from
38 ftp://ftp.adobe.com/pub/adobe/type/win/all/afmfiles .  The directories base17
39 or base35 are good places to start.  Note that these are only the font metrics
40 and not the fonts themselves. At the moment the driver does not download
41 additional fonts, so you can only use fonts that are already present on the
42 printer.
43
44 Then create a [afmfiles] section in your wine.conf (or ~/.winerc) and add a
45 line of the form
46
47 file<n>=/unix/path/name/filename.afm
48
49 for each AFM file that you wish to use. [This might change in the future]
50
51 You also require a PPD file for your printer.  This describes certain
52 characteristics of the printer such as which fonts are installed, how to select
53 manual feed etc.  Adobe also has many of these on its website, have a look in
54 ftp://ftp.adobe.com/pub/adobe/printerdrivers/win/all/
55 Create a [psdrv] section in your wine.conf (or ~/.winerc) and add the 
56 following entry:
57
58 ppdfile=/somewhere/file.ppd
59
60 By default, the driver will look for a file named default.ppd in the directory
61 from which you started wine.
62
63 To enable colour printing you need to have the *ColorDevice entry in the PPD
64 set to true, otherwise the driver will generate greyscale.
65
66 Note that you need not set printer=on in the [wine] section of wine.conf, this
67 enables printing via external printer drivers and does not affect wineps.
68
69 If you're lucky you should now be able to produce PS files from Wine!
70
71 I've tested it with win3.1 notepad/write, Winword6 and Origin4.0 and 32 bit
72 apps such as win98 wordpad, Winword97, Powerpoint2000 with some degree of
73 success - you should be able to get something out, it may not be in the right
74 place.
75
76 TODO / Bugs
77 -----------
78
79 Driver does read PPD files, but ignores all constraints and doesn't let you
80 specify whether you have optional extras such as envelope feeders. You will
81 therefore find a larger than normal selection of input bins in the print setup
82 dialog box. I've only really tested ppd parsing on the hp4m6_v1.ppd file.
83
84 No TrueType download.
85
86 StretchDIBits uses level 2 PostScript.
87
88 AdvancedSetup dialog box.
89
90 Many partially implemented functions.
91
92 ps.c is becoming messy.
93
94 Notepad often starts text too far to the left depending on the margin
95 settings. However the win3.1 pscript.drv (under wine) also does this.
96
97 Probably many more...
98
99 Please contact me if you want to help so that we can avoid duplication.
100
101 Huw Davies <h.davies1@physics.ox.ac.uk>