File: README

package info (click to toggle)
libbarcode-code128-perl 2.21-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster
  • size: 124 kB
  • sloc: perl: 374; makefile: 2
file content (59 lines) | stat: -rw-r--r-- 2,813 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
README for Barcode::Code128 - Generate CODE 128 bar codes

DESCRIPTION:
    Barcode::Code128 generates bar codes using the CODE 128 symbology.
    It can generate images in PNG or GIF format using the GD package,
    or it can generate a text string representing the barcode that you
    can render using some other technology if desired.

    The intended use of this module is to create a web page with a bar
    code on it, which can then be printed out and faxed or mailed to
    someone who will scan the bar code.  The application which spurred
    its creation was an expense report tool, where the employee
    submitting the report would print out the web page and staple the
    receipts to it, and the Accounts Payable clerk would scan the bar
    code to indicate that the receipts were received.

    The default settings for this module produce a large image that
    can safely be FAXed several times and still scanned easily.  If
    this requirement is not important you can generate smaller image
    using optional parameters.

    If you wish to generate images with this module you must also have
    the GD.pm module (written by Lincoln Stein, and available from
    CPAN) installed.  Version 1.20 or higher of GD generates a PNG
    file, due to issues with the GIF patent.  If you want to create a
    GIF, you must use version 1.19 or earlier of GD.  However, most
    browsers have no trouble with PNG files.

    If the GD module is not present, you can still use the module, but
    you will not be able to use its functions for generating images.
    You can use the barcode() method to get a string of "#" and " "
    (hash and space) characters, and use your own image-generating
    routine with that as input.

    To use the the GD module, you will need to install it along with
    this module.  You can obtain it from the CPAN (Comprehensive Perl
    Archive Network) repository of your choice under the directory
    "authors/id/LDS".  Visit http://www.cpan.org/ for more information
    about CPAN.  The GD home page is:
	    http://stein.cshl.org/WWW/software/GD/GD.html

EXAMPLE:
    use Barcode::Code128;
    $object = new Barcode::Code128;
    print "Content-Type: image/png\n\n";
    $object->png('CODE 128');

AUTHOR: William R. Ward, wrw@cpan.org

TERMS: This module is placed into the public domain.  You are free to
    use, modify, or redistribute this module in any way for commercial
    or other uses.  My only request is that if you change it, please
    submit copies of your changed code (or diffs) so that I can
    incorporate them into the version on CPAN.  Also, in order to
    reduce the likelihood of confusion please do not distribute a
    modified version of this module unless you change the name first.

HISTORY:
    See Changes file for history.