PDF417Barcode($aNumCols=10, $aErrLevel=2)

Purpose:

To create a new PDF417 encoder with a chosen number of columns and error level. Please note that these parameters can also be adjusted using the methods described below. The method will throw exceptions if the parmeters are outside there valid range.

$aNumCols , an integer in the range [2,30]

$aErrLevel, an integer in the range [0,8]

Returns:

A new encoder which is used by the backend to generate the barcode label.

Example:

1
2

// Create a new encoder with 20 columns
$encoder = new PDF417Barcode(20);

SetColumns($aCols)

Purpose:

Specify number of data columns. This should be a value in the range [2-30] (inclusively) . Note that it is also possible to specify the number of columns in the instantiation of the encoder.

Example:

1
2
3

// Create a new encoder with 20 columns
$encoder = new PDF417Barcode();
$encoder->SetColumns(20);

Note:

The number of rows will be automatically adjusted to fit the data and the error correction codewords as specified by the error level setting. The number of rows is not directly user configurable.

SetErrLevel($aErrLevel)

Purpose:

Specify the chosen level of error correction.

Example:

1
2

$encoder = new PDF417Barcode();
$encoder->SetErrLevel(5);

Note:

A high error level will limit the number of payload data since the total number of data in the label is fixed.

SetTruncated($aTrunc=true)

Purpose:

Specify that barcode should use the truncated PDF format. This will make the barcode slightly narrower and might be used where the physical space is at premium.

Example:

1
2

$encoder = new  PDF417Barcode();
$encoder->SetTruncated ();

Note:

Not all barcode scanners can handle truncated PDF417.

Stroke($aData, $aFile='')

Purpose:

Encode a specific data string entered as the first argument and send the barcode output, depending on backend, either directly back to the browser as an image or return the Postscript representation as a string.

Example:

1
2
3
4
5
6
7
8
9
10
11

<?php
// Data to be encoded
$data = ... ;
 
try {
    ...
    $backend->Stroke($data);
} catch( JpGraphException $e) {
    ...
}
?>

SetVertical($aFlg=true)

Purpose:

Draw the barcode vertically instead of the default horizontal direction

Example:

1

$backend->SetVertical();

SetScale($aScale)

Purpose:

Will arbitrary scale the generated barcode image. Scale factor is specified as a floating point number .

Example:

1

$backend->SetScale(2.5);

SetModuleWidth($aWidth)

Purpose:

Specifies the module width to be used in the barcode. The module width is interpretated differently depending on whether it is applied on an image or a postscript backend. The module width will determine the physical width of the overall barcode. Please make sure that the printer has good enough resolution to handle the chosen module width.

For image backends is specifies the number of pixels to be used for the width of one module in the barcode. The module can be thought of as the thinnest line printed in the barcode. Each codeword is encoded 17 modules wide where there are 4 black and 4 white separated areas.

Even though most modern inkjet printers (2003 and later) can resolve modules down to 1 pixels it is recommended that for inkjet printers a module width of >= 2 is used.

For Postcript backend the module width specified the width in Postscript points (1 point = 1/72 inch).

Example:

1

$backend->SetModuleWidth(2);

SetHeight($aHeight)

Purpose:

Specified the height to width ratio for the individual rows in the barcode. By default the ratio is 3, which means that the height of the rows in the barcode is 3 times the module width. Most scanners can handle a factor between 2-5. You should very rarely have to change this parameter.

The ratio is specified as an integer.

One reason to change this to a smaller value is to make a barcode label take up less vertical space.

Example:

1

$backend->SetHeight(2);

SetColor($aFrgColor,$aBkgColor)

Purpose:

Specify the foreground and background color for the barcode.

Example:

1

$backend->SetColor( 'black', 'lightyellow');

ShowFrame($aFlg=true)

Purpose:

Draw a 1 pixel frame around the barcode. This is not recommended in production since it might disturb some scanners reading. This is only useful if you need a visual feedback on the boundaries for the image.

Example:

1

backend->SetFrame();

ShowText($aFlg=true)

Purpose:

Show human readable text of the encoded data underneath the barcode label.

Example:

SetFont($aFontFam,$aFontStyle,$aFontSize)

Purpose:

Specify the font for the human readable text underneath the barcode label.

Example:

1

$backend->SetFont( FF_ARIAL, FS_NORMAL, 8);

SetImgFormat($aFormat)

Purpose:

Specify image format. Possible values are

Example:

1

$backend->SetImgFormat('jpeg');

SetEPS($aFlg=true)

Purpose:

Format the output as Encapsulated Postcript. This adds a bounding box information to the output and makes this format suitable to be included in other postscript files.

Example:

1
2
3

$encoder = new PDF417Barcode( $columns, $errlevel);
$backend = PDF417BackendFactory::Create( BACKEND_PS, $encoder); 
$backend->SetEPS();