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> <figcaption><span class="figure-label">Figure 55:</span>
<code>zint -b TELEPEN --compliantheight -d "Z8000"</code></figcaption> <code>zint -b TELEPEN --compliantheight -d "Z8000"</code></figcaption>
</figure> </figure>
<p>Full ASCII + Compressed Numeric Mode, which uses different <p>AIM-defined Start/Stop characters may be enabled by setting
AIM-defined Start/Stop characters, may be enabled by setting
<code>--vers=1</code> (API <code>option_2 = 1</code>). In this mode <code>--vers=1</code> (API <code>option_2 = 1</code>). In this mode
control character <code>DLE</code> (ASCII 16, escape sequence control character <code>DLE</code> (ASCII 16, escape sequence
<code>\L</code>) indicates a switch from Full ASCII to Compressed <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> <figure>
<img src="images/telepen_aim.svg" class="lin" <img src="images/telepen_aim.svg" class="lin"
alt="zint -b TELEPEN --compliantheight -d &quot;Z\L8000&quot; -esc --vers=1" /> 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> using.</p>
<h4 id="telepen-numeric">6.1.6.2 Telepen Numeric</h4> <h4 id="telepen-numeric">6.1.6.2 Telepen Numeric</h4>
<p>Telepen Numeric allows compression of numeric data into a Telepen <p>Telepen Numeric allows compression of numeric data into a Telepen
symbol. Data can consist of pairs of numbers or pairs consisting of a symbol. Data consists of pairs of digits or pairs of “digit X” - a digit
numerical digit followed an X character. For example: 466333 and 466X33 followed an X character. For example: <code>"466333"</code> and
are valid codes whereas 46X333 is not (the digit pair <code>"X3"</code> <code>"466X33"</code> are valid codes whereas <code>"46X333"</code> is
is not valid). Up to 138 digits can be encoded. Telepen Numeric includes not (the pair <code>"X3"</code> is not valid). If an odd number of
a hidden modulo-127 check digit which is added by Zint.</p> 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> <figure>
<img src="images/telepen_num.svg" class="lin" <img src="images/telepen_num.svg" class="lin"
alt="zint -b TELEPEN_NUM --compliantheight -d &quot;466X33&quot;" /> alt="zint -b TELEPEN_NUM --compliantheight -d &quot;466X33&quot;" />
<figcaption><span class="figure-label">Figure 57:</span> <figcaption><span class="figure-label">Figure 57:</span>
<code>zint -b TELEPEN_NUM --compliantheight -d "466X33"</code></figcaption> <code>zint -b TELEPEN_NUM --compliantheight -d "466X33"</code></figcaption>
</figure> </figure>
<p>Trailing ASCII characters may also be encoded by prefixing them with <p>Additionally trailing ASCII characters may be encoded by prefixing
a <code>DLE</code> control character (ASCII 16, escape sequence them with a <code>DLE</code> control character (ASCII 16, escape
<code>\L</code>) and appending them to the numeric data:</p> sequence <code>\L</code>) and appending them to the numeric data:</p>
<figure> <figure>
<img src="images/telepen_num_asc.svg" class="lin" <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> <figcaption><span class="figure-label">Figure 58:</span>
<code>zint -b TELEPEN_NUM --compliantheight -d "12\LAB"</code> <code>zint -b TELEPEN_NUM --compliantheight -d "12\LAB" --esc</code></figcaption>
–esc</figcaption>
</figure> </figure>
<p>This method allows odd numbers to be encoded without a leading <p>This method allows odd numbers to be encoded without a leading
zero:</p> zero:</p>
<figure> <figure>
<img src="images/telepen_num_odd.svg" class="lin" <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> <figcaption><span class="figure-label">Figure 59:</span>
<code>zint -b TELEPEN_NUM --compliantheight -d "123\L4"</code> <code>zint -b TELEPEN_NUM --compliantheight -d "123\L4" --esc</code></figcaption>
–esc</figcaption>
</figure> </figure>
<p>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>). This allows <code>--vers=1</code> (API <code>option_2 = 1</code>). This allows
barcode readers that recognise them to detect Compressed Numeric data barcode readers to detect Compressed Numeric data automatically, but
automatically.</p> 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> <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 <h4 id="standard-code-39-iso-16388">6.1.7.1 Standard Code 39 (ISO
16388)</h4> 16388)</h4>
@@ -9942,7 +9943,7 @@ MSI Plessey 0 to 6 (none to various visible options)
DAFT 50 to 900 (permille tracker ratio) DAFT 50 to 900 (permille tracker ratio)
DPD 1 (relabel) DPD 1 (relabel)
PZN 1 (PZN7 instead of default PZN8) 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) Telepen Numeric 1 (use AIM-defined Start/Stop)
Ultracode 2 (revision 2) Ultracode 2 (revision 2)
VIN 1 (add international prefix)</code></pre> 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 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), 5), ISO/IEC 16023:2000 (MaxiCode), ISO/IEC 24728:2006 (MicroPDF417),
ISO/IEC 15438:2015 (PDF417), ISO/IEC 18004:2024 (QR Code), ISO/IEC 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> (2015) (Ultracode)</p>
<h2 id="copyright">COPYRIGHT</h2> <h2 id="copyright">COPYRIGHT</h2>
<p>Copyright © 2026 Robin Stuart. Released under GNU GPL 3.0 or <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} ![`zint -b TELEPEN --compliantheight -d "Z8000"`](images/telepen.svg){.lin}
Full ASCII + Compressed Numeric Mode, which uses different AIM-defined AIM-defined Start/Stop characters may be enabled by setting `--vers=1` (API
Start/Stop characters, may be enabled by setting `--vers=1` (API
`option_2 = 1`). In this mode control character `DLE` (ASCII 16, escape sequence `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 `\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 ![`zint -b TELEPEN --compliantheight -d
"Z\L8000" -esc --vers=1`](images/telepen_aim.svg){.lin} "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 #### 6.1.6.2 Telepen Numeric
Telepen Numeric allows compression of numeric data into a Telepen symbol. Data Telepen Numeric allows compression of numeric data into a Telepen symbol.
can consist of pairs of numbers or pairs consisting of a numerical digit Data consists of pairs of digits or pairs of "digit X" - a digit followed an X
followed an X character. For example: 466333 and 466X33 are valid codes whereas 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 `"46X333"` is not (the pair `"X3"` is not valid). If an odd number of digits is
encoded. Telepen Numeric includes a hidden modulo-127 check digit which is added supplied, Zint will add a leading zero. Up to 138 digits can be encoded. A
by Zint. hidden modulo-127 check digit is added by Zint.
![`zint -b TELEPEN_NUM --compliantheight -d ![`zint -b TELEPEN_NUM --compliantheight -d
"466X33"`](images/telepen_num.svg){.lin} "466X33"`](images/telepen_num.svg){.lin}
Trailing ASCII characters may also be encoded by prefixing them with a `DLE` Additionally trailing ASCII characters may be encoded by prefixing them with a
control character (ASCII 16, escape sequence `\L`) and appending them to the `DLE` control character (ASCII 16, escape sequence `\L`) and appending them to
numeric data: the numeric data:
![`zint -b TELEPEN_NUM --compliantheight -d ![`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: This method allows odd numbers to be encoded without a leading zero:
![`zint -b TELEPEN_NUM --compliantheight -d ![`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 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 `option_2 = 1`). This allows barcode readers to detect Compressed Numeric data
Compressed Numeric data automatically. 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 ### 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"] [zint -b TELEPEN --compliantheight -d "Z8000"]
Full ASCII + Compressed Numeric Mode, which uses different AIM-defined AIM-defined Start/Stop characters may be enabled by setting --vers=1 (API
Start/Stop characters, may be enabled by setting --vers=1 (API option_2 = 1). In option_2 = 1). In this mode control character DLE (ASCII 16, escape sequence \L)
this mode control character DLE (ASCII 16, escape sequence \L) indicates a indicates a switch from Full ASCII to Compressed Numeric, where each symbol
switch from Full ASCII to Compressed Numeric, where each symbol character character encodes a digit pair (or a “digit X” pair - see Telepen Numeric
encodes a digit pair: below):
[zint -b TELEPEN --compliantheight -d "Z\L8000" -esc --vers=1] [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 6.1.6.2 Telepen Numeric
Telepen Numeric allows compression of numeric data into a Telepen symbol. Data 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 consists of pairs of digits or pairs of “digit X” - a digit followed an X
followed an X character. For example: 466333 and 466X33 are valid codes whereas character. For example: "466333" and "466X33" are valid codes whereas "46X333"
46X333 is not (the digit pair "X3" is not valid). Up to 138 digits can be is not (the pair "X3" is not valid). If an odd number of digits is supplied,
encoded. Telepen Numeric includes a hidden modulo-127 check digit which is added Zint will add a leading zero. Up to 138 digits can be encoded. A hidden
by Zint. modulo-127 check digit is added by Zint.
[zint -b TELEPEN_NUM --compliantheight -d "466X33"] [zint -b TELEPEN_NUM --compliantheight -d "466X33"]
Trailing ASCII characters may also be encoded by prefixing them with a DLE Additionally trailing ASCII characters may be encoded by prefixing them with a
control character (ASCII 16, escape sequence \L) and appending them to the DLE control character (ASCII 16, escape sequence \L) and appending them to the
numeric data: 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: 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 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 option_2 = 1). This allows barcode readers to detect Compressed Numeric data
Compressed Numeric data automatically. 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 6.1.7 Code 39
@@ -5919,7 +5921,7 @@ OPTIONS
DAFT 50 to 900 (permille tracker ratio) DAFT 50 to 900 (permille tracker ratio)
DPD 1 (relabel) DPD 1 (relabel)
PZN 1 (PZN7 instead of default PZN8) 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) Telepen Numeric 1 (use AIM-defined Start/Stop)
Ultracode 2 (revision 2) Ultracode 2 (revision 2)
VIN 1 (add international prefix) 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 (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 (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), (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) (2015) (Ultracode)
COPYRIGHT 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) DAFT 50 to 900 (permille tracker ratio)
DPD 1 (relabel) DPD 1 (relabel)
PZN 1 (PZN7 instead of default PZN8) 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) Telepen Numeric 1 (use AIM\-defined Start/Stop)
Ultracode 2 (revision 2) Ultracode 2 (revision 2)
VIN 1 (add international prefix) 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 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), 5), ISO/IEC 16023:2000 (MaxiCode), ISO/IEC 24728:2006 (MicroPDF417),
ISO/IEC 15438:2015 (PDF417), ISO/IEC 18004:2024 (QR Code), ISO/IEC 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),
(2015) (Ultracode) AIMD/TSC15032\-43 (2015) (Ultracode)
.SH COPYRIGHT .SH COPYRIGHT
Copyright © 2026 Robin Stuart. Copyright © 2026 Robin Stuart.
Released under GNU GPL 3.0 or later. 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) DAFT 50 to 900 (permille tracker ratio)
DPD 1 (relabel) DPD 1 (relabel)
PZN 1 (PZN7 instead of default PZN8) 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) Telepen Numeric 1 (use AIM-defined Start/Stop)
Ultracode 2 (revision 2) Ultracode 2 (revision 2)
VIN 1 (add international prefix) VIN 1 (add international prefix)