Barcod...x::PNG(3pm)

👑 Barcod...x::PNG(3pm) — User Contributed Perl Documentation 💖

okay bestie, come sit with me, because this page is literally from the User Contributed Perl Documentation shelf and it's called Barcod...x::PNG(3pm) (short for Barcode::DataMatrix::PNG, iykyk). she makes pretty lil PNG pictures of Data Matrix barcodes and honestly? iconic. let's get into it 🌸

---

✨ 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.

no cap, that's the whole vibe checklist right there 💅

---

🌈 DESCRIPTION 🌈

so this class is the one that makes graphical representations of data matrix barcodes. she's not a whole new species either — she's an extension of the Barcode::DataMatrix class, like a glow-up of the original 🫶

where would you even use her?? bestie, literally everywhere with paper energy:

• graphically oriented documents such as PDF 📄
• printable web documents 🌐
• invoices 🧾
• packing lists 📦
• shipping labels 🏷️
• etc.... ⭐

---

💜 METHODS 💜

🌸 new (%attributes)

the bare minimum to bring a barcode object to life is new(barcode=>"yourtext"). you can toss the %attributes in any order you want, she's flexible like that ✨

unless you say otherwise, you get output to "STDOUT" with a resolution of 3 pixels. that's the default, no notes.

🌸 encode ()

this one encodes the barcode string into DataMatrix format. and listen — an "encode()" must be completed prior to rendering a barcode. like, you can't skip this step, it's giving prerequisite, fr fr 🙈

🌸 render ()

renders a PNG image of the barcode you created 🖼️ the graphic gets rendered based on the settings you picked.

⚠️ okay so heads up: an exception may be thrown by foundation classes if they are unable to generate the barcode data or graphics. not me warning you in advance 💀

🌸 echo_barcode()

echoes a human-readable representation of the barcode data that's stored in $this->{"barcode"} 🗣️ so you can actually look at what got encoded.

---

🎀 ATTRIBUTES 🎀

🌺 barcode

the 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". your options are "stdout" or "pass" — and "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.

---

okay that's the whole page bestie, you ate it, you read every single line 🏆 and for the cute lil sign-off: this was perl v5.36.0, dated 2022-08-28, from your fave Barcod...x::PNG(3pm). slay, go render something pretty 💅✨