Home

TBarCode/X User Manual V11

1. Index Symbol size rows x cols Index Symbol size rows x cols 0 Automatic calculation 17 83 x 83 1 15x15 18 87 x 87 2 19x19 19 91x91 3 23 x 23 20 95 x 95 4 27x27 21 101 x 101 5 31 31 22 105 x 105 6 37 x 37 23 109 x 109 7 41x41 24 113 x 113 8 45 x 45 25 117 117 9 49 x 49 26 121 x 121 10 53 x 53 27 125 x 125 11 57 x57 28 131 x 131 12 61 x 61 29 135 x 135 13 67 x 67 30 139 x 139 14 71x71 31 143 x 143 15 75 75 32 147 x 147 16 79 79 33 151 x 151 And 3 special sizes usually used only for reader programming 34 19 x 19 reader progr 36 27 x 27 reader progr 35 23 x 23 reader progr Table 44 Aztec Code Symbol Sizes C 10 2 Format This table shows the possible formats for Aztec Code barcodes The format can be defined by the control sequence ACformat ndex Index Format Description WWW TEC IT COM Page 85 of 97 Default format Default GS1 UCC EAN Adds an FNC1 as first symbology character to indicate usage within the GS1 system Industry Encodes the format specifier followed by an FNC1 at second position to indicate usage for particular industry standards Table 45 Aztec Code Format Options C 11 DotCode Parameters C 11 1 Format This table shows the possible formats for DotCode barcodes The format can be defined by the control sequence DCformat ndex Index Format 0 Auto default If the d
2. f tbhearcodesps x send content of the registered filter to console f tharcode ps 8 5 2 2 Create Virtual Printer In order to use the filter create a printer based on the tbarcode input Example local printers PostScript lpadmin p tbcprintlocall v dev bpp0 D TBarCode Printer on parallel port lpadmin p tbcprintlocall m lp printer model n lt path ppdfile gt lpadmin p tbcprintlocall I tbarcode ps T unknown usr bin enable tbcprintlocall usr sbin accept tbcprintlocall lpadmin p tbcprintlocal2 v dev cua b D TBarCode Printer on serial port lpadmin p tbcprintlocal2 m lp printer model n lt path ppdfile gt lpadmin p tbcprintlocal2 I tbarcode ps T unknown usr bin enable tbcprintlocal2 usr sbin accept tbcprintlocal2 Example network printer PCL lpadmin p tbcprintremote v dev null D TBarCode network Printer lpadmin p tbcprintremote o dest lt printer ip gt lt printer port gt o protocol tcp o timeout 5 lpadmin p tbcprintremote m lp printer model n lt path ppdfile gt lpadmin p tbcprintremote I tbarcode pcl T unknown usr bin enable tbcprintremote usr sbin accept tbcprintremote Real example PostScript lpadmin p tecitdevel v dev null D TBarCode network Printer lpadmin p tecitdevel o dest 172 16 100 104 9100 o protocol tcp o timeout 5 lpadmin p tecitdevel I tbarcode ps T unknown us
3. WWW TEC IT COM 60 Code128 Subset B 1 2 3 4 1 2 3 4 1B 2B 3B 4B 1S 2S 3S8 4S eCDCode128 61 Code128 Subset C 1 2 3 4 1 2 3 4 1 2 3 4 15 25 35 45 eCDCode128 62 Code 93 Ascii 1 2 3 4 1 2 3 4 1 2 3 4 15 25 35 45 eCD2Mod47 63 Australian Post standard 1 1 1B 1S eCDNone customer barcode 64 Australian Post customer 1 1 1B 1S eCDNone barcode 2 65 Australian Post customer 1 1 1B 1S eCDNone barcode 3 66 Australian Post Reply Paid 1 1 1B 1S eCDNone barcode 67 Australian Post Routing 1 1 18 15 eCDNone barcode 68 Australian Post Redirection 1 1 1B 1S eCDNone barcode 69 ISBN 13 EAN13P5 1 2 3 4 1 2 3 4 1B 2B 3B 4B 1S 2S 3S 4S eCDEAN13 70 Royal Mail 4 State customer 1 1 18 15 eCDNone code RM4SCC 71 Data Matrix 1 1 1B 1S eCDNone 72 EAN 14 1 2 3 4 1 2 3 4 1 2 3 4 15 25 35 45 eCDEAN14 73 VIN FIN 1 3 1 3 1B 2B 1S 2S eCDNone 74 Codablock F 1 2 3 4 1 2 3 4 1B 2B 1S 2S eCDCodablockF 75 NVE 18 1 2 3 4 1 2 3 4 1B 2B 3B 4B 1S 2S 3S8 4S eCDMod10 76 Japanese Postal customer 1 1 1 1 eCDNone code 77 Korean Postal Authority Code 1 3 4 1B 1S 2S eCDMod10Kor 78 GS1 DataBar Truncated 1 2 3 4 5 6 7 8 9 1 1B 2B 3B 4B 5B 6B 7B 8B 9B eCDNone RSS 14 Truncated 2 3 4 5 6 7 8 9 18 28 38 48 58 68 78 88 98 79 GS1 DataBar Stacked RSS 1 2 3 4 5 6 7 8 9 1 1B 2B 3B 4B 5B 6B 7B 8B 9B eCDNone 14 Stacked 2 3 4 5 6 7 8 9 18 28 38 48 58 68 78 88 98 80 GS1 DataBar Stacked 1 2 3 4 5 6 7 8 9 1 1B 2B 3B 4B 5B 6B 7
4. easybar ON insert MODE Only for experts Sets the insert position for the barcode data within the PS or PCL file Possible values beforeline afterline beforestring default afterstring Example insert afterline insertpattern Only for experts Scan spool file for a specific pattern The pattern indicates the line in which the EPS output bar code image should be inserted For PostScript only Example insertpattern Specific PS Code insert afterline linebyline Only for experts Filters the data stream line by line Normally a barcode escape sequence can span multiple lines of the input file The end of the escape sequence marked with by default can be several lines after the start of the escape start sequence When line by line filtering is activated the escape sequence is limited to the current line of the input file stream This flag can help to recover from filter errors in invalid or unsupported input files Table 3 Filter Options Additionally there are a number of filter options that can be set individually for each barcode see Section 7 5 7 4 4 Compatibility Options V1 Format The format of the barcode parameters has changed from TBarCode X version 1 x to version 2 0 and higher This also implies that the syntax of the barcode control sequences has changed The TBarCode X command line application can be run in compatibility mo
5. PDFchecksum SUM Sets the checksum Table 17 Macro PDF417 Options 7 5 13 Data Matrix Settings The following parameters are optional and can be used to fine tune the generation of Data Matrix Short Long Description DMsize SIZE Sets the Data Matrix size The Data Matrix sizes can be looked up in Section C 5 1 Symbol Sizes DMformat FORMAT Sets the Data Matrix format The Data Matrix formats can be looked up in section C 5 2 Format DMbinary Barcode content is encoded in binary mode DMrect Draws Data Matrix as a rectangle Square is default DMsum SUM Sets the total number of structured append symbols Possible values 2 16 pMindex NDEX Sets the index of the current structured append symbol Possible values 1 16 DMfile D Sets the file id of structured append Table 18 Data Matrix Options WWW TEC IT COM Page 42 of 97 7 5 14 MaxiCode Settings The following parameters are optional and can be used to fine tune the generation of MaxiCode Short Long Description MCmode MODE Sets the mode of the MaxiCode Possible values w 2 5 MCundercut UNDERCUT Sets the undercut of the hexagons Unit of measurement Percents Possible values 0 100 MCpre PREAMBLE Sets the preamble MCsum SUM Sets the total number of structured append symbols MCindex
6. format TYPE Defines the output format Possible values Lees PostScript Default w POD nous PCL PDF PDFFRAG PDF fragment IMAGE Image bitmap Adobe Illustrator 7 SVG SVG The default setting is format PS In filter mode the output format is the same as the format of the input stream When format IMAGE is set determines the bitmap format Example creating a barcode as GIF then the parameter imageformat format IMAGE imageformat GIF output Barcode gif Note Text output HRT is not supported with PDF Al and IMAGE format imageformat FORMAT Defines the bitmap format which is used for output This parameter is only relevant when format IMAGE is set FORMAT is the extension of the bitmap format Currently supported formats are BMP default GIF JPG PNG and TIF Example format IMAGE imageformat GIF output Barcode gif dpi DPI Sets the resolution of the image Unit of measurement Dots per inch dpi nooverhead Suppresses the PCL or PostScript overhead PCL Reset commands are omitted on begin and at the end of the file PostScript The overhead for encapsulated PostScript EPS is omitted pclmode MODE The PCL output mode By default TBarCode X creates PCL Level 5 compatible output PCL Level 5 compatible output includes HP GL 2 drawing operations Some barcode types
7. 8 2 CUPS Printing System In CUPS you can install filters for specific mime type conversions TBarCode Filter can be installed to handle mime types application postscript application pcP and application octet stream gt You cannot apply TBarCode X filter on a raw queue because such queues will ignore all filters You have to use queues with local filtering using a printer driver ppd 8 2 1 Setting up TBarCode X Spool Filter for PostScript Output The following changes have to be made to the MIME type conversion file of CUPS 1 Open etc cups mime convs Or usr share cups mime mime convs 2 Search for the line with the pstops conversion rule application postscript application vnd cups postscript 66 pstops CUPS 1 0 1 1 Replace pstops with usr local share tbarcodell filtercups ps sh The line should look like this application postscript application vnd cups postscript 66 usr local share tbarcodell filtercups ps sh CUPS 1 2 x and later In mime convs change the line as follows application postscript application vnd cups postscript 66 filtercups ps sh Retrieve your CUPS installation directory cups config serverbin It should be usr lib cups In this case filters must be in the filter subdir usr lib cups filter Create a sym link to place the TBarCode X filter script into this sub dir In s usr local share tbarcodell filtercups ps sh usr lib cups filter filtercups ps sh 3
8. DCdirection DIRECTION Optimizes the DotCode symbol for a specific print direction If omitted no optimization is done default Possible values horz Optimize for horizontal printing vert Optimize for vertical printing DCratio RATIO Sets the with height ratio for the DotCode symbol An aspect ratio between 1 2 and 2 1 is recommended The default ratio is 3 2 Example DCratio 4 3 DCcols COLUMNS Sets the barcode width in dots The number of rows is determined automatically if not set Please note If DCratio is specified this parameter will be ignored DCrows ROWS Sets the barcode height in dots The number of columns is determined automatically if not set Please note If DCratio or DCcolumns is specified this parameter will be ignored DCbinary Barcode content is encoded in binary mode DCformat FORMAT Specifies the DotCode format The possible values can be looked up in section C 11 1 Format DCspec SPECIFIER Sets the format specifier Is considered only when DCformat is set to 3 ndustry format The specifier must consist of 1 letter upper or lower or 2 digits DCmask MASK Sets the mask pattern 0 3 Default The mask is computed automatically time consuming DCappend Enables the structured append mode DCsum SUM Sets the total number of the structured append symbols Possible values 2 w 35
9. DCindex NDEX Sets the index of the current structured append symbol Possible values l1 39 Table 24 DotCode Options 7 5 20 Han Xin Code Settings All of these parameters are optional and can be used to fine tune the generation of Han Xin Code Short Long Description HXversion VERSION Specifies the symbol version the symbol size For a list of different versions see section C 12 1 Possible values 0 Auto default 1 84 Fixed symbol sizes from 23x23 to 189x189 squares HXecl LEVEL Sets the error correction level For details on each level see section C 12 2 Possible values 0 L1 default 1 L2 2 L3 WWW TEC IT COM Page 45 of 97 3 L4 Note The default level changed from L2 to L1 in V11 1 0 HXmask MASK Sets the mask pattern 0 3 Default The mask is computed automatically time consuming HXbinary Barcode content is encoded in binary mode Table 25 Han Xin Code Options 7 5 24 GS1 DataBar Expanded Stacked Settings This parameter is optional and can be used to fine tune the generation of GS1 DataBar Expanded Stacked formerly RSS Expanded Stacked Short Long Description pBseg SEGMENTS Sets the number of segments per row Possible values w 22 22 Table 26 GS1 DataBar Expanded Stacked Options 7 5 22 Composite Barcode Settings This parameter is optional and
10. QRec1 ndex Index Error Correction Level 0 Low 1 Medium 2 Quartile Default 3 High Table 40 QR Code Error Correction Levels C 8 Micro QR Code Parameters C 8 1 Version Symbol Sizes This table shows the possible user defined symbol sizes for Micro QR Code The symbol size can be defined by the parameter MORversion ndex Index Symbol size rows x cols Index Symbol size rows x cols 0 Automatic calculation 3 15x15 1 11x11 4 17 x 17 2 13 13 Table 41 Micro QR Code Symbol Sizes C 8 2 Error Correction Level This table shows the possible Error Correction Levels for Micro QR Code barcodes The Error Correction Level can be defined by the parameter MoRec1 ndex Index Error Correction Level 0 Low 1 Medium WWW TEC IT COM Page 84 of 97 2 Quartile 3 High not used Table 42 QR Code Error Correction Levels C 9 Codablock F Parameters C 9 1 Format This table shows the possible formats for Codablock F barcodes The format can be defined by the parameter CBformat ndex Index Format 0 Default format 1 GS1 UCC EAN Table 43 Codablock F Parameters C 10 Aztec Code Parameters C 10 1 Symbol Sizes This table shows the possible user defined symbol sizes for Aztec Code The symbol size can be defined by the parameter ACsize ndex
11. pkgrm SMCliconv install the TEC IT iconv library cer ceci pko gz iuge xw pkgadd d teciticonv 1 13 1 solaris 10 sparc pkgexport A 2 Shared Library Path TBarCode X is shipped with the shared library libtbarcode installed in usr local 1lib TBarCode X also depends on the GCC runtime libraries If the dynamic linker can t find one of these libraries it will abort loading the program You see messages like error while loading shared libraries libtbarcodell so 0 cannot open shared object file No such file or directory gt The solution for this problem is to add the library installation path to the shared library search path of your system See next chapters for how to do this for your operating system 17 Some TBarCode X binaries are statically linked and contain no libtbarcode WWW TEC IT COM Page 69 of 97 2 1 Background Each version of UNIX has its own specific method of searching for libraries specifically this process is done by a program called 14 50 or on HP UX dld so or similar You can add the library path as system wide default or you can prefer to use a wrapper script that sets the library path appropriately before launching the executable If you have a compelling reason to add a path to many programs you can change the system s default search path Setting a specific library path in a wrapper script can provide a workarou
12. 2547 216976 702 20055 20055 2005 20055 20055 20055 20055 20055 20055 2005 09 09 09 09 2 20 09 09 09 09 userxy SuSE93 gt 11 usr local share tbarcodell filltercups filltercups ps sh fillterlprng 56 filterlprng sh license ini samples tbarcode tbarcode conf tbarcoded tbarcoded conf Dates and file sizes may vary the important information is marked bold The file tbarcode needs execute rights and the user id SUID bit needs to be set The file tbarcoded needs to have execute rights for its owner Missing attributes may be set by root only with chmod tbarcode chmod tbarcoded 5 7 SAP R 3 and SAP ERP Integration TBarCode X can be used with SAP systems to generate bar codes during printing Please request more information about the required configuration steps under the following email addresses sap tec it com support tec it com WWW TEC IT COM Page 22 of 97 6 Testing TBarCode X After installation of TBarCode X it is advisable to test it This can be done from any console terminal 6 1 Run TBarCode X from Command Line 6 1 1 Run the TBarCode Command Open a new console terminal and type the following command tbarcode output barcode eps barcode 20 data abc1234 This should create a new PostScript file containing a barcode You can view the barcode using a PostScript viewer for example KGhostvi
13. 5 3 3 Missing usr local directory 5 3 4 Common Problems 5 3 5 Uninstall TBarCode X 5 4 Install TBarCode X on SCO Operating Systems 5 4 1 Remove TBarCode X 5 5 Install TBarCode X on Mac OS X 5 5 1 Installation Path 5 5 1 1 TBarCode X V9 5 5 1 2 TBarCode X V10 and later 5 5 2 Remove TBarCode X V9 5 6 File Permissions 5 6 1 TBarCode X without Daemon newer versions 5 6 2 TBarCode X with Daemon elder versions 5 7 SAP R 3 and SAP ERP Integration 6 Testing TBarCode X 6 1 Run TBarCode X from Command Line 6 1 1 Run the TBarCode Command 6 1 2 Run TBarCode as Filter 6 2 Demo License Restriction 6 3 TBarCode X isn t Working 7 Using TBarCode X 7 1 Create a Barcode 7 1 1 Create a Barcode in EPS PostScript Format WWW TEC IT COM Page 2 of 97 7 2 7 2 1 7 2 2 7 2 3 7 3 7 3 1 7 4 7 4 1 7 4 2 7 4 3 7 4 4 7 4 5 7 4 6 7 5 7 5 1 7 5 2 7 5 3 7 5 4 7 5 5 7 5 6 7 5 7 7 5 8 7 5 9 7 5 10 7 5 11 7 5 12 7 5 13 7 5 14 7 5 15 7 5 16 7 5 17 7 5 18 7 5 19 7 5 20 7 5 21 7 5 22 7 5 23 7 5 24 7 6 7 6 1 7 6 2 7 6 2 1 7 6 2 2 7 6 3 7 6 4 7 6 5 8 5 2 8 5 2 1 8 5 22 8 5 23 8 5 3 Create a Barcode in PCL 5 HP GL 2 Format Create a Barcode in PDF Portable Document Format Create a Barcode in Bitmap Format Filter a Print Job or Document File Control Sequence Structure Insert a Barcode into a PostScript Document Insert a Barcode into a PCL Document TBarCode X Command Line Tool
14. LibT BarCode The text callback function now supports UNICODE Minimalistic font handling support for PCL export was implemented The module width can now be set in double precision 64 bit floating point The list of the supported application identifiers GS1 128 was updated Check digit method Modulo 10 Luhn Algorithm has been added New installation path usr local share tbarcode1 0 3 5 1 3 What s new in V9 New Barcode types Micro QR Code Health Industry Bar Codes HIBC Full support of Aztec Code optimized encoding Improved quiet zone adjustment Works for all barcodes now Calculate optimal bitmap sizes PDF output Improved bar width reduction handling units decimal numbers Adding ZLib to the X64 version setup New installation path usr local share tbarcode9 3 5 1 4 What s new in V8 New Barcode type Aztec Code inclusive the according settings Several 1D bar codes have been implemented DAFT Code Italian Postal 2 of 5 DPD Callback functions for MaxiCode New attributes for parameter bearer type New installation path usr local share tbarcode8 3 5 1 5 What s new in V7 Image output is now integrated in TBarCode X ImageMagick is not required anymore The code base is now identical with TBarCode DLL Library for Windows and Windows Mobile Detailed version info including version of TBarCode library and revision number New parameters linebyline insertpattern onnodata compress bearerw
15. NDEX Sets the index of the current structured append symbol Possible values 1 8 MCservice SERVICE Sets the service class of the structured carrier message MCcountry COUNTRY Sets the country code of the structured carrier message MCpostal POSTAL Sets the postal code of the structured carrier message Table 19 MaxiCode Options 7 5 15 QR Code Settings The following parameters are optional and can be used to fine tune the generation of QR Code Short Long Description QRversion VERSION Sets the QR Code version symbol size The possible values can be looked up in section C 7 1 Version Symbol Sizes QRformat FORMAT Sets the QR Code format The possible values can be looked up in section C 7 2 Format QRind NDICATOR Sets the format application indicator QRecl LEVEL Sets the error correction level The error correction levels can be looked up in section C 7 3 Error Correction Level Possible values 0 default 2 3 QRmask PATTERN Sets the mask pattern 0 7 Default The mask is computed automatically time consuming QRsum SUM Sets the total number of structured append symbols Possible values 2 16 QRindex NDEX Sets the index of the current structured append symbol Possible values 1 16 QRparity PARITY Sets the parity byte structured append
16. add gcc library path to SHLIB PATH export SHLIB PATH your gcc lib path SHLIB PATH add libtbarcode directory to SHLIB PATH export SHLIB PATH usr local lib SHLIB PATH Use a dynamic search path for a specific library if listed as static checi l opie Gee lib 2 3 1 SHLIB Path Being Ignored SHLIB Path being ignored for Non root users WWW TEC IT COM Page 71 of 97 For looking up shared libraries for setuid applications the dynamic loader uses only the paths listed in etc dld sl conf In other words the security system won t let SUID root applications look at SHLIB PATH LD LIBRARY PATH You must include the paths also in etc dld sl conf 2 3 2 Not finding libstdc Install the gcc lib version which was used for building the binary see A 1 2 3 Add the gcc lib path to SHLIB PATH or LD LIBRARY PATH fthe gcc lib path is different from the static search path stored in the binary enable dynamic lookup with the following command Use a dynamic search path for a specific library if listed as static cho i Mee b 515 A 2 4 AIX On AIX the system variable LIBPATH is used to set the runtime linker search path On demand add the installation path of the TBarCode X libraries libtbarcode as follows export LIBPATH usr local lib LIBPATH If the gcc runtime libraries are not found export the LIBPATH environment
17. gt tbarcode command is here Library Frameworks TBarCode framework Versions 10 2 1 Commands directory with all headers Library Frameworks TBarCode framework Versions 10 2 1 Headers eS directory with the portable shared library for apps using TBarCode X library Library Frameworks TBarCode framework Versions 10 2 1 Libraries directory with all resources sample demos CUPS filters manuals Library Frameworks TBarCode framework Versions 10 2 1 Resources TBarCode X shared library Library Frameworks TBarCode framework Versions 10 2 1 TBarCode To use tbarcode TBarcode X 10 2 1 Library Frameworks TBarCode framework Versions 10 2 1 Commands tbarcode Last version of TBarCode X Library Frameworks TBarCode framework Commands tbarcode or use the PATH variable export PATH Library Frameworks TBarCode framework Versions 10 2 1 Commands PATH tbarcode 5 5 2 Remove TBarCode X V9 If you have installed TBarCode X on Mac OS you can remove it by moving following directories to the Trash tecit TBarCode9 Library Frameworks TBarCode framework 5 6 File Permissions The executables of TBarCode X require certain file permissions After installation these permissions should be set properly You can ensure this by checking the directory entries of usr local share tbarcodell using the command 11 usr local share tbarcodell Depending on the operation mode of TB
18. 10 Encoding Options 37 Table 11 Barcode Appearance Options 39 Table 12 Barcode Quality Options 39 Table 13 Colors Color and Background Modes 40 Table 14 Filtering Options 41 Table 15 PDF417 Options 42 Table 16 Micro PDF417 Options 42 Table 17 Macro PDF417 Options 42 Table 18 Data Matrix Options 42 Table 19 MaxiCode Options 43 Table 20 QR Code Options 43 Table 21 Micro QR Code Options 44 Table 22 Codablock F Options 44 Table 23 Aztec Code Options 45 Table 24 DotCode Options 45 Table 25 Han Xin Code Options 46 Table 26 GS1 DataBar Expanded Stacked Options 46 Table 27 Composite Barcode Options 46 Table 28 Deprecated Options 46 Table 29 TBarCode X Configuration Files 47 Table 30 Barcode Symbologies 80 Table 31 Check Digit Methods and Enumerators 81 Table 32 PDF417 Encoding Mode 81 Table 33 Micro PDF417 Symbol Sizes 82 Table 34 Micro PDF417 Modes 82 Table 35 Data Matrix Symbol Sizes 83 Table 36 Data Matrix Formats 83 Table 37 MaxiCode Modes 83 Table 38 QR Code Symbol Sizes 84 Table 39 QR Code Format Options 84 Table 40 QR Code Error Correction Levels 84 Table 41 Micro QR Code Symbol Sizes 84 Table 42 QR Code Error Correction Levels 85 WWW TEC IT COM Page 7 of 97 Table 43 Table 44 Table 45 Table 46 Table 47 Table 48 Table 49 Table 50 Table 51 Table 52 Table 53 Table 54 Table 55 Table 56 Table 57 Table 58 Table 59 Codablock F Parameters Aztec Code Symbol Sizes Aztec C
19. 103 HIBC PAS Data Matrix 1 1 18 15 eCDMod43 104 HIBC LIC QR Code 1 1 1 1 eCDMod43 105 HIBC PAS QR Code 1 1 1 1 eCDMod43 106 HIBC LIC PDF417 1 2 3 4 5 6 7 8 1 2 1B 2B 3B 4B 5B 6B 7B 8B 1S 2 eCDMod43 3 4 5 6 5 35 45 55 65 107 HIBC PAS PDF417 1 2 3 4 5 6 7 8 1 2 1B 2B 3B 4B 5B 6B 7B 8B 1S 2 eCDMod43 3 4 5 6 5 35 45 55 65 108 HIBC LIC MicroPDF417 1 2 3 4 5 6 1 2 3 4 1B 2B 3B 4B 5B 6B 1S 28 38 4 eCDMod43 5 6 5 55 65 109 HIBC PAS MicroPDF417 1 2 3 4 5 6 1 2 3 4 1B 2B 3B 4B 5B 6B 1S 2S 3S 4 eCDMod43 5 6 5 55 65 110 HIBC LIC Codablock F 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDMod43 111 HIBC PAS Codablock F 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDMod43 112 QR Code 2005 1 1 18 15 113 PZN8 Pharma Zentral 1 2 5 1 2 5 1B 2B 1S 2S eCDPZN Nummer Germany 8 digits 114 Reserved seen J 115 DotCode 1 1 1B 1S eCDNone 116 Han Xin Code 1 1 1B 1S eCDNone 117 USPS Intelligent Mail amp 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 4S eCDCode128 Package Barcode 118 Swedish Postal 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 4S eCDSwedishPostal Shipment Item ID Barcode 119 Royal Mail CMDM Mailmark 1 1 1B 1S eCDNone Reserved but not implemented Table 30 Barcode Symbologies C 2 Check Digit Methods The check digit calculation method can be set with the parameter checkdigit Number For example checkdigit 2 sets the Modulo 10 check digit method WWW TEC IT COM Ind
20. 18 28 38 48 eCDCode128 switching auto compress Page 77 of 97 WWW TEC IT COM WWW TEC IT COM Code128 A B C see below 21 Deutsche Post Leitcode 1 3 1 3 1B 2B 18 28 eCDDPLeit 22 Deutsche Post Identcode 1 3 1 3 1 28 1 2 eCDDPident 23 ISBN 13 5 digits add on 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDNone 24 ISMN 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDNone 25 Code 93 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCD2Mod47 26 ISSN 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDNone 27 ISSN 2 digits addon 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDNone 28 Flattermarken 1 1 18 15 eCDNone 29 GS1 DataBar RSS 14 1 2 3 4 5 6 7 8 9 1 1B 2B 3B 4B 5B 6B 7B 8B 9B eCDNone 2 3 4 5 6 7 8 9 15 25 35 45 55 65 75 85 95 30 GS1 DataBar Limited RSS 1 2 3 4 5 6 7 8 9 1 1B 2B 3B 4B 5B 6B 7B 8B 9B eCDNone Limited 2 3 4 5 6 7 8 9 15 25 35 45 55 65 75 85 95 31 GS1 DataBar Expanded RSS 1 2 3 4 5 6 7 8 9 1 1B 2B 3B 4B 5B 6B 7B 8B 9B eCDNone Expanded 2 3 4 5 6 7 8 9 15 25 35 45 55 65 75 85 95 32 Telepen Alpha 1 3 1 3 1B 2B 1S 2S eCDNone 33 UCC128 EAN128 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDCode128 34 UPCA 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDUPCA 35 UPC A 2 digit add on 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDUPCA 36 UPC A 5 digit add on 1 2 3 4 1 2 3 4 1B 2B 3B 4B 1S 2S 3S8 4S eCDUPCA
21. 4 height linch height 100px m modulewidth WIDTH Sets the module width Unit of measurement millimeters default or mm mils inch px Pixels Example modulewidth 0 254 modulewidth 13mils modulewidth 5px See also sizemode printratio optimalwidth mustfit STATE When activated TBarCode X returns an error if the barcode does not fit into the given bounding rectangle defined by width height Possible values On off default Example mustfit OFF rot ROTATION Sets the rotation of the barcode Unit of measurement degrees counterclockwise only 90 angles are sup ported Possible values 0 default 00 WWW TEC IT COM Page 34 of 97 180 270 Examples 90 rot 180 sizemode MODE Sets the mode that determines the barcode size fit The parameters width and height determine the size module parameter modulewidth determines the size width minimal The parameters decoder dpi determine the size The default size mode is fit If no width and or height is specified the bar code size depends on internal default values When sizemode MINIMAL is used TBarCode X automatically considers the decoding solution and the resolution of the document It will then create a barcode with minimal size that should be optimally readable under the given conditions Example scenario You are rec
22. Modified by TEC IT to call TBarCode filter tbarcode filter export LD PRELOAD usr local share teciticonv lib libiconv sl export LD LIBRARY PATH usr local lib generate a temp filename PROCFILE mktemp d tmp p tbarcode Wei win Siewiles do call barcode engine add S for SAP output 7067 local share tbarcodell tbarcode lt Sprint file SPROGETLE replace original file with process file my SPROCEILE Sprint fiet done 1 Next we insert a call to tbarcode filter at two places each time before REALMODEL fi Modified by TEC IT to perform the TBarCode filter ilter 1 SREALMODEL job user title copy options 11 gt debugf exit 0 while do Modified by TEC IT to perform the TBarCode filter on 27th Oct 2009 barcode Miter 1 Save the stderr messages in a temporary log file and discard stdout which is the peripheral output SREALMODEL job Suser title Scopy Soptions 11 SHPNPF 2 gt gt LOG gt dev null Now the filter is called before the spool job is sent to the printer with the SREALMODEL command 8 4 6 Printing Script HP UX 11 11 Edit the script and insert the bold lines before the Realmodel command WWW TEC IT COM Page 55 of 97 while do He EE HH HHH HE EE HE EH EE EE E FE FE HE EH HE EE TE E HEE EH HH START TECIT generate a temp filename P
23. Symbol Sizes C 10 2 Format C 11 DotCode Parameters C 11 1 Format C 12 Han Xin Code Parameters C 12 1 Version Symbol Sizes C 12 2 Error Correction Level C 13 Encoding Bytes and Control Characters in Input Data C 13 1 Implemented Escape Sequences C 13 2 Encoding Bytes or Binary Values C 13 3 Symbology Specific Control Characters C 14 Formatting Barcode Data C 15 PCL Font Numbers Appendix D Using Version 1 x Format D 1 Overview V1 Format Appendix E TBarCode Daemon E 1 Usage E 2 Options E 2 1 General Options E 2 2 Daemon and IPC Options E 3 Error Message and Debug Options E 3 1 Informative Output Appendix F ASCII Table Appendix G Knowledge Base G 1 Unix Printing HP UX and Solaris G 1 1 SVR4 Spooling System G 1 2 Interface Programs BSD and SVR4 G 1 3 Printer Interface Scripts HP UX G 1 4 Links WWW TEC IT COM Page 5 of 97 1 1 Table of Figures Figure 1 TBarCode X with Daemon as Background Server Process Figure 2 TBarCode X without Daemon Figure 3 Printing with TBarCode X Figure 4 HP UX Printer Models Interfaces WWW TEC IT COM 13 13 49 54 Page 6 of 97 1 2 List of Tables Table 1 General Options 28 Table 2 Output Format Settings 29 Table 3 Filter Options 30 Table 4 Compatibility Options 30 Table 5 Error Message and Debug Options 31 Table 6 Informative Output 31 Table 7 General Barcode Settings 34 Table 8 Barcode Size and Position 36 Table 9 Barcode Text Options 37 Table
24. Table 20 QR Code Options 7 5 16 Micro QR Code Settings The following parameters can be used to fine tune the generation of Micro QR Code optional Short Long Description MQRversion VERSION Sets the Micro QR Code version symbol size The possible values can be looked up in section C 8 1 Version Symbol Sizes WWW TEC IT COM Page 43 of 97 MQRecl LEVEL Sets the number of the error correction level The error correction levels can be looked up in section C 8 2 Error Correction Level Possible values 0 1 default 2 3 MORmask PATTERN Sets the mask pattern 0 4 Default The mask is computed automatically time consuming Table 21 Micro QR Code Options 7 5 17 Codablock F Settings The following parameters are optional and can be used to fine tune the generation of Codablock F Short Long Description CBrows ROWS Sets the number of rows Possible values 2 44 CBcols COLUMNS Sets the number of columns Possible values 4 62 CBrowheight HEIGHT Sets the height of a row Unit of measurement millimeters CBsepheight HEIGHT Sets the height of the row separator Unit of measurement millimeters CBformat FORMAT Sets the format Possible values 0 Standard default 1 GS1 EAN UCC Table 22 Codablock F Options 7 5 18 Aztec Code Settings The follo
25. can be used to fine tune the generation of Composite Barcodes Short Long Description CCtype TYPE Sets the type of composite component Possible values none auto A B Table 27 Composite Barcode Options 7 5 23 Multiple Barcodes Creating multiple 2D barcodes with auto structured append mode is supported in TBarCode X V9 and V10 gt Support for multiple bar codes was discontinued in Version 11 7 5 24 Deprecated Barcode Settings The following options are deprecated Deprecated Option New Option Replacement guardline WIDTH bearerwidth WIDTH and bearertype TYPE barsimmdefaults defaultset 1 RSSseg SEGMENTS DBseg SEGMENTS eS S SAP autocorrect ON enabled by default Table 28 Deprecated Options 7 6 TBarCode X Configuration Files Each TBarCode X executable has a configuration file to define global settings Executable Name of Configuration File tbarcode tbarcode conf WWW TEC IT COM Page 46 of 97 tbarcoded tbarcoded conf Table 29 TBarCode X Configuration Files Each time tbarcode or tbarcoded is started the application reads the configuration file gt Only system administrators can edit the TBarCode X configuration files 7 6 1 Path of Configuration Files TBarCode X searches in the following directories for a suitable configuration file Path specified in the
26. code page conversion is used input data is used as is HEXADECIMAL Input data is treated as pairs of hexadecimal values Bytes No code page conversion is performed Default mode is CODEPAGE Examples encodingmode HEXADECIMAL data 1B FE 1D 04 codepage ENCODING Sets the code page used for encoding the bar code data This parameter converts the input data to the specified code page If omitted the default encoding of the selected bar code type is used see our Barcode Reference for more information Escape sequences are translated before this conversion is applied With encoding mode RAW or HEXADECIMAL this parameter is ignored Possible values ANSI ANSI ASCII 1252 Windows 1252 LATINI ISO 8859 1 CPA37 ASCII Extended CP437 UTES Siue UTF 8 949 CP932 Japanese Shift JIS OP936 us Simplified Chinese CP950 Traditional Chinese ANSI Cyrillic CP20866 Russian KOI8 R Examples codepage UTF8 This parameter does not specify the encoding character set of the input characters see data Parameter for more information It is recommended to change the code page only in closed applications or when using ECI parameters in 2D codes many cases bar code readers decode the bar code data only with the default code page of the bar code hexbinary Enables hexadecimal encoding
27. control sequences in the print jobs or documents and replace them with bar code symbols either PCL or PostScript format The samples below give you a quick start for using TBarCode X in filter mode For more detailed instructions go ahead to sections 7 3 and 7 5 7 2 2 Insert a Barcode into a PostScript Document Place the following sequence into your document e g infile ps to create a barcode Text before Barcode tbcs fPS b71 m0 508 dMyBarcodeData tbce Text after Barcode Barcode sequence parameters Parameter Description tbcs Begin of barcode control sequence fPS Format of output is PostScript default b71 Generate barcode type Data Matrix 71 see section C 1 for more types m0 508 Set the module width X dimension to 0 508 mm dMyBarcodeData d marks the begin of barcode data all characters following will be encoded tbce End of barcode sequence Then call tbarcode with the following parameters tbarcode filter stream PS infile ps gt outfile ps Now the out file ps will contain the original file plus the drawing commands for the barcode WWW TEC IT COM Page 25 of 97 gt For automatic barcode generation via your spool system see chapter 8 7 2 3 Insert a Barcode into a PCL Document Place the following sequence into your document e g infile pcl to create a barcode Text before Barcode tbcs fPCL b71 m0 508 dMyBarcodeD
28. detects the type of the input stream Example stream PS escapebegin STRING Sets a string that identifies the beginning of a barcode control sequence The default value is _tbcs This string must be distinguishable from any PostScript or PCL PJL command In particular t must not begin with because 9 has special meaning in PJL t must not begin with 96 or any other special character that has a special meaning in PostScript t must be different than the string set with escapeend Example escapebegin BARCODEBEGIN escapeend STRING Sets a string that identifies the end of a barcode control sequence The default value is tbce This string must be distinguishable from any PostScript or PCL PJL command In particular t must not begin with because 9 has special meaning in PJL t must not begin with 96 or any other special character that has a special meaning in PostScript tmust be different than the string set with escapebegin Example escapeend BARCODEEND pclreset Creates PCL reset commands at the beginning and the end of the PCL stream in filter mode easybar STATE Enables or disables the handling of EasyBar control sequences Possible values on off default EasyBar control sequences are another type of control sequences for embedding barcodes in PCL data streams Example WWW TEC IT COM Page 29 of 97
29. full path if required b13 Generate Barcode Type EAN 13 13 see section C 1 for more types m0 508 Set the module width X Dimension to 0 508 mm d 123456789012 Encode the data 123456789012 the check digit is calculated automatically Alternatively the Parameter fPDFFRAG could be used instead of fPDF In this case a PDF fragment would be generated instead of a valid document The fragment could be embedded into other PDF files WWW TEC IT COM Page 24 of 97 7 1 4 Create a Barcode in Bitmap Format The command below creates Code 39 barcode with the data content DATA1234 as GIF image tbarcode F IMACE Sobarcode gif b8 O Sd DATAIZ3 4 Parameter Description fIMAGE Generate bitmap image iGIF Selected image format GIF other formats may be BMP JPG PNG or TIF obarcode gif Write barcode to the output file barcode gif specify full path if required b8 Generate Barcode Type Code 39 8 see section C 1 for more types 0 Optimize resolution required for bitmap graphics d DATA1234 Encode the data DATA1234 See section 9 1 Direct Method Create Bitmap Images with TBarCode X for more bitmap samples 7 2 Filter a Print Job or Document File 7 2 1 Control Sequence Structure The print job or document must contain filter control sequences in the following format Prefix Data Suffix In filter mode TBarCode X will decode the
30. http www tec it com WWW TEC IT COM Page 64 of 97 11 Contact and Support Information TEC IT Datenverarbeitung GmbH Address Hans Wagner Str 6 AT 4400 Steyr Austria Europe Phone 43 0 7252 72 72 0 Fax 43 0 7252 72 720 77 Email mailto barcode tec it com Web http www tec it com Adobe and Adobe Illustrator are are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and or other countries AIX amp AS 400 OS 400 are registered trademarks of IBM Corporation AMD and Opteron are trademarks of Advanced Micro Devices Inc BarSIMM is a registered trademark of JetMobile France Debian is a registered trademark of Software In The Public Interest Inc The mark FreeBSD is a registered trademark of The FreeBSD Foundation HTML DHTML XML XHTML are trademarks or registered trademarks of W3C World Wide Web Consortium Laboratory for Computer Science NE43 358 Massachusetts Institute of Technology 545 Technology Square Cambridge MA 02139 HP UX and PA RISC are registered trademarks of Hewlett Packard Company ImageMagick6 is a registered trademark of ImageMagick Studio LLC 40 Landenberg PA 19350 United States Intel and Itanium are registered trademarks of Intel Corporation JAVA is a registered trademark of Sun Microsystems Inc 901 San Antonio Road Palo Alto CA 94303 USA JAVASCRIPT is a registered
31. in Short style POSIX style for example tbarcode obarcode eps b20 d abci234 Long style GNU style for example WWW TEC IT COM Page 26 of 97 tbarcode output barcode eps barcode 20 data abc1234 Windows DOS style for example tbarcode output barcode eps b 20 data abc1234 The available options and barcode settings are described below using long style and short style Please note Only the most important parameters are available in short style 7 4 Options You can view the options of the TBarCode X command line application with tbarcode help 7 4 4 Global Options The following global or general options are typically specified in the tbarcode conf file Short Long Description inifile FILE Sets the path and name of the configuration file The default is usr local share tbarcodell tbarcode conf Example inifile home userXYZ myTbarcode conf license DIRECTORY Sets the path where the license file is located The default is usr local share tbarcodell Example license etc The name of the license file is always license ini globalxoffset X Sets an offset for the x coordinate This offset is added to the x coordinate of the barcode positions Unit of measurement millimeters Example globalxoffset 10 5 globalyoffset Y Sets an offset for the y coordinate This offset is added to the y coordinate of the barco
32. may be problems with PDF417 QR Code and Micro QR bar code generation due to missing code page s in the pre installed iconv library WWW TEC IT COM Page 68 of 97 Missing CP437 conversions Missing SHIFT JIS conversions Solution TEC IT provides the following pre built ibiconv binaries with full code page support TBarCode X TEC IT Iconv Library Download Links V9 0 0 GNU Iconv V1 12 Solaris 10 SPARC See folder SetupTBarCode dependences in the available TBarCode X installation package V9 0 5 GNU Iconv V1 13 1 Solaris 10 x86 htto www tec it com download tbarcodex unix linux Download aspx V10 0 0 Solaris 10 SPARC Other versions Please contact support tec it com Installation Untar if tar gz file and then install with pkgadd d teciticonv XXX pkg On x86 based systems this library will be a side by side installation and does not interfere with the system libiconv On SPARC systems a side by side installation is not possible see below On Solaris x86 platforms force the use of the TEC IT Iconv library with this command before calling tbarcode export LD PRELOAD usr local share teciticonv lib preloadable libiconv so On Solaris SPARC platforms the LD PRELOAD method cannot be used You have to replace the actual installation of iconv as follows get name of actually installed iconv package pkginfo grep iconv remove the package here we have SMCliconv from sunfreeware
33. most Linux distributions The following command creates a black and white PNG image gs dNOPAUSE dBATCH sDEVICE pngmono 72 g225x143 sOutputFile barcode png 4d barcode eps WWW TEC IT COM Page 61 of 97 The parameter 9225x143 sets the size of the image The size bounding box can be determined with gs dBATCH sDEVICE bbox barcode eps 9 3 Web Applications PHP You can use TBarCode X in dynamic web pages on your Linux server To create a barcode on demand in your PHP script you can execute tbarcode in a shell The syntax for creating bitmap barcodes JPG GIF PNG etc is described in the previous section 9 3 1 Display a Barcode in a Browser Here are two examples how to generate barcodes and display them in a web application 9 3 1 1 Example 1 Create the barcode image file with PHP mypage php be fille get random file name t gas wr pe shell execute tharcode barcode parameters Stmp bel fille Reference the file in your HTML output lt img src imgpath tmp bc file With this approach you periodically have to clean up the temporary created image files otherwise your hard drive will be flooded with barcode image files 9 3 1 2 Example 2 In your HTML image tag you reference a PHP script which creates a barcode image data stream mypage php lt img src BarcodeStream php data 1234 gt The BarcodeStream script creates a bar code image based upon the GET p
34. or binary file Alternatively you can directly specify the data as command line parameter with data Example datafile home userXY bcdata dat For the supported character encodings see data bcfile FILE Instead of specifying the barcode settings as command line parameters you can specify a file that contains the barcode settings Example tbarcode obc eps bcfile settings dat data 0123 Example content of settings dat barcode 20 modulewith 0 352 width 35 3 UTF 8 and 1252 are supported in TBarCode X V10 1 and later Previous versions support only ANSI ASCII Upcoming releases of TBarCode X may support custom encodings also in filter mode WWW TEC IT COM Page 32 of 97 height 15 The syntax of a barcode settings file is identical to the syntax of a configuration file See section 7 6 2 Syntax of a Configuration File c checkdigit NUMBER Sets the check digit calculation method The NUMBER of the check digit method can be looked up in Section C 2 Check Digit Methods For specific bar code types the standard check digit is calculated by default Examples checkdigit 3 autocorrect STATE Enables or disables auto correction of input data for specific bar code types Code 205 Interleaved Add a leading zero to the barcode data to produce even number of digits required by the encoder Code 39 Remove leading trailing asterisk
35. the usr spool 1p model directory Many of them have names that match the model numbers of Hewlett Packard printers and plotters When you configure your printer into the spooler e g with SAM you must specify which printer model interface script you want to use The model will be automatically copied from the usr spool lp model directory into the usr spool lp interface directory and given the name that you specified as printer name If you list the usr spool 1p model directory you will find printer interface scripts like HPGL1 draftpro hp2560 HPGL2 dumb laserjet PCL1 dumbplot laserjetIIIS PCL2 fonts hp2565a hp33447a paintjet PCL3 hp2225a hp2566b hp3630a quietjet PCL4 hp2225d hp2567b hp7440a rmodel PRINT3K model hp2227a hp2631g hp7475a rmttroff bf remote hp2228a hp2684a hp7550a ruggedwriter colorpro thinkjet deskjet and many others If you have an HP printer you will probably find a model script that matches its model number or name Those interface model scripts that match your printers typically do not need to be changed except we want to include TEC IT barcode software 18 Solaris 11 is using CUPS the information in this section applies only to Solaris 8 9 and 10 WWW TEC IT COM Page 96 of 97 gt In order to use TBarCode X we need some shell programming to customize the printer interface model scripts to meet our printing needs If you do not have an HP printer
36. try using the dumb interface model You might have to modify it to be able to use all of the features of your non HP printer but dumb should work for basic ASCII text printing If the dumb printer interface model script does not work contact your printer supplier for a UNIX line printer spooler interface script or try the script that most closely matches your non HP printer type G 1 4 Links Printing under Unix BSD SVR4 CUPS http ibgwww colorado edu lessem psyc51 12 usail peripherals printers http en wikipedia org wiki System V printing system http en wikipedia org wiki CUPS AIX HP UX Printing Guide Interoperability http www blacksheepnetworks com security resources aix hpux interop chapO08 print html WWW TEC IT COM Page 97 of 97
37. ypos POSITION Sets the absolute or relative y position of the barcode Unit of measurement millimeters The positioning mode absolute or relative positioning can be set with pos Examples pos abs ypos 100 pos rel ypos 10 5 origin ORIGIN Sets the origin of the barcode The origin is the coordinate that can be set with xpos and ypos Possible values top The origin is the top left corner of the barcode bottom The origin is the bottom left corner of the barcode Example WWW TEC IT COM Page 35 of 97 origin TOP Table 8 Barcode Size and Position 7 5 3 Text Settings These parameters can be used to fine tune the output of the human readable text They are opti onal Short Long Description E text POS Sets the position of the barcode of the readable barcode text or hides the barcode text Possible values below Draws the text below the bars default for most barcodes above Draws the barcode text above the bars h hide Hides the barcodes text draws only the bars Examples mex mm align ALIGNMENT Sets the horizontal text alignment Possible values default left center right Example align left fontsize SIZE Sets the size of the readable barcode text Unit of measurement Points font NAME Sets the font that is used for drawing the readable barcode text Th
38. 0456 WWW TEC IT COM Page 88 of 97 Control character Escape Sequence Barcode type s FNC1 210 Code128 EAN128 UCC128 FNC2 211 Code128 EAN128 UCC128 FNC3 212 Code128 EAN128 UCC128 FNC4 213 Code128 EAN128 UCC128 DC1 11 Code93 Code93Ext DC2 x12 Code93 Code93Ext DC3 x13 Code93 Code93Ext DC4 x14 Code93 Code93Ext Rs 1 MaxiCode Mode 3 4 SCM Gs 1 MaxiCode Mode 3 4 SCM Eot x04 MaxiCode Mode 3 4 SCM Table 50 Extended Escape Sequences C 14 Formatting Barcode Data The Format string specifies how the input data should be processed prior to encoding it please do not mix up the Format with the Ratio Format Placeholders in the specified format string can be mixed with constant data characters to build a final barcode data string Also control characters are supported With this feature it is possible to Select subsets in Code 128 GS1 128 formerly EAN UCC 128 even within the code Select the required start stop character for CODABAR Change the position of the check digit For MaxiCode Set the values of Date Preamble and Service Class Postal and Country code directly in the barcode data in conjunction with special escape sequences The placeholders are as follows Placeholder Description character Stands for the next character in the input data property Text amp Stands for all remaini
39. 2 Not Finding libtbarcode on Debian 4 Enter on the command line echo usr local lib etc ld so conf d tbarcode conf ldconfig This adds the installation path to the Id config directory and rebuilds the Id cache 23 HP UX In HP UX the search for dynamic libraries is controlled by LD_LIBRARY_PATH environment variable standard PATH format SHLIB PATH environment variable standard PATH format from etc SHLIB PATH LD PRELOAD environment variable specifies library names full path name RPATH the executable s embedded path embedded at link time by Id etc did sl conf one library directory per line Program attributes adjustable with the chatr command With the chatr command you can control for a specific executable how the runtime linker evaluates the library path look at the internal attributes of tbarcode chatr tbarcode example output on HP UX 11 11 tharcode shared executable shared library dynamic path search SHLIB PATH enabled 4E abiere embedded path disabled second opt gcc lib shared library list dynamic usr lib libpthread 1 dynamic usr lib libdld 2 static dynamic dynamic usr lib libm 2 dynamic Walleye 2 28 Use the following commands to adjust the search path for dependencies enable first to search in SHLIB PATH and then in the embedded path chatr s enable b enable tbarcode
40. 37 UPC E 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDUPCE 38 UPC E 2 digit add on 1 2 3 4 1 2 3 4 1 2 3 4 15 25 35 45 eCDUPCE 39 UPC 5 digit add on 1 2 3 4 1 2 3 4 1B 2B 3B 4B 1S 2S 3S8 4S eCDUPCE 40 USPS PostNet 5 ZIP 5 digits 1 1 1B 1S eCDPostNet 41 USPS PostNet 6 ZIP 5 digits 1 1 1B 1S eCDPostNet check digit 42 USPS PostNet 9 ZIP 4 1 1 1B 1S eCDNone 43 USPS PostNet 10 ZIP 4 1 1 1B 1S eCDPostNet check digit 44 27 PostNet 11 ZIP 4 1 1 1 1 eCDPostNet 45 USPS PostNet 12 ZIP 4 1 1 1B 1S eCDPostNet 2 check digit 46 Plessey Code 1 2 1 2 1B 2B 1S 2S eCDPlessey 47 MSI Plessey Code 1 2 1 2 1B 2B 1S 2S eCDMSI1 48 SSCC18 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDMod10 49 Reserved 0000000 50 LOGMARS 1 3 1 3 1B 2B 1S 2S eCDNone 51 Pharmacode One Track 1 3 2 4 2 3 1B 2B 1C 2C 18 28 eCDNone 52 PZN Pharma Zentral Nummer 1 2 5 1 2 5 1B 2B 1S 2S eCDPZN Germany 53 Pharmacode Two Track 1 1 18 15 eCDNone 54 Brazilian CEPNet 1 1 1 1 eCDUSPSPostnet 55 PDF417 1 2 3 4 5 6 7 8 1B 2B 3B 4B 5B 6B 7B 8B eCDNone 1 2 3 4 5 6 15 25 35 45 55 65 56 PDF417 Truncated 1 2 3 4 5 6 7 8 1B 2B 3B 4B 5B 6B 7B 8B eCDNone 1 2 3 4 5 6 15 25 35 45 55 65 57 MaxiCode 1 e eCDNone 58 QR Code 1 1 1B 1S eCDNone 59 Code128 Subset A 1 2 3 4 1 2 3 4 1 2 3 4 15 25 35 45 eCDCode128 Page 78 of 97
41. All barcode related control sequen ces are replaced by the corresponding barcodes automatically For example tbarcode filter input ps output ps This command processes the PostScript document input ps and searches for certain barcode control sequences in the file The control sequences are replaced with barcodes The resulting document that includes the barcodes is written to output TBarCode X can be installed in the printing system to automatically filter print jobs 4 1 2 TBarCode X Library TBarCode X Library also referred to as LibTBarCode is available as static and shared library and as framework for Mac OS It provides functions to generate barcodes The TBarCode X command line application uses the functions of the library to create the barcodes Programmers can use the library to add barcode generation capabilities to their own applications By default all required library files and header files for C C are automatically installed The complete documentation of the TBarCode X Library API is available online http www tec it com Download gt TBarCode X gt develop your own applications with the TBarCode X Library you need to acquire a deve loper license from TEC IT Just visit our website http www tec it com or contact us to find out more 4 1 2 1 TBarCode X Library Java Interface For LibTBarCode we provide a Java Interface This interface uses JNI and consists of Java Classes and a J
42. Available If there is no f1 attribute available recreate the printer queue with option Local filtering before sending to print server The commands used to create a virtual printer the mkvirprt or smit virprt commands copy a predefined virtual printer definition and create a customized virtual printer definition for the specified queue and queue device If there are no printer definitions available you need to install them 8 4 HP UX s Printing System This section describes how to setup TBarCode X as a filter in the standard Ip spooler coming with HP UX 11 xx Please read Section G 1 Unix Printing HP UX and Solaris for background information First you should perform a basic test to see if the filter works on your system These tests are described in Section 6 1 2 Run TBarCode as Filter 8 4 1 Spool System HP UX 11 xx can use the Ip spooler or the HPDPS spooler both can be configured with SAM Below we focus on the SVR4 based Ip spooler which is the default printing mechanism in HP UX 11 WWW TEC IT COM Page 53 of 97 If you have installed LPRng which is also available for HP UX the installation procedure would be the same as for Linux HPDPS is also supported by TBarCode X but the installation is more complex gt Please contact our support if you need help 8 42 Using a Local Printer TBarCode X can be integrated into the model files located in usr lib 1p These files are scripts that handle and describe t
43. B 8B 9B eCDNone Omnidirectional RSS 14 2 3 4 5 6 7 8 9 15 25 35 45 55 65 75 85 95 Stacked Omnidirectional 81 GS1 DataBar Expanded 1 2 3 4 5 6 7 8 9 1 1B 2B 3B 4B 5B 6B 7B 8B 9B eCDNone Stacked RSS Expanded 2 3 4 5 6 7 8 9 18 28 38 48 58 68 78 88 98 Stacked 82 Planet Code 12 digits 1 1 1B 1S eCDMod10Pla 83 Planet Code 14 digits 11 1B 1S eCDMod10Pla 84 MicroPDF417 1 2 3 4 5 6 1B 2B 3B 4B 5B 6B eCDNone 1 2 3 4 5 6 18 28 38 48 58 68 85 USPS Intelligent Mail amp Barcode 1 1 1B 1S eCDNone 86 Plessey Code with 1 2 3 1 2 1B 2B 3T 18 28 eCDPlessey bidirectional reading support 87 Telepen 1 3 1 3 1B 2B 1S 2S eCDNone 88 951 128 EAN UCC 128 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDNone 89 ITF 14 1 3 1 3 1B 2B 1S 2S eCDNone 90 KIX 1 1 1B 1S eCDNone 91 Code 32 Italian Pharmacode 1 2 5 1 2 5 1B 1S eCDMod10LuhnRev 92 Aztec Code 1 1 1B 1S eCDNone 93 DAFT Code i 1B 1S eCDNone 94 Italian Postal 2 of 5 1 3 1 3 1B 2B 1S 2S eCDNone 95 Italian Postal 3of9 ween x 96 DPD Code 1 2 3 4 1 2 3 4 1 2 3 4 15 25 35 45 eCDNone Page 79 of 97 97 Micro QR Code 1 1 18 15 eCDNone 98 HIBC LIC 128 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDMod43 99 HIBC LIC 39 1 3 1 3 1B 2B 1S 2S eCDMod43 100 HIBC PAS 128 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDMod43 101 HIBC PAS 39 1 3 1 3 1B 2B 18 28 eCDMod43 102 HIBC LIC Data Matrix 1 1 18 15 eCDMod43
44. C IT Support Support tec it com A 1 3 ICONV Libraries On UNIX systems iconv is used to convert between different character sets Iconv is available on the command line as well as through the shared library libiconv Usually the installed iconv libraries contain all character sets and conversion tables required for the basic linear bar code types Latin 1 ASCII etc But specific 2D codes may require a more advanced code page conversion as currently installed on your system WWW TEC IT COM Page 67 of 97 QR Code Japan requires CP932 SHIFT JIS PDF417 requires CP437 In this case you have to extend your iconv installation as follows 3 options Install the missing conversion tables from your system installation base Update your iconv installation e g by downloading a suitable binary Usethe iconv library provided by TEC IT if available for your platform see also below gt If you don t need the specified 2D codes you can omit the update of the Iconv library A 1 3 1 Iconv for Update your iconv packages install missing Codepages as shown in the following example root lparl19mll6ed_pub mnt AIX53Base lpp installp ppc gt lslpp 1 bos iconv ucs pc Fileset Level State Description Path usr lib objrepos DOs 1 Cony 5 3 0 0 COMMITTED Unicode Converters for Additional PC Code Sets root lparl9mll6ed_pub mnt AIX53Base lpp installp ppc gt lslpp 1 bos iconv ucs com
45. Code X Printers Figure 3 Printing with TBarCode X In the following sections you will find information on how to setup TBarCode X for the most important print spooling systems 8 1 LPRng Printing System To install TBarCode X as a filter in a print queue we provide two scripts Script Description filterlprng sh This script should be used if the print queue is configured without local filtering It reads printing data from stdin adds barcodes and sends the result to stdout filterlprng fwd sh This script should be used if the print queue is configured for local filtering It reads printing data from stdin adds barcodes and forwards the result to the original filter This script needs to be modified depending on your local configuration One of these filter scripts need to be added to the printcap file of the print server The following steps are necessary 1 Open the printcap file etc printcap ofthe print server 2 Locate the printer queue for which you want to add TBarCode X Here is an example what a printcap entry could look like printer AE DEN mll 0 mx 0 sd var spool lpd printer N af var spool lpd printer printer acct V lp dev 1p0 WWW TEC IT COM Page 49 of 97 lpd_bounce true if usr share printconf util mf wrapper 3 If your entry does not contain the parameter if then perform step 4 otherwise go to step 5 4 The parameters 1pd bounce lpr bound and i
46. Fileset Level State Description Path usr lib objrepos DOs ues com 5 3 9 0 COMMITTED Unicode Base Converters for AIX Code Sets Fonts In a special case the math library may also be required package bos adt libm 1 3 2 Iconv for HP UX On HP UX there may be problems with PDF417 bar code generation due to missing code page s in the pre installed HP UX iconv library UCS 4BE to CP437 conversion not supported HPUX 11 23 1252 to CP437 conversion not supported on HPUX 11 23 Solution TEC IT provides the following pre built ibiconv binaries with full code page support TBarCode X TEC IT Iconv Library Download Links V9 0 2 GNU Iconv V1 13 HP UX 11 11 PA 2 0 http www tec it com download Unix HPUX dep tec iconv hpux 11 11 pa tar gz V9 0 4 GNU Iconv V1 11 1 UX 11 23 IA64 http www tec it com download Unix HPUX dep tec iconv hpux 1 1 23 ia64 tar gz V9 1 0 GNU Iconv V1 13 1 HP UX 11 31 IA64 http www tec it com download tbarcodex unix linux Download aspx Other versions Please contact support tec it com Installation Untar into root directory to install into usr local share teciticonv This library will be a side by side installation and does not interfere with the system libiconv Force the use of the TEC IT iconv library with this command before calling tbarcode export LD PRELOAD usr local share teciticonv lib libiconv so A 1 3 3 Iconv for Solaris On Solaris there
47. NI interface library more information see TBarCode X Developer Manual The Java Interface is available on request please contact our support and provide information about your target platform Please note TIF is only supported on Linux systems WWW TEC IT COM Page 14 of 97 4 1 3 TBarCode X Daemon The TBarCode X Daemon is a background server process which performs barcode calculations If the TBarCode X Daemon is installed then the TBarCode X command line application is only a light weight frontend for the daemon The separation of the barcode generation process into a light weight frontend and a server process can improve the overall performance The daemon can be found at usr local share tbarcodell tbarcoded or under Mac OS at tecit TBarCodell tbarcoded The daemon is started automatically as soon as the TBarCode X command line application is invoked In general there is no need to start the daemon manually P Please note that the TBarCode X Library does not use or require the daemon gt In actual versions of TBarCode X no daemon is used 4 2 About this Manual Here is a quick overview of the most important sections in this manual The installation of TBarCode X is described in Chapter 5 Installation After installation some basic tests can be performed to see whether TBarCode X was installed correctly These tests are described in Chapter 6 Testing TBarCode X The command line usage o
48. OTE ADDR putenv REMOTE ADDR remaddr shell exec path to subprocess 16 taken from php net WWW TEC IT COM Page 63 of 97 10 Licensing 10 1 License Key and License Types As long as you have not licensed TBarCode X an additional horizontal bar will be printed across the generated barcodes Usually this horizontal bar does not affect the readability of the code for evaluation purposes Purchasing a license removes this restriction Please contact TEC IT for available license modes Just send an email to office tec it com 10 2 License File The license file is named license ini and contains the license information and your license key Please copy this file into the directory of TBarCode X usr local share tbarcodell Or for Mac OS tecit TBarCodell You have to copy this file to each system client where you want to use TBarCode X Overwrite the original demo License ini file that was installed during setup On systems where TBarCode X Daemon is installed the background server process needs to be restarted after installing the License ini file To restart the background server process call usr local share tbarcodell tbarcoded restart You need root privileges to do this If you cannot find tbarcoded then you are probably using a TBarCode X version without TBarCode X Daemon In this case there is no need to restart any process Additional information can be found on our web site
49. Position Absolute y position in mm see above wWidth Width of barcode in mm e g w50 or w53 12 hHeight Height of barcode in mm ot Orientation Top x y Position sets the upper left corner of the barcode Default in PostScript ob Orientation Bottom x y Position sets the lower left corner of the barcode Default in PCL bBarcodeNo Number of barcode see Barcode Types in the Appendix cMethodNo Number of check digit calculation method rRotation Rotation in degrees 0 90 180 or 270 T on off Show human readable text n Do not print human readable text same as Toff a Print the human readable text above the barcode default is below s on off Translate escape sequences in input data WWW TEC IT COM Page 91 of 97 A on off Turn auto correct on or off gGuardWidth Width of guarding line in mm fFontname Font name in PostScript or Typeface Family Value in PCL PostScript Times Roman Courier Helvetica PCL 4101 4099 16602 If the number from the f parameter is 1000 or bigger than 1000 it will be identified as PCL Font number fFontsize Size of font in points tFormat Output format PS PostScript default or PCL iDistance Text distance in mm NHeight Notch height in mm mModWidth Module width narrow bar width in um 1 1000 mm if used the W parameter for the symbol width is irrelevant RRatio Print ratio FFormat Format string used for formatt
50. ROCFILE mktemp d tmp p tbarcode call barcode engine S for SAP output usr local share tbarcodell tbarcode filter lt gt M PROCHILE replace original file with process file mv SPROCFILE 1 END TECIT FE AE HE FE FE AE FE FE HE HE HE EE HH HE EH HEE EE RR EH Save the stderr messages in a temporary llog fille and discard stdout which is the peripheral output SREALMODEL job Suser title Soptions files SHPNPF 2 gt gt LOG gt eli dev null 8 4 7 Other Printing Scripts Please contact support tec it com if you need help with your printing script 8 4 8 Make a Test Print 1p d Printer usr local share tbarcodell samples testfile ps On a PostScript printer the printout should contain several barcodes 8 5 Solaris Printing System This section describes how to setup TBarCode X as a filter in the standard spool system coming with Solaris Please read section G 1 Unix Printing HP UX and Solaris for background information if you are using Solaris 10 and earlier First you should perform a basic test to see if the filter works on your system These tests are described in section 6 1 2 Run TBarCode as Filter 8 5 1 Spool System Integration Solaris 11 Starting with the Oracle Solaris 11 release the LP print service is removed The default and only available print service in Oracle Solaris 11 is CUPS Please follow the step
51. Restart the printing service etc init d cups restart 8 2 2 Setting up TBarCode X Spool Filter for PCL Output Setting up TBarCode X to filter PCL data streams requires a bit more work because CUPS by default does not filter PCL data We have to add a custom MIME type for PCL documents 1 Open etc cups mime types Or usr share cups mime mime types 2 Add the new MIME type application pcl to the list of Application generated files application pcl is a custom mime type based upon application vnd cups raw 10 If the sym links in CUPS filter directory already exist as they are created by the setup use the existing ones There is also a possibility with a customized PPD file more details on request TBCX PCL Queue on CUPS WWW TEC IT COM Page 51 of 97 application vnd hp HPGLhpgl string 0 1B amp N string 0 lt 1B gt E lt 1B gt 0B String 0 lt LB gt S 1B string 0 lt 200B gt string 0 BP string 0 IN string 0 DF N string 0 BPINPS tcontains 0 128 lt 1B gt 12345X contains 0 1024 contains 0 1024 HPGL application pcl string 0 lt 1B gt E string 2 lt 1B gt 0B string 0 lt 1B gt contains 0 128 lt 1B gt 12345x contains 0 1024 LANGUAGE PCL contains 0 1024 LANGUAGE PCL The lines that should be added are marked bold Use tab characters after application pcl no spaces Insert the new m
52. Solaris Printing System Spool System Integration Solaris 11 Spool System Integration Solaris 10 and earlier Register Filter Setup Create Virtual Printer Print To Filtered Printer Print Barcode Filter Test File WWW TEC IT COM Page 3 of 97 8 6 Mac OS X Printing System 8 7 TBarCode X with UNISPOOL Holland House B V 8 8 SAP R 3 and SAP ERP Integration 9 Generating Bitmap Images 9 1 Direct Method Create Bitmap Images with TBarCode X 9 1 1 Samples 9 2 Indirect Method Convert PostScript Output to Bitmap 9 3 Web Applications PHP 9 3 1 Display a Barcode in a Browser 9 3 1 1 Example 1 9 3 1 2 Example 2 9 3 2 Hints for using shell execute 10 Licensing 10 1 License Key and License Types 10 2 License File 11 Contact and Support Information Appendix A Library Dependencies A 1 Dependencies List Dynamic Dependencies GCC Runtime Libraries GCC for Linux GCC for AIX GCC for HP UX ICONV Libraries Iconv for AIX Iconv for HP UX Iconv for Solaris Shared Library Path Background Linux LD_LIBRARY_PATH Not Finding libtbarcode on Debian 4 HP UX SHLIB Path Being Ignored Not finding libstdc AIX GCC Lib Conflicts Appendix B Troubleshooting FAQ B 1 QD UJ UJ itia di 04 Dua cul du B 3 General Questions Can use the old parameter format as it was used in TBarCode for Linux Version 1 x have troubles with convert gray bars inside the barcode H
53. TBCX CONFDIR environment variable In the current directory In the directory of the executable In usr local share tbarcodell Linux UNIX In Library Frameworks TBarCode framework Versions version OS X Ege a The path and the name of the configuration file can be overwritten with the inifile command line option An administrator can edit these files to set global settings for TBarCode X These settings are applied each time when a new instance of TBarCode X is started The settings in the configuration files have the same functionality as the settings on the command line of TBarCode X 7 6 2 Syntax of a Configuration File The syntax of the TBarCode X configuration files is similar but not identical to the syntax of most UNIX configuration files A line of configuration file contains either an option or a barcode setting or acomment 7 6 2 1 Options and Barcode Settings These have the following syntax option or option value 7 6 2 2 Comments If the first character in a line is then this line is treated as a comment its content is ignored This is a comment 6 tbarcoded is the TBarCode X Daemon background server process not available in all versions 7 Supported in V11 1 0 and later 8 Supported in V10 and later V9 uses tecit TBarCode9 WWW TEC IT COM Page 47 of 97 7 6 3 tbarcode conf The configuration file tharcode conf can contain options and barcode sett
54. TBarCode X Barcode Generator Software for Linux UNIX and Mac OS X Version 11 2 User Documentation November 12 2014 TEC IT Datenverarbeitung GmbH Hans Wagner Strasse 6 A 4400 Steyr Austria t 43 0 7252 72720 f 443 0 7252 72720 77 office tec it com www tec it com WWW TEC IT COM 1 Content 1 Content 1 1 Table of Figures 1 2 List of Tables 2 Disclaimer 3 About TBarCode X 3 1 Features 3 1 1 TBarCode X 3 1 2 2D Symbologies 3 1 3 Barcode Quality 3 2 Usage 3 3 System Requirements 3 3 1 Supported Platforms 3 3 2 Supported Output Devices 3 4 Functional Restriction of the Demo Version 3 5 Version History 3 5 1 TBarCode X Version History 3 5 1 1 What s new in V11 3 5 1 2 What s new in V10 3 5 1 3 What s new in V9 3 5 1 4 What s new in V8 3 5 1 5 What s new in V7 4 Overview 4 1 TBarCode X Technology 4 1 1 TBarCode X Command Line Tool 4 1 1 1 Create Barcodes on Command Line 4 1 1 2 Using TBarCode X to Process Data Streams 4 1 2 TBarCode X Library 4 1 2 1 TBarCode X Library Java Interface 4 1 3 TBarCode X Daemon 4 2 About this Manual 5 Installation 5 1 Install TBarCode X from a BIN Package 5 1 1 Common Problems 5 2 Install TBarCode X from an RPM Package 5 2 1 Debian Ubuntu 5 2 2 Common Problems 5 2 3 Remove TBarCode X 5 3 Install TBarCode X from a TAR GZ Package 5 3 1 Prerequisites 5 3 1 1 Prerequisites for AIX 5 3 2 Installation procedure 5 3 2 1 Installation from tar gz files on AIX
55. Usage Options Global Options Output Options Filter Options Compatibility Options V1 Format Error Messages and Debug Options Informative Output Barcode Settings Barcode Type Barcode Data Barcode Size and Drawing Position Text Settings Encoding Options Appearance Quiet Zone Print Ratio Quality Enhancement Colors Advanced Barcode Options Filter Settings PDF417 Settings Micro PDF417 Settings Macro PDF417 Settings Data Matrix Settings MaxiCode Settings QR Code Settings Micro QR Code Settings Codablock F Settings Aztec Code Settings DotCode Settings Han Xin Code Settings GS1 DataBar Expanded Stacked Settings Composite Barcode Settings Multiple Barcodes Deprecated Barcode Settings TBarCode X Configuration Files Path of Configuration Files Syntax of a Configuration File Options and Barcode Settings Comments tbarcode conf tbarcoded conf Priority of Options and Barcode Settings TBarCode X as Spool Filter LPRng Printing System Testing the Printer Filter CUPS Printing System Setting up TBarCode X Spool Filter for PostScript Output Setting up TBarCode X Spool Filter for PCL Output AIX s Printing System No f1 Attribute Available HP UX s Printing System Spool System Using a Local Printer Using a Remote Printer Printing Script HP UX 11 00 or HP UX 11 23 Printing Script HP UX 11 23 with Iconv Preload Printing Script HP UX 11 11 Other Printing Scripts Make a Test Print
56. VIN North America eCDVIN 30 Mod 10 with reverse Luhn algorithm eCDMod10LuhnRev 31 Mod 23 for PPSN eCDMod23PPSN 32 Mod 10 for Intelligent Mail Package Barcode eCDMod10IMPackage 33 Mod 11 using maximum weight 10 eCDMod11W10 34 11 Universal Postal Union eCDUPU Method for Swedish Postal Shipment Item ID eCDSwedishPostal Table 31 Check Digit Methods and Enumerators PDF417 Parameters C 3 1 Encoding Mode The PDF417 encoding mode cane be set with the parameter PDFmode ndex Index Mode 0 Normal default encoding 1 Binary Compaction Table 32 PDF417 Encoding Mode C 4 Micro PDF417 Parameters C 4 1 Version Symbol Sizes This table shows the possible user defined symbol sizes for Micro PDF Code The symbol size can be defined by the parameter MPDFversion ndex Index Symbol size rows x cols Index Symbol size rows x cols 0 Automatic calculation 18 3x15 1 1x11 19 3x20 2 1x14 20 3x26 3 1x17 21 3x32 4 1x20 22 3x38 5 1x24 23 3x44 WWW TEC IT COM Page 81 of 97 6 1x28 24 4x4 7 2x8 25 4x6 8 2x11 26 4x8 9 2x14 27 4x10 10 2x17 28 4x12 11 2x20 29 4x15 12 2x23 30 4x20 13 2x26 31 4x26 14 3x6 32 4x32 15 3x8 33 4x38 16 3x 10 34 4x44 17 3x12 Table 33 Micro PDF417 Symbol Sizes C 4 2 Mode The Micro PDF417 mode can be set with the parameter MPDFmode ndex Inde
57. YZ the print job is created but sent to the printer The print job can be found in the spool directory of the printer for example var spool lpd PrinterXYZ Copy this data to analyze the print job When you restart the print queue all pending print jobs are processed lpe start PrinterXYZ B 3 Wherel can get more help Your question is not listed here Please contact us see section 11 Contact and Support Information We do our best to support our customers WWW TEC IT COM Page 76 of 97 Appendix C Barcode Parameters C 1 Barcode Symbologies These are the barcode symbologies that are currently supported by TBarCode X The barcode symbology can be set with the parameter barcode D For example barcode 1 sets the barcode type Code 11 gt For more detailed information on supported barcode types please refer to the Barcode Reference which is available as separate document The Barcode Reference can be downloaded from www tec it com Column descriptions ID Barcode Name Print Ratio Ratio Format String Internal barcode ID If not supported in the current version marked with Name of the barcode symbology Standard Print Ratio of the barcode Predefined corresponding to the barcode symbology Format of the Print Ratio Helpful to understand the definition of the Print Ratio xB 1B 2B width of the single Bars xS 18 2S width of the single Spaces also ca
58. arCode X with our without daemon process the following files are displayed by the 1s command 5 6 1 TBarCode X without Daemon newer versions If TBarCode X was installed without daemon check the file permissions for these files userxy SuSE93 gt 11 usr local share tbarcodell total 496 Ca SAEC EIE LUBWOCI X3 AGN PSG eA Se RESER rw r r rwsr xr x rw r r root root disi 2005 11 09 09 06 iilterevos pel sin root root 1648 2005 11 09 09 06 filltercups ps sh IAGONE IONE 1464 2005 11 09 09 06 filterlprng fwd sh Sc oS OI RO GAS OO SSI 09809 206 ONE 108620055 098095 0 695 censermm TOGE root root 261588 2005 11 09 09 06 tbarcode 700E ISIN 2 ee OU Dates and file sizes may vary the important information is marked bold The file tbarcode needs execute rights and the user id SUID bit needs to be set Missing attributes may be set by root with chmod tbarcode WWW TEC IT COM Page 21 of 97 5 6 2 TBarCode X with Daemon elder versions For the daemon version the output should look like this total 496 APOE root ats 5 root TAPE root TOGE root N root rwsr xr x 1 root Sieg root rwxr r 1 root root root root root root root root root Som 649 464 064 086 192 261588
59. arameters BarcodeStream php header Content type image JPEG create the bar code image file Sunique filename dirname PATH TRANSLATED NN uniqid rand jpg r shell execute tbarcode data Sunique filename the whole file and send it to the browser fp fopen Sunique filename rb pass through as binary data stream JPG image format fpassthru fp delete file immediately unlink Sunique filename jpg make sure that you don t add unwanted white space outside of the lt gt tags Instead of the she11 execute function you could also use exec or system WWW TEC IT COM Page 62 of 97 9 3 2 Hints for using shel1_execute If you re not getting any output from echo shellexec prog for instance at least try prog before bothering with the full path Add 2 gt amp 1 to the end of your shell command to have STDERR returned as well as STDOUT shell return shell exec shell command 2 gt 61 Note You can t used shell exec when safemode on instead use exec and copy the needed program into the nonexec directory by default set in php ini When running sub processes via shell exec and maybe others from Apache mod php4 Apache s environment variables don t seem to be passed on to the sub process environment unless you specifically force them by using putenv something like this remaddr getenv REM
60. ata tbce Text after Barcode Barcode sequence parameters Parameter Description tbcs Begin of barcode control sequence fPCL Format of output is PCL b71 Generate barcode type Data Matrix 71 see section C 1 for more types m0 508 Set the module width X dimension to 0 508 mm dMyBarcodeData d marks the begin of barcode data all characters following will be encoded tbce End of barcode sequence Then call tbarcode with the following parameters tbharcode SSstream PCh pelik out Now the outfile pcl will contain the original file plus the PCL 5 HPGL drawing commands for the barcode gt For automatic barcode generation by your spool system see chapter 8 7 3 TBarCode X Command Line Tool All features of TBarCode X are available through a single command tbarcode The executable tbarcode is usually located in usr local bin or usr bin If the path to the tbarcode executable is not set in the environment variable PATH you will need to specify the full path to start it For example usr local bin tbarcode 7 3 1 Usage tbarcode options barcodesettings gt The options are used to specify general functionality of the TBarCode X command line application see section 7 4 Options P The barcodesettings are used to adjust barcode parameters see section 7 5 Barcode Settings The parameters may be specified
61. ata starts with 2 digits GS1 mode is used otherwise generic format will be used Generic mode In generic mode an FNC1 will be inserted to indicate generic data GS1 mode Special format defined by GS1 for encoding Application Identifiers Industry mode Supports peculiar industry formats adds FNC1 at 2nd position Macro 05 The data is surrounded by the sequence gt RS 05 GS RS EOT Macro 06 The data is surrounded by the sequence RS 06 GS RS EOT Macro 12 The data is surrounded by the sequence gt RS 12 GS RS EOT Custom macro The data is surrounded by the sequence gt EOT 8 Reader Programming Table 46 DotCode Format Options C 12 Han Xin Code Parameters C 12 1 Version Symbol Sizes This table shows the possible symbol sizes for the Han Xin Code The symbol size can be defined by the parameter HXxversion ndex Index Symbol size rows x cols 0 Automatic calculation 1 23 x 23 2 n 21 x 2 n 21 84 189 x 189 Table 47 Han Xin Code Symbol Sizes WWW TEC IT COM Page 86 of 97 C 12 2 Error Correction Level This table shows the possible error correction levels for the Han Xin Code The error correction level can be defined by the parameter HXec1 ndex Index Error Correction Level 0 L1 Lowest level Data recovery capacity is approxima
62. cc V11 1 0 AIX6 1 PPC libgcc 4 2 0 libstdcplusplus 4 2 0 IBM Package download libgcc and libstdc for 6 1 ftp ftp software ibm com aix freeSoftware aixtoolbox RPMS ppc gcc Others Please see the README file in the products installation directory if available or contact TEC IT Support support tec it com 1 2 3 GCC for HP UX HP UX 11 11 PA 2 0 TBarCode X Required Runtime Libraries Download Links V2 0 2 gcc libs or gcc 4 0 2 hppa64 HP UX 11 11 2 0 64 http hpacxx external hp com gcc V7 0 1 gcc libs 3 3 2 or gcc 3 3 2 HP UX 11 00 PA 2 0 http www tec it com Download Unix HPUX gcc 3 3 2 sd 11 00 depot gz V8 0 4 gcc libs 3 2 2 http www tec it com download Unix HPUX gcc gcc libs 3 2 2 hpux11 11 tar gz http www tec it com download Unix HP UX gcc gcc libs 3 2 2 tar bz2 V9 0 0 libgcc 4 3 1 or gcc 4 3 1 V9 0 4 http hpacxx external hp com gcc gcc ia64 4 3 1 depot gz V10 1 2 http www tec it com download Unix HPUX gcc libgcc 4 3 1 HPUX1 1 23 ia64 tar gz V11 0 0 UX 11 23 1 64 V9 0 1 libgcc 4 3 3 or gcc 4 3 3 HP UX 11 11 PA 2 0 http hpacxx external hp com gcc gcc hppa 4 3 3 depot gz V9 0 4 libgcc 4 4 0 or gcc 4 4 0 HP UX 11 31 IA64 http hpacxx external hp com gcc gcc ia64 4 4 0 depot gz Others Please see the README file in the products installation directory if available or contact TE
63. ce tbcs b55 n w40 h20 r90 d123abc tbce In TBarCode X the same barcode can be created with the following barcode control sequence 9S uec S995 Seale wA 20 The parameter viformat enables the compatibility mode When this parameter is set all barcode control sequences are interpreted as in TBarCode for Linux Unix 1 x It is best to specify the parameter viformat in the TBarCode X configuration file tbarcode conf But be aware that you cannot mix old and new barcode control sequences more intuitive gt Use viformat if you upgrade from version 1 x to the actual version and if you don t want to change the Filter Control Sequences in your application In SAP R 3 and SAP ERP due to the limitation of length for Print controls the v1format is used because it needs less space gt If possible we recommend using the new parameters because they are more flexible and D 1 Overview V1 Format Below you find a short overview about the most important parameters in Version 1 x format For the detailed list see the manual of TBarCode for Linux UNIX Version 1 x Parameters of Version 1 x Description tbcs Marks the beginning of the sequence used with filter tbce Marks the end of the sequence used with filter dContent Content data of barcode must be the last parameter before tbce xPosition Absolute x position in mm see above y
64. ciated with the destination The destination consists of a printer name and an optional specification of a class to which the printer belongs When the specified printer is busy the job is sent to another printer in the same class The spool directory is normally var spool lp request printer name and the print file is given a unique name to identify both the job and the user Access to the printer is controlled by 1psched daemon It picks up the jobs from the spool directory and sends them to appropriate destination when it becomes available 1psched also keeps a log usually in usr spool 1p 1og The log file would indicate any error in processing the print jobs as well as the user name G 1 2 Interface Programs BSD and SVR4 Both BSD and SVR4 spooling systems support the concept of an interface program The interface program referred to as filters under the BSD system is usually a shell script that translates the print file to a format suitable for the output device The tasks performed by the interface program include adding a banner and trailer pages adding or removing a line feed character generating accounting information and setting the correct modes on the output device A standard interface program may be found in usr lib lpf for the BSD systems and in usr spool 1p model for SVR4 System G 1 3 Printer Interface Scripts HP UX There are printer interface script models you can choose from that have been created for you in
65. de positions Unit of measurement millimeters Example globalyoffset 5 memory SIZE Changes the size of the memory reserved for barcode creation Only relevant when using the TBarCode X Daemon The daemon uses a fixed memory block for the inter process communication to exchange barcodes with the TBarCode X command line application When creating only small barcodes linear barcodes with la small amount of data the memory consumption can be reduced by setting this value The memory block needs to be big enough to hold a complete barcode the size of the resulting barcode file The TBarCode X command line application and the daemon must use identical memory settings see also the configuration files tbarcode conf and tbarcoded conf The concept of TBarCode X allows you to specify all parameters if required permanently in the tbarcode conf file WWW TEC IT COM Page 27 of 97 If unsure what to set then do not edit this parameter manually Example memory 65000 Table 1 General Options 7 4 2 Output Options These parameters are used for specifying the output options like file name image format PCL or PS options etc For generating a barcode an output file name is required All other parameters are optional Short Long Description mie output FILE Specifies the name of the output file Examples o tmp barcode eps output tmp b ps
66. de to support the old bar code parameter format In this way you can easily migrate from version 1 x to version 2 0 or higher Short Long Description vlformat Enables compatibility mode with TBarCode X version 1 x All barcode control sequences will be interpreted as with TBarCode X 1 x If you set this parameter in the tbarcode conf configuration file the tbarcode command works like the tbarcodeclient in TBarCode X 1 x Here is a sample control sequence for TBarCode X 1 x v1 format tbcs tPS b20 dHello World tbce Here is the same control sequence for TBarCode X 2 0 and newer thes PS b20 d Hello World tbce Table 4 Compatibility Options 7 4 5 Error Messages and Debug Options With these additional parameters the creation of debug information and or log files can be enabled WWW TEC IT COM Page 30 of 97 Short Long Description errorfile FILE Saves all messages in the given file This should only be used for debugging and not in a production system Example errorfile tmp tbarcode errors log syslog Logs all messages using the syslog service nostderr Prevents messages from being written to standard error channel stderr trace LEVEL Sets the trace level to a certain value The trace level defines the amount of log messages that are written to an error file syslog or stderr Possible values sorted from minimal t
67. ds roo rS VIM MO ATS PEER eee cd SetupTBarCode uninstall sh 3 Uninstallation is complete 5 4 Install TBarCode X on SCO Operating Systems When you are using a SCO operating system such as SCO OpenServer or SCO UnixWare you receive TBarCode X as a native package image The package usually has the extension ds and the file has a name like tbarcode 11 2 0 ds The name of your package might be different You will need to substitute the name tbarcode 11 2 0 ds with the exact name of your package in the following instructions The following steps need to be performed as administrator user root 1 Opena new console terminal 2 Type the command pkgadd d home userXYZ tbarcode 11 2 0 ds tbarcode 3 Check the execute permissions of TBarCode X see section 5 6 4 Installation is complete You can verify whether the package was installed correctly by typing the following command pkginfo 1 tbarcode WWW TEC IT COM Page 19 of 97 5 4 1 Remove TBarCode X If you have installed TBarCode X on a SCO operating system you can remove it with the following steps as administrator 1 Open a new console terminal 2 Type the command pkgrm tbarcode 3 Uninstallation is complete 5 5 Install TBarCode X on Mac OS X TBarCode X for OS X will be delivered as installation package built with PackageMaker The package usually has the extension pkg in earlier versions mpkg and
68. e PCL printers can accept normal text files ASCII files Reports and lists are often printed as normal ASCII files You can filter a text file with TBarCode X and let it create PCL barcodes The resulting document will contain the ASCII print data together with PCL commands for drawing barcodes This document can be sent directly to the printer But you need to ensure that this document is sent directly to the printer without going through the Unix standard spool filters The spool filter could convert the barcode drawing commands back to normal text Read the next FAQ item for additional information WWW TEC IT COM Page 75 of 97 B 2 7 How can send a file without modification to a printer How can avoid that my file is processed by spool filters e g the magic filter This can be achieved with a remote queue In order to pass the file directly to this queue you have to use lpr with parameter For example lpr P PCLQueue remotehost b file pcl Here is an example how to filter a text file with the TBarCode X command line application and then send it directly to a printer SAwECCS tile iile wabsm loaweocles joel lpr PHP4050PCL karthago b file with barcodes pcl B 2 8 LPRng Spool System How can find out what data the printer gets from the queue spooler You can stop an individual printer with lpc stop 50 When a document is printed on the print queue Printerx
69. e font is only relevant when creating PostScript or PCL output Bitmaps do not yet support text output Example Postscript font Helvetica font Helvetica Bold Example PCL font Courier font Courier Bold In PCL the font names are mapped to the PCL font numbers as following Courier 4099 fixed CG Times 4101 proportional Univers 4148 proportional Arial serena 16602 proportional default Times 16901 proportional Helvetica 16388 proportional To make the font bold simply add bold after the font Specifying font numbers directly In PCL you can also specify font numbers in the format nnnnns n font number spacing flag f fixed or p proportional 5 Supported in TBarCode X V10 1 1 and higher PCL output only WWW TEC IT COM Page 36 of 97 font 4099f font 16 70lp font 1620lp Bold textdist DISTANCE Sets the distance between the bars and the readable barcode text Unit of measurement millimeters Table 9 Barcode Text Options 7 5 4 Encoding Options These parameters can be used to control the character encoding code page of the bar code data Short Long Description encodingmode MODE Sets the encoding mode for the bar code data Possible values CODEPAGE Use the codepage specified with codepage or use the default encoding of the selected bar code type RAW No
70. e resolution of the image Unit of measurement Dots per inch dpi 0 optimalwidth Optimizes the module width for the given output resolution 72dpiraster This option reduces aliasing effects in bitmaps and minimizes printing tolerance For low output resolution the module width optimization is a must to get a readable bar code Use this parameter in combination with the dpi parameter When this setting is turned on the X dimension module width will become exactly a multiple of a single printer dot or Pixel Module widths with fractional parts are avoided This option is useful if you want create bitmap barcodes with maximal quality All drawing operations will fit exactly into the pixel raster of a bitmap See also Optimize Barcode for the Output Device in the Barcode Reference reduction REDUCTION Bar width reduction also known as Pixel Shaving or BRW Reduction of the nominal bar width dimension to compensate for systematic errors e g dot gain in some printing processes usually applied on film masters or printing plates but also useful to compensate ink bleeding or high toner saturation The given value reduces the width of the modules by a certain amount For the possible units of the BWR see argument reductionunit Example for reducing each bar about 10 of actual module width reduction 10 reductionunit perc reduction 10 Example for reducing each bar or dot 0 033 mms reducti
71. ed by TBarCode in command line mode as well as in spool filter mode filter control sequence prefix Page 31 of 97 WWW TEC IT COM 7 5 1 Barcode Type Barcode Data These parameters are used for specifying the general barcode settings Short Long Description b barcode NUMBER Sets the type of barcode The NUMBER of the barcode type can be looked up in Section C 1 Barcode Symbologies Default is barcode 20 which is Code 128 Examples b20 barcode 71 data DATA Sets the data of a barcode Alternatively you can specify a file that contains the data with datafile Examples d12345 data 12345 d ABCD 12345 data ABCD 12345 Double quotes need to be escaped with two double quotes So if you want to encode the data 283801080 into barcode you need write data Text 123 Character Set Encoding The system locale LANG is used to determine the character set of the input data on the command line In the actual version the input data can be in UTF 8 and CP1252 format depending on LANG Please note that the ilter command treats all input PS or PCL like ANSI ASCII CP1252 characters The character set used for encoding the bar code data can be adjusted with the codepage Parameter Please contact support tec it com if you have questions datafile FILE Sets the file that contains the barcode data FILE can be any ASCII
72. eiving documents per FAX 200 dpi and you want to decode the barcodes on a server software solution You can optimize the printed barcodes by specifying the following options decoder software dpi 200 sizemode MINIMAL decoder TYPE Specifies the type of barcode decoder which will be used for scanning the barcode Used in combination with sizemode MINIMAL Possible values X Any cisci Default The type of decoder is unknown hardware A hardware barcode scanner such as a handheld device software A software barcode decoder tbarcode The TBarCode Scanner The TBarCode Scanner is a software decoding solution It is available on re quest just contact office tec it com By setting the type of decoder TBarCode X can optimize the size of the barcode to ensure optimal readability Example scenario You are receiving documents per FAX 200 dpi and you want to decode the barcodes on a server software decoding solution You can optimize the printed barcodes by specifying the following options decoder software dpi 200 sizemode MINIMAL dpi DPI Sets the resolution of the image Unit of measurement Dots per inch dpi x xpos POSITION Sets the absolute or relative x position of the barcode Unit of measurement millimeters The positioning mode absolute or relative positioning can be set with pos Examples pos abs xpos 100 pos rel xpos 10 5 y
73. epending on colormode default is RGB Example bgcollor 192 255 128 bgcolor COFF80 Colors can be specified as decimal or hexadecimal values Make sure to use the following syntax For RGB each partial value one primary color may range from 0 to 255 or 00 in hex notation RGB 255 255 255 decimal RRGGBB hexadecimal For CMYK and GRAY each partial value one primary color may range from 0 to 100 in the decimal notation and from 00 FF in hex notation CMYK 100 50 50 20 decimal CCMMYYKK hexadecimal GRAY 100 decimal KK hexadecimal Table 13 Colors Color and Background Modes 7 5 8 Advanced Barcode Options Short Long Description options OPTIONS Sets advanced bar code options via name value pairs text based The options string is compatible with the BCSetOptions function in TBarCode Library Multiple parameters are separated by a blank in that case the option string must be put into double quotes Possible values DRAW BarWidthReduction Legacy true CHECK CodaBarIncludeStartStop true DataMatrix EncodingMode 2 prefer ASCII mode and others For more details see TBarCode Library TBarCode SDK user manual Examples options DRAW BarWidthReduction Legacy true WWW TEC IT COM Page 40 of 97 7 5 9 Filter Settings To enable filtering TBarCode X has to be called with the program option filter See
74. ew or similar kghostview barcode eps 6 1 2 Run TBarCode as Filter Type the following command tbarcode filter usr local share tbarcodell samples testfile ps output ps testfile ps is a sample document that includes some barcode control sequences The TBarCode filter processes the document and replaces all barcode control sequences with acual barcode symbols The result is stored in output ps You can view the result in any PostScript viewer or directly send output to a PostScript printer for example with 1p d name of printer output ps Verify that the resulting page contains barcodes 6 2 Demo License Restriction When testing TBarCode X you will probably see a black bar drawn horizontally across the whole barcode This bar only appears in the unlicensed version of TBarCode X As soon as you have installed a valid license all barcodes will be drawn correctly Section 10 Licensing describes how you can acquire a valid license from TEC IT 6 3 TBarCode X isn t Working Please read through the previous sections Make sure you have performed all required steps during installation Consult the section Appendix B Troubleshooting FAQ in case of persisting problems WWW TEC IT COM Page 23 of 97 7 Using TBarCode X 7 1 Create a Barcode The samples below give you a quick start for generating barcodes For more detailed instructions go ahead to section 7 3 7 1 1 Create a Barcode in EPS Po
75. ex Check digit calculation method Enumeration 0 No check digit will be computed eCDNone 1 Standard check digit of the selected barcode type is used eCDStandard 2 Modulo 10 usually used with Interleaved 2015 eCDMod10 3 Modulo 43 suggested for Code39 and Logmars consist of 1 digit eCDMod43 4 Modulo 47 2 digits eCD2Mod47 5 Method for DP Leitcode eCDDPLeit 6 Method for DP Identcode eCDDPident 7 Method for Code11 1 digit eCD1Code11 8 Method for Code11 2 digits eCD2Code11 9 Method for USPS Postnet eCDPostnet 10 Method for MSI 1 digit eCDMSI1 11 Method for MSI 2 digits eCDMSI2 Page 80 of 97 12 Method for Plessey eCDPlessey 13 Method for EAN 8 eCDEAN8 14 Method for EAN 13 eCDEAN13 15 Method for UPC A eCDUPCA 16 Method for UPC E eCDUPCE 17 951 128 internal method Modulo 103 eCDEAN128 18 Code 128 internal method Modulo 103 eCDCode128 19 Method for Royal Mail 4 State eCDRM4SCC 20 Mod 11 Method for PZN eCDPZN 21 Mod 11 using maximum weight 7 eCDMod11W7 22 Method for EAN 14 eCDEAN14 23 Method for Korean Postal Authority Modulo 10 eCDMod10Kor 24 Method for Planet Modulo 10 eCDMod10Pla 25 Method for Italian Postal 2 5 Modulo 10 based eCDMod1 OltlPst25 26 Modulo 36 ISO IES 7064 for DPD Barcode eCDMod36 27 Modulo 16 for Codabar Barcode eCDMod16 28 Modulo 10 with Luhn algorithm for Credit Cards IMEI etc eCDMod10Luhn 29 Method for
76. f TBarCode X is described in Chapter 7 Using TBarCode X Chapter 8 TBarCode X as Spool Filter explains how TBarCode X can be configured as printer filter that automatically filters print jobs Before you use TBarCode X commercially you need to acquire a valid license from TEC IT Chapter 10 Licensing explains how to install a valid license WWW TEC IT COM Page 15 of 97 5 Installation TBarCode X is available in binary form only The installation package is available in three versions as BIN package which is a combination of RPM or DEB archive with an installation script as HPM or DEB package which are common formats for Linux operating systems or as TAR GZ package with installation scripts for UNIX operating systems AIX HPUX as MPKG package for Mac Operating Systems Depending on the type of package you have received or downloaded the installation is slightly different 5 1 Install TBarCode X from a BIN Package If you have received the TBarCode X software as BIN package then follow the instructions in this section BIN packages can be executed like shell scripts and consist of ashell script which displays the license information and installs the product abinary package the software installation base RPM or DEB file The following steps need to be performed as administrator user root 1 Opena new console terminal 2 Type the command sh tbarcodell xxx bin Replace
77. f need to be added to the printcap entry Add the following lines mined Mens 1 bounce true V lpr bounce true V if usr local share tbarcodell filterlprng sh Then continue with step 7 5 Remember the original filter in our example usr share printconf util mf wrapper Change the if parameter to if usr local share tbarcodell filterlprng fwd sh The printcap entry of our example would then look like printer galing m1 0 mx 0 sd var spool lpd printer af var spool lpd printer printer acct V lpd_bounce true if usr local share tbarcodell filterlprng fwd sh 6 Now open the script usr local share tbarcode1 1 filterlprng fwd sh and substitute path of original filter inline 25 with the path and name of the original filter in our example usr share printconf util mf wrapper 7 Restart the print service LPD etc init d lpd restart 8 1 1 Testing the Printer Filter You can now test the TBarCode X printer filter Enter the following line substitute name of printer With the name of your printer lpr P name of printer usr local share tbarcodell samples testfile ps This command should print a simple test file Check the printout it should contain several bar codes gt Advice Certain configuration tools might overwrite your changes So backup your configu ration files as soon as you have done all required changes WWW TEC IT COM Page 50 of 97
78. g filter doesn t produce gray scaled bars if the resolution of the input file is big enough 1 Create the barcode 4 times bigger than you need it If you have a module width parameter of m0 353 use gt m1 411 If you have a width parameter w100 use w400 multiply your value with 4 If you have a height parameter of h20 use n80 height 4 2 During conversion reduce the size to 25 convert scale 25 barcode eps barcode png 3 Now you have the size you want and an image with clear content B 1 3 How can encode an XML string with the TBarCode Command The best solution is to store the XML string in a data file and call the TBarCode X command line application with the parameter datafile File For example tbarcode obarcode ps b71 datafile data xml B 1 4 How to license the product After you have ordered TBarCode X you will receive your license key stored in a file license ini This file must be copied into the installation directory of TBarCode X usually usr local share tbarcodell See section 10 Licensing for more information B 1 5 How retrieve the hostname for buying a single license For a single license we need the hostname of the computer the client where you want to use TBarCode X To get this hostname enter the following command at the command line of the target system hostname WWW TEC IT COM Page 73 of 97 1 6 TBarCode X reports that a shared library is missing When
79. gorithm Example WWW TEC IT COM Page 33 of 97 compress DEFLATE Important To use compression the ZLib compression library available at http www zlib net has to be installed on your Linux or UNIX server defaultset NUMBER Use a certain set of default values specific for each bar code type The following parameters are set by activating a default set width height module width row height human readable text translate escape sequences Possible values LUE ooo No default set applied Default set 1 typical values defaultset 1 should be used when you are migrating from a hardware based barcode printing solution to TBarCode X or if you don t know which bar code parameters are optimal for your application Note Default set 1 is already preset in the tbarcode conf file Table 7 General Barcode Settings 7 5 2 Barcode Size and Drawing Position Use these parameters to adjust the bar code size and to optimize the bar code quality All of these parameters are optional Short Long Description W width WIDTH Sets the width of the barcode see also sizemode fit Unit of measurement millimeters default or mm mils inch px Pixels Examples w25 4 width 55 width 2inch height HEIGHT Sets the height of the barcode Unit of measurement millimeters default or mm mils inch px Pixels Examples inu height 25
80. haracters in hexadecimal notation hh hexadecimal digits 0 F Crrggbb Color selection See Pharmacode Ce Reset the color to default FNC1 Function Number Character 1 used field 128 UCC 128 Codablock F separator MicroPDF417 a special FNC1 codeword is inserted when using emulation mode for EAN 128 or Code 128 Data Matrix a special FNC1 codeword is WWW TEC IT COM Page 87 of 97 inserted F Inserts a Gs Group Separator or ASCII 1DHex PDF417 MaxiCode and in QR Code Don t encode the x1d directly QR Code When using format UCC EAN GS1 Gs is inserted in Byte Mode a is inserted in alphanumeric mode Extended Channel Interpretation MaxiCode Data Matrix QR Code PDF417 nnnnnn 6 digit number with leading zeros MicroPDF417 Aztec Code Used for defining the character set code page for the subsequent encoded data EB WEE Special identifiers for nesting ECIs QR Code EB ECI Begin opens a nesting level EE ECI End closes it G Global Language Identifier GLI similar to see E PDF417 210 FNC1 Code128 EAN 128 UCC128 Codablock F 211 FNC2 Code128 EAN 128 UCC128 Codablock F 212 FNC3 Code128 EAN 128 UCC128 Codablock F 213 FNC4 Code128 EAN 128 UCC128 Codablock F x11 DC1 Code93 Code93Ext x12 DC2 Code93 Code93Ext x13 DC3 Code93 Code93Ext x14 DC4 Code93 Code93Ext x
81. he Print Controls in Hex Format For each character an equivalent hexadecimal code exists For example C 43 hexadecimal or 2 32 hexadecimal Hex Code Symbol Hex Code Symbol Hex Code Symbol Hex Code Symbol 0 NUL 20 space 40 60 1 SOH 21 41 61 2 STX 22 T 42 B 62 b 3 ETX 23 43 63 c 4 EOT 24 44 D 64 d 5 ENQ 25 45 65 6 26 amp 46 66 f 7 BEL 27 i 47 G 67 g 8 BS 28 48 H 68 h 9 HAT 29 49 69 i A LF 2A 4A J 6A j B VT 2B 4B K 6B k 2 j 4 L 6C D CR 2D 4D M 6D m E SO 2E 4 6E n F ST 2F 4F 6F 10 SLE 30 0 50 70 11 51 31 1 51 71 q 12 DC2 32 2 52 R 72 r 13 DC3 33 3 53 73 14 DC4 34 4 54 T 74 t 15 NAK 35 5 55 U 75 16 SYN 36 6 56 V 76 17 37 7 57 77 w 18 CAN 38 8 58 X 78 19 39 9 59 Y 79 y 1A STB 3A 5A Z 7A 2 1B ESC 3B 5B 7B 1 FS 3C lt 5C 7 1D GS 3D 5D 7D 1E RS 3E gt 5E 7E 1 US 3F 5F 7F Table 59 ASCII Table WWW TEC IT COM Page 95 of 97 Appendix G Knowledge Base G 1 Unix Printing HP UX and Solaris 1 1 Spooling System Solaris 8 9 10 and HP UX uses the SVR4 print services Under the SVR4 spooling system the 1 command accepts the data to be printed and makes a copy of it in the spool directory asso
82. he barcodes are created as vector graphics EPS and PCL therefore utilizing the maximum of the available printing resolution And many others 3 2 Usage There are two main usages of TBarCode X Create Bar Codes on the Command Line All necessary parameters are passed to a command line program and barcodes are saved as vector or bitmap graphics files Filter Print Jobs TBarCode X can process PostScript or PCL print jobs During the filter process TBarCode X searches for barcode control sequences and replaces them with the barcode graphics Barcode parameters are specified in the document as part as part of the control sequence WWW TEC IT COM Page 10 of 97 3 3 System Requirements 3 3 1 Supported Platforms TBarCode X binaries are available for Linux SUSE Red Hat and other distributions Intel x86 x86 64 FreeBSD 5 4 6 Intel x86 AIX 4 3 5 2 5 3 6 1 7 x PowerPC HP UX 11 00 11 11 PA RISC HP UX 11 23 11 31 Itanium 2 OS 400 AS 400 SCO OpenServer 5 0 7 6 SCO UnixWare 7 1 4 Intel x86 Solaris 8 9 SPARC Solaris 10 11 Intel x86 SPARC Mac OS X gt 10 4 Please visit our website http www tec it com to check out the latest versions and supported platforms Binaries for special platforms are available on request 3 3 2 Supported Output Devices PostScript Level 2 PCL Level 5 PDF 1 3 3 4 Functional Restriction of the Demo Version T
83. he characteristics supported by a printer You can either add an own model file to this directory or modify an existing one It is very easy to call the filter inside such a script each time a printout is made the filter will be called because the script is run for each spool job file Which model file script is used and which model file script has to be modified depends on the settings within SAM it is adjusted in the input field printer model interface fdd Local Printer Plotter medusa Printer Printer Nodel Interface Default Request Priority of Val Hodels Taterfac Description Printer Class optional This Printer the Default laser jet Standard HP script laser jet4 Standard HP script laser jet 451 Standard HP script laser jet4y Standard HP script laser jet5 i Standard HP script laser jet IIISi Standard HP script paint jet Standard HP script paint jetxi OO Standard HP script __ Standard _ Standard p Standard script ruggeduriter Standard HP nodel script think jet Standard HP nodel script Zetc lp interface HP4050PS In use printer nodel script Cancel Figure 4 HP UX Printer Models Interfaces You need to add some commands to the model script in order to call TBarCode X see next section they are the same as with remote printers 8 4 3 Using a Remote Printer For remote printers LPR different scripts are responsible for calling the filter
84. he unlicensed version contains a black bar drawn horizontally across the whole barcode This horizontal bar disappears as soon as you have installed a valid license file gt If you want to test the product without this horizontal bar you can request a temporary license key for free Simply contact sales tec it com Section 10 Licensing describes how you can acquire a valid license from TEC IT 3 5 Version History 3 5 1 TBarCode X Version History The detailed version history including the list of bug fixes can be found on the web http www tec it com software barcode software barcode linux unix mac os x history Default aspx Below you find a brief introduction into the main versions 3 5 1 1 What s new in V11 New bar code types DotCode Han Xin Code USPS Intelligent Mail amp Package Barcode Customizable drawing routines TBarCode Library New output formats Al Adobe Illustrator 7 and SVG both introduced in V11 1 Improved PDF output no PDF template file required Colors Foreground Background Text Quiet Zone EPS Overprinting New check digit methods VIN Modulo 10 Reverse Luhn Module 23 Modulo 10 USPS IM Mod 11 W 10 Swedish Postal New installation path usr local share tbarcode1 1 WWW TEC IT COM Page 11 of 97 3 5 1 2 What s new in V10 New bar code types DP Postmatrix QR Code 2005 ISBN 13 ISBN 13 5 ISMN ISSN ISSN 2 USPS Intelligent Mail Barcode
85. here are more possibilities All barcode symbologies and text output are supported 9 1 Direct Method Create Bitmap Images with TBarCode X Here is an example how a bitmap barcode can be created tbarcode format IMAGE imageformat PNG output barcode png barcode 20 data 1234 optimalwidth Instead of the long form you can also use the short form for the parameters tbarcode fIMAGE iPNG obarcode png b20 d 1234 O This will create a barcode where one module thinnest bar is exactly one pixel The parameter optimalwidth O ensures that the modules are exactly an integer multiple of pixels no fractional part Without this parameter the barcode might not be readable TBarCode X automatically chooses an appropriate width and height for the barcode If the resulting size of the barcode does not fit your needs you can specify the width and height yourself The parameters width and height specify the size of the barcode in millimeters The actual size of the bitmap in pixels depends on the image resolution which is set If nothing is specified a resolution of 72 dpi dots per inch is assumed A custom resolution can be set with the parameter dpi For example the parameters width 50 height 20 dpi 600 will create a barcode which is 1181 x 472 pixels large If this barcode is printed at a resolution of 600 dpi the resulting barcode will be 50 x 20 mm If you specify the parameters width optimalw
86. idth bearertype reduction defaultset mustfit decoder sizemode align RSSseg New parameters for multiple barcodes multiple rows columns hdist vdist datalimit dynamicsize structapp Deprecated parameters guardline barsimmdefaults Filter scripts now run with bin sh instead of bin bash New installation path usr local share tbarcode7 TBarCode without Daemon Memory limitation removed TBarCode automatically reallocates more memory if required More samples added to user documentation WWW TEC IT COM Page 12 of 97 4 Overview This section gives you some insight how TBarCode X works and in which ways you can use it This section is not essential if you are only looking for the installation instructions you can skip ahead to the according section 4 1 The TBarCode X Technology TBarCode X exists in two versions TBarCode X without Daemon TBarCode X with Daemon In the version TBarCode X with Daemon the barcode generation is performed in a background server process whereas in the other version the barcode generation is done in a single program The two versions are actually equivalent Same usage Same functionality Same price Same license if you have a license for TBarCode X you can use either of the two versions The only differences are TBarCode X with Daemon is faster TBarCode X with Daemon is perhaps more difficult to configure TBarCode X with Daemon requires in
87. idth at the same time then TBarCode X will to the following TBarCode X will choose the optimal size which is closest to the specified width An optimal size is where all bar widths are exactly integer multiples of pixels gt Always use the option optimalwidth or just 0 when creating bitmap barcodes This will guarantee the readability of the resulting barcodes 9 1 1 Samples Here are some more examples tbarcode fIMAGE iPNG obarcode png b71 O d 0123456789 creates a small Data Matrix barcode The resulting bitmap is 12 x 12 pixels large where a module is exactly one pixel WWW TEC IT COM Page 60 of 97 tbarcode fIMAGE iTIF obarcode tif b20 w50 h20 dpi 200 d 0123456789 creates a Code 128 barcode which is 50 mm x 20 mm when printed at 200 dpi Warning This barcode might not be readable because the module width is not aligned with the pixel raster Use the parameter optimalwidth just O This will ensure that the barcode is perfectly readable See next example Examples tbarcode fIMAGE iTIF obarcode tif b20 w50 h20 dpi 200 d 0123456789 O creates a Code 128 barcode which fits into an area of 50 mm x 20 mm The actual size of the resulting bitmap is 45 7 mm x 19 9 mm This barcodes is guaranteed to be readable tbarcode fIMAGE iTIF obarcode tif b71 sizemode MINIMAL dpi 200 4 decoder SOFTWARE d DATA 0123456789 creates a barcode that is op
88. ime type application pcl before application vnd cups raw since it needs higher priority The type application vnd cups raw must remain in the file 3 CUPS 1 0 x 1 1 x Open the MIME type conversion file etc cups mime convs Add the conversion rule for application pcl application pdf application postscript 33 pdftops application postscript application vnd cups postscript 66 pstops application pcl application vnd cups raw 66 al usr local share tbarcodell filtercups pcl sh CUPS 1 2 x and later Open the MIME type conversion file etc cups mime convs Add the conversion rule for application pcl application pdf application postscript 33 pdftops application postscript application vnd cups postscript 66 pstops application pcl application vnd cups raw 66 filtercups pcl sh Retrieve your CUPS installation directory cups config serverbin It should be usr lib cups Filters must be then in the filter subdir usr lib cups filter Create a sym link to place the TBarCode filter script into this sub dir s usr local share tbarcodell filtercups pcl sh usr lib cups filter filtercups pcl sh 4 Restart the printing service etc init d cups restart 12 If the sym links in CUPS filter directory already exist as they are created by the setup use the existing ones WWW TEC IT COM Page 52 of 97 8 3 AIX s Printing System To install TBarCode X in an AIX printer queue follow these steps 1 Choose in
89. ing barcode data prior to printing it Calculate optimal width of barcode QhHorzQZ Horizontal quiet zone in mm e g Qh1 34 or Qh5 The specified quiet zone is a blank space which is added to the left and right side of the symbol Usually the Quiet zone should be 10 times the module width or higher QvVertQZ Vertical quiet zone in mm e g Qv1 34 or Qv5 The specified quiet zone is a blank space which is added to the top and bottom of the symbol Usually the Quiet zone should be 10 times the module width or higher I Use initgraphics command in PostScript This may improve the positioning of the barcode if relative positioning is used in PostScript documents e Move cursor to end of barcode in PCL W Remove leading and trailing spaces from content Table 54 Overview Parameter Syntax of Version 1 x WWW TEC IT COM Page 92 of 97 Appendix E TBarCode Daemon The TBarCode Daemon is a background server process that performs the barcode generation The TBarCode Daemon is an optional component It is not available and not required for certain distributions of TBarCode X The daemon is usually located in usr local share tbarcodell tbarcoded In general there is no need to manually start or stop the TBarCode Daemon It is started automatically It is only necessary to restart the daemon when the configuration files or license files have changed E 1 Usage You need to have root privileges to run the TBarCode Daemo
90. ings as described in sections 7 4 Options and 7 5 Barcode Settings Example Sample tbarcode conf memory 524288 SAP viformat defaultset 1 errorfile tmp tbarcode log nosyslog nostderr trace verbose globalxoffset 10 globalyoffset 10 escapebegin BARCODE START escapeend BARCODE END 7 6 4 tbarcoded conf The configuration file tbarcoded can contain the following options memory license errorfile nosyslog nostderr trace 7 6 5 Priority of Options and Barcode Settings As shown so far options can be set at three levels As command line parameter configuration file n custom barcode settings file using bcfile The same options could be set multiple times In this case the options on the command line and in the barcode settings file override the options in the configuration files WWW TEC IT COM Page 48 of 97 8 TBarCode X as Spool Filter TBarCode X can be installed in the spool system to automatically filter print jobs TBarCode X works with all PostScript or PCL based printing queues TBarCode X scans all print jobs for certain barcode control sequences Here is an example of a barcode control sequence tbcs b3 d 1234567890 tbce When TBarCode X detects such a sequence it automatically replaces the sequence with a barcode Document with Barcode Control Sequences Document with Barcodes TTE Wie M Print Server with TBar
91. lled gaps Check Digit Enumeration of the pre selected check digit method for each barcode symbology ID Barcode Name Print Ratio Ratio Format String Default Ratio Hint Check Digit 0 Not a valid type m 1 Code 11 1 2 24 3 48 1 2 24 1B 2B 3B 1S 2S eCDNone 2 Code 2 of 5 Standard 1 3 4 5 1 3 1B 2B 3B 18 28 eCDNone 3 Interleaved 2 of 5 Standard 1 3 1 3 1B 2B 18 28 eCDNone 4 Code 2 of 5 IATA 1 3 1 1B 2B 1S eCDNone 5 Code 2 of 5 Matrix 1 3 4 5 1 3 1B 2B 3B 18 28 eCDNone 6 Code 2 of 5 Data Logic 1 3 1 3 1B 2B 1S 2S eCDNone 7 Code 2 of 5 Industrial 1 3 1 1B 2B 1S eCDNone 8 Code 3 of 9 Code 39 1 3 1 3 1B 2B 1S 2S eCDNone 9 Code of 9 Code 39 ASCII 1 3 1 3 1B 2B 1S 2S eCDNone 10 EAN8 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDEAN8 11 8 2 digits add on 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDEAN8 12 8 5 digits add on 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDEAN8 13 EAN13 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDEAN13 14 2 digits add on 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDEAN13 15 EAN13 5 digits add on 1 2 3 4 1 2 3 4 1B 2B 3B 4B 1S 2S 3S8 4S eCDEAN13 16 EAN128 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDCode128 17 UPC 12 Digits 1 2 3 4 1 2 3 4 1B 2B 3B 4B 18 28 38 48 eCDUPCA 18 Codabar 2 widths 1 3 1 3 1B 2B 1S 2S eCDNone 19 Reserved mE 20 Code128 automatic subset 1 2 3 4 1 2 3 4 1B 2B 3B 4B
92. lter an ASCII text directly the file must be converted into PostScript or PCL format first There are several ASCII to PostScript filters available from the Linux Unix vendors or third party One of the common tools is 2 5 If your printer has no PostScript capability in most cases it can decode PCL Level 5 very common e g LaserJet 4 5 In this case the input to our TBarCode X filter must be PCL Either your application creates PCL input or you find an ASCII to PCL filter to do this One of the filter products is Magicfilter which converts ASCII to PCL on demand This program is standard for several Linux distributions and often installed in the spool system by default The converted document can then be passed on to TBarCode X TBarCode X adds barcodes in the proper format either PostScript or PCL WWW TEC IT COM Page 74 of 97 B 2 3 Why is there no barcode when I m testing the TBarCode X with LPRng The print data has to include a barcode control sequence for example thes fPCL b20 m0 254 h10 2 d0123456789 tbce The filter must be registered in the printcap file see section 8 TBarCode X as Spool Filter Sometimes uses raw mode no filtering use lpr instead B 2 4 How to replace printer specific control sequences with TBarCode control sequences All device specific control sequences for example as used by BarSIMM need to be replaced with TBarCode control sequences Here is an e
93. mode and enforces binary encoding mode in the selected 2D symbology Can be used for DP Premiumadress Data Matrix where the data is given as hex string and the Data Matrix should use BASE256 binary encoding mode Table 10 Encoding Options WWW TEC IT COM Page 37 of 97 7 5 5 Appearance Quiet Zone Print Ratio These parameters are used for specifying appearance options like Bearer Bar Quiet Zone and Narrow To Wide Bar Ratio Print Ratio All of these parameters are optional Short Long Description quietzoneunit UNIT The unit of quiet zones see also quietzoneh and quietzonev Possible values none No Quiet Zone default qu d ses In Number of Modules Millimeters mils Mils 1 Mil 1 1000 Inch inch Inches DR eee Pixels Example 10 modules each side quietzoneh 10 quietzoneunit mod quietzonev 10 quietzoneh SIZE Sets the width of the horizontal quiet zone A horizontal quiet zone is the empty space in the left and the right of a barcode Unit of measurement see quietzoneunit Example quietzoneh 10 quietzoneunit mod or quietzoneh 10mm quietzoneh 10mod quietzoneh 0 5inch It is not allowed to specify different units for vertical and horizontal quite zone quietzonev SIZE Sets the height of the vertical quiet zone A vertical quiet zone is the empty space in the top and the bot
94. n usr local share tbarcodell tbarcoded options Examples usr local share tbarcodell tbarcoded usr local share tbarcodell tbarcoded help usr local share tbarcodell tbarcoded stop E 2 Options E 2 1 General Options Short Long Description inifile FILE Sets the path and name of the configuration file Default 15 usr local share tbarcodel1 tbarcoded conf Example inifile home userXYZ myTbarcoded conf license DIRECTORY Sets the path where the license file is located Default is usr local share tbarcodell Example license etc The name of the license file is always License ini Table 55 TBarCode Daemon General Options E 2 2 Daemon and IPC Options Short Long Description r restart Restarts the daemon s stop Stops the daemon kill Kills the daemon check Checks the state of daemon cleanup Cleans up the resources id ID Sets the identification number to ID memory SIZE Changes the size of the memory reserved for barcode creation TBarCode Daemon uses a fixed memory block for the inter process communi cation to exchange barcodes with the TBarCode Command When creating only small barcodes linear barcodes with little data the memory consumption can be reduced by setting this value WWW TEC IT COM Page 93 of 97 The memory block needs to be big enough to hold a complete barcode the
95. nd in the rare case where two applications require incompatible versions of a library In addition to the system search process each program has an embedded library search path The following commands list the embedded library search path of executables and libraries Use them for troubleshooting Linux readelf d binary grep RPATH Solaris HPUX 1 s lt binary gt HPUX chatr lt binary gt AIX rdump lt binary gt gt For troubleshooting shared library problems see also section A 1 1 List Dynamic Dependencies A 2 2 Linux By default the libraries of TBarCode X are installed usr 10ocal lib You can add this library installation path system wide to the runtime linker search path with ldconfig usr local lib Alternatively you can add the path usr local lib manually to the ld config file etc ld so conf In most cases the usr local 1ib installation path is already listed in the Id config file All you have to do is to rebuild the runtime linker cache with ldconfig Afterwards the TBarCode X libraries should be found A 2 2 1 LD LIBRARY PATH You can use the environment variable LD LIBRARY PATH if you want to extend the library search path inside of a wrapper script WWW TEC IT COM Page 70 of 97 Example export LD LIBRARY PATH opt gcc lib 3 3 2 LD LIBRARY PATH This adds opt gcc lib 3 3 2 to the library path but only for the current session A 2 2
96. ng data characters in the input data property Text A Stands for the next check digit use only if check digits will be computed TBarCode 6 or earlier computes the check digit for all characters in the input data TBarCode 8 or later only uses input data left of the check digit placeholder for check digit computation see examples below A Switch to Subset A used in Code 128 GS1 128 formerly UCC EAN 128 Start or stop character A only in CODABAR B Switch to Subset B used in Code 128 GS1 128 formerly UCC EAN 128 Start or stop character B only in CODABAR C Switch to Subset C used in Code 128 GS1 128 formerly UCC EAN 128 Start or stop character C only in CODABAR D Start or stop character D only in CODABAR S Only for MaxiCode enables setting the values of Date Preamble Service Class Postal and Country Code directly in the barcode data only in conjunction with escape sequences J For Japanese Postal codes the Address B data fields can be automatically compressed i e Japanese symbols are converted into ASCII symbols Table 51 Format Placeholders WWW TEC IT COM Page 89 of 97 Examples Input data Barcode type Format string Data used for Notes encoding 123 Irrelevant 123 123 Irrelevant 5 amp 5123 123 Irrelevant amp 6 1236 123 Irrelevant q w e qiw2e3 123 Irrelevant q amp 1923 123 Irrelevant amp 123 123 Irrelevan
97. ng on your system follow the steps in section 5 3 3 5 3 1 1 Prerequisites for GZip is a free utility you can download from the AIX Toolbox for Linux Applications http www 03 ibm com servers aix products aixos linux For TBarCode X V9 Please update your bos iconv ucs file sets See A 1 3 5 3 2 Installation procedure The following steps need to be performed as administrator user root 1 Opena new console terminal 2 Type the commands tar xzf SetupTBarCode tar gz cd SetupTBarCode install sh of your package might be different Replace the above file name with the file you have downloaded or received for your operating system For command syntax on AIX see section 5 3 2 1 Installation from tar gz files on AIX 3 Register the TBarCode X libraries see section A 2 Shared Library Path 4 Checkthe execute permissions of TBarCode X see section 5 6 5 Installation is complete Step 3 4 is optional but recommended to ensure that everything is installed properly Here is an example that shows what the installations procedure could look like SuSE93 temp tar xzf SetupTBarCode tar gz SuSE93 temp ls 1 total 1058 AEWRE Xi X TOOt Toot 120 2005 12 20 09 37 20 SCONE roor TSA 200521220 09530 AEWRE XI X OOL Toot 216 2005 11 08 11 45 SetupTBarCode epupepeepee l foot root 1078102 2005 12 20 09 35 SetupIBartode tar gz SuSE93 temp cd SetupTBarCode SuSE93 temp Set
98. nstalled properly gt Instead of using the rpm command in step 2 you can use any package manager that comes with your Linux distribution for example gnorpm kpackage etc 5 2 1 Debian Ubuntu On Debian based Linux distributions such as Ubuntu the rpm command might be missing In this case consult the manual of your Linux distribution and look for an alternative command On Ubuntu for example you can install RPM packages using the following command alien i tbarcodell xxx rpm 5 2 2 Common Problems Failed dependencies e g GCC runtime libraries missing see A 1 Dependencies Shared library libtbarcode not found see A 2 Shared Library Path 5 2 3 Remove TBarCode X If you have installed TBarCode X from a RPM package you can remove it with the following steps as administrator 1 Opena new console terminal 2 Type the command rpm tbarcode 3 Uninstallation is complete Alternatively you can use any package manager that comes with your Linux distribution 5 3 Install TBarCode X from a TAR GZ Package TAR GZ packages are files with the extension tar gz or tgz If you have received TBarCode X as a TAR GZ package then follow the instructions in this section 5 3 1 Prerequisites Please make sure that the required GCC runtime see A 1 2 and Iconv see A 1 3 libraries are installed on the target system WWW TEC IT COM Page 17 of 97 If the usr local directory is missi
99. o maximal information output error default warning info verbose Example trace INFO onerror ACTION Defines the action if wrong barcode settings are applied Possible values ignore message default When using the default setting onerror message TBarCode X reports wrong barcode parameters Additionally the exit value is set to the corresponding error code When onerror ignore is set TBarCode X ignores errors onnodata ACTION Defines the action if the data parameter is missing d or data Possible values ignore message default When using the default setting onnodata message TBarCode X reports missing barcode data Additionally the exit value is set to the corresponding error code When onnodata ignore is set TBarCode X ignores missing barcode data Table 5 Error Message and Debug Options 7 4 6 Informative Output Use one of these parameters for displaying help information Short Long Description s barcodesettings Shows a help text for all barcode settings help Shows a help text for general option shorthelp Shows a short help text version Shows the version information Table 6 Informative Output 7 5 Barcode Settings You can view the available parameters for barcode settings with tbarcode barcodesettings tharcode P Please be aware that the following bar code settings are us
100. ode Format Options DotCode Format Options Han Xin Code Symbol Sizes Han Xin Code Error Correction Levels Implemented Escape Sequences Extended Escape Sequences Format Placeholders Format Examples PCL Font Numbers Overview Parameter Syntax of Version 1 x TBarCode Daemon General Options TBarCode Daemon Daemon and IPC Options TBarCode Daemon Error Message and Debug Options TBarCode Daemon Informative Output ASCII Table WWW TEC IT COM 85 85 86 86 86 87 88 89 89 90 90 92 93 94 94 94 95 Page 8 of 97 2 Disclaimer The actual version of this product document is available as is TEC IT declines all warranties which go beyond applicable rights The licensee or reader bears all risks that might take place during the use of the system the documentation TEC IT and its contractual partner cannot be penalized for direct and indirect damages or losses this includes non restrictive damages through loss of revenues constriction in the exercise of business loss of business information or any kind of commercial loss which is caused by use or inability to use the product documentation although the possibility of such damage was pointed out by TEC IT We reserve all rights to this document and the information contained therein Reproduction use or disclosure to third parties without express authority is strictly forbidden F r dieses Dokument und den darin dargestellten Gegenstand behalten wir un
101. on 0 033mm reductionunit UNIT The unit of the bar width reduction value see also reduction Possible values Perc Percent default or use 96 qmm Millimeters mils Mils 1 Mil 1 1000 Inch inch Inches Example reductionunit perc Table 12 Barcode Quality Options WWW TEC IT COM Page 39 of 97 7 5 7 Colors The following parameters allows you to specify the color modes and fore background colors Short Long Description bgmode MODE The background mode of the generated output Possible values transparent background is transparent no background a white filled rectangle is drawn default Example bkmode transparent colormode MODE The color mode of the output Only relevant for PostScript Possible values RGB color space default CMYK CMYK color space GRAY Grayscale color space Example colormode CMYK 1 80 5 72 0 37 color COLOR Sets the barcode and text color depending on colormode default is RGB Example color FF8080 Qolor 255 128 128 barcodecolor COLOR Sets the bar code color depending on colormode default is RGB textcolor COLOR Sets the text color depending on colormode default is RGB bgcolor COLOR backgroundcolor COLOR Sets the background color d
102. ow can encode an XML string with the TBarCode Command How to license the product How can retrieve the hostname for buying a single license TBarCode X reports that a shared library is missing Where can read syslog messages Why is a horizontal bar drawn across the barcodes Questions about Filtering Printing CUPS How to tell which filters are in place and maybe failing or missing How can filter ASCII files Why is there no barcode when I m testing the TBarCode X with LPRng How to replace printer specific control sequences with TBarCode control sequences How can filter Easybar control sequences How can print barcodes within a text file How can send a file without modification to a printer LPRng Spool System How can find out what data the printer gets from the queue spooler Where can get more help Appendix C Barcode Parameters C 1 C 2 C 3 3 1 C 4 4 1 4 2 5 5 1 5 2 C 6 C 6 1 Barcode Symbologies Check Digit Methods PDF417 Parameters Encoding Mode Micro PDF417 Parameters Version Symbol Sizes Mode Data Matrix Parameters Symbol Sizes Format MaxiCode Parameters Mode WWW TEC IT COM Page 4 of 97 C 7 QR Code Parameters 7 1 Version Symbol Sizes 7 2 Format 7 3 Error Correction Level C 8 Micro QR Code Parameters 8 1 Version Symbol Sizes C 8 2 Error Correction Level 9 Codablock F Parameters 9 1 Format C 10 Aztec Code Parameters C 10 1
103. psd 4 Test the CUPS integration print the sample Postscript file lp Library Frameworks TBarCode framework Resources samples testfile ps show errors tail 100 var log cups error log Note for TBarCode X V10 2 1 The filter scripts need a fix wrong TBarCode directory please contact TEC IT support for the required steps 8 7 TBarCode X with UNISPOOL Holland House B V Create a script home unispool tbc filter script The script should have the following content cat 6 tbarcode filter home unispool cexpand In UNISPOOL use the filter by calling home unispool tbo filter script 8 8 SAP R 3 and SAP ERP Integration TBarCode X can be used with SAP systems to generate bar codes during printing Please request more information about the required configuration steps under the following email addresses sap tec it com support tec it com WWW TEC IT COM Page 58 of 97 WWW TEC IT COM Page 59 of 97 9 Generating Bitmap Images There are currently two ways to create barcodes as raster images Direct Bitmap Generation TBarCode X supports built in bitmap output but the human readable text will not be drawn In addition certain barcode symbologies such as the MAXICODE are not support for direct bitmap output Indirect Bitmap Generation via PostScript Create PostScript output and convert the PostScript output to the desired raster image format This method requires a bit more work but t
104. r bin enable tecitdevel usr sbin accept tecitdevel 8 5 2 3 Print To Filtered Printer Print the file report ps to the local Postscript printer o nobanner report ps Print the file report vl ps contains the TBarCodeX commands in the old V1 format to the local PostScript printer 15 Filter registration by the setup is implemented in TBarCode X V9 0 4 and later versions WWW TEC IT COM Page 57 of 97 lip thbeprintlocall viltormat nobanner repore vl ps Print PCL output to the network PCL printer lp d tbcprintremote o nobanner output pcl 8 5 3 Print Barcode Filter Test File lp d PSPrinterName usr local share tbarcodell samples testfile ps 8 6 Mac OS X Printing System Please follow the steps described above in section 8 2 for CUPS spool filter installation About the filter scripts gt Sym links will not work on OS X the filter scripts must be copied to the CUPS filter directory instead and the permissions must be set RX for all W for nobody retrieve CUPS filter directory cups config serverbin filter set the permissions chmod 0555 fi dltereupsm copy to CUPS filter directory sudo cp filtercups sh cups config serverbin filter Modify manually the usr share cups mime mime convs see above restart CUPS sudo start org cups cu
105. ries cannot be found dump H usr local share tbarcodell tbarcode 1 2 GCC Runtime Libraries Depending on the downloaded TBarCode X binary and target platform specific versions of the GCC runtime libraries are required Please download and install the missing gcc runtime libraries by using the information below 1 2 1 for Linux To find out which gcc version or libgcc version is required for your TBarCode X binary follow the notes in the README file coming with the installation see installation directory If there is no readme file available then please contact support tec it com WWW TEC IT COM Page 66 of 97 1 2 2 GCC for TBarCode X Required Runtime Libraries Download Links V7 0 4 AIX5 2 PPC V9 0 2 AIX5 2 PPC libgcc 3 3 2 libstdcplusplus 3 3 2 TEC IT Package untar into root dir http www tec it com Download Unix AIX gcc libs 3 3 2 AIX5 2 tar gz IBM Package download libgcc and libstdc for AIX 5 2 ftp ftp software ibm com aix freeSoftware aixtoolbox RPMS ppc gcc V10 0 0 AIX5 3 PPC V10 1 1 AIX5 3 PPC libgcc 3 3 2 libstdcplusplus 3 3 2 IBM Package download libgcc and libstdc for 5 3 ftp ftp software ibm com aix freeSoftware aixtoolbox RPMS ppc gcc V11 0 0 AIX5 3 PPC libgcc 4 2 0 libstdcplusplus 4 2 0 IBM Package download libgcc and libstdc for AIX 5 3 ftp ftp software ibm com aix freeSoftware aixtoolbox RPMS ppc g
106. rowheight HEIGHT Sets the height of a row Unit of measurement millimeters Examples PDFrowheight 5 0 PDFecl LEVEL Sets the error correction level Possible values 0 8 WWW TEC IT COM Page 41 of 97 Example 1 0 PDFmode MODE Sets the PDF417 encoding mode The PDF417 modes can be looked up in Section C 3 1 Encoding Mode Table 15 PDF417 Options 7 5 11 Micro PDF417 Settings The following parameters can be used to fine tune the generation of Micro PDF417 optional Short Long Description MPDFversion VERSION Sets the Micro PDF417 version symbol size The possible values can be looked up in Section C 4 1 Version Symbol Sizes MPDFmode MODE Sets the Micro PDF417 mode The Micro PDF417 modes can be looked up in section C 4 2 Mode Table 16 Micro PDF417 Options 7 5 12 Macro PDF417 Settings The following parameters can be used to configure the macro mode of PDF417 MicroPDF417 Short Long Description PDFindex NDEX Sets the segment index PDFid D Sets the file ID PDFlast Last segment PDFfile NAME Sets the file name PDFcount COUNT Sets the segment count PDFtime TIMESTAMP Sets timestamp PDFsender SENDER Sets the sender PDFaddr ADDRESSEE Sets the addressee PDFsize SIZE Sets the file size
107. s A 1 Dependencies The TBarCode X software uses shared libraries to provide a smaller total distribution size You have to make sure that all required libraries dependencies are installed on your system gt In most cases you need to install the GCC runtime libraries or a specific version of them If the correct 1ibgcc package has been already installed you may have to adapt the library path see A 2 Shared Library Path A 1 1 List Dynamic Dependencies If some dependencies are not installed or not found TBarCode X can function incorrectly or fail In this situation you must check that all the shared libraries are installed and can be found The following commands list the dynamic dependencies of executable files and libraries Use them to troubleshoot failed dependencies ldd on Solaris and Linux systems chatr on HP UX systems dump H on AIX systems Here are some examples 0 Commands Samples Linux ldd The output of these commands lists the dynamic dependencies and indicates which Solaris libraries cannot be found ldd usr local share tbarcodell tbarcode ldd usr local lib libtbarcode HP UX chatr The output of these commands shows the shared library path and whether the environment variable is enabled or disabled chatr usr local share tbarcodell tbarcode chatr usr local lib libtbarcode AIX dump H The output of this command lists the dynamic dependencies and indicates which libra
108. s alle Rechte vor Vervielfaltigung Bekanntgabe an Dritte oder Verwendung auBerhalb des vereinbarten Zweckes sind nicht gestattet 1998 2014 TEC IT Datenverarbeitung GimbH Hans Wagner Str 6 A 4400 Austria t 43 0 7252 72720 f 43 0 7252 72720 77 http www tec it com WWW TEC IT COM Page 9 of 97 3 About TBarCode X 3 1 Features 3 1 1 TBarCode X reduces the costs for barcode printing makes it possible to print barcodes on any PCL or PostScript compatible printer does not require costly barcode extension cartridges or special barcode fonts Thus you can print barcodes in a complete device independent way works in a completely transparent way is available as precompiled barcode engine for Linux AIX and Mac OS X Other operating systems on request 3 1 2 2 Symbologies Besides linear barcodes e g 20f5 20f5 ITL Code39 Code128 EAN128 EAN UPC TBarCode X also supports 2D symbologies like PDF417 Micro PDF Data Matrix MaxiCode QR Code Micro QR Code Aztec Code DotCode Han Xin Code Codablock 3 1 3 Barcode Quality TBarCode X offers the possibility to specify all barcode parameters these are for example The module width in absolute units completely device independent Selection of the subsets of Code128 subsets A B and C and automatic mode Advanced 2D bar code properties PDF417 error correction level etc T
109. s described above in section 8 2 for CUPS spool filter installation http docs oracle com cd E23824 01 html 821 1451 cups intro html http docs oracle com cd E23824 01 html 821 1451 gllmb html 8 5 2 Spool System Integration Solaris 10 and earlier Solaris spool filter integration can be done through modifying the netstandard interface file or by registering an pfilter as shown below TBarCode X for Solaris contains two filter definition files jos il pel 13 experts only Please contact TEC IT support if you want to change the netstandard interface script 14 Please contact TEC IT support if the Solaris filter scripts not part of your installation WWW TEC IT COM Page 56 of 97 With these files it is possible to include TBarCode filter into the 1p spool system In order to support filtering with remote printer queues we use Virtual printers as workaround Proceed as described below 8 5 2 1 Register Filter Setup During the installation phase the setup program registers automatically the TBarCode X filters using the following commands usr sbin lpfilter f tbarcode ps F usr local share tbarcodell filterlp ps fd usr sbin lpfilter f tbarcode pcl F usr local share tbarcodell filterlp pcl fd tbarcode isthe filter used for print jobs in PostSript printer language tbarcode pclis the filter used for print jobs in PCL printer language TIPS remove the filter
110. s from the bar code data start stop characters are insert automatically by the encoder 951 128 Remove leading trailing FNC1 characters from the bar code data FNC1 at first data position is added automatically by the encoder Possible values on off Example zgeUtoconrect oN e translation STATE Enables or disables the translation of escape sequences see also Escape Sequences in the Barcode Reference Possible values mon Orr ASO translation ON trimwhitespaces Removes all whitespaces spaces tabs etc from begin and the end of the barcode data removechars CHARS Removes the specified characters from the input data Can be used to remove spaces or dashes from article numbers Example removechars formatstring FORMAT Sets the format string The format string syntax can be looked up in Section C 14 Formatting Barcode Data Example formatstring A B amp compress ALGORITHM Compresses the data by using a compression algorithm Possible algorithms NONE default DEFLATE GZIP ZLIB Compression may be applied when a large amount of data has to be encoded as barcodes Compression should only be used in closed applications only with barcode symbologies that support binary data e g Data Matrix PDF417 MicroPDF QR Code etc After reading the barcode the data has to be decompressed using the appropriate al
111. section 7 4 3 The following filter parameters can be used to fine tune single barcodes individually These para meters are optional Short Long Description initgraphics Calls initgraphics in PostScript movecursor Moves cursor in the PCL code to end of the barcode remove Removes barcode control sequence from the data stream after filtering The default behavior is to overwrite the barcode control sequences with blanks embed STATE Defines the type of PostScript PCL code that is created Possible values on default for filtering off embed on creates a barcode that can be inserted into a PostScript PCL stream or file embed off creates a stand alone PostScript PCL file pos POS Sets the positioning mode to relative or absolute coordinates Possible values default for PostScript default for PCL abs rel Table 14 Filtering Options 7 5 10 PDF417 Settings The following parameters are optional and can be used to fine tune the generation of PDF417 Short Long Description PDFrows ROWS Sets the number of rows Possible values 3 90 Example PDFrows 10 PDFcols COLUMNS Sets the number of columns Possible values 1 30 Example PDFcols 9 PDFratio RATIO Sets the rows columns ratio Example PDFratio 3 1 PDFauto Automatically chooses the rows columns ratio PDF
112. size of the resulting barcode file The TBarCode Command and the TBarCode Daemon have to be called with the same memory settings So it is best to set an equal memory size in the configuration files tbarcode conf and tbarcoded conf unsure what to set then do not edit this parameter manually Example memory 65000 Table 56 TBarCode Daemon Daemon and IPC Options E 3 Error Message and Debug Options Short Long Description errorfile FILE Saves all messages in the given file This should only be used for debugging and not in the productive system Example errorfile tmp tbarcoded_errors log nosyslog Do not log messages using syslog nostderr Do not log messages to stderr trace LEVEL Sets the trace level to a certain value The trace level defines the amount of log messages that are written to an error file syslog or stderr Possible values sorted from minimal to maximal information output error default warning info verbose Example trace INFO Table 57 TBarCode Daemon Error Message and Debug Options E 3 1 Informative Output Short Long Description help Shows a help text for general options version Shows the version information Table 58 TBarCode Daemon Informative Output WWW TEC IT COM Page 94 of 97 Appendix F ASCII Table This table helps you to enter t
113. stScript Format The command below creates a Data Matrix barcode with the data content 2D Code tbarcode fPS oBarcode ps b7l m0 508 d 2D Code Parameter Description fPS Use PostScript output format default oBarcode ps Write barcode to the output file Barcode ps specify full path if required b71 Generate Barcode Type Data Matrix 71 see section C 1 for more types m0 508 Set the module width X Dimension to 0 508 mm d 2D Code Encode the data 2D Code 7 1 2 Create a Barcode in PCL 5 HP GL 25 Format The command below creates an EAN 13 barcode with the data content 123456789012 tbarcode fPOL oEANIS pol b13 m0 508 9 123456 789012 Parameter Description fPCL Use PCL output format oEAN13 pcl Write barcode to the output file EAN13 pcl specify full path if required b13 Generate Barcode Type EAN 13 13 see section C 1 for more types m0 508 Set the module width X Dimension to 0 508 mm d 123456789012 Encode the data 123456789012 the check digit is calculated automatically 7 1 3 Create a Barcode in PDF Portable Document Format The command below creates an EAN 13 barcode with the data content 123456789012 tbatcode oEANI3 pdf bl13 m0 508 d 123456789012 Parameter Description fPDF Use PDF output format oEAN13 pdf Write barcode to the output file EAN13 pdf specify
114. starting TBarCode X you receive the following error message or similar error while loading shared libraries libtbarcodelllso 0 cannot open shared object fases No such file or directory Solution Make sure that 1 11 isin usr local lib or usr 1ib If itis missing reinstall TBarCode X Ifthe problem still remains run the following command Linux only ldconfig usr local lib B 1 7 Where can read syslog messages Syslog messages will be written to the appropriate file specified in etc syslog conf Normally this is set to var log messages B 1 8 Why is a horizontal bar drawn across the barcodes You are currently working with the restricted demo version There is either no license file or an invalid license file installed Please refer to section 10 Licensing or contact us for a valid license file B 2 Questions about Filtering Printing 2 1 CUPS How to tell which filters are in place and maybe failing or missing You can switch on the debug mode in CUPS Open etc cups cupsd conf and add the line LogLevel debug Afterwards restart the CUPS daemon with etc init d cups restart When you now print a job a lot of information is written to the CUPS error log file usually var log cups error 109 You can read which filters and backends are called in which order For more information about printing problems see www linuxprinting org B 2 2 How filter ASCII files To fi
115. such as MAXICODE can only be drawn with HP GL 2 Unfortunately some printers are not fully PCL Level 5 compatible and do not understand HP GL 2 drawing operations Therefore HP GL 2 output can be disabled with this option Possible values PORS PCL5 compatible output PCL5noHPGL PCL5 compatible output without HP GL 2 operations Example WWW TEC IT COM Page 28 of 97 pclmode PCL5noHPGL overprint Enables overpriting for PostScript output If enabled all bars and the human readable text are printed over the existing background Otherwise PostScript will automatically calculate knock outs in underlying elements default Table 2 Output Format Settings 7 4 3 Filter Options These parameters allow you to enable and configure the filter mode of TBarCode X These are optional Short Long Description filter Enables filter mode In filter mode the TBarCode X command line application reads data from stand ard input stdin and writes the results to standard output stdout The input stream is scanned for barcode control sequences Each valid control sequence is replaced with a barcode The input stream must be PostScript or PCL All other input streams are not modified by TBarCode X stream TYPE Sets the type of the input stream Possible values PS PostScript data stream PCL PCL data If not set TBarCode X automatically
116. t amp c123 TBarCode version 8 and newer always returns 0 12345 Irrelevant THHHENE 1234c5 When using Modulo 10 for check digit calculation c will be Mod 10 12345 5 for TBarCode 6 or earlier Mod 10 1234 0 for TBarCode 7 or later Hello Code 128 A amp Hello Hello Code 128 A B amp Hello Hello4711 Code 128 A B amp Hello4711 Hello4711 Code 128 amp Hello4711 Table 52 Format Examples red characters gray characters green characters represented subset A represented in subset B represented in subset C represents the place of the check digit C 15 PCL Font Numbers Use these font numbers in combination with the parameter ont Number Typeface Family PCL Number Albertus 4362 Antique Olive 4168 Claredon 4140 Coronet 4116 Courier 4099 Garamond Antiqua 4197 Letter Gothic 4102 Marigold 4297 CG Omega 4113 CG Times 4101 Univers 4148 Table 53 PCL Font Numbers WWW TEC IT COM Page 90 of 97 Appendix D Using Version 1 x Format TBarCode for Linux Unix Version 1 x was the predecessor of TBarCode X Version 2 0 and newer The format of the required command line parameters and barcode control sequences has changed from version 1 x to current version of TBarCode X But TBarCode X can be run in a compatibility mode where it supports the old barcode control sequences Here is an example of an old barcode control sequen
117. te Rs Record Separator ASCII 1EHex PDF417 QR Code Data Matrix MaxiCode Mode 3 4 SCM xid Gs Group Separator ASCII 1DHex PDF417 QR Code Data Matrix MaxiCode Mode 3 4 SCM x04 Eot End of Transmission ASCII 04Hex PDF417 QR Code Data Matrix MaxiCode Mode 3 4 SCM Table 49 Implemented Escape Sequences P Please keep in mind that when translation of escape sequences is enabled you cannot code a backslash directly Use NV instead Please refer to the Barcode Reference http www tec it com Support gt Knowledge Base for more information C 13 2 Encoding Bytes or Binary Values With xhh you can encode Bytes in hexadecimal notation e g x01 xFF encodes the Byte 1 and 255 Note when using from the command line Put the input data into single quotes otherwise you need to encode a double backslash V to get a single one gt The specified values are translated to the default codepage used by the adjusted bar code C 13 3 Symbology Specific Control Characters If you have enabled translation of Escape sequences parameter translation on you can encode the following control characters barcode type dependent The input data must contain the escape sequence that corresponds to the control character Note when using from the command line Put the input data into single quotes e g 123 210456 otherwise you would need a double backslash like 123 21
118. tely up to 896 Default Level in V11 1 and later 1 L2 Up to 15 2 L3 Up to 23 3 L4 Highest level Up to 3096 Table 48 Han Xin Code Error Correction Levels C 13 Encoding Bytes and Control Characters in Input Data If you want to use non printable or special characters in your barcode data you have to use Escape Sequences These sequences start with a backslash followed by the sequence see table below You can use them also for encoding binary data in your barcode but only if the symbology offers this feature e g PDF417 or Data Matrix gt If you want to use escape sequences the command line put the data string into single quotation marks like 123 F and enable translation of escape sequences with translation on C 13 1 Implemented Escape Sequences Escape Description Valid for Barcode Symbology sequence a Bell alert All b Backspace f Form feed In New Line r Carriage Return t Horizontal Tab v Vertical Tab Backslash To get the escape symbol you have to escape it with itself 0 Zero Byte if subsequent char is non numeric Available in TBarCode V10 and higher 10000 ASCII character in octal notation Up to 3 octal digits 0 7 First digit is always zero ddd ASCII character in decimal notation up to decimal digits 0 9 First digit must not be zero xhh For encoding bytes or ASCll c
119. ter process communication which is not available on all platforms Here is a schematic overview of the TBarCode X components TBarCode Library Barcode Generation Library TBarCode TBarCode Daemon Command Line Tool Background Server Process Figure 1 TBarCode X with Daemon as Background Server Process TBarCode TBarCode Library Command Line Tool Barcode Generation Library Figure 2 TBarCode X without Daemon WWW TEC IT COM Page 13 of 97 4 1 1 TBarCode X Command Line Tool TBarCode X is shipped with a command line tool which can be called from any console shell to create barcodes It can also be used or invoked by shell scripts and applications 4 1 1 1 Create Barcodes on Command Line TBarCode X supports different output formats Vector image formats such as PostScript PS EPS PCL PDF Al and SVG Bitmap image formats BMP GIF JPG PNG and TIF The following example command creates a barcode of type Code 128 that contains the data abc1234 tbarcode output barcode eps barcode 20 data abc1234 The resulting barcode is stored as Encapsulated PostScript eps in the file barcode eps 4 1 1 2 Using TBarCode X to Process Data Streams With the TBarCode X command line application you can also process data streams like print jobs In this filler mode the TBarCode X command line application reads data from standard input stdin and writes the results to standard output stdout
120. the above file name with the file you have downloaded for your operating system 3 Walk through the displayed license terms with Space and confirm them agree by entering Yes followed by Return 4 The package will be installed gt If you install an rpm bin package see also the instructions in section 5 2 Install TBarCode X from an RPM Package 5 1 1 Common Problems Failed dependencies e g GCC runtime libraries missing see A 1 Dependencies Shared library libtbarcode not found see A 2 Shared Library Path 5 2 Install TBarCode X from an RPM Package If you have received the TBarCode X software as RPM package then follow the instructions in this section gt RPMs file extension rpm are archive files for automated software installation They require an RPM package manager installed on your system WWW TEC IT COM Page 16 of 97 The following steps need to be performed as administrator user root 1 Open anew console terminal 2 Type the command rpm i tbarcodell xxx rpm The name of your package might be different Replace the above file name with the file you have downloaded or received for your operating system 3 Register the TBarCode X libraries see section A 2 Shared Library Path 4 Check the execute permissions of TBarCode X see section 5 6 5 Installation is complete Steps 3 and 4 are actually optional but they are recommended to ensure that everything is i
121. the file has a name like tbarcodex 10 2 1 16367 mac 10 4 i386 x86 64 pkg where 10 2 1 version 16367 revision 10 4 from MacOS X version 10 4 1386 x86 64 architecture 32 bit 1386 and 64 bit x86_64 The following steps need to be performed you need an administrator password 1 Open the package by double clicking it 2 Follow the instructions of the installation wizard 5 5 1 Installation Path 5 5 1 1 TBarCode X V9 TBarCode will be installed at following paths tecit TBarCode9 gt TBarCodeX Library Frameworks TBarCode framework gt TBarCode Framework 5 5 1 2 TBarCode X V10 and later Starting with version 10 the Mac OS X framework standard is used TBarCode X Library Mac OS X Framework This framework is updated automatically to the latest TBarCode X version Library Frameworks TBarCode framework The symbolic Links to actual version automatically updated Library Frameworks TBarCode framework Commands Library Frameworks TBarCode framework Headers Library Frameworks TBarCode framework Libraries Library Frameworks TBarCode framework Resources Library Frameworks TBarCode framework TBarCode SS directory containing the versions Library Frameworks TBarCode framework Versions gt TBarCode X Version 10 2 1 home directory for TBarCode X 10 2 1 Library Frameworks TBarCode framework Versions 10 2 1 WWW TEC IT COM Page 20 of 97 directory with all commands
122. they are placed in etc lp interface For instance if you have a remote printer HP4050PS the script which handles the print out is located in etc 1p interface HP4050PS please check if you have a script in this place 8 4 4 Printing Script HP UX 11 00 or HP UX 11 23 Edit the script and insert the bold lines before the final 1 command HAE AE AE AE HE aE HE HE HE aE HE HE HE HE HE HEHEHE EE HEHEHE EE EEE HEHEHE HaHa EEE A E EU start TBarCode filter create temp file name INPUT mktemp tmp tbarcode XXXXXX WWW TEC IT COM Page 54 of 97 call tbarcode to insert barcode output to temp file usr local share tbarcodell tbarcode filter 1 INPUT overwrite original spool file mv SINPUT 1 end filter FEFE AE HE AE E FE TE HE FE E FE TE FE TE HE FE E FE TE HE AE E FE TE FE TE HE FE E FE TE FE AE AE FE E AE TE E AE E E E E E EE EE EE E EE EEEE usr sbin rlp I requestid BSDC BSDJ BSDT BSDi BSD1 BSD2 BSD3 BSD4 BSDw Result the filter is called before the spool job is sent to the printer with the r1p command 8 4 5 Printing Script HP UX 11 23 with Iconv Preload The iconv library from TEC IT A 1 3 2 must be available in usr local share teciticonv Edit the printing script and insert the following lines First we define a function tbarcode_filter for processing the spool file s Add this function code where applicable e g below the remote function remote lpr
123. timized for 200 dpi and software barcode decoder 9 2 Indirect Method Convert PostScript Output to Bitmap The following steps demonstrate an alternative method how to create barcode bitmap images with TBarCode X You will have to use this method if you want to see the barcode text in the bitmap 1 Generate a new barcode tbarcode obarcode eps b20 w80 h50 fontsize 24 O d Demo123 This creates a barcode of with a size of 80 mm x 50 mm The parameter 0 optimalwidth ensures the that all bars fit into a 72 dpi raster which is the native resolution in PostScript Instead of setting the width of the barcode directly you can also specify the desired module width For example tbarcode obarcode eps b20 modulewidth 0 35278 fontsize 24 O d Demo123 If you set the module width directly make sure that the module width is an integer multiple of 0 35278 mm Because 0 35278 mm matches exactly one dot pixel in PostScript 2 Convert the EPS file to bitmap format Several programs can be used to convert PostScript eps ps images to bitmap format Here are two examples convert is a command line tool that comes with the free ImageMagick software suite http www imagemagick org convert barcode eps barcode png You can use the option tantialias disable antialiasing for example convert tantialias barcode barcode png gs is a command line tool that comes with Ghostscript which is contained in
124. tom of a barcode Unit of measurement see quietzoneunit Example quietzonev 10 quietzoneunit mod or quietzonev 10mod quietzonev 10mm quietzonev 0 5inch It is not allowed to specify different units for vertical and horizontal quite zone bearertype TYPE Sets the type of the bearer bar Possible values W MONS Default topandbottom Horizontal bar above and below the barcode rectangle Rectangle around the barcode Ro Horizontal bar above the barcode D BOCCOM Horizontal bar below the barcode The former value horizontal is deprecated and has been replaced by topandbottom Example bearert ype TOPANDBOTTOM bearerwidth WIDTH Sets the width of a bearer bar Unit of measurement millimeters WWW TEC IT COM Page 38 of 97 Example bearerwidth 1 5 notchheight HEIGHT Set the notch height Unit of measurement millimeters Example notchheight 2 0 printratio RATIO Sets the print ratio ratio of narrow to wide bars and spaces See also Print Ratio in the Barcode Reference Example Table 11 Barcode Appearance Options 7 5 6 Quality Enhancement These parameters are used for enhancing bar code quality depending on output format All of these parameters are optional Short Long Description dpi DPI Sets th
125. trademark of Sun Microsystems Inc used under license for technology invented and implemented by Netscape Microsoft Windows Microsoft Word amp Microsoft Excel amp are registered trademarks of Microsoft Corporation Mac and Mac OS are trademarks of Apple Inc registered in the U S and other countries Navision is a registered trademark of Microsoft Business Solutions ApS in the United States and or other countries Oracle is a registered trademark of Oracle Corporation PCL6 is a registered trademark of the Hewlett Packard Company PostScript is a registered trademark of Adobe Systems Inc SAP SAP Logo R 28 ABAP SAPscript amp mySAPO are trademarks or registered trademarks of SAP AG in Germany and in several other countries SCO and SCO OpenServer are registered trademarks of The SCO Group Inc in the United States and other countries Solaris is a registered trademark of Sun Microsystems Inc SPARC is registered trademark of SPARC International Inc SUSE is registered trademark of SUSE AG a Novell business UNIX is a registered trademark of The Open Group All other products mentioned are trademarks or registered trademarks of their respective companies If any trademark on our web site or in this document is not marked as trademark or registered trademark we ask you to send us a short message mailto office tec it com WWW TEC IT COM Page 65 of 97 Appendix A Library Dependencie
126. upTBarCode install sh TBarcode for Unix Installation Copying include files Copying libraries Copying tbarcode files Registering TBarCode Library Creating link for TBarCode executable Setting file permissions Installation finished SuSE93 temp SetupTBarCode 5 3 2 1 Installation from tar gz files on AIX 1 First convert gz to tar by typing the following command gzip d SetupTBarCode V11 2 0 AIX5 3 PPC tar gz 2 Extract the tar file to the directory using this command tar xf SetupTBarCode V11 2 0 AIX5 3 PPC tar WWW TEC IT COM Page 18 of 97 5 3 3 Missing usr local directory TBarCode X V11 setup scripts create all required directories for you Earlier versions don t create all required directories so follow these steps 1 If the usr local directory is missing on your system you need to create the following directories manually mkdir usr local mkdir usr local bin mkdir usr local include mkdir usr local lib mkdir usr local share 2 Give the directories the same rights permissions as usr 5 3 4 Common Problems Failed dependencies e g GCC runtime libraries missing see A 1 Dependencies Shared library libtbarcode not found see A 2 Shared Library Path 5 3 5 Uninstall TBarCode X If you have installed TBarCode X from a TAR GZ package you can remove it with the following steps as administrator 1 Opena new console terminal 2 Type the comman
127. variable to the correct GCC library version like so export LIBPATH opt freeware lib gcc lib powerpc ibm aix5 3 0 0 3 3 2 9LIBPATH 2 4 1 GCC Lib Conflicts How to avoid conflicts between different versions of gcc libraries installed at the same time You could put the gcc libraries required by TBarCode into a sub folder of tbarcode and adjust the library path before calling tbarcode like so export LIBPATH usr local share tbarcodell gcec lib usr local lib LIBPATH WWW TEC IT COM Page 72 of 97 Appendix B Troubleshooting FAQ B 1 General Questions B 1 4 Canluse the old parameter format as it was used in TBarCode for Linux Version 1 x Yes add the line viformat to the TBarCode X configuration file tbarcode conf Now all barcode control sequences are interpreted as in TBarCode for Linux Version 1 x When you have the TBarCode Daemon installed you will have to restart the daemon before change comes into effect B 1 2 I have troubles with convert gray bars inside the barcode The convert utility was originally made for image conversion photographs and has a built in antialias filter During conversion from 72 dpi EPS files to bitmap files this filter can produce blurred bars with grayscales There is an option called antialias to switch off the filter but due to a bug in some version this option may work or not Use the following workaround to get a clear image with convert The antialiasin
128. which printer queue you want to use TBarCode X 2 First do a listing of the filter attributes to see if there is already a custom filter 1 anda general filter reference _ configured for your printer istvirpre 9 lt QueueName gt 3 Next we install TBarCode X as new filter to the virtual queue The attributes 1 2 3 4 5 may specify user defined filters f 1 is not occupied by another filter we set the value of 1 to usr local share tbarcodell tbarcode filter lt Parameters gt Forthat we use chvirprt to edit the attributes of the virtual printer definition chvirprt q lt QueueName gt d DeviceName a f1 usr local share tbarcodell tbarcode cxtat Ieee lt QueueName gt must be replaced with the virtual queue name lt DeviceName gt must be replaced with the device name of the virtual queue 4 f you want to print and filter barcodes call qprt with the parameter 1 The following test print shows if the filter is working qprt PQueueName f1 usr local share tbarcodell testfile ps qprt PQueueName f1 usr local share tbarcodell samples 2bc pcl 5 fthe filter is working you see bar codes make the filter 1 permanent This is done by setting the virtual printer attribute to 1 chvirprt q lt QueueName gt d lt DeviceName gt a f 1 With this setting all print jobs for this queue will be filtered automatically with TBarCode X 8 3 1 No f1 Attribute
129. wing parameters are optional and can be used to fine tune the generation of Aztec Code Short Long Description ACsize SIZE Sets the Aztec Code symbol size The possible values can be looked up in section C 10 1 Symbol Sizes ACbinary Barcode content is encoded in binary mode ACecl LEVEL Sets the error correction level in percent Possible values 89 ACrunes Switch to Runes mode Aztec Runes are small distinct machine readable marks which are able to encode values from 0 255 8 bits ACformat FORMAT Sets the Aztec Code format The possible values can be looked up in section C 10 2 Format ACspec SPECIFIER Sets the format specifier It is considered only when ACformat is set to 2 Industry format Allowed values are one single letter or a pair of digits ACappend Enables the structured append mode ACsum SUM Sets the total number of the structured append symbols Possible values YA 7 ACindex INDEX Sets the index of the current structured append symbol Possible values 7 rd WWW TEC IT COM Page 44 of 97 ACmessage D Sets the structured append message id Table 23 Aztec Code Options 7 5 19 DotCode Settings The following parameters are optional and can be used to fine tune the generation of DotCode Short Long Description
130. x Mode 2 SCM Numeric 3 SCM Alphanumeric 4 Default Mode 5 Full EEC Table 37 MaxiCode Modes C 7 QR Code Parameters C 7 1 Version Symbol Sizes This table shows the possible user defined symbol sizes for QR Code The symbol size can be defined by the parameter ORversion ndex Index Symbol size rows x cols Index Symbol size rows x cols 0 Automatic calculation 21 101 x 101 1 21x21 22 105 x 105 2 25x25 23 109 x 109 3 29 x 29 24 113 x 113 4 33 x 33 25 117 117 5 37 37 26 121 x 121 6 41x41 27 125 x 125 7 45 x 45 28 129 x 129 8 49 x 49 29 133 x 133 9 53 x 53 30 137 x 137 10 57 57 31 141 x 141 11 61 x 61 32 145 x 145 12 65 x 65 33 149 x 149 WWW TEC IT COM Page 83 of 97 13 69 x 69 34 153 x 153 14 73 X 73 35 157 x 157 15 77 77 36 161 x 161 16 81 x 81 37 165 x 165 17 85 x 85 38 169 x 169 18 89 x 89 39 173 x 173 19 93 x 93 40 177 177 20 97 97 Table 38 QR Code Symbol Sizes C 7 2 Format This table shows the possible formats for QR Code barcodes The format can be defined by the control sequence QRformat ndex Index Format 0 Default format 1 GS1 UCC EAN 2 Industry Table 39 QR Code Format Options C 7 3 Error Correction Level This table shows the possible Error Correction Levels for QR Code barcodes The Error Correction Level can be defined by the parameter
131. x Format Default format UCC EAN GS1 128 Emulation Code 128 Emulation Code 128 FNC2 Emulation Linked UCC EAN GS1 128 05 Macro 06 Macro CC A Data Mode ON DO c CC B Prefix 9 Binary encoding mode no data analysis Table 34 Micro PDF417 Modes C 5 Data Matrix Parameters C 5 1 Symbol Sizes The user defined symbol sizes for Data Matrix can be set with the parameter DMsi ze I ndex Index Symbol size rows x cols Index Symbol size rows x cols 0 Automatic calculation 16 64 x 64 1 10x10 17 72 x 72 2 12x12 18 80 x 80 3 14x14 19 88 x 88 4 16 16 20 96 x 96 5 18 18 21 104 104 6 20 x 20 22 120 x 120 7 22 x 22 23 132 x 132 8 24 x 24 24 144 x 144 9 26 x 26 25 8x18 10 32 x 32 26 8x32 11 36 x 36 27 12x26 12 40 x 40 28 12 x 36 WWW TEC IT COM Page 82 of 97 13 44 x 44 29 16 x 36 14 48 x 48 30 16 x 48 15 52x52 Table 35 Data Matrix Symbol Sizes C 5 2 Format The Data Matrix format can be set with the parameter DMformat ndex Index Format 0 Default format 1 GS1 UCC EAN 2 Industry 3 Macro 05 4 Macro 06 Table 36 Data Matrix Formats C 6 MaxiCode Parameters C 6 1 Mode This table shows the possible modes for MaxiCode The mode can be defined by the parameter MCmode ndex Inde
132. xample for the symbology 2of5 Interleaved TBarCode X Control Sequence Prefix tbcs fPCL b3 m0 254 h13 tHIDE origin BOTTOM d Suffix tbce Please note If you want to edit PCL print data directly e g within a spool file during tests please consider that a standard text editor could corrupt the print data during saving umlauts character set differences and CR LF conversion Use a hex editor for PCL editing for example KHexEdit If you omit the parameters m or h TBarCode X will use default values With the parameter defaultset 1 TBarCode X uses default values which are common for most barcode applications You can specify this parameter in the TBarCode X configuration file tbarcode conf If you don t know which barcode parameters to use please contact support tec it com B 25 can l filter Easybar control sequences Easybar control sequences can be filtered directly with TBarCode Command Use the following syntax tbarcode filter easybar on input pcl output pcl When TBarCode X is installed in your print spool system you can enable Easybar support permanently by adding the line easybar on to the TBarCode X configuration file tbarcode conf You should also consider using the option remove This option removes the Easybar control sequence from the filter stream which is the default behavior of most Easybar devices B 2 6 How print barcodes within a text fil

TBarCode/X User Manual V11

Contents

Download Pdf Manuals

Related Search

Related Contents