mirror of
https://git.code.sf.net/p/zint/code
synced 2026-06-10 15:43:40 +00:00
pandoc: update to 3.10; add extension "four_space_rule" to
txt output to semi-restore previous behaviour; adjust GS1-Enabled table & command line so not > 80 chars; Fedora now requires tcolorbox install BWIPP: update to latest
This commit is contained in:
+1
-1
@@ -163,7 +163,7 @@ PDF_OPTS = --pdf-engine=xelatex \
|
||||
-V csquotes=true --dpi=300
|
||||
TEX_MAN_PAGE = zint.1.tex
|
||||
TXT_OPTS = --lua-filter=$(LUA_FILTER) \
|
||||
--columns 80 --eol=lf -t plain
|
||||
--columns 80 --eol=lf -t plain+four_space_rule
|
||||
MAN_PAGE_OPTS = -s -t man
|
||||
|
||||
all : $(OUT_PDF) $(OUT_TXT) $(OUT_MAN_PAGE) $(OUT_QT_MAN_PAGE) $(OUT_HTML)
|
||||
|
||||
+7
-6
@@ -1,4 +1,4 @@
|
||||
% docs/README 2026-03-22
|
||||
% docs/README 2026-06-05
|
||||
% vim: set ts=4 sw=4 et :
|
||||
|
||||
For generation of "docs/manual.html", "docs/manual.pdf" and "docs/manual.txt" from "manual.pmd"
|
||||
@@ -7,8 +7,8 @@ using pandoc >= 3.8.2.
|
||||
|
||||
On Ubuntu/Debian (tested on Ubuntu 22.04 and Ubuntu 24.04)
|
||||
|
||||
wget https://github.com/jgm/pandoc/releases/download/3.9.0.2/pandoc-3.9.0.2-1-amd64.deb
|
||||
sudo dpkg -i pandoc-3.9.0.2-1-amd64.deb
|
||||
wget https://github.com/jgm/pandoc/releases/download/3.10/pandoc-3.10-1-amd64.deb
|
||||
sudo dpkg -i pandoc-3.10-1-amd64.deb
|
||||
sudo apt install librsvg2-bin
|
||||
sudo apt install texlive-xetex
|
||||
sudo apt install texlive-lang-cjk
|
||||
@@ -17,9 +17,9 @@ On Ubuntu/Debian (tested on Ubuntu 22.04 and Ubuntu 24.04)
|
||||
|
||||
On Fedora (tested on Fedora Linux 38 (Workstation Edition) and Fedora Linux 42 (Workstation Edition))
|
||||
|
||||
wget https://github.com/jgm/pandoc/releases/download/3.9.0.2/pandoc-3.9.0.2-linux-amd64.tar.gz
|
||||
tar xf pandoc-3.9.0.2-linux-amd64.tar.gz
|
||||
sudo mv -i pandoc-3.9.0.2/bin/pandoc /usr/local/bin
|
||||
wget https://github.com/jgm/pandoc/releases/download/3.10/pandoc-3.10-linux-amd64.tar.gz
|
||||
tar xf pandoc-3.10-linux-amd64.tar.gz
|
||||
sudo mv -i pandoc-3.10/bin/pandoc /usr/local/bin
|
||||
sudo dnf install librsvg2-tools.x86_64
|
||||
sudo dnf install texlive-xetex
|
||||
sudo dnf install texlive-ctex.noarch
|
||||
@@ -29,6 +29,7 @@ On Fedora (tested on Fedora Linux 38 (Workstation Edition) and Fedora Linux 42 (
|
||||
sudo dnf install texlive-sectsty.noarch
|
||||
sudo dnf install texlive-xecjk.noarch
|
||||
sudo dnf install texlive-tex-gyre.noarch
|
||||
sudo dnf install texlive-tcolorbox.noarch
|
||||
sudo dnf install wqy-microhei-fonts.noarch
|
||||
make
|
||||
|
||||
|
||||
+50
-43
@@ -334,7 +334,7 @@
|
||||
<h1 class="title">Zint Barcode Generator and Zint Barcode Studio User
|
||||
Manual</h1>
|
||||
<p class="author">Version 2.16.0.9</p>
|
||||
<p class="date">May 2026</p>
|
||||
<p class="date">June 2026</p>
|
||||
</header>
|
||||
<nav id="TOC" role="doc-toc">
|
||||
<ul>
|
||||
@@ -2957,113 +2957,120 @@ alt="zint -b QRCODE --binary -d "\xE2\x82\xAC\xE5\xB8\xB8" --esc" />
|
||||
<h3 id="gs1-data-entry-and-options">4.11.3 GS1 Data Entry and
|
||||
Options</h3>
|
||||
<p>The following symbologies accept GS1 data:</p>
|
||||
<table>
|
||||
<table style="width:82%;">
|
||||
<caption><span class="table-label">Table 10:</span> GS1-Enabled
|
||||
Symbologies</caption>
|
||||
<colgroup>
|
||||
<col style="width: 36%" />
|
||||
<col style="width: 13%" />
|
||||
<col style="width: 13%" />
|
||||
<col style="width: 18%" />
|
||||
</colgroup>
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="text-align: left;">Symbology</th>
|
||||
<th>Implicit AI?</th>
|
||||
<th>Assumed?</th>
|
||||
<th>Supports Composite?</th>
|
||||
<th style="text-align: left;">Implicit AI?</th>
|
||||
<th>GS1 Data Assumed?</th>
|
||||
<th style="text-align: left;">Supports GS1 Composite?</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td style="text-align: left;">Aztec Code</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">Code 16K</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">Code 49</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">Code One</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">Data Matrix</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">DotCode</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">EAN-13, EAN-8</td>
|
||||
<td>Yes (01)</td>
|
||||
<td>Yes</td>
|
||||
<td style="text-align: left;">Yes (01)</td>
|
||||
<td>Yes</td>
|
||||
<td style="text-align: left;">Yes</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">EAN-14</td>
|
||||
<td>Yes (01)</td>
|
||||
<td style="text-align: left;">Yes (01)</td>
|
||||
<td>Yes</td>
|
||||
<td>No</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">GS1-128</td>
|
||||
<td>No</td>
|
||||
<td>Yes</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
<td>Yes</td>
|
||||
<td style="text-align: left;">Yes</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">GS1 DataBar Expanded (Stacked)</td>
|
||||
<td>No</td>
|
||||
<td>Yes</td>
|
||||
<td style="text-align: left;">GS1 DataBar Expanded (including
|
||||
Stacked)</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
<td>Yes</td>
|
||||
<td style="text-align: left;">Yes</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">GS1 DataBar (all others)</td>
|
||||
<td>Yes (01)</td>
|
||||
<td>Yes</td>
|
||||
<td style="text-align: left;">Yes (01)</td>
|
||||
<td>Yes</td>
|
||||
<td style="text-align: left;">Yes</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">NVE-18</td>
|
||||
<td>Yes (00)</td>
|
||||
<td style="text-align: left;">Yes (00)</td>
|
||||
<td>Yes</td>
|
||||
<td>No</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">QR Code</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">rMQR</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">Ultracode</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td>No</td>
|
||||
<td style="text-align: left;">No</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td style="text-align: left;">UPC-A, UPC-E</td>
|
||||
<td>Yes (01)</td>
|
||||
<td>Yes</td>
|
||||
<td style="text-align: left;">Yes (01)</td>
|
||||
<td>Yes</td>
|
||||
<td style="text-align: left;">Yes</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
@@ -3078,13 +3085,13 @@ distinguish AIs.</p>
|
||||
<p>The traditional way in Zint of specifying GS1 data for these cases is
|
||||
to delimit the GS1 AIs in square brackets:</p>
|
||||
<div class="sourceCode" id="cb48"><pre
|
||||
class="sourceCode bash"><code class="sourceCode bash"><span id="cb48-1"><a href="#cb48-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> AZTEC <span class="at">-d</span> <span class="st">"[01]09520123456788[10]BATCH4[21]07"</span> <span class="at">--gs1</span></span></code></pre></div>
|
||||
class="sourceCode bash"><code class="sourceCode bash"><span id="cb48-1"><a href="#cb48-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> AZTEC <span class="at">-d</span> <span class="st">"[01]09520123456788[10]BCH4[21]07"</span> <span class="at">--gs1</span></span></code></pre></div>
|
||||
<p>(Note that for the matrix symbologies the <code>--gs1</code> option
|
||||
must be given.)</p>
|
||||
<p>Parentheses (round brackets) may be used instead by giving the
|
||||
<code>--gs1parens</code> option:</p>
|
||||
<div class="sourceCode" id="cb49"><pre
|
||||
class="sourceCode bash"><code class="sourceCode bash"><span id="cb49-1"><a href="#cb49-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> AZTEC <span class="at">-d</span> <span class="st">"(01)09520123456788(10)BATCH4(21)07"</span> <span class="at">--gs1parens</span></span></code></pre></div>
|
||||
class="sourceCode bash"><code class="sourceCode bash"><span id="cb49-1"><a href="#cb49-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> AZTEC <span class="at">-d</span> <span class="st">"(01)09520123456788(10)BCH4(21)07"</span> <span class="at">--gs1parens</span></span></code></pre></div>
|
||||
<p>If the data includes opening parentheses when using the latter
|
||||
format, they must be escaped and the <code>--esc</code> option
|
||||
given:</p>
|
||||
@@ -3093,7 +3100,7 @@ class="sourceCode bash"><code class="sourceCode bash"><span id="cb50-1"><a href=
|
||||
<p>Closing parentheses may also be escaped for clarity.</p>
|
||||
<p>For matrix symbologies, a GS1 Digital Link URI may be used:</p>
|
||||
<div class="sourceCode" id="cb51"><pre
|
||||
class="sourceCode bash"><code class="sourceCode bash"><span id="cb51-1"><a href="#cb51-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> AZTEC <span class="at">-d</span> <span class="st">"https://example.com/01/09520123456788/10/BATCH4/21/07"</span> <span class="at">--gs1</span></span></code></pre></div>
|
||||
class="sourceCode bash"><code class="sourceCode bash"><span id="cb51-1"><a href="#cb51-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> AZTEC <span class="at">-d</span> <span class="st">"https://example.com/01/09520123456788/10/BCH4/21/07"</span> <span class="at">--gs1</span></span></code></pre></div>
|
||||
<p>A further way to specify GS1 input is “Unbracketed AI”, a GS1 Syntax
|
||||
Engine format<a href="#fn10" class="footnote-ref" id="fnref10"
|
||||
role="doc-noteref"><sup>10</sup></a> that uses carets (<code>^</code>)
|
||||
@@ -3101,13 +3108,13 @@ to indicate any required <code>FNC1</code>s.<a href="#fn11"
|
||||
class="footnote-ref" id="fnref11" role="doc-noteref"><sup>11</sup></a>
|
||||
The data must start with a caret:</p>
|
||||
<div class="sourceCode" id="cb52"><pre
|
||||
class="sourceCode bash"><code class="sourceCode bash"><span id="cb52-1"><a href="#cb52-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> AZTEC <span class="at">-d</span> <span class="st">"^010952012345678810BATCH4^2107"</span> <span class="at">--gs1</span></span></code></pre></div>
|
||||
class="sourceCode bash"><code class="sourceCode bash"><span id="cb52-1"><a href="#cb52-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> AZTEC <span class="at">-d</span> <span class="st">"^010952012345678810BCH4^2107"</span> <span class="at">--gs1</span></span></code></pre></div>
|
||||
<p>The final way to specify input is the related “raw” mode using the
|
||||
<code>--gs1raw</code> option. Here <code>FNC1</code>s are indicated by
|
||||
Group Separators (<code>GS</code>, ASCII 29, escape sequence
|
||||
<code>\G</code>). It does not start with a <code>GS</code>:</p>
|
||||
<div class="sourceCode" id="cb53"><pre
|
||||
class="sourceCode bash"><code class="sourceCode bash"><span id="cb53-1"><a href="#cb53-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> AZTEC <span class="at">-d</span> <span class="st">"010952012345678810BATCH4\G2107"</span> <span class="at">--esc</span> <span class="at">--gs1raw</span></span></code></pre></div>
|
||||
class="sourceCode bash"><code class="sourceCode bash"><span id="cb53-1"><a href="#cb53-1" aria-hidden="true" tabindex="-1"></a><span class="ex">zint</span> <span class="at">-b</span> AZTEC <span class="at">-d</span> <span class="st">"010952012345678810BCH4\G2107"</span> <span class="at">--esc</span> <span class="at">--gs1raw</span></span></code></pre></div>
|
||||
<h4 id="gs1-options">4.11.3.2 GS1 Options</h4>
|
||||
<p>Apart from <code>--gs1</code>, <code>--gs1parens</code> and
|
||||
<code>--gs1raw</code> discussed above, there are two other GS1
|
||||
|
||||
+43
-24
@@ -1,6 +1,6 @@
|
||||
% Zint Barcode Generator and Zint Barcode Studio User Manual
|
||||
% Version 2.16.0.9
|
||||
% May 2026
|
||||
% June 2026
|
||||
|
||||
[//]: # ( vim: set ts=4 sw=4 et : )
|
||||
|
||||
@@ -1508,24 +1508,43 @@ zint -b QRCODE --binary -d "UTF-8 data"
|
||||
|
||||
The following symbologies accept GS1 data:
|
||||
|
||||
Symbology Implicit AI? Assumed? Supports Composite?
|
||||
------------- ------------ -------- -------------------
|
||||
Aztec Code No No No
|
||||
Code 16K No No No
|
||||
Code 49 No No No
|
||||
Code One No No No
|
||||
Data Matrix No No No
|
||||
DotCode No No No
|
||||
EAN-13, EAN-8 Yes (01) Yes Yes
|
||||
EAN-14 Yes (01) Yes No
|
||||
GS1-128 No Yes Yes
|
||||
GS1 DataBar Expanded (Stacked) No Yes Yes
|
||||
GS1 DataBar (all others) Yes (01) Yes Yes
|
||||
NVE-18 Yes (00) Yes No
|
||||
QR Code No No No
|
||||
rMQR No No No
|
||||
Ultracode No No No
|
||||
UPC-A, UPC-E Yes (01) Yes Yes
|
||||
----------------------------------------------------------
|
||||
Symbology Implicit GS1 Data Supports GS1
|
||||
AI? Assumed? Composite?
|
||||
------------- -------- -------- ------------
|
||||
Aztec Code No No No
|
||||
|
||||
Code 16K No No No
|
||||
|
||||
Code 49 No No No
|
||||
|
||||
Code One No No No
|
||||
|
||||
Data Matrix No No No
|
||||
|
||||
DotCode No No No
|
||||
|
||||
EAN-13, EAN-8 Yes (01) Yes Yes
|
||||
|
||||
EAN-14 Yes (01) Yes No
|
||||
|
||||
GS1-128 No Yes Yes
|
||||
|
||||
GS1 DataBar Expanded No Yes Yes
|
||||
(including Stacked)
|
||||
|
||||
GS1 DataBar (all others) Yes (01) Yes Yes
|
||||
|
||||
NVE-18 Yes (00) Yes No
|
||||
|
||||
QR Code No No No
|
||||
|
||||
rMQR No No No
|
||||
|
||||
Ultracode No No No
|
||||
|
||||
UPC-A, UPC-E Yes (01) Yes Yes
|
||||
----------------------------------------------------------
|
||||
|
||||
Table: GS1-Enabled Symbologies
|
||||
|
||||
@@ -1542,7 +1561,7 @@ The traditional way in Zint of specifying GS1 data for these cases is to delimit
|
||||
the GS1 AIs in square brackets:
|
||||
|
||||
```bash
|
||||
zint -b AZTEC -d "[01]09520123456788[10]BATCH4[21]07" --gs1
|
||||
zint -b AZTEC -d "[01]09520123456788[10]BCH4[21]07" --gs1
|
||||
```
|
||||
|
||||
(Note that for the matrix symbologies the `--gs1` option must be given.)
|
||||
@@ -1551,7 +1570,7 @@ Parentheses (round brackets) may be used instead by giving the `--gs1parens`
|
||||
option:
|
||||
|
||||
```bash
|
||||
zint -b AZTEC -d "(01)09520123456788(10)BATCH4(21)07" --gs1parens
|
||||
zint -b AZTEC -d "(01)09520123456788(10)BCH4(21)07" --gs1parens
|
||||
```
|
||||
|
||||
If the data includes opening parentheses when using the latter format, they must
|
||||
@@ -1566,7 +1585,7 @@ Closing parentheses may also be escaped for clarity.
|
||||
For matrix symbologies, a GS1 Digital Link URI may be used:
|
||||
|
||||
```bash
|
||||
zint -b AZTEC -d "https://example.com/01/09520123456788/10/BATCH4/21/07" --gs1
|
||||
zint -b AZTEC -d "https://example.com/01/09520123456788/10/BCH4/21/07" --gs1
|
||||
```
|
||||
|
||||
A further way to specify GS1 input is "Unbracketed AI", a GS1 Syntax Engine
|
||||
@@ -1574,7 +1593,7 @@ format[^10] that uses carets (`^`) to indicate any required `FNC1`s.[^11] The
|
||||
data must start with a caret:
|
||||
|
||||
```bash
|
||||
zint -b AZTEC -d "^010952012345678810BATCH4^2107" --gs1
|
||||
zint -b AZTEC -d "^010952012345678810BCH4^2107" --gs1
|
||||
```
|
||||
|
||||
[^10]: For more information on the "Unbracketed AI" format for GS1 data entry,
|
||||
@@ -1594,7 +1613,7 @@ option. Here `FNC1`s are indicated by Group Separators (`GS`, ASCII 29, escape
|
||||
sequence `\G`). It does not start with a `GS`:
|
||||
|
||||
```bash
|
||||
zint -b AZTEC -d "010952012345678810BATCH4\G2107" --esc --gs1raw
|
||||
zint -b AZTEC -d "010952012345678810BCH4\G2107" --esc --gs1raw
|
||||
```
|
||||
|
||||
#### 4.11.3.2 GS1 Options
|
||||
|
||||
+355
-336
@@ -1,6 +1,6 @@
|
||||
Zint Barcode Generator and Zint Barcode Studio User Manual
|
||||
Version 2.16.0.9
|
||||
May 2026
|
||||
June 2026
|
||||
|
||||
*******************************************************************************
|
||||
* For reference the following is a text-only version of the Zint manual, *
|
||||
@@ -9,206 +9,206 @@ May 2026
|
||||
* however this text file is more likely to be up-to-date. *
|
||||
*******************************************************************************
|
||||
|
||||
- 1. Introduction
|
||||
- 1.1 Glossary
|
||||
- 2. Installing Zint
|
||||
- 2.1 Linux
|
||||
- 2.2 BSD
|
||||
- 2.3 Microsoft Windows
|
||||
- 2.4 Apple macOS
|
||||
- 2.5 Zint Tcl Backend
|
||||
- 3. Using Zint Barcode Studio
|
||||
- 3.1 Main Window and Data Tab
|
||||
- 3.2 GS1 Composite Groupbox
|
||||
- 3.3 Additional ECI/Data Segments Groupbox
|
||||
- 3.4 Symbology-specific Groupbox
|
||||
- 3.5 Symbology-specific Tab
|
||||
- 3.6 Appearance Tab
|
||||
- 3.7 Data Dialog
|
||||
- 3.8 Sequence Dialog
|
||||
- 3.9 Export Dialog
|
||||
- 3.10 CLI Equivalent Dialog
|
||||
- 4. Using the Command Line
|
||||
- 4.1 Inputting Data
|
||||
- 4.2 Directing Output
|
||||
- 4.3 Selecting Barcode Type
|
||||
- 4.4 Adjusting Height
|
||||
- 4.5 Adjusting Whitespace
|
||||
- 4.6 Adding Boundary Bars and Boxes
|
||||
- 4.7 Using Colour
|
||||
- 4.8 Rotating the Symbol
|
||||
- 4.9 Adjusting Image Size (X-dimension)
|
||||
- 4.9.1 Scaling by X-dimension and Resolution
|
||||
- 4.9.2 Scaling Example
|
||||
- 4.9.3 MaxiCode Raster Scaling
|
||||
- 4.10 Human Readable Text (HRT) Options
|
||||
- 4.11 Input Modes
|
||||
- 4.11.1 Unicode, Data, and GS1 Modes
|
||||
- 4.11.2 Input Modes and ECI
|
||||
- 4.11.2.1 Input Modes and ECI Example 1
|
||||
- 4.11.2.2 Input Modes and ECI Example 2
|
||||
- 4.11.2.3 Input Modes and ECI Example 3
|
||||
- 4.11.3 GS1 Data Entry and Options
|
||||
- 4.11.3.1 GS1 Data Entry
|
||||
- 4.11.3.2 GS1 Options
|
||||
- 4.12 Batch Processing
|
||||
- 4.13 Direct Output to stdout
|
||||
- 4.14 Automatic Filenames
|
||||
- 4.15 Working with Dots
|
||||
- 4.16 Multiple Segments
|
||||
- 4.17 Structured Append
|
||||
- 4.18 Help Options
|
||||
- 4.19 Other Options
|
||||
- 5. Using the API
|
||||
- 5.1 Creating and Deleting Symbols
|
||||
- 5.2 Encoding and Saving to File
|
||||
- 5.3 Encoding and Printing Functions in Depth
|
||||
- 5.4 Buffering Symbols in Memory (raster)
|
||||
- 5.5 Buffering Symbols in Memory (vector)
|
||||
- 5.6 Buffering Symbols in Memory (memfile)
|
||||
- 5.7 Setting Options
|
||||
- 5.8 Handling Errors
|
||||
- 5.9 Specifying a Symbology
|
||||
- 5.10 Adjusting Output Options
|
||||
- 5.11 Setting the Input Mode
|
||||
- 5.12 Multiple Segments
|
||||
- 5.13 Scaling Helpers
|
||||
- 5.14 Verifying Symbology Availability
|
||||
- 5.15 Checking Symbology Capabilities
|
||||
- 5.16 Feedback
|
||||
- 5.17 UTF-8 to ECI convenience functions
|
||||
- 5.18 Zint Version
|
||||
- 5.19 Debug Info
|
||||
- 6. Types of Symbology
|
||||
- 6.1 One-Dimensional Symbols
|
||||
- 6.1.1 Code 11
|
||||
- 6.1.2 Code 2 of 5
|
||||
- 6.1.2.1 Standard Code 2 of 5
|
||||
- 6.1.2.2 IATA Code 2 of 5
|
||||
- 6.1.2.3 Industrial Code 2 of 5
|
||||
- 6.1.2.4 Interleaved Code 2 of 5 (ISO 16390)
|
||||
- 6.1.2.5 Code 2 of 5 Data Logic
|
||||
- 6.1.2.6 ITF-14
|
||||
- 6.1.2.7 Deutsche Post Leitcode
|
||||
- 6.1.2.8 Deutsche Post Identcode
|
||||
- 6.1.3 UPC (Universal Product Code) (ISO 15420)
|
||||
- 6.1.3.1 UPC Version A
|
||||
- 6.1.3.2 UPC Version E
|
||||
- 6.1.4 EAN (European Article Number) (ISO 15420)
|
||||
- 6.1.4.1 EAN-13
|
||||
- 6.1.4.2 EAN-8
|
||||
- 6.1.4.3 ISBN (including SBN and ISBN-13)
|
||||
- 6.1.4.4 EAN/UPC Add-Ons (standalone)
|
||||
- 6.1.5 Plessey
|
||||
- 6.1.5.1 UK Plessey
|
||||
- 6.1.5.2 MSI Plessey
|
||||
- 6.1.6 Telepen
|
||||
- 6.1.6.1 Telepen Alpha
|
||||
- 6.1.6.2 Telepen Numeric
|
||||
- 6.1.7 Code 39
|
||||
- 6.1.7.1 Standard Code 39 (ISO 16388)
|
||||
- 6.1.7.2 Extended Code 39
|
||||
- 6.1.7.3 Code 93
|
||||
- 6.1.7.4 PZN (Pharmazentralnummer)
|
||||
- 6.1.7.5 LOGMARS
|
||||
- 6.1.7.6 Code 32
|
||||
- 6.1.7.7 HIBC Code 39
|
||||
- 6.1.7.8 Vehicle Identification Number (VIN)
|
||||
- 6.1.8 Codabar (EN 798)
|
||||
- 6.1.9 Pharmacode One-Track
|
||||
- 6.1.10 Code 128
|
||||
- 6.1.10.1 Standard Code 128 (ISO 15417)
|
||||
- 6.1.10.2 Code 128 Suppress Code Set C (Code Sets A and B only)
|
||||
- 6.1.10.3 GS1-128
|
||||
- 6.1.10.4 EAN-14
|
||||
- 6.1.10.5 NVE-18 (SSCC-18)
|
||||
- 6.1.10.6 HIBC Code 128
|
||||
- 6.1.10.7 DPD Code
|
||||
- 6.1.10.8 UPU S10
|
||||
- 6.1.11 GS1 DataBar (ISO 24724)
|
||||
- 6.1.11.1 GS1 DataBar Omnidirectional and GS1 DataBar Truncated
|
||||
- 6.1.11.2 GS1 DataBar Limited
|
||||
- 6.1.11.3 GS1 DataBar Expanded
|
||||
- 6.1.12 Korea Post Barcode
|
||||
- 6.1.13 Channel Code
|
||||
- 6.1.14 BC412 (SEMI T1-95)
|
||||
- 6.2 Stacked Symbologies
|
||||
- 6.2.1 Basic Symbol Stacking
|
||||
- 6.2.2 Codablock F
|
||||
- 6.2.3 Code 16K (EN 12323)
|
||||
- 6.2.4 PDF417 (ISO 15438)
|
||||
- 6.2.5 Compact PDF417 (ISO 15438)
|
||||
- 6.2.6 MicroPDF417 (ISO 24728)
|
||||
- 6.2.7 GS1 DataBar Stacked (ISO 24724)
|
||||
- 6.2.7.1 GS1 DataBar Stacked
|
||||
- 6.2.7.2 GS1 DataBar Stacked Omnidirectional
|
||||
- 6.2.7.3 GS1 DataBar Expanded Stacked
|
||||
- 6.2.8 Code 49
|
||||
- 6.3 GS1 Composite Symbols (ISO 24723)
|
||||
- 6.3.1 CC-A
|
||||
- 6.3.2 CC-B
|
||||
- 6.3.3 CC-C
|
||||
- 6.4 Two-Track Symbols
|
||||
- 6.4.1 Pharmacode Two-Track
|
||||
- 6.4.2 POSTNET
|
||||
- 6.4.3 PLANET
|
||||
- 6.4.4 Brazilian CEPNet
|
||||
- 6.4.5 DX Film Edge Barcode
|
||||
- 6.5 4-State Postal Codes
|
||||
- 6.5.1 Australia Post 4-State Symbols
|
||||
- 6.5.1.1 Customer Barcodes
|
||||
- 6.5.1.2 Reply Paid Barcode
|
||||
- 6.5.1.3 Routing Barcode
|
||||
- 6.5.1.4 Redirect Barcode
|
||||
- 6.5.2 Dutch Post KIX Code
|
||||
- 6.5.3 Royal Mail 4-State Customer Code (RM4SCC)
|
||||
- 6.5.4 Royal Mail 4-State Mailmark
|
||||
- 6.5.5 USPS Intelligent Mail
|
||||
- 6.5.6 Japanese Postal Code
|
||||
- 6.5.7 DAFT Code
|
||||
- 6.6 Matrix Symbols
|
||||
- 6.6.1 Data Matrix (ISO 16022)
|
||||
- 6.6.2 Royal Mail 2D Mailmark (CMDM) (Data Matrix)
|
||||
- 6.6.3 QR Code (ISO 18004)
|
||||
- 6.6.4 Micro QR Code (ISO 18004)
|
||||
- 6.6.5 Rectangular Micro QR Code (rMQR) (ISO 23941)
|
||||
- 6.6.6 UPNQR (Univerzalnega Plačilnega Naloga QR)
|
||||
- 6.6.7 MaxiCode (ISO 16023)
|
||||
- 6.6.8 Aztec Code (ISO 24778)
|
||||
- 6.6.9 Aztec Runes (ISO 24778)
|
||||
- 6.6.10 Code One
|
||||
- 6.6.11 Grid Matrix
|
||||
- 6.6.12 DotCode
|
||||
- 6.6.13 Han Xin Code (ISO 20830)
|
||||
- 6.6.14 Ultracode
|
||||
- 6.7 Other Barcode-Like Markings
|
||||
- 6.7.1 Facing Identification Mark (FIM)
|
||||
- 6.7.2 Flattermarken
|
||||
- 7. Legal and Version Information
|
||||
- 7.1 License
|
||||
- 7.2 Patent Issues
|
||||
- 7.3 Version Information
|
||||
- 7.4 Sources of Information
|
||||
- 7.5 Standards Compliance
|
||||
- 7.5.1 Symbology Standards
|
||||
- 7.5.2 General Standards
|
||||
- Annex A. Character Encoding
|
||||
- A.1 ASCII Standard
|
||||
- A.2 Latin Alphabet No. 1 (ISO/IEC 8859-1)
|
||||
- Annex B. Qt Backend QZint
|
||||
- Annex C. Tcl Backend Binding
|
||||
- Annex D. Man Page ZINT(1)
|
||||
- NAME
|
||||
- SYNOPSIS
|
||||
- DESCRIPTION
|
||||
- OPTIONS
|
||||
- EXIT STATUS
|
||||
- EXAMPLES
|
||||
- BUGS
|
||||
- SEE ALSO
|
||||
- CONFORMING TO
|
||||
- COPYRIGHT
|
||||
- AUTHOR
|
||||
- 1. Introduction
|
||||
- 1.1 Glossary
|
||||
- 2. Installing Zint
|
||||
- 2.1 Linux
|
||||
- 2.2 BSD
|
||||
- 2.3 Microsoft Windows
|
||||
- 2.4 Apple macOS
|
||||
- 2.5 Zint Tcl Backend
|
||||
- 3. Using Zint Barcode Studio
|
||||
- 3.1 Main Window and Data Tab
|
||||
- 3.2 GS1 Composite Groupbox
|
||||
- 3.3 Additional ECI/Data Segments Groupbox
|
||||
- 3.4 Symbology-specific Groupbox
|
||||
- 3.5 Symbology-specific Tab
|
||||
- 3.6 Appearance Tab
|
||||
- 3.7 Data Dialog
|
||||
- 3.8 Sequence Dialog
|
||||
- 3.9 Export Dialog
|
||||
- 3.10 CLI Equivalent Dialog
|
||||
- 4. Using the Command Line
|
||||
- 4.1 Inputting Data
|
||||
- 4.2 Directing Output
|
||||
- 4.3 Selecting Barcode Type
|
||||
- 4.4 Adjusting Height
|
||||
- 4.5 Adjusting Whitespace
|
||||
- 4.6 Adding Boundary Bars and Boxes
|
||||
- 4.7 Using Colour
|
||||
- 4.8 Rotating the Symbol
|
||||
- 4.9 Adjusting Image Size (X-dimension)
|
||||
- 4.9.1 Scaling by X-dimension and Resolution
|
||||
- 4.9.2 Scaling Example
|
||||
- 4.9.3 MaxiCode Raster Scaling
|
||||
- 4.10 Human Readable Text (HRT) Options
|
||||
- 4.11 Input Modes
|
||||
- 4.11.1 Unicode, Data, and GS1 Modes
|
||||
- 4.11.2 Input Modes and ECI
|
||||
- 4.11.2.1 Input Modes and ECI Example 1
|
||||
- 4.11.2.2 Input Modes and ECI Example 2
|
||||
- 4.11.2.3 Input Modes and ECI Example 3
|
||||
- 4.11.3 GS1 Data Entry and Options
|
||||
- 4.11.3.1 GS1 Data Entry
|
||||
- 4.11.3.2 GS1 Options
|
||||
- 4.12 Batch Processing
|
||||
- 4.13 Direct Output to stdout
|
||||
- 4.14 Automatic Filenames
|
||||
- 4.15 Working with Dots
|
||||
- 4.16 Multiple Segments
|
||||
- 4.17 Structured Append
|
||||
- 4.18 Help Options
|
||||
- 4.19 Other Options
|
||||
- 5. Using the API
|
||||
- 5.1 Creating and Deleting Symbols
|
||||
- 5.2 Encoding and Saving to File
|
||||
- 5.3 Encoding and Printing Functions in Depth
|
||||
- 5.4 Buffering Symbols in Memory (raster)
|
||||
- 5.5 Buffering Symbols in Memory (vector)
|
||||
- 5.6 Buffering Symbols in Memory (memfile)
|
||||
- 5.7 Setting Options
|
||||
- 5.8 Handling Errors
|
||||
- 5.9 Specifying a Symbology
|
||||
- 5.10 Adjusting Output Options
|
||||
- 5.11 Setting the Input Mode
|
||||
- 5.12 Multiple Segments
|
||||
- 5.13 Scaling Helpers
|
||||
- 5.14 Verifying Symbology Availability
|
||||
- 5.15 Checking Symbology Capabilities
|
||||
- 5.16 Feedback
|
||||
- 5.17 UTF-8 to ECI convenience functions
|
||||
- 5.18 Zint Version
|
||||
- 5.19 Debug Info
|
||||
- 6. Types of Symbology
|
||||
- 6.1 One-Dimensional Symbols
|
||||
- 6.1.1 Code 11
|
||||
- 6.1.2 Code 2 of 5
|
||||
- 6.1.2.1 Standard Code 2 of 5
|
||||
- 6.1.2.2 IATA Code 2 of 5
|
||||
- 6.1.2.3 Industrial Code 2 of 5
|
||||
- 6.1.2.4 Interleaved Code 2 of 5 (ISO 16390)
|
||||
- 6.1.2.5 Code 2 of 5 Data Logic
|
||||
- 6.1.2.6 ITF-14
|
||||
- 6.1.2.7 Deutsche Post Leitcode
|
||||
- 6.1.2.8 Deutsche Post Identcode
|
||||
- 6.1.3 UPC (Universal Product Code) (ISO 15420)
|
||||
- 6.1.3.1 UPC Version A
|
||||
- 6.1.3.2 UPC Version E
|
||||
- 6.1.4 EAN (European Article Number) (ISO 15420)
|
||||
- 6.1.4.1 EAN-13
|
||||
- 6.1.4.2 EAN-8
|
||||
- 6.1.4.3 ISBN (including SBN and ISBN-13)
|
||||
- 6.1.4.4 EAN/UPC Add-Ons (standalone)
|
||||
- 6.1.5 Plessey
|
||||
- 6.1.5.1 UK Plessey
|
||||
- 6.1.5.2 MSI Plessey
|
||||
- 6.1.6 Telepen
|
||||
- 6.1.6.1 Telepen Alpha
|
||||
- 6.1.6.2 Telepen Numeric
|
||||
- 6.1.7 Code 39
|
||||
- 6.1.7.1 Standard Code 39 (ISO 16388)
|
||||
- 6.1.7.2 Extended Code 39
|
||||
- 6.1.7.3 Code 93
|
||||
- 6.1.7.4 PZN (Pharmazentralnummer)
|
||||
- 6.1.7.5 LOGMARS
|
||||
- 6.1.7.6 Code 32
|
||||
- 6.1.7.7 HIBC Code 39
|
||||
- 6.1.7.8 Vehicle Identification Number (VIN)
|
||||
- 6.1.8 Codabar (EN 798)
|
||||
- 6.1.9 Pharmacode One-Track
|
||||
- 6.1.10 Code 128
|
||||
- 6.1.10.1 Standard Code 128 (ISO 15417)
|
||||
- 6.1.10.2 Code 128 Suppress Code Set C (Code Sets A and B only)
|
||||
- 6.1.10.3 GS1-128
|
||||
- 6.1.10.4 EAN-14
|
||||
- 6.1.10.5 NVE-18 (SSCC-18)
|
||||
- 6.1.10.6 HIBC Code 128
|
||||
- 6.1.10.7 DPD Code
|
||||
- 6.1.10.8 UPU S10
|
||||
- 6.1.11 GS1 DataBar (ISO 24724)
|
||||
- 6.1.11.1 GS1 DataBar Omnidirectional and GS1 DataBar Truncated
|
||||
- 6.1.11.2 GS1 DataBar Limited
|
||||
- 6.1.11.3 GS1 DataBar Expanded
|
||||
- 6.1.12 Korea Post Barcode
|
||||
- 6.1.13 Channel Code
|
||||
- 6.1.14 BC412 (SEMI T1-95)
|
||||
- 6.2 Stacked Symbologies
|
||||
- 6.2.1 Basic Symbol Stacking
|
||||
- 6.2.2 Codablock F
|
||||
- 6.2.3 Code 16K (EN 12323)
|
||||
- 6.2.4 PDF417 (ISO 15438)
|
||||
- 6.2.5 Compact PDF417 (ISO 15438)
|
||||
- 6.2.6 MicroPDF417 (ISO 24728)
|
||||
- 6.2.7 GS1 DataBar Stacked (ISO 24724)
|
||||
- 6.2.7.1 GS1 DataBar Stacked
|
||||
- 6.2.7.2 GS1 DataBar Stacked Omnidirectional
|
||||
- 6.2.7.3 GS1 DataBar Expanded Stacked
|
||||
- 6.2.8 Code 49
|
||||
- 6.3 GS1 Composite Symbols (ISO 24723)
|
||||
- 6.3.1 CC-A
|
||||
- 6.3.2 CC-B
|
||||
- 6.3.3 CC-C
|
||||
- 6.4 Two-Track Symbols
|
||||
- 6.4.1 Pharmacode Two-Track
|
||||
- 6.4.2 POSTNET
|
||||
- 6.4.3 PLANET
|
||||
- 6.4.4 Brazilian CEPNet
|
||||
- 6.4.5 DX Film Edge Barcode
|
||||
- 6.5 4-State Postal Codes
|
||||
- 6.5.1 Australia Post 4-State Symbols
|
||||
- 6.5.1.1 Customer Barcodes
|
||||
- 6.5.1.2 Reply Paid Barcode
|
||||
- 6.5.1.3 Routing Barcode
|
||||
- 6.5.1.4 Redirect Barcode
|
||||
- 6.5.2 Dutch Post KIX Code
|
||||
- 6.5.3 Royal Mail 4-State Customer Code (RM4SCC)
|
||||
- 6.5.4 Royal Mail 4-State Mailmark
|
||||
- 6.5.5 USPS Intelligent Mail
|
||||
- 6.5.6 Japanese Postal Code
|
||||
- 6.5.7 DAFT Code
|
||||
- 6.6 Matrix Symbols
|
||||
- 6.6.1 Data Matrix (ISO 16022)
|
||||
- 6.6.2 Royal Mail 2D Mailmark (CMDM) (Data Matrix)
|
||||
- 6.6.3 QR Code (ISO 18004)
|
||||
- 6.6.4 Micro QR Code (ISO 18004)
|
||||
- 6.6.5 Rectangular Micro QR Code (rMQR) (ISO 23941)
|
||||
- 6.6.6 UPNQR (Univerzalnega Plačilnega Naloga QR)
|
||||
- 6.6.7 MaxiCode (ISO 16023)
|
||||
- 6.6.8 Aztec Code (ISO 24778)
|
||||
- 6.6.9 Aztec Runes (ISO 24778)
|
||||
- 6.6.10 Code One
|
||||
- 6.6.11 Grid Matrix
|
||||
- 6.6.12 DotCode
|
||||
- 6.6.13 Han Xin Code (ISO 20830)
|
||||
- 6.6.14 Ultracode
|
||||
- 6.7 Other Barcode-Like Markings
|
||||
- 6.7.1 Facing Identification Mark (FIM)
|
||||
- 6.7.2 Flattermarken
|
||||
- 7. Legal and Version Information
|
||||
- 7.1 License
|
||||
- 7.2 Patent Issues
|
||||
- 7.3 Version Information
|
||||
- 7.4 Sources of Information
|
||||
- 7.5 Standards Compliance
|
||||
- 7.5.1 Symbology Standards
|
||||
- 7.5.2 General Standards
|
||||
- Annex A. Character Encoding
|
||||
- A.1 ASCII Standard
|
||||
- A.2 Latin Alphabet No. 1 (ISO/IEC 8859-1)
|
||||
- Annex B. Qt Backend QZint
|
||||
- Annex C. Tcl Backend Binding
|
||||
- Annex D. Man Page ZINT(1)
|
||||
- NAME
|
||||
- SYNOPSIS
|
||||
- DESCRIPTION
|
||||
- OPTIONS
|
||||
- EXIT STATUS
|
||||
- EXAMPLES
|
||||
- BUGS
|
||||
- SEE ALSO
|
||||
- CONFORMING TO
|
||||
- COPYRIGHT
|
||||
- AUTHOR
|
||||
|
||||
1. Introduction
|
||||
|
||||
@@ -225,14 +225,14 @@ to encode data in over 50 barcode symbologies (types of barcode), for each of
|
||||
which it is possible to translate that data from either UTF-8 (Unicode) or a raw
|
||||
8-bit data stream. The image can be rendered as a
|
||||
|
||||
- Windows Bitmap (BMP),
|
||||
- Enhanced Metafile Format (EMF),
|
||||
- Encapsulated PostScript (EPS),
|
||||
- Graphics Interchange Format (GIF),
|
||||
- ZSoft Paintbrush (PCX) image,
|
||||
- Portable Network Graphic (PNG) image,
|
||||
- Tagged Image File Format (TIF), or a
|
||||
- Scalable Vector Graphic (SVG).
|
||||
- Windows Bitmap (BMP),
|
||||
- Enhanced Metafile Format (EMF),
|
||||
- Encapsulated PostScript (EPS),
|
||||
- Graphics Interchange Format (GIF),
|
||||
- ZSoft Paintbrush (PCX) image,
|
||||
- Portable Network Graphic (PNG) image,
|
||||
- Tagged Image File Format (TIF), or a
|
||||
- Scalable Vector Graphic (SVG).
|
||||
|
||||
Many options are available for setting the characteristics of the output image
|
||||
including the size and colour of the image, the amount of error correction used
|
||||
@@ -395,8 +395,8 @@ For Microsoft Windows, Zint is distributed as a binary executable. Simply
|
||||
download the ZIP file, then right-click on the ZIP file and "Extract All". A new
|
||||
folder will be created within which are two binary files:
|
||||
|
||||
- qtZint.exe - Zint Barcode Studio
|
||||
- zint.exe - Command Line Interface
|
||||
- qtZint.exe - Zint Barcode Studio
|
||||
- zint.exe - Command Line Interface
|
||||
|
||||
For fresh releases you will get a warning message from Microsoft Defender
|
||||
SmartScreen that this is an ‘unrecognised app’. This happens because Zint is a
|
||||
@@ -1565,25 +1565,43 @@ by default and do not support ECI. In this case supply UTF-8 data and use the
|
||||
|
||||
The following symbologies accept GS1 data:
|
||||
|
||||
Symbology Implicit AI? Assumed? Supports Composite?
|
||||
-------------------------------- -------------- ---------- -------------------
|
||||
--
|
||||
Aztec Code No No No
|
||||
Code 16K No No No
|
||||
Code 49 No No No
|
||||
Code One No No No
|
||||
Data Matrix No No No
|
||||
DotCode No No No
|
||||
EAN-13, EAN-8 Yes (01) Yes Yes
|
||||
EAN-14 Yes (01) Yes No
|
||||
GS1-128 No Yes Yes
|
||||
GS1 DataBar Expanded (Stacked) No Yes Yes
|
||||
GS1 DataBar (all others) Yes (01) Yes Yes
|
||||
NVE-18 Yes (00) Yes No
|
||||
QR Code No No No
|
||||
rMQR No No No
|
||||
Ultracode No No No
|
||||
UPC-A, UPC-E Yes (01) Yes Yes
|
||||
------------------------------------------------------------
|
||||
Symbology Implicit GS1 Data Supports GS1
|
||||
AI? Assumed? Composite?
|
||||
------------------------- ---------- ---------- ------------
|
||||
Aztec Code No No No
|
||||
|
||||
Code 16K No No No
|
||||
|
||||
Code 49 No No No
|
||||
|
||||
Code One No No No
|
||||
|
||||
Data Matrix No No No
|
||||
|
||||
DotCode No No No
|
||||
|
||||
EAN-13, EAN-8 Yes (01) Yes Yes
|
||||
|
||||
EAN-14 Yes (01) Yes No
|
||||
|
||||
GS1-128 No Yes Yes
|
||||
|
||||
GS1 DataBar Expanded No Yes Yes
|
||||
(including Stacked)
|
||||
|
||||
GS1 DataBar (all others) Yes (01) Yes Yes
|
||||
|
||||
NVE-18 Yes (00) Yes No
|
||||
|
||||
QR Code No No No
|
||||
|
||||
rMQR No No No
|
||||
|
||||
Ultracode No No No
|
||||
|
||||
UPC-A, UPC-E Yes (01) Yes Yes
|
||||
------------------------------------------------------------
|
||||
|
||||
Table 10: GS1-Enabled Symbologies
|
||||
|
||||
@@ -1599,14 +1617,14 @@ encode multiple AIs, require markup in the data to distinguish AIs.
|
||||
The traditional way in Zint of specifying GS1 data for these cases is to delimit
|
||||
the GS1 AIs in square brackets:
|
||||
|
||||
zint -b AZTEC -d "[01]09520123456788[10]BATCH4[21]07" --gs1
|
||||
zint -b AZTEC -d "[01]09520123456788[10]BCH4[21]07" --gs1
|
||||
|
||||
(Note that for the matrix symbologies the --gs1 option must be given.)
|
||||
|
||||
Parentheses (round brackets) may be used instead by giving the --gs1parens
|
||||
option:
|
||||
|
||||
zint -b AZTEC -d "(01)09520123456788(10)BATCH4(21)07" --gs1parens
|
||||
zint -b AZTEC -d "(01)09520123456788(10)BCH4(21)07" --gs1parens
|
||||
|
||||
If the data includes opening parentheses when using the latter format, they must
|
||||
be escaped and the --esc option given:
|
||||
@@ -1617,39 +1635,39 @@ Closing parentheses may also be escaped for clarity.
|
||||
|
||||
For matrix symbologies, a GS1 Digital Link URI may be used:
|
||||
|
||||
zint -b AZTEC -d "https://example.com/01/09520123456788/10/BATCH4/21/07" --g
|
||||
s1
|
||||
zint -b AZTEC -d "https://example.com/01/09520123456788/10/BCH4/21/07" --gs1
|
||||
|
||||
A further way to specify GS1 input is “Unbracketed AI”, a GS1 Syntax Engine
|
||||
format[10] that uses carets (^) to indicate any required FNC1s.[11] The data
|
||||
must start with a caret:
|
||||
|
||||
zint -b AZTEC -d "^010952012345678810BATCH4^2107" --gs1
|
||||
zint -b AZTEC -d "^010952012345678810BCH4^2107" --gs1
|
||||
|
||||
The final way to specify input is the related “raw” mode using the --gs1raw
|
||||
option. Here FNC1s are indicated by Group Separators (GS, ASCII 29, escape
|
||||
sequence \G). It does not start with a GS:
|
||||
|
||||
zint -b AZTEC -d "010952012345678810BATCH4\G2107" --esc --gs1raw
|
||||
zint -b AZTEC -d "010952012345678810BCH4\G2107" --esc --gs1raw
|
||||
|
||||
4.11.3.2 GS1 Options
|
||||
|
||||
Apart from --gs1, --gs1parens and --gs1raw discussed above, there are two other
|
||||
GS1 options.
|
||||
|
||||
- --gs1strict, which enables the use the GS1 Syntax Engine to strictly validate
|
||||
GS1 data, including GS1 Digital Link URIs (by default Zint does not validate
|
||||
Digital Links at all). It requires that the gs1encoders library was present
|
||||
when Zint was built, otherwise the default built-in validation will be used.
|
||||
- --gs1strict, which enables the use the GS1 Syntax Engine to strictly
|
||||
validate GS1 data, including GS1 Digital Link URIs (by default Zint does not
|
||||
validate Digital Links at all). It requires that the gs1encoders library was
|
||||
present when Zint was built, otherwise the default built-in validation will
|
||||
be used.
|
||||
|
||||
- --gs1nocheck, for use with legacy systems that have data that does not conform
|
||||
to the current GS1 standard. Printable ASCII input is still checked for, as is
|
||||
the validity of GS1 data specified without AIs (e.g. linear data for GS1
|
||||
DataBar Omnidirectional/Limited/etc.). Also checked is GS1 DataBar Expanded
|
||||
and GS1 Composite input that is not in the GS1 encodable character set 82 (see
|
||||
GS1 General Specifications 26.0 Table 7-2 “GS1 AI encodable character set
|
||||
82”), otherwise encodation would fail. In “Unbracketed AI” and raw mode,
|
||||
overlong AI data will also fail.
|
||||
- --gs1nocheck, for use with legacy systems that have data that does not
|
||||
conform to the current GS1 standard. Printable ASCII input is still checked
|
||||
for, as is the validity of GS1 data specified without AIs (e.g. linear data
|
||||
for GS1 DataBar Omnidirectional/Limited/etc.). Also checked is GS1 DataBar
|
||||
Expanded and GS1 Composite input that is not in the GS1 encodable character
|
||||
set 82 (see GS1 General Specifications 26.0 Table 7-2 “GS1 AI encodable
|
||||
character set 82”), otherwise encodation would fail. In “Unbracketed AI” and
|
||||
raw mode, overlong AI data will also fail.
|
||||
|
||||
All the GS1 options imply --gs1 (unlike their API equivalents, for which see
|
||||
5.11 Setting the Input Mode).
|
||||
@@ -4103,10 +4121,10 @@ tracking code, followed by a dash (-), followed by a delivery point ZIP code
|
||||
which can be 0, 5, 9 or 11 digits in length. For example all of the following
|
||||
inputs are valid data entries:
|
||||
|
||||
- "01234567094987654321"
|
||||
- "01234567094987654321-01234"
|
||||
- "01234567094987654321-012345678"
|
||||
- "01234567094987654321-01234567891"
|
||||
- "01234567094987654321"
|
||||
- "01234567094987654321-01234"
|
||||
- "01234567094987654321-012345678"
|
||||
- "01234567094987654321-01234567891"
|
||||
|
||||
6.5.6 Japanese Postal Code
|
||||
|
||||
@@ -5043,24 +5061,24 @@ See "ChangeLog" in the project root directory for information on all releases.
|
||||
|
||||
Below is a list of some of the sources used in rough chronological order:
|
||||
|
||||
- Nick Johnson’s Barcode Specifications
|
||||
- Bar Code 1 Specification Source Page
|
||||
- SB Electronic Systems Telepen website
|
||||
- Pharmacode specifications from Laetus
|
||||
- Morovia RM4SCC specification
|
||||
- Australia Post’s ‘A Guide to Printing the 4-State Barcode’ and bcsample source
|
||||
code
|
||||
- Plessey algorithm from GNU-Barcode v0.98 by Leonid A. Broukhis
|
||||
- GS1 General Specifications v 8.0 Issue 2
|
||||
- PNG: The Definitive Guide and wpng source code by Greg Reolofs
|
||||
- PDF417 specification and pdf417 source code by Grand Zebu
|
||||
- Barcode Reference, TBarCode/X User Documentation and TBarCode/X demonstration
|
||||
program from TEC-IT
|
||||
- IEC16022 source code by Stefan Schmidt et al
|
||||
- United States Postal Service Specification USPS-B-3200
|
||||
- Adobe Systems Incorporated Encapsulated PostScript File Format Specification
|
||||
- BSI Online Library
|
||||
- Libdmtx Data Matrix ECC200 decoding library
|
||||
- Nick Johnson’s Barcode Specifications
|
||||
- Bar Code 1 Specification Source Page
|
||||
- SB Electronic Systems Telepen website
|
||||
- Pharmacode specifications from Laetus
|
||||
- Morovia RM4SCC specification
|
||||
- Australia Post’s ‘A Guide to Printing the 4-State Barcode’ and bcsample
|
||||
source code
|
||||
- Plessey algorithm from GNU-Barcode v0.98 by Leonid A. Broukhis
|
||||
- GS1 General Specifications v 8.0 Issue 2
|
||||
- PNG: The Definitive Guide and wpng source code by Greg Reolofs
|
||||
- PDF417 specification and pdf417 source code by Grand Zebu
|
||||
- Barcode Reference, TBarCode/X User Documentation and TBarCode/X
|
||||
demonstration program from TEC-IT
|
||||
- IEC16022 source code by Stefan Schmidt et al
|
||||
- United States Postal Service Specification USPS-B-3200
|
||||
- Adobe Systems Incorporated Encapsulated PostScript File Format Specification
|
||||
- BSI Online Library
|
||||
- Libdmtx Data Matrix ECC200 decoding library
|
||||
|
||||
7.5 Standards Compliance
|
||||
|
||||
@@ -5069,56 +5087,57 @@ international standards:
|
||||
|
||||
7.5.1 Symbology Standards
|
||||
|
||||
- ISO/IEC 24778:2024 Information technology - Automatic identification and data
|
||||
capture techniques - Aztec Code bar code symbology specification
|
||||
- SEMI T1-95 Specification for Back Surface Bar Code Marking of Silicon Wafers
|
||||
(BC412) (1996)
|
||||
- ANSI/AIM BC12-1998 - Uniform Symbology Specification Channel Code
|
||||
- BS EN 798:1996 Bar coding - Symbology specifications - ‘Codabar’
|
||||
- AIM Europe ISS-X-24 - Uniform Symbology Specification Codablock F (1995)
|
||||
- ISO/IEC 15417:2007 Information technology - Automatic identification and data
|
||||
capture techniques - Code 128 bar code symbology specification
|
||||
- BS EN 12323:2005 AIDC technologies - Symbology specifications - Code 16K
|
||||
- ISO/IEC 16388:2023 Information technology - Automatic identification and data
|
||||
capture techniques - Code 39 bar code symbology specification
|
||||
- ANSI/AIM BC6-2000 - Uniform Symbology Specification Code 49
|
||||
- ANSI/AIM BC5-1995 - Uniform Symbology Specification Code 93
|
||||
- AIM Uniform Symbology Specification Code One (1994)
|
||||
- ISO/IEC 16022:2024 Information technology - Automatic identification and data
|
||||
capture techniques - Data Matrix bar code symbology specification
|
||||
- ISO/IEC 21471:2025 Information technology - Automatic identification and data
|
||||
capture techniques - Extended rectangular data matrix (DMRE) bar code
|
||||
symbology specification
|
||||
- AIM TSC1705001 (v 4.0 Draft 0.15) - Information technology - Automatic
|
||||
identification and data capture techniques - Bar code symbology
|
||||
specification - DotCode (Revised 28th May 2019)
|
||||
- ISO/IEC 15420:2025 Information technology - Automatic identification and data
|
||||
capture techniques - EAN/UPC bar code symbology specification
|
||||
- AIMD014 (v 1.63) - Information technology, Automatic identification and data
|
||||
capture techniques - Bar code symbology specification - Grid Matrix (Released
|
||||
9th Dec 2008)
|
||||
- ISO/IEC 24723:2010 Information technology - Automatic identification and data
|
||||
capture techniques - GS1 Composite bar code symbology specification
|
||||
- ISO/IEC 24724:2011 Information technology - Automatic identification and data
|
||||
capture techniques - GS1 DataBar bar code symbology specification
|
||||
- ISO/IEC 20830:2021 Information technology - Automatic identification and data
|
||||
capture techniques - Han Xin Code bar code symbology specification
|
||||
- ISO/IEC 16390:2007 Information technology - Automatic identification and data
|
||||
capture techniques - Interleaved 2 of 5 bar code symbology specification
|
||||
- ISO/IEC 16023:2000 Information technology - International symbology
|
||||
specification - MaxiCode
|
||||
- ISO/IEC 24728:2006 Information technology - Automatic identification and data
|
||||
capture techniques - MicroPDF417 bar code symbology specification
|
||||
- ISO/IEC 15438:2015 Information technology - Automatic identification and data
|
||||
capture techniques - PDF417 bar code symbology specification
|
||||
- ISO/IEC 18004:2024 Information technology - Automatic identification and data
|
||||
capture techniques - QR Code bar code symbology specification
|
||||
- ISO/IEC 23941:2022 Information technology - Automatic identification and data
|
||||
capture techniques - Rectangular Micro QR Code (rMQR) bar code symbology
|
||||
specification
|
||||
- AIM Europe X-25 - Uniform Symbology Specification Telepen (1991)
|
||||
- AIMD/TSC15032-43 (v 0.99c) - International Technical Specification - Ultracode
|
||||
Symbology (Draft) (Released 4th Nov 2015)
|
||||
- ISO/IEC 24778:2024 Information technology - Automatic identification and
|
||||
data capture techniques - Aztec Code bar code symbology specification
|
||||
- SEMI T1-95 Specification for Back Surface Bar Code Marking of Silicon Wafers
|
||||
(BC412) (1996)
|
||||
- ANSI/AIM BC12-1998 - Uniform Symbology Specification Channel Code
|
||||
- BS EN 798:1996 Bar coding - Symbology specifications - ‘Codabar’
|
||||
- AIM Europe ISS-X-24 - Uniform Symbology Specification Codablock F (1995)
|
||||
- ISO/IEC 15417:2007 Information technology - Automatic identification and
|
||||
data capture techniques - Code 128 bar code symbology specification
|
||||
- BS EN 12323:2005 AIDC technologies - Symbology specifications - Code 16K
|
||||
- ISO/IEC 16388:2023 Information technology - Automatic identification and
|
||||
data capture techniques - Code 39 bar code symbology specification
|
||||
- ANSI/AIM BC6-2000 - Uniform Symbology Specification Code 49
|
||||
- ANSI/AIM BC5-1995 - Uniform Symbology Specification Code 93
|
||||
- AIM Uniform Symbology Specification Code One (1994)
|
||||
- ISO/IEC 16022:2024 Information technology - Automatic identification and
|
||||
data capture techniques - Data Matrix bar code symbology specification
|
||||
- ISO/IEC 21471:2025 Information technology - Automatic identification and
|
||||
data capture techniques - Extended rectangular data matrix (DMRE) bar code
|
||||
symbology specification
|
||||
- AIM TSC1705001 (v 4.0 Draft 0.15) - Information technology - Automatic
|
||||
identification and data capture techniques - Bar code symbology
|
||||
specification - DotCode (Revised 28th May 2019)
|
||||
- ISO/IEC 15420:2025 Information technology - Automatic identification and
|
||||
data capture techniques - EAN/UPC bar code symbology specification
|
||||
- AIMD014 (v 1.63) - Information technology, Automatic identification and data
|
||||
capture techniques - Bar code symbology specification - Grid Matrix
|
||||
(Released 9th Dec 2008)
|
||||
- ISO/IEC 24723:2010 Information technology - Automatic identification and
|
||||
data capture techniques - GS1 Composite bar code symbology specification
|
||||
- ISO/IEC 24724:2011 Information technology - Automatic identification and
|
||||
data capture techniques - GS1 DataBar bar code symbology specification
|
||||
- ISO/IEC 20830:2021 Information technology - Automatic identification and
|
||||
data capture techniques - Han Xin Code bar code symbology specification
|
||||
- ISO/IEC 16390:2007 Information technology - Automatic identification and
|
||||
data capture techniques - Interleaved 2 of 5 bar code symbology
|
||||
specification
|
||||
- ISO/IEC 16023:2000 Information technology - International symbology
|
||||
specification - MaxiCode
|
||||
- ISO/IEC 24728:2006 Information technology - Automatic identification and
|
||||
data capture techniques - MicroPDF417 bar code symbology specification
|
||||
- ISO/IEC 15438:2015 Information technology - Automatic identification and
|
||||
data capture techniques - PDF417 bar code symbology specification
|
||||
- ISO/IEC 18004:2024 Information technology - Automatic identification and
|
||||
data capture techniques - QR Code bar code symbology specification
|
||||
- ISO/IEC 23941:2022 Information technology - Automatic identification and
|
||||
data capture techniques - Rectangular Micro QR Code (rMQR) bar code
|
||||
symbology specification
|
||||
- AIM Europe X-25 - Uniform Symbology Specification Telepen (1991)
|
||||
- AIMD/TSC15032-43 (v 0.99c) - International Technical Specification -
|
||||
Ultracode Symbology (Draft) (Released 4th Nov 2015)
|
||||
|
||||
A number of other specification documents have also been referenced, such as
|
||||
MIL-STD-1189 Rev. B (1989) (LOGMARS), USPS DMM 300 2006 (2011) (POSTNET, PLANET,
|
||||
@@ -5127,21 +5146,21 @@ company references in particular.
|
||||
|
||||
7.5.2 General Standards
|
||||
|
||||
- AIM ITS/04-001 International Technical Standard - Extended Channel
|
||||
Interpretations Part 1: Identification Schemes and Protocol (Released 24th May
|
||||
2004)
|
||||
- AIM ITS/04-023 International Technical Standard - Extended Channel
|
||||
Interpretations Part 3: Register (Version 2, February 2022)
|
||||
- GS1 General Specifications Release 26.0 (Jan 2026)
|
||||
- ANSI/HIBC 2.6-2016 - The Health Industry Bar Code (HIBC) Supplier Labeling
|
||||
Standard
|
||||
- ANSI/HIBC 1.3-2010 - The Health Industry Bar Code (HIBC) Provider Applications
|
||||
Standard
|
||||
- ISO/IEC 15424:2025 Information technology - Automatic identification and data
|
||||
capture techniques - Data carrier identifiers (including symbology
|
||||
identifiers)
|
||||
- ISO/IEC 15434:2019 Information technology — Automatic identification and data
|
||||
capture techniques — Syntax for high-capacity ADC media
|
||||
- AIM ITS/04-001 International Technical Standard - Extended Channel
|
||||
Interpretations Part 1: Identification Schemes and Protocol (Released 24th
|
||||
May 2004)
|
||||
- AIM ITS/04-023 International Technical Standard - Extended Channel
|
||||
Interpretations Part 3: Register (Version 2, February 2022)
|
||||
- GS1 General Specifications Release 26.0 (Jan 2026)
|
||||
- ANSI/HIBC 2.6-2016 - The Health Industry Bar Code (HIBC) Supplier Labeling
|
||||
Standard
|
||||
- ANSI/HIBC 1.3-2010 - The Health Industry Bar Code (HIBC) Provider
|
||||
Applications Standard
|
||||
- ISO/IEC 15424:2025 Information technology - Automatic identification and
|
||||
data capture techniques - Data carrier identifiers (including symbology
|
||||
identifiers)
|
||||
- ISO/IEC 15434:2019 Information technology — Automatic identification and
|
||||
data capture techniques — Syntax for high-capacity ADC media
|
||||
|
||||
Annex A. Character Encoding
|
||||
|
||||
@@ -5293,7 +5312,7 @@ configured barcode is updated when the "Generate" button is pressed.
|
||||
|
||||
Annex D. Man Page ZINT(1)
|
||||
|
||||
% ZINT(1) Version 2.16.0.9 % % May 2026
|
||||
% ZINT(1) Version 2.16.0.9 % % June 2026
|
||||
|
||||
NAME
|
||||
|
||||
|
||||
+1
-1
@@ -1,4 +1,4 @@
|
||||
.\" Automatically generated by Pandoc 3.9.0.2
|
||||
.\" Automatically generated by Pandoc 3.10
|
||||
.\"
|
||||
.TH "ZINT\-QT" "1" "March 2026" "Version 2.16.0.9"
|
||||
.SH NAME
|
||||
|
||||
+2
-2
@@ -1,6 +1,6 @@
|
||||
.\" Automatically generated by Pandoc 3.9.0.2
|
||||
.\" Automatically generated by Pandoc 3.10
|
||||
.\"
|
||||
.TH "ZINT" "1" "May 2026" "Version 2.16.0.9"
|
||||
.TH "ZINT" "1" "June 2026" "Version 2.16.0.9"
|
||||
.SH NAME
|
||||
\f[CR]zint\f[R] \- encode data as a barcode image
|
||||
.SH SYNOPSIS
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
% ZINT(1) Version 2.16.0.9
|
||||
%
|
||||
% May 2026
|
||||
% June 2026
|
||||
|
||||
[//]: # ( vim: set ts=4 sw=4 et : )
|
||||
|
||||
|
||||
Reference in New Issue
Block a user