table of contents
other versions
other sections
BARCODE(3) | GNU barcode | BARCODE(3) |
NAME¶
barcode - a library to create and print bar codesSYNOPSIS¶
#include <barcode.h>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.- 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).
October 1999 | 4th Berkeley Distribution |