1 |
PHP-Barcode 0.3pl1 |
2 |
|
3 |
PHP-Barcode generates |
4 |
- Barcode-Images using libgd (png, jpg,gif), |
5 |
- HTML-Images (using 1x1 pixel and html-table) |
6 |
- silly Text-Barcodes |
7 |
|
8 |
PHP-Barcode encodes using |
9 |
- a built-in EAN-13/ISBN Encoder |
10 |
- genbarcode (by Folke Ashberg), a command line |
11 |
barcode-encoder which uses GNU-Barcode |
12 |
genbarcode can encode EAN-13, EAN-8, UPC, ISBN, 39, 128(a,b,c), |
13 |
I25, 128RAW, CBR, MSI, PLS |
14 |
genbarcode is available at www.ashberg.de/bar |
15 |
|
16 |
(C) 2001,2002,2003,2004 by Folke Ashberg <folke@ashberg.de> |
17 |
|
18 |
The newest version can be found at http://www.ashberg.de/bar |
19 |
|
20 |
|
21 |
INSTALLATION: |
22 |
|
23 |
WHAT YOU NEED TO BE ABLE TO USE PHP-BARCODE |
24 |
You need php>4 on your system. |
25 |
You need the gd2-extension to be able to render images. |
26 |
You need a TrueTypeFont if you want to see the CODE below the bars. |
27 |
You need genbarcode (from www.ashberg.de/bar) in you want to use |
28 |
another encoding than EAN-12/EAN-12/ISBN |
29 |
|
30 |
Copy the following files into your html/php-directory |
31 |
- php-barcode.php - main library |
32 |
- encode_bars.php - built-in encoders |
33 |
optional: |
34 |
- barcode.php - Sample-File |
35 |
- white.png - for HTML-Images |
36 |
- black.png - for HTML-Images |
37 |
|
38 |
FONT-Installation |
39 |
UNIX: |
40 |
A TrueTypeFont isn't included in this distribution! |
41 |
Copy one into the html/php-directory and change in php-barcode.php |
42 |
$font_loc (change the arialbd.tff to your font name). |
43 |
arialbd.ttf from Windows looks great. |
44 |
|
45 |
WINDOWS: |
46 |
If you use Windows the font should be located automatically. |
47 |
|
48 |
OPTIONAL - genbarcode: |
49 |
If you want to generate not only EAN-12/EAN-13/ISBN-Codes you have to install |
50 |
genbarcode, a small unix-commandline tool which uses GNU-Barcode. |
51 |
genbarcode is available http://www.ashberg.de/bar , read genbarcodes |
52 |
README for installation. |
53 |
If you have installed genbarcode not to /usr/bin set the $genbarcode_loc |
54 |
in php-barcode.php . |
55 |
|
56 |
TESTING |
57 |
If everything works fine you should see an image if you call |
58 |
http://localhost/path/barcode.php |
59 |
|
60 |
Or call http://localhost/path/barcode.php?code=<CODE>&encoding=<ENCODING>&mode=<png|jpg|gif|html|text>&size=<1,2,3,...> |
61 |
|
62 |
|
63 |
|
64 |
If you need more then the sample barcode.php can do, you need to build your own. |
65 |
|
66 |
FUNCTIONS - API-Reference |
67 |
|
68 |
-------------------------------------------------------------------------- |
69 |
function barcode_encode(code, encoding) |
70 |
encodes $code with $encoding using genbarcode OR built-in encoder |
71 |
if you don't have genbarcode only EAN-13/ISBN is possible |
72 |
|
73 |
You can use the following encodings (when you have genbarcode): |
74 |
ANY choose best-fit (default) |
75 |
EAN 8 or 13 EAN-Code |
76 |
UPC 12-digit EAN |
77 |
ISBN isbn numbers (still EAN-13) |
78 |
39 code 39 |
79 |
128 code 128 (a,b,c: autoselection) |
80 |
128C code 128 (compact form for digits) |
81 |
128B code 128, full printable ascii |
82 |
I25 interleaved 2 of 5 (only digits) |
83 |
128RAW Raw code 128 (by Leonid A. Broukhis) |
84 |
CBR Codabar (by Leonid A. Broukhis) |
85 |
MSI MSI (by Leonid A. Broukhis) |
86 |
PLS Plessey (by Leonid A. Broukhis) |
87 |
|
88 |
return: |
89 |
array[encoding] : the encoding which has been used |
90 |
array[bars] : the bars |
91 |
array[text] : text-positioning info |
92 |
|
93 |
-------------------------------------------------------------------------- |
94 |
function barcode_outimage(text, bars [, scale [, mode [, total_y [, space ]]]] ) |
95 |
|
96 |
Outputs an image using libgd |
97 |
|
98 |
text : the text-line (<position>:<font-size>:<character> ...) |
99 |
bars : where to place the bars (<space-width><bar-width><space-width><bar-width>...) |
100 |
scale : scale factor ( 1 < scale < unlimited (scale 50 will produce |
101 |
5400x300 pixels when |
102 |
using EAN-13!!!)) |
103 |
mode : png,gif,jpg, depending on libgd ! (default='png') |
104 |
total_y: the total height of the image ( default: scale * 60 ) |
105 |
space : space |
106 |
default: |
107 |
$space[top] = 2 * $scale; |
108 |
$space[bottom]= 2 * $scale; |
109 |
$space[left] = 2 * $scale; |
110 |
$space[right] = 2 * $scale; |
111 |
|
112 |
-------------------------------------------------------------------------- |
113 |
function barcode_outhtml(text, bars [, scale [, total_y [, space ]]] ) |
114 |
|
115 |
returns(!) HTML-Code for barcode-image using html-code (using a table and with black.png and white.png) |
116 |
|
117 |
text : the text-line (<position>:<font-size>:<character> ...) |
118 |
bars : where to place the bars (<space-width><bar-width><space-width><bar-width>...) |
119 |
scale : scale factor ( 1 < scale < unlimited (scale 50 will produce |
120 |
5400x300 pixels when |
121 |
using EAN-13!!!)) |
122 |
total_y: the total height of the image ( default: scale * 60 ) |
123 |
space : space |
124 |
default: |
125 |
$space[top] = 2 * $scale; |
126 |
$space[bottom]= 2 * $scale; |
127 |
$space[left] = 2 * $scale; |
128 |
$space[right] = 2 * $scale; |
129 |
|
130 |
-------------------------------------------------------------------------- |
131 |
function barcode_outtext(code, bars) |
132 |
|
133 |
Returns (!) a barcode as plain-text |
134 |
ATTENTION: this is very silly! |
135 |
|
136 |
text : the text-line (<position>:<font-size>:<character> ...) |
137 |
bars : where to place the bars (<space-width><bar-width><space-width><bar-width>...) |
138 |
|
139 |
-------------------------------------------------------------------------- |
140 |
For more function see php-barcode.php |
141 |
Also see barcode.php or just use them :) |
142 |
|
143 |
|
144 |
|
145 |
|
146 |
|
147 |
|
148 |
This program is free software; you can redistribute it and/or modify |
149 |
it under the terms of the GNU General Public License as published by |
150 |
the Free Software Foundation; either version 2 of the License, or |
151 |
(at your option) any later version. |
152 |
|
153 |
This program is distributed in the hope that it will be useful, |
154 |
but WITHOUT ANY WARRANTY; without even the implied warranty of |
155 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
156 |
GNU General Public License for more details. |
157 |
|
158 |
You should have received a copy of the GNU General Public License |
159 |
along with this program; if not, write to the Free Software |
160 |
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. |
161 |
|
162 |
|