The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
HTML-Barcode-DataMatrix-0.03
River stage zero No dependents
++
/ HTML::Barcode::DataMatrix

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.

Here is an example of a barcode rendered with this module:

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 "render_barcode" and "css".

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, <stratman@gmail.com>

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.