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

LICENSE AND COPYRIGHT

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.