Implement DocumentProperties, DeviceCapabilities, beginnings of
[wine] / graphics / psdrv / README
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 At the moment the driver will only work for 16 bit apps, the move to 32 bit
13 should be quite easy, I'd just like to improve it first. The driver behaves as
14 if it were a DRV file called WINEPS.DRV . To install it as the default printer
15 driver add
16
17 device=Wine PostScript Driver,WINEPS,LPT1:
18
19 to the [windows] section of win.ini . You may prefer to add
20
21 Wine PostScript Driver=WINEPS,LPT1:
22
23 to the [devices] section of win.ini instead.
24
25 You will need Adobe Font Metric (AFM) files for the (type 1 PostScript) fonts
26 that you wish to use. You can get these from
27
28 ftp://ftp.adobe.com/pub/adobe/type/win/all/afmfiles . The directories base17 or
29 base35 are good places to start.
30
31 Note that these are only the font metrics and not the fonts themselves. At
32 present the driver does not download additional fonts, so you can only use
33 fonts that are already present on the printer.
34
35 Then create a [afmfiles] section in your wine.conf (or ~/.winerc) and add a
36 line of the form
37
38 file=/unix/path/name/filename.afm
39
40 for each AFM file that you wish to use. [This might change in the future]
41
42 You also require a PPD file for your printer. This describes certain
43 characteristics of the printer such as which fonts are installed, how to select
44 manual feed etc. Adobe also has many of these on its website, have a look in
45 ftp://ftp.adobe.com/pub/adobe/printerdrivers/win/all/
46 Put the PPD in the directory from which you start wine and call it default.ppd
47 [this will definitely change soon].
48
49 To enable colour printing you need to have the *ColorDevice entry in the PPD
50 set to true, otherwise the driver will generate greyscale.
51
52 Note that you need not set printer=on in the [wine] section of wine.conf, this
53 enables printing via external printer drivers and does not affect wineps.
54
55 If you're lucky you should now be able to produce PS files from Wine!
56
57 I've tested it with win3.1 notepad/write, Winword6 and Origin4.0 with some
58 degree of success - you should be able to get something out, it may not be in
59 the right place.
60
61 TODO / Bugs
62 -----------
63
64 Driver does read PPD files, but ignores all constraints and doesn't let you
65 specify whether you have optional extras such as envelope feeders. You will
66 therefore find a larger than normal selection of input bins in the print setup
67 dialog box. I've only really tested ppd parsing on the hp4m6_v1.ppd file.
68
69 No TrueType download.
70
71 StretchDIBits uses level 2 PostScript.
72
73 AdvancedSetup dialog box.
74
75 Many partially implemented functions.
76
77 ps.c is becoming messy.
78
79 No clipping.
80
81 Notepad often starts text too far to the left depending on the margin
82 settings. However the win3.1 pscript.drv (under wine) also does this.
83
84 Probably many more...
85
86 Since the driver is very alpha, things are likely to change quickly.
87 Please contact me if you want to help so that we can avoid duplication.
88
89 Huw Davies <h.davies1@physics.ox.ac.uk>