Perl module to generate Data Matrix barcodes in html
Perl6 Perl
Latest commit 1f86709 Mar 25, 2016 @mstratman Incremented version

README

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, `<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.