BARCODE(3) GNU barcode BARCODE(3)
NAME
barcode - a library to create and print bar codes
SYNOPSIS
#include <barcode.h>
struct Barcode_Item *Barcode_Create(char *text);
int Barcode_Delete(struct Barcode_Item *bc);
int Barcode_Encode(struct Barcode_Item *bc, int flags);
int Barcode_Print(struct Barcode_Item *bc, FILE *f, int flags);
int Barcode_Position(struct Barcode_Item *bc, int wid, int hei, int xoff, int yoff , double scalef);
int Barcode_Encode_and_Print(char *text, FILE *f, int wid, int hei, int xoff, int yoff, int flags);
int Barcode_Version(char *versionname);
DESCRIPTION
The barcode family of library functions is meant to ease creation of bar-code printouts. The information below is extracted from the tex-
info file, which is the preferred source of information.
The functions included in the barcode library are declared in the header file barcode.h. They perform the following tasks:
struct Barcode_Item *Barcode_Create(char *text);
The function creates a new barcode object to deal with a specified text string. It returns NULL in case of failure and a pointer to
a barcode data structure in case of success.
int Barcode_Delete(struct Barcode_Item *bc);
Destroy a barcode object. Always returns 0 (success)
int Barcode_Encode(struct Barcode_Item *bc, int flags);
Encode the text included in the bc object. Valid flags are the encoding type (other flags are ignored) and BARCODE_NO_CHECKSUM
(other flags are silently ignored); if the flag argument is zero, bc->flags will apply. The function returns 0 on success and -1 in
case of error. After successful termination the data structure will host the description of the bar code and its textual representa-
tion, after a failure the error field will include the reason of the failure.
int Barcode_Print(struct Barcode_Item *bc, FILE *f, int flags);
Print the bar code described by bc to the specified file. Valid flags are the output type, BARCODE_NO_ASCII and BARCODE_OUT_NOHEAD-
ERS, other flags are ignored. If any of these flags is zero, it will be inherited from bc->flags which therefore takes precedence.
The function returns 0 on success and -1 in case of error (with bc->error set accordingly). In case of success, the bar code is
printed to the specified file, which won't be closed after use.
int Barcode_Position(struct Barcode_Item *bc, int wid, int hei, int xoff, int yoff, double scalef);
The function is a shortcut to assign values to the data structure.
int Barcode_Encode_and_Print(char *text, FILE *f, int wid, int hei, int xoff, int yoff, int flags);
The function deals with the whole life of the barcode object by calling the other functions; it uses all the specified flags.
int Barcode_Version(char *versionname);
Returns the current version as an integer number of the form major * 10000 + minor * 100 + release. Therefore, version 1.03.5 will
be returned as 10305 and version 0.53 as 5300. If the argument is non-null, it will be used to return the version number as a
string. Note that the same information is available from two preprocessor macros: BARCODE_VERSION (the string) and BARCODE_VER-
SION_INT (the integer number).
4th Berkeley Distribution October 1999 BARCODE(3)