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 texinfo 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 representation, 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_NOHEADERS, 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_VERSION_INT (the
              integer number).