.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "Barcode::DataMatrix 3pm"
.TH Barcode::DataMatrix 3pm "2017-11-19" "perl v5.26.1" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Barcode::DataMatrix \- Generate data for Data Matrix barcodes
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 6
\&    use Barcode::DataMatrix;
\&    my $data = Barcode::DataMatrix\->new\->barcode(\*(AqMONKEY\*(Aq);
\&    for my $row (@$data) {
\&        print for map { $_ ? "#" : \*(Aq \*(Aq } @$row;
\&        print "\en";
\&    }
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This class is used to generate data for Data Matrix barcodes. It is primarily
useful as a data source for barcode modules that do rendering,
such as HTML::Barcode::DataMatrix.  You can easily make a version that
renders an image, \s-1PDF,\s0 or anything else.
.SH "METHODS"
.IX Header "METHODS"
.SS "new (%attributes)"
.IX Subsection "new (%attributes)"
Instantiate a new Barcode::DataMatrix object. The \f(CW%attributes\fR hash
can take any of the other attributes listed below.
.SS "barcode ($text)"
.IX Subsection "barcode ($text)"
Generate barcode data representing the \f(CW$text\fR string.  This returns
an array ref of rows in the data matrix, each containing array refs of
cells within that row. The cells are true and false values
that represent filled or empty squares.
.PP
This can throw an exception if it's unable to generate the barcode data.
.SH "ATTRIBUTES"
.IX Header "ATTRIBUTES"
.SS "encoding_mode"
.IX Subsection "encoding_mode"
The encoding mode for the data matrix. Can be one of:
\&\f(CW\*(C`AUTO\*(C'\fR (default), \f(CW\*(C`ASCII\*(C'\fR, \f(CW\*(C`C40\*(C'\fR, \f(CW\*(C`TEXT\*(C'\fR, \f(CW\*(C`BASE256\*(C'\fR, or \f(CW\*(C`NONE\*(C'\fR.
.SS "size"
.IX Subsection "size"
The module size for the data matrix. Can be one of:
\&\f(CW\*(C`AUTO\*(C'\fR (default), \f(CW\*(C`10x10\*(C'\fR, \f(CW\*(C`12x12\*(C'\fR, \f(CW\*(C`14x14\*(C'\fR, \f(CW\*(C`16x16\*(C'\fR, \f(CW\*(C`18x18\*(C'\fR, \f(CW\*(C`20x20\*(C'\fR, \f(CW\*(C`22x22\*(C'\fR, \f(CW\*(C`24x24\*(C'\fR, \f(CW\*(C`26x26\*(C'\fR, \f(CW\*(C`32x32\*(C'\fR, \f(CW\*(C`36x36\*(C'\fR, \f(CW\*(C`40x40\*(C'\fR, \f(CW\*(C`44x44\*(C'\fR, \f(CW\*(C`48x48\*(C'\fR, \f(CW\*(C`52x52\*(C'\fR, \f(CW\*(C`64x64\*(C'\fR, \f(CW\*(C`72x72\*(C'\fR, \f(CW\*(C`80x80\*(C'\fR, \f(CW\*(C`88x88\*(C'\fR, \f(CW\*(C`96x96\*(C'\fR, \f(CW\*(C`104x104\*(C'\fR, \f(CW\*(C`120x120\*(C'\fR, \f(CW\*(C`132x132\*(C'\fR, \f(CW\*(C`144x144\*(C'\fR, \f(CW\*(C`8x18\*(C'\fR, \f(CW\*(C`8x32\*(C'\fR, \f(CW\*(C`12x26\*(C'\fR, \f(CW\*(C`12x36\*(C'\fR, \f(CW\*(C`16x36\*(C'\fR, \f(CW\*(C`16x48\*(C'\fR.
.SS "process_tilde"
.IX Subsection "process_tilde"
Boolean. Set to true to indicate the tilde character \*(L"~\*(R" is being used to recognize
special characters. See this page for more information:
<http://www.idautomation.com/datamatrixfaq.html>
.SH "AUTHORS"
.IX Header "AUTHORS"
Mons Anderson \f(CW\*(C`<inthrax@gmail.com>\*(C'\fR (GD::Barcode::DataMatrix at <https://github.com/Mons/perl\-ex/>, from which this distribution originates)
.PP
Mark A. Stratman, \f(CW\*(C`<stratman@gmail.com>\*(C'\fR
.PP
Paul Cochrane, <https://github.com/paultcochrane>
.SH "SOURCE REPOSITORY"
.IX Header "SOURCE REPOSITORY"
<http://github.com/mstratman/Barcode\-DataMatrix>
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.IP "HTML::Barcode::DataMatrix" 4
.IX Item "HTML::Barcode::DataMatrix"
.PD 0
.IP "<http://grandzebu.net/informatique/codbar\-en/datamatrix.htm>" 4
.IX Item "<http://grandzebu.net/informatique/codbar-en/datamatrix.htm>"
.IP "<http://www.idautomation.com/datamatrixfaq.html>" 4
.IX Item "<http://www.idautomation.com/datamatrixfaq.html>"
.PD
.SH "LICENSE AND COPYRIGHT"
.IX Header "LICENSE AND COPYRIGHT"
Copyright 2015 the AUTHORs listed above.
.PP
This program is free software; you can redistribute it and/or modify it
under the terms of either: the \s-1GNU\s0 General Public License as published
by the Free Software Foundation; or the Artistic License.
.PP
See http://dev.perl.org/licenses/ for more information.