Mirrors/zint
1
0
Fork 0
mirror of https://git.code.sf.net/p/zint/code synced 2026-06-10 15:43:40 +00:00
Code Issues Projects Releases Wiki Activity

manual: rephrase some Telepen stuff

Browse Source 
man page: Telepen -> Telepen Alpha
This commit is contained in:
gitlost
2026-05-27 15:40:53 +01:00
parent 771a1b3cdd
commit bc080f6fa2
5 changed files with 64 additions and 59 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/manual.html
+22 -21
View File
@@ -5124,12 +5124,12 @@ alt="zint -b TELEPEN --compliantheight -d "Z8000"" />
<figcaption><span class="figure-label">Figure 55:</span>
<code>zint -b TELEPEN --compliantheight -d "Z8000"</code></figcaption>
</figure>
<p>Full ASCII + Compressed Numeric Mode, which uses different
AIM-defined Start/Stop characters, may be enabled by setting
<p>AIM-defined Start/Stop characters may be enabled by setting
<code>--vers=1</code> (API <code>option_2 = 1</code>). In this mode
control character <code>DLE</code> (ASCII 16, escape sequence
<code>\L</code>) indicates a switch from Full ASCII to Compressed
Numeric, where each symbol character encodes a digit pair:</p>
Numeric, where each symbol character encodes a digit pair (or a “digit
X” pair - see Telepen Numeric below):</p>
<figure>
<img src="images/telepen_aim.svg" class="lin"
alt="zint -b TELEPEN --compliantheight -d &quot;Z\L8000&quot; -esc --vers=1" />
@@ -5140,40 +5140,41 @@ alt="zint -b TELEPEN --compliantheight -d &quot;Z\L8000&quot; -esc --vers=1" />
using.</p>
<h4 id="telepen-numeric">6.1.6.2 Telepen Numeric</h4>
<p>Telepen Numeric allows compression of numeric data into a Telepen
symbol. Data can consist of pairs of numbers or pairs consisting of a
numerical digit followed an X character. For example: 466333 and 466X33
are valid codes whereas 46X333 is not (the digit pair <code>"X3"</code>
is not valid). Up to 138 digits can be encoded. Telepen Numeric includes
a hidden modulo-127 check digit which is added by Zint.</p>
symbol. Data consists of pairs of digits or pairs of “digit X” - a digit
followed an X character. For example: <code>"466333"</code> and
<code>"466X33"</code> are valid codes whereas <code>"46X333"</code> is
not (the pair <code>"X3"</code> is not valid). If an odd number of
digits is supplied, Zint will add a leading zero. Up to 138 digits can
be encoded. A hidden modulo-127 check digit is added by Zint.</p>
<figure>
<img src="images/telepen_num.svg" class="lin"
alt="zint -b TELEPEN_NUM --compliantheight -d &quot;466X33&quot;" />
<figcaption><span class="figure-label">Figure 57:</span>
<code>zint -b TELEPEN_NUM --compliantheight -d "466X33"</code></figcaption>
</figure>
<p>Trailing ASCII characters may also be encoded by prefixing them with
a <code>DLE</code> control character (ASCII 16, escape sequence
<code>\L</code>) and appending them to the numeric data:</p>
<p>Additionally trailing ASCII characters may be encoded by prefixing
them with a <code>DLE</code> control character (ASCII 16, escape
sequence <code>\L</code>) and appending them to the numeric data:</p>
<figure>
<img src="images/telepen_num_asc.svg" class="lin"
alt="zint -b TELEPEN_NUM --compliantheight -d &quot;12\LAB&quot; –esc" />
alt="zint -b TELEPEN_NUM --compliantheight -d &quot;12\LAB&quot; --esc" />
<figcaption><span class="figure-label">Figure 58:</span>
<code>zint -b TELEPEN_NUM --compliantheight -d "12\LAB"</code>
–esc</figcaption>
<code>zint -b TELEPEN_NUM --compliantheight -d "12\LAB" --esc</code></figcaption>
</figure>
<p>This method allows odd numbers to be encoded without a leading
zero:</p>
<figure>
<img src="images/telepen_num_odd.svg" class="lin"
alt="zint -b TELEPEN_NUM --compliantheight -d &quot;123\L4&quot; –esc" />
alt="zint -b TELEPEN_NUM --compliantheight -d &quot;123\L4&quot; --esc" />
<figcaption><span class="figure-label">Figure 59:</span>
<code>zint -b TELEPEN_NUM --compliantheight -d "123\L4"</code>
–esc</figcaption>
<code>zint -b TELEPEN_NUM --compliantheight -d "123\L4" --esc</code></figcaption>
</figure>
<p>AIM-defined Start/Stop characters may be enabled by setting
<code>--vers=1</code> (API <code>option_2 = 1</code>). This allows
barcode readers that recognise them to detect Compressed Numeric data
automatically.</p>
barcode readers to detect Compressed Numeric data automatically, but
check that your reader recognises them before using. Note that trailing
ASCII can be used without enabling this mode, unlike in the Telepen
Alpha case for trailing Compressed Numerics.</p>
<h3 id="code-39">6.1.7 Code 39</h3>
<h4 id="standard-code-39-iso-16388">6.1.7.1 Standard Code 39 (ISO
16388)</h4>
@@ -9942,7 +9943,7 @@ MSI Plessey 0 to 6 (none to various visible options)
DAFT 50 to 900 (permille tracker ratio)
DPD 1 (relabel)
PZN 1 (PZN7 instead of default PZN8)
Telepen 1 (use AIM-defined Start/Stop)
Telepen Alpha 1 (use AIM-defined Start/Stop)
Telepen Numeric 1 (use AIM-defined Start/Stop)
Ultracode 2 (revision 2)
VIN 1 (add international prefix)</code></pre>
@@ -10085,7 +10086,7 @@ ISO/IEC 24723:2010 (GS1 Composite), ISO/IEC 24724:2011 (GS1 DataBar),
ISO/IEC 20830:2021 (Han Xin Code), ISO/IEC 16390:2007 (Interleaved 2 of
5), ISO/IEC 16023:2000 (MaxiCode), ISO/IEC 24728:2006 (MicroPDF417),
ISO/IEC 15438:2015 (PDF417), ISO/IEC 18004:2024 (QR Code), ISO/IEC
23941:2022 (rMQR), AIM Europe X-25 (1991) (Telepen), AIMD/TSC15032-43
23941:2022 (rMQR), AIM Europe X-25 USS Telepen (1991), AIMD/TSC15032-43
(2015) (Ultracode)</p>
<h2 id="copyright">COPYRIGHT</h2>
<p>Copyright © 2026 Robin Stuart. Released under GNU GPL 3.0 or
docs/manual.pmd
+18 -16
View File
@@ -3333,11 +3333,11 @@ hidden modulo-127 check digit, added by Zint.
![`zint -b TELEPEN --compliantheight -d "Z8000"`](images/telepen.svg){.lin}
Full ASCII + Compressed Numeric Mode, which uses different AIM-defined
Start/Stop characters, may be enabled by setting `--vers=1` (API
AIM-defined Start/Stop characters may be enabled by setting `--vers=1` (API
`option_2 = 1`). In this mode control character `DLE` (ASCII 16, escape sequence
`\L`) indicates a switch from Full ASCII to Compressed Numeric, where each
symbol character encodes a digit pair:
symbol character encodes a digit pair (or a "digit X" pair - see Telepen Numeric
below):
![`zint -b TELEPEN --compliantheight -d
"Z\L8000" -esc --vers=1`](images/telepen_aim.svg){.lin}
@@ -3346,31 +3346,33 @@ However not all barcode readers recognise this mode so check before using.
#### 6.1.6.2 Telepen Numeric
Telepen Numeric allows compression of numeric data into a Telepen symbol. Data
can consist of pairs of numbers or pairs consisting of a numerical digit
followed an X character. For example: 466333 and 466X33 are valid codes whereas
46X333 is not (the digit pair `"X3"` is not valid). Up to 138 digits can be
encoded. Telepen Numeric includes a hidden modulo-127 check digit which is added
by Zint.
Telepen Numeric allows compression of numeric data into a Telepen symbol.
Data consists of pairs of digits or pairs of "digit X" - a digit followed an X
character. For example: `"466333"` and `"466X33"` are valid codes whereas
`"46X333"` is not (the pair `"X3"` is not valid). If an odd number of digits is
supplied, Zint will add a leading zero. Up to 138 digits can be encoded. A
hidden modulo-127 check digit is added by Zint.
![`zint -b TELEPEN_NUM --compliantheight -d
"466X33"`](images/telepen_num.svg){.lin}
Trailing ASCII characters may also be encoded by prefixing them with a `DLE`
control character (ASCII 16, escape sequence `\L`) and appending them to the
numeric data:
Additionally trailing ASCII characters may be encoded by prefixing them with a
`DLE` control character (ASCII 16, escape sequence `\L`) and appending them to
the numeric data:
![`zint -b TELEPEN_NUM --compliantheight -d
"12\LAB"` --esc](images/telepen_num_asc.svg){.lin}
"12\LAB" --esc`](images/telepen_num_asc.svg){.lin}
This method allows odd numbers to be encoded without a leading zero:
![`zint -b TELEPEN_NUM --compliantheight -d
"123\L4"` --esc](images/telepen_num_odd.svg){.lin}
"123\L4" --esc`](images/telepen_num_odd.svg){.lin}
AIM-defined Start/Stop characters may be enabled by setting `--vers=1` (API
`option_2 = 1`). This allows barcode readers that recognise them to detect
Compressed Numeric data automatically.
`option_2 = 1`). This allows barcode readers to detect Compressed Numeric data
automatically, but check that your reader recognises them before using. Note
that trailing ASCII can be used without enabling this mode, unlike in the
Telepen Alpha case for trailing Compressed Numerics.
### 6.1.7 Code 39
docs/manual.txt
+20 -18
View File
@@ -3198,11 +3198,11 @@ hidden modulo-127 check digit, added by Zint.
[zint -b TELEPEN --compliantheight -d "Z8000"]
Full ASCII + Compressed Numeric Mode, which uses different AIM-defined
Start/Stop characters, may be enabled by setting --vers=1 (API option_2 = 1). In
this mode control character DLE (ASCII 16, escape sequence \L) indicates a
switch from Full ASCII to Compressed Numeric, where each symbol character
encodes a digit pair:
AIM-defined Start/Stop characters may be enabled by setting --vers=1 (API
option_2 = 1). In this mode control character DLE (ASCII 16, escape sequence \L)
indicates a switch from Full ASCII to Compressed Numeric, where each symbol
character encodes a digit pair (or a “digit X” pair - see Telepen Numeric
below):
[zint -b TELEPEN --compliantheight -d "Z\L8000" -esc --vers=1]
@@ -3211,27 +3211,29 @@ However not all barcode readers recognise this mode so check before using.
6.1.6.2 Telepen Numeric
Telepen Numeric allows compression of numeric data into a Telepen symbol. Data
can consist of pairs of numbers or pairs consisting of a numerical digit
followed an X character. For example: 466333 and 466X33 are valid codes whereas
46X333 is not (the digit pair "X3" is not valid). Up to 138 digits can be
encoded. Telepen Numeric includes a hidden modulo-127 check digit which is added
by Zint.
consists of pairs of digits or pairs of “digit X” - a digit followed an X
character. For example: "466333" and "466X33" are valid codes whereas "46X333"
is not (the pair "X3" is not valid). If an odd number of digits is supplied,
Zint will add a leading zero. Up to 138 digits can be encoded. A hidden
modulo-127 check digit is added by Zint.
[zint -b TELEPEN_NUM --compliantheight -d "466X33"]
Trailing ASCII characters may also be encoded by prefixing them with a DLE
control character (ASCII 16, escape sequence \L) and appending them to the
Additionally trailing ASCII characters may be encoded by prefixing them with a
DLE control character (ASCII 16, escape sequence \L) and appending them to the
numeric data:
[zint -b TELEPEN_NUM --compliantheight -d "12\LAB" –esc]
[zint -b TELEPEN_NUM --compliantheight -d "12\LAB" --esc]
This method allows odd numbers to be encoded without a leading zero:
[zint -b TELEPEN_NUM --compliantheight -d "123\L4" –esc]
[zint -b TELEPEN_NUM --compliantheight -d "123\L4" --esc]
AIM-defined Start/Stop characters may be enabled by setting --vers=1 (API
option_2 = 1). This allows barcode readers that recognise them to detect
Compressed Numeric data automatically.
option_2 = 1). This allows barcode readers to detect Compressed Numeric data
automatically, but check that your reader recognises them before using. Note
that trailing ASCII can be used without enabling this mode, unlike in the
Telepen Alpha case for trailing Compressed Numerics.
6.1.7 Code 39
@@ -5919,7 +5921,7 @@ OPTIONS
DAFT 50 to 900 (permille tracker ratio)
DPD 1 (relabel)
PZN 1 (PZN7 instead of default PZN8)
Telepen 1 (use AIM-defined Start/Stop)
Telepen Alpha 1 (use AIM-defined Start/Stop)
Telepen Numeric 1 (use AIM-defined Start/Stop)
Ultracode 2 (revision 2)
VIN 1 (add international prefix)
@@ -6042,7 +6044,7 @@ AIM TSC1705001 (2019) (DotCode), ISO/IEC 15420:2025 (EAN/UPC), AIMD014 (v 1.63)
(GS1 DataBar), ISO/IEC 20830:2021 (Han Xin Code), ISO/IEC 16390:2007
(Interleaved 2 of 5), ISO/IEC 16023:2000 (MaxiCode), ISO/IEC 24728:2006
(MicroPDF417), ISO/IEC 15438:2015 (PDF417), ISO/IEC 18004:2024 (QR Code),
ISO/IEC 23941:2022 (rMQR), AIM Europe X-25 (1991) (Telepen), AIMD/TSC15032-43
ISO/IEC 23941:2022 (rMQR), AIM Europe X-25 USS Telepen (1991), AIMD/TSC15032-43
(2015) (Ultracode)
COPYRIGHT
docs/zint.1
+3 -3
View File
@@ -670,7 +670,7 @@ Channel Code 3 to 8 (no. of channels)
DAFT 50 to 900 (permille tracker ratio)
DPD 1 (relabel)
PZN 1 (PZN7 instead of default PZN8)
Telepen 1 (use AIM\-defined Start/Stop)
Telepen Alpha 1 (use AIM\-defined Start/Stop)
Telepen Numeric 1 (use AIM\-defined Start/Stop)
Ultracode 2 (revision 2)
VIN 1 (add international prefix)
@@ -804,8 +804,8 @@ ISO/IEC 24723:2010 (GS1 Composite), ISO/IEC 24724:2011 (GS1 DataBar),
ISO/IEC 20830:2021 (Han Xin Code), ISO/IEC 16390:2007 (Interleaved 2 of
5), ISO/IEC 16023:2000 (MaxiCode), ISO/IEC 24728:2006 (MicroPDF417),
ISO/IEC 15438:2015 (PDF417), ISO/IEC 18004:2024 (QR Code), ISO/IEC
23941:2022 (rMQR), AIM Europe X\-25 (1991) (Telepen), AIMD/TSC15032\-43
(2015) (Ultracode)
23941:2022 (rMQR), AIM Europe X\-25 USS Telepen (1991),
AIMD/TSC15032\-43 (2015) (Ultracode)
.SH COPYRIGHT
Copyright © 2026 Robin Stuart.
Released under GNU GPL 3.0 or later.
docs/zint.1.pmd
+1 -1
View File
@@ -579,7 +579,7 @@ Paintbrush (`PCX`), Portable Network Format (`PNG`), Scalable Vector Graphic (`S
DAFT 50 to 900 (permille tracker ratio)
DPD 1 (relabel)
PZN 1 (PZN7 instead of default PZN8)
Telepen 1 (use AIM-defined Start/Stop)
Telepen Alpha 1 (use AIM-defined Start/Stop)
Telepen Numeric 1 (use AIM-defined Start/Stop)
Ultracode 2 (revision 2)
VIN 1 (add international prefix)