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)