Zint Barcode Generator and Zint Barcode Studio User Manual
Version 2.11.1
August 2022
Contents
1. Introduction 6
1.1 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2. Installing Zint 8
2.1 Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.2 Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.3 Apple macOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.4 Zint Tcl Backend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3. Using Zint Barcode Studio 10
3.1 Main Window and Data Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3.2 GS1 Composite Groupbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.3 Additional ECI/Data Segments Groupbox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3.4 Symbology-specic Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.5 Appearance Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.6 Colour Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.7 Data Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
3.8 Sequence Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.9 Export Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3.10 CLI Equivalent Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
4. Using the Command Line 18
4.1 Inputting Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
4.2 Directing Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.3 Selecting Barcode Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
4.4 Adjusting Height . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
4.5 Adjusting Whitespace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4.6 Adding Boundary Bars and Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4.7 Using Colour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
4.8 Rotating the Symbol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
4.9 Adjusting Image Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
4.9.1 Scaling Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
4.9.2 MaxiCode Raster Scaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.10 Input Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.10.1 Unicode, Data, and GS1 Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
4.10.2 Input Modes and ECI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
4.10.2.1 Input Modes and ECI Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . 27
4.10.2.2 Input Modes and ECI Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.10.2.3 Input Modes and ECI Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.11 Batch Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.12 Direct Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.13 Automatic Filenames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
4.14 Working with Dots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
4.15 Multiple Segments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
4.16 Structured Append . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
4.17 Help Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
4.18 Other Output Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
5. Using the API 32
5.1 Creating and Deleting Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
5.2 Encoding and Saving to File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
5.3 Encoding and Printing Functions in Depth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
5.4 Buering Symbols in Memory (raster) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
5.5 Buering Symbols in Memory (vector) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
5.6 Setting Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
5.7 Handling Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
5.8 Specifying a Symbology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
5.9 Adjusting Other Output Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
5.10 Setting the Input Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
2
5.11 Multiple Segments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
5.12 Verifying Symbology Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
5.13 Checking Symbology Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
5.14 Zint Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
6. Types of Symbology 42
6.1 One-Dimensional Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6.1.1 Code 11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6.1.2 Code 2 of 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6.1.2.1 Standard Code 2 of 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6.1.2.2 IATA Code 2 of 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
6.1.2.3 Industrial Code 2 of 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
6.1.2.4 Interleaved Code 2 of 5 (ISO 16390) . . . . . . . . . . . . . . . . . . . . . . . . . 43
6.1.2.5 Code 2 of 5 Data Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
6.1.2.6 ITF-14 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
6.1.2.7 Deutsche Post Leitcode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
6.1.2.8 Deutsche Post Identcode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
6.1.3 UPC (Universal Product Code) (ISO 15420) . . . . . . . . . . . . . . . . . . . . . . . . . 44
6.1.3.1 UPC Version A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
6.1.3.2 UPC Version E . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
6.1.4 EAN (European Article Number) (ISO 15420) . . . . . . . . . . . . . . . . . . . . . . . . 45
6.1.4.1 EAN-2, EAN-5, EAN-8 and EAN-13 . . . . . . . . . . . . . . . . . . . . . . . . . 45
6.1.4.2 SBN, ISBN and ISBN-13 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
6.1.5 Plessey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
6.1.5.1 UK Plessey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
6.1.5.2 MSI Plessey . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
6.1.6 Telepen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
6.1.6.1 Telepen Alpha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
6.1.6.2 Telepen Numeric . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
6.1.7 Code 39 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
6.1.7.1 Standard Code 39 (ISO 16388) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
6.1.7.2 Extended Code 39 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
6.1.7.3 Code 93 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
6.1.7.4 PZN (Pharmazentralnummer) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
6.1.7.5 LOGMARS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
6.1.7.6 Code 32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
6.1.7.7 HIBC Code 39 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
6.1.7.8 Vehicle Identication Number (VIN) . . . . . . . . . . . . . . . . . . . . . . . . 50
6.1.8 Codabar (EN 798) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
6.1.9 Pharmacode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
6.1.10 Code 128 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
6.1.10.1 Standard Code 128 (ISO 15417) . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
6.1.10.2 Code 128 Subset B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
6.1.10.3 GS1-128 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
6.1.10.4 EAN-14 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
6.1.10.5 NVE-18 (SSCC-18) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
6.1.10.6 HIBC Code 128 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
6.1.10.7 DPD Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
6.1.11 GS1 DataBar (ISO 24724) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
6.1.11.1 GS1 DataBar Omnidirectional and GS1 DataBar Truncated . . . . . . . . . . . . 53
6.1.11.2 GS1 DataBar Limited . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
6.1.11.3 GS1 DataBar Expanded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
6.1.12 Korea Post Barcode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
6.1.13 Channel Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
6.1.14 BC412 (SEMI T1-95) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
6.2 Stacked Symbologies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
6.2.1 Basic Symbol Stacking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
6.2.2 Codablock-F . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
6.2.3 Code 16K (EN 12323) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
6.2.4 PDF417 (ISO 15438) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
6.2.5 Compact PDF417 (ISO 15438) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
3
6.2.6 MicroPDF417 (ISO 24728) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
6.2.7 GS1 DataBar Stacked (ISO 24724) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
6.2.7.1 GS1 DataBar Stacked . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
6.2.7.2 GS1 DataBar Stacked Omnidirectional . . . . . . . . . . . . . . . . . . . . . . . . 58
6.2.7.3 GS1 DataBar Expanded Stacked . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
6.2.8 Code 49 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
6.3 GS1 Composite Symbols (ISO 24723) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
6.3.1 CC-A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
6.3.2 CC-B . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
6.3.3 CC-C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
6.4 Two-Track Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
6.4.1 Two-Track Pharmacode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
6.4.2 POSTNET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
6.4.3 PLANET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
6.4.4 Brazilian CEPNet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
6.5 4-State Postal Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
6.5.1 Australia Post 4-State Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
6.5.1.1 Customer Barcodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
6.5.1.2 Reply Paid Barcode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
6.5.1.3 Routing Barcode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
6.5.1.4 Redirect Barcode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
6.5.2 Dutch Post KIX Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
6.5.3 Royal Mail 4-State Customer Code (RM4SCC) . . . . . . . . . . . . . . . . . . . . . . . . 64
6.5.4 Royal Mail 4-State Mailmark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
6.5.5 USPS Intelligent Mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
6.5.6 Japanese Postal Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
6.5.7 DAFT Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
6.6 Matrix Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
6.6.1 Data Matrix (ISO 16022) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
6.6.2 QR Code (ISO 18004) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
6.6.3 Micro QR Code (ISO 18004) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
6.6.4 Rectangular Micro QR Code (rMQR) (ISO 23941) . . . . . . . . . . . . . . . . . . . . . . 69
6.6.5 UPNQR (Univerzalnega Plačilnega Naloga QR) . . . . . . . . . . . . . . . . . . . . . . . 70
6.6.6 MaxiCode (ISO 16023) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
6.6.7 Aztec Code (ISO 24778) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
6.6.8 Aztec Runes (ISO 24778) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
6.6.9 Code One . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
6.6.10 Grid Matrix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
6.6.11 DotCode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
6.6.12 Han Xin Code (ISO 20830) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
6.6.13 Ultracode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
6.7 Other Barcode-Like Markings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
6.7.1 Facing Identication Mark (FIM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
6.7.2 Flattermarken . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
7. Legal and Version Information 78
7.1 License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
7.2 Patent Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
7.3 Version Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
7.4 Sources of Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
7.5 Standards Compliance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
7.5.1 Symbology Standards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
7.5.2 General Standards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Annex A. Character Encoding 80
A.1 ASCII Standard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
A.2 Latin Alphabet No. 1 (ISO/IEC 8859-1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Annex B. Man Page ZINT(1) 81
NAME . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
SYNOPSIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
4
DESCRIPTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
EXIT STATUS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
BUGS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
SEE ALSO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
CONFORMING TO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
COPYRIGHT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
AUTHOR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
5