update for new inkscape --actions
[Printer-EVOLIS.git] / README
1 NAME
2     Printer::EVOLIS - pixel-exact driver for EVOLIS Dualys two-side card
3     printer in perl
4
5 DESCRIPTION
6     This is experimental support for EVOLIS Dualys 3 printer with black
7     ribbon (K) to provide pixel-exact driver with support for two-side
8     printing.
9
10     Existing cups driver is available at
11
12     http://www.evolis.com/eng/Drivers-Support/Product-support/Dualys-3
13
14     but I haven't been able to make it print on both sides of cards, partly
15     because using dumplex option in cups seems to segfault GhostScript
16     and/or `rastertoevolis' cups filter depending on combination of duplex
17     options.
18
19     I also needed pixel perfect transfer to printer, and cups bitmap format
20     is always in color, leaving final pixel modifications down to cups
21     filter which always produced differences between file sent to printer
22     and perfect black and white rendition of it.
23
24 SCRIPTS
25     Current toolset consists of following scripts:
26
27   scripts/inkscape-render.pl card/template.svg 201008159999 login Name Surname
28     Generate pdf files from Inkscape SVG template in `card/' using
29     `print-front' and `print-back' object IDs. Layers doesn't work since we
30     can't toggle visilbity easily. To print more than one object gruop them
31     and change ID of group.
32
33     After pdf files are created, GhostScript is used to rasterize them into
34     pbm (monochrome) bitmaps.
35
36   scripts/evolis-driver.pl front.pbm back.pbm > evolis.commands
37     Provides driver which generates printer command stream to print
38     two-sided card from pbm files.
39
40   scripts/evolis-simulator.pl evolis
41     Simulator for EVOLIS printer commands which is useful for development.
42     It creates one pbm file per page printed.
43
44   scripts/evolis-command.pl
45     Command-line interface to send commands to printer and receive
46     responses. Supports readline for editing and history. Requires local
47     parallel port connection, probably to USB parallel device.
48
49 EXAMPLE
50     Following is simple walk-through from svg image in Inkscape to evolis
51     command stream which can be executed in top-level directory of this
52     distribution:
53
54       ./scripts/inkscape-render.pl card/ffzg-2010.svg 201008159999 Ime Prezime
55       ./scripts/evolis-driver.pl out/201008159999.front.pbm out/201008159999.back.pbm > evolis
56       ./scripts/evolis-simulator.pl evolis
57       qiv evolis*.pbm
58