improve documentation
[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 available at
11
12     http://www.evolis.com/eng/Drivers-Support/Product-support/Dualys-3
13
14     does work, but I haven't been able to make it print duplex on cards,
15     especially when generating front and back pages separatly.
16
17 SCRIPTS
18     Current toolset consists of following scripts:
19
20   scripts/inkscape-render.pl card/template.svg 201008159999 Name Surname
21     Generate pdf files from Inkscape SVG template in `card/' using
22     `print-front' and `print-back' object IDs. Layers doesn't work since we
23     can't toggle visilbity easily. To print more than one object gruop them
24     and change ID of group.
25
26     After pdf files are created, GhostScript is used to rasterize them into
27     pbm (monochrome) bitmaps.
28
29   scripts/evolis-driver.pl front.pbm back.pbm > evolis.commands
30     Provides driver which generates printer command stream to print
31     two-sided card from pbm files.
32
33   scripts/evolis-simulator.pl evolis
34     Simulator for EVOLIS printer commands which is useful for development.
35     It creates one pbm file per page printed.
36
37 EXAMPLE
38     Following is simple walk-through from svg image in Inkscape to evolis
39     command stream which can be executed in top-level directory of this
40     distribution:
41
42       ./scripts/inkscape-render.pl card/ffzg-2010.svg 201008159999 Ime Prezime
43       ./scripts/evolis-driver.pl out/201008159999.front.pbm out/201008159999.back.pbm > evolis
44       ./scripts/evolis-simulator.pl evolis
45       qiv evolis*.pbm
46