/ 
PostScript-LabelSheet-0.02
River stage zero No dependents
/ PostScript::LabelSheet

NAME

PostScript::LabelSheet - print multiple labels on a sheet, starting from PostScript label template.

SYNOPSIS

use PostScript::LabelSheet;

my $sheet = new PostScript::LabelSheet;

$sheet->columns(3); # 3 labels abreast
$sheet->rows(10);   # on 10 rows
# Or specify the dimensions of the labels, in PostScript points
# $sheet->label_width(...); $sheet->label_height(...);

$sheet->skip(5); # leave 5 labels blank

$sheet->add('/path/to/label_1.eps', 5);
$sheet->add('/path/to/label_2.eps', 3);
$sheet->add('/path/to/label_3.eps');
$sheet->fill_last_page(1); # label_3 will fill the last sheet.

print $sheet->as_postscript();

DESCRIPTION

Why this module?

I sometimes have to print a sheet of labels, each label bearing the same design, for example to label jars of marmelade. I tried to do this with OpenOffice.org writer, in a table. But I had to manually copy and paste the design of the first label into every cell, and of course, if I changed the design, the changes had to be reported manually to the other cells. And of course, changing the dimensions, or adding a column or a row, need some manual intervention.

This module is here to easily print a sheet (or sheets) of labels representing a repeating pattern. Give it a design in Encapsulated PostScript (EPS), how many labels you want, how big they should be or how many should fit in the width and heigth of the page, and PostScript::LabelSheet generates the PostScript code for you, which you can then directly print.

There are options to print several kinds of labels on the same sheet, each with its own design, to draw a grid around the labels for cutting them, and to control how they are laid out on the page.

Additionally, labels can be numbered. This can be useful to print numbered tickets for a local event for instance.

Drawing the design

Use inkscape (http://www.inkscape.org) to draw the design that you want to print on each label. Keep the original in the SVG format, and export it as Encapsulated PostScript for use with PostScript::LabelSheet.

The size of the design is unimportant, as this is vector graphics, the generated PostScript program will resize without losing quality so that it fits within a label. What is important, however, is that the design occupies all the space on the page. The easiest is to draw without giving any thought to the page, then adjust the page size to the drawing. In inkscape, you can use the Document Properties dialog box to let the page fit the design exactly (menu File, Document Properties, in the Page tab, click the "Fit page to selection" button).

To save the design in EPS format, in inkscape, go to menu File, Save a copy, and choose the "Encapsulated PostScript (*.eps)" format. Inkscape will show a dialog with options for the conversion to EPS. Do check the box "Make bounding box around full page", so that the generated EPS code contains information about the size of the design. PostScript::LabelSheet needs it to work out the scale at which the design should be included on the page.

Constructor

new

Returns a new instance of PostScript::LabelSheet with all its attributes set to the built-in default values.

Accessors / Mutators

The following methods are accessors when given no argument, and mutators when given one. As accessor they return the corresponding attribute's value:

print $sheet->width();

As mutators, they set the attribute's value, and return the PostScript::LabelSheet instance itself, making it possible to stack several calls to mutators:

my $sheet = PostScript::LabelSheet->new()
    ->width(595)
    ->height(842)
    ->grid(0)
    ;

Labels management

columns
rows

Give the number of columns and rows in which the labels should be laid out on each page. The labels width and height will be calculated accordingly.

label_width
label_height

Give the width and height of each label. The program will automatically calculate how many labels will fit on each row and column.

Either columns() or label_width(), and either row() or label_height(), must be specified before invoking as_postscript().

fill_last_page (defaults to true)

Set this option to a true value to have the last label repeat until the end of the last page.

Layout

width
height

Dimensions of the page. Default to DIN A4 (210 × 297 mm).

h_margin
v_margin

Vertical (top and bottom) and horizontal (left and right) margins. Default to 5 mm. Use margin() to set both v_margin() and h_margin() at the same time. It is not possible to set the top margin independantly from the bottom margin, nor the left margin independantly from the right one.

h_padding
v_padding

Space left blank inside each label and around the design within. Default to 0. Use padding() to set both h_padding() and v_padding() at the same time.

h_spacing
v_spacing

Space between columns (h_spacing()) or rows (v_spacing()) of labels. Default to 0 (no space between rows and columns). Use spacing() to set both h_spacing() and v_spacing() at the same time.

skip

Number of labels to leave blank at the top of the first page. The default is to start at the top left of the page.

portrait

If set to a true value, the designs are rotated 90 degrees clockwise inside each label. Default to false.

grid

If set to a true value, a grid is drawn around the labels. This is the default.

Miscellaneous

postscript_skeleton
labels

Methods

add PATH, COUNT

Adds a design to the sheet of labels. PATH is the path to a file in the Encapsulated PostScript format. See the "Drawing the design" section above for hints on how to make such a file. COUNT is optional and defaults to 1. However, it fill_last_page() is set to a true value, the last design will be repeated until the end of the last page.

Returns the instance of the PostScript::LabelSheet object, so calls can be stacked:

$sheet->add('file1.eps', 5)
      ->add('file2.eps', 6)
      ->add('file3.eps', 4)
      ;
count_labels_per_page

Returns the number labels that would fit on a page.

count_labels

Returns the number of labels printed on all the pages. If fill_last_page() is set to a true value, this might not reflect the number of labels actually printed, as the last one will be printed multiple times. The number will be accurate after the PostScript has been generated in a call to as_postscript(), as the count property of the last design will be adjusted at that moment.

set NAME, VALUE

A rewrite of Class::Accessor's set() mutator, that returns the instance of the object, instead of the value.

margin SIZE
padding SIZE
spacing SIZE

Sets both h_margin() and v_margin() to SIZE at the same time, and respectively for h_padding() and v_padding(), and for h_spacing() and v_spacing().

as_postscript

Returns the PostScript code that prints the labels. It can be sent directly to a printer spool, or converted to PDF, or whatever you can do with PostScript.

AUTHOR

Cédric Bouvier, <cbouvi at cpan.org>

BUGS

Please report any bugs or feature requests to bug-postscript-labelsheet at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=PostScript-LabelSheet. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc PostScript::LabelSheet

You can also look for information at:

COPYRIGHT & LICENSE

Copyright 2009 Cédric Bouvier.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

1 POD Error

The following errors were encountered while parsing the POD:

Around line 449:

Non-ASCII character seen before =encoding in 'Cédric'. Assuming UTF-8