oracular (3) Barcode::DataMatrix::PNG.3pm.gz

Provided by: libbarcode-datamatrix-png-perl_0.04-3_all bug

NAME

       Barcode::DataMatrix::PNG - Generate PNG graphical representations of Data Matrix barcodes

SYNOPSIS

           use Barcode::DataMatrix::PNG;
           my $data = Barcode::DataMatrix::PNG->new->(barcode=>'test_barcode');
                                                                                               # Minimal call for a new object.
               $data->encode();                                                # Encode the Barcode data.
               $data->render();                                                # Default:  Render the image to <STDOUT>
               $data->target = 'pass';                                 # C<return()> the image.
               my $barcode = $data->render();                  # Return a PNG representation of a DataMatrix Barcode.
               my $my_barcode = $data->echo_barcode(); # Return a human-readable string of the encoded data.

               $data->barcode = "A new barcode.";              # To render a new barcode with the same object.
               $data->target = 'stdout';
               $data->encode();
               $data->render();                                                # etc.

DESCRIPTION

       This class is used to create graphical representations of data matrix barcodes.  It is an extension of
       the Barcode::DataMatrix class.  Potential applications include graphically oriented documents such as
       PDF, printable web documents, invoices, packing lists, shipping labels, etc....

METHODS

   new (%attributes)
       Minimal initiation of a barcode object is new(barcode=>"yourtext").  Options may be added via the
       %attributes in any order.

       Default settings of output to "STDOUT" with a resolution of 3 pixels will be used unless changed.

   encode ()
       Encode the barcode string into DataMatrix format.  An "encode()" must be completed prior to rendering a
       barcode.

   render ()
       Render a PNG image of the created barcode.  The graphic will be rendered based on settings selected.

       An exception may be thrown by foundation classes if they are unable to generate the barcode data or
       graphics.

   echo_barcode()
       Echo a human-readable representation of the barcode data stored in $this->{"barcode"}

ATTRIBUTES

   barcode
       Ascii string data to be inserted into the barcode.

   resolution
       The resolution (in pixels) of the barcode to be generated.   The default setting is 3 pixels resolution.

   target
       Default output is "stdout".  Options are "stdout" or "pass".  Pass will "return()" the barcode PNG data
       for use.

AUTHOR

       Kasem Omary<< <kasemo@cpan.org> >>

SOURCE REPOSITORY

       <https://github.com/KasemOmary/Barcode-DataMatrix-PNG>

SEE ALSO

       HTML::Barcode::DataMatrix

       Copyright 2014 the AUTHORs listed above.

       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.