NAME
HTML::Barcode::DataMatrix - Generate HTML representations of Data Matrix
barcodes
SYNOPSIS
my $barcode = HTML::Barcode::DataMatrix->new(text => '
http://search.cpan.org');
print $code->render;
DESCRIPTION
This class allows you to easily create HTML representations of Data
Matrix barcodes.
You can read more about Data Matrix barcodes online (e.g.
http://en.wikipedia.org/wiki/Data_Matrix)
METHODS
new (%attributes)
Instantiate a new HTML::Barcode::DataMatrix object. The `%attributes'
hash requires the text attribute, and can take any of the other
attributes listed below.
render
This is a convenience routine which returns `<style>...</style>' tags
and the rendered barcode.
If you are printing multiple barcodes or want to ensure your `style'
tags are in your HTML headers, then you probably want to output the
barcode and style separately with the render_barcode and css entries
elsewhere in this document.
render_barcode
Returns only the rendered barcode. You will need to provide stylesheets
separately, either writing them yourself or using the output of css.
css
Returns CSS needed to properly display your rendered barcode. This is
only necessary if you are using render_barcode instead of the easier
render method.
ATTRIBUTES
These attributes can be passed to new, or used as accessors.
text
Required - The information to put into the barcode.
encoding_mode
The encoding mode for the data matrix. Can be one of: `AUTO' (default),
`ASCII', `C40', `TEXT', `BASE256', or `NONE'.
process_tilde
Set to true to indicate the tilde character "~" is being used to
recognize special characters. See this page for more information:
http://www.idautomation.com/datamatrixfaq.html
foreground_color
A CSS color value (e.g. '#000' or 'black') for the foreground. Default
is '#000'.
background_color
A CSS color value background. Default is '#fff'.
module_size
A CSS value for the width and height of an individual module (a dot) in
the code. Default is '3px'.
css_class
The value for the `class' attribute applied to any container tags in the
HTML (e.g. `table' or `div'). `td' tags within the table will have
either css_class_on or css_class_off classes applied to them.
For example, if css_class is "barcode", you will get `<table
class="barcode">' and its cells will be either `<td class="barcode_on">'
or `<td class="barcode_off">'.
embed_style
Rather than rendering CSS stylesheets, embed the style information in
HTML `style' attributes. You should not use this option without good
reason, as it greatly increases the size of the generated markup, and
makes it impossible to override with stylesheets.
AUTHOR
Mark A. Stratman, `<
[email protected]>'
SOURCE REPOSITORY
http://github.com/mstratman/HTML-Barcode-DataMatrix
SEE ALSO
Barcode::DataMatrix
LICENSE AND COPYRIGHT
Copyright 2011 Mark A. Stratman.
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.
