Quick Guide

Using Barcode Writer in Pure PostScript requires only some basic PostScript knowledge that is easily learned by experimentation. If you do not want to get your hands messy playing with PostScript then you can use one of the project's frontends which hide many of the details.

The best way to get familiar with using the code is to download the monolithic flavour of the latest release and open the barcode_with_sample.ps file with a text editor.

This file consists of the following sections:

• A PostScript indicator, beginning %!PS.
• Comments, with lines beginning %.
• A definition for the uk.co.terryburton.bwipp category for the named resources.
• Named resource definitions for the renderers delimited by % --BEGIN RENDERER ...-- and % --END RENDERER ...--.
• Named resource definitions for the encoders delimited by % --BEGIN ENCODER ...-- and % --END ENCODER ...--.
• A set of sample barcode invocations delimited by % --BEGIN SAMPLE-- and % --END SAMPLE--.

This is one example from the samples:

150 750 moveto (0123456789) (includecheck includetext)
/interleaved2of5 /uk.co.terryburton.bwipp findresource exec

The meaning of each component of the invocation is as follows:

150 750 moveto              % defines the position on the canvas for the symbol
(0123456789)                % the data field containing the information to encode
(includetext height=0.75)   % the options field defining features of the symbol
/interleaved2of5            % the name of the barcode type
/uk.co.terryburton.bwipp findresource exec   % plot the symbol on the canvas

The acceptable contents of the data field varies from symbology to symbology as defined in the symbologies reference.

The acceptable contents of the options field is for the most part common across all of the symbologies as defined in the options reference, however encoder specific options do exist in some cases and the default values of omitted options varies across symbologies.

Using the references mentioned above you should now be able to experiment by carefully amending the sample section of the file.

You will want to view the result of your changes regularly (since bugs may be hard to track down once introduced) either by using a software PostScript interpreter alongside a viewer or by sending the file to a PostScript enabled printer. Alternatively you can use the web-based generator to see the effect of the options on the output.

• GhostScript is a free PostScript interpreter that is available for both Windows and Linux.
• gsview is a viewer for PostScript files on Windows, which requires that GhostScript be installed.
• gv is a viewer for PostScript files on Linux, which requires that GhostScript be installed.
• Adobe Distiller is a commercial PostScript interpreter that is available for Windows and MacOS.
• Most reasonable laser printers have native support for PostScript.
• CUPS, the Common Unix Printing System, adds PostScript support to most non-capable printers by filtering via GhostScript.

To directly print a file to an installed, PostScript enabled printer in Windows use the following command:

PRINT [/D:device] barcode_with_sample.ps

Alternatively for a printer attached directly to the first parallel port:

COPY /B barcode_with_sample.ps LPT1:

To directly print a file to a PostScript enabled printer in Linux use the following command:

lpr -Pdevice -o raw barcode_with_sample.ps

Once you are comfortable with amending the barcode_with_sample.ps file you may want to simplify the file bearing in mind the following points:

• You need only include the named resource definitions for the symbologies of the symbols that you are actually intending to create, and any dependencies as specified in the resource file. Examining the contents of the PS files created by the web-based generator at http://www.terryburton.co.uk/barcodewriter/generator/ illustrates this point. If you have downloaded the source distribution of BWIPP you can create a standalone file containing only the resources required for a particular symbology by running something like make build/standalone/code39.ps or make build/standalone_package/code39.ps.
• If you intend to create an application for generation of documents containing barcodes it is suggested that you use the file monolithic barcode.ps as a template and use the % --BEGIN/END ENCODER ...-- and % --BEGIN/END RENDERER ...-- delimiters to extract the relevant named resource definitions into your documents. This will allow you to simply update your project to the latest version of the BWIPP resource by just replacing your barcode.ps with the latest version.