improve documentation
[Printer-EVOLIS.git] / lib / Printer / EVOLIS.pm
1 package Printer::EVOLIS;
2
3 use warnings;
4 use strict;
5
6 =head1 NAME
7
8 Printer::EVOLIS - pixel-exact driver for EVOLIS Dualys two-side card printer in perl
9
10 =cut
11
12 our $VERSION = '0.01';
13
14 =head1 DESCRIPTION
15
16 This is experimental support for EVOLIS Dualys 3 printer with black ribbon (K) to provide
17 pixel-exact driver with support for two-side printing.
18
19 Existing cups driver available at
20
21 L<http://www.evolis.com/eng/Drivers-Support/Product-support/Dualys-3>
22
23 does work, but I haven't been able to make it print duplex on cards, especially when generating
24 front and back pages separatly.
25
26 =head1 SCRIPTS
27
28 Current toolset consists of following scripts:
29
30 =head2 scripts/inkscape-render.pl card/template.svg 201008159999 Name Surname
31
32 Generate pdf files from Inkscape SVG template in C<card/> using
33 C<print-front> and C<print-back> object IDs. Layers doesn't work
34 since we can't toggle visilbity easily. To print more than one
35 object gruop them and change ID of group.
36
37 After pdf files are created, GhostScript is used to rasterize them
38 into pbm (monochrome) bitmaps.
39
40 =head2 scripts/evolis-driver.pl front.pbm back.pbm > evolis.commands
41
42 Provides driver which generates printer command stream to print
43 two-sided card from pbm files.
44
45 =head2 scripts/evolis-simulator.pl evolis
46
47 Simulator for EVOLIS printer commands which is useful for development.
48 It creates one pbm file per page printed.
49
50 =head1 EXAMPLE
51
52 Following is simple walk-through from svg image in Inkscape to
53 evolis command stream which can be executed in top-level directory
54 of this distribution:
55
56   ./scripts/inkscape-render.pl card/ffzg-2010.svg 201008159999 Ime Prezime
57   ./scripts/evolis-driver.pl out/201008159999.front.pbm out/201008159999.back.pbm > evolis
58   ./scripts/evolis-simulator.pl evolis
59   qiv evolis*.pbm
60
61 =cut