diff --git a/docs/manual.html b/docs/manual.html index 0c4b23b2..b0fb6e4d 100644 --- a/docs/manual.html +++ b/docs/manual.html @@ -5124,12 +5124,12 @@ alt="zint -b TELEPEN --compliantheight -d "Z8000"" />
Figure 55: zint -b TELEPEN --compliantheight -d "Z8000"
-

Full ASCII + Compressed Numeric Mode, which uses different -AIM-defined Start/Stop characters, may be enabled by setting +

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:

+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 @@ -5140,40 +5140,41 @@ alt="zint -b TELEPEN --compliantheight -d "Z\L8000" -esc --vers=1" /> 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.

+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"
Figure 57: 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 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:

+alt="zint -b TELEPEN_NUM --compliantheight -d "12\LAB" --esc" />
Figure 58: -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:

+alt="zint -b TELEPEN_NUM --compliantheight -d "123\L4" --esc" />
Figure 59: -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.

+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

6.1.7.1 Standard Code 39 (ISO 16388)

@@ -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) @@ -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)

Copyright © 2026 Robin Stuart. Released under GNU GPL 3.0 or diff --git a/docs/manual.pmd b/docs/manual.pmd index 5112ee73..9090904a 100644 --- a/docs/manual.pmd +++ b/docs/manual.pmd @@ -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 diff --git a/docs/manual.txt b/docs/manual.txt index 0c732f04..51c4eefb 100644 --- a/docs/manual.txt +++ b/docs/manual.txt @@ -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 diff --git a/docs/zint.1 b/docs/zint.1 index 5f9a8a29..bb72b6bc 100644 --- a/docs/zint.1 +++ b/docs/zint.1 @@ -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. diff --git a/docs/zint.1.pmd b/docs/zint.1.pmd index dd4abf59..4c7b976c 100644 --- a/docs/zint.1.pmd +++ b/docs/zint.1.pmd @@ -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)