mirror of
https://git.code.sf.net/p/zint/code
synced 2025-05-22 03:05:11 -04:00
- library: check symbol->primary for escape sequences also
- GUI: error message GS1_MODE -> GS1 mode - GUI: sequence window: fix initial clear button status - GUI: make acceptable for macOS; add iconset for macOS, install - manual: update macOS Homebrew install info; add README.macos - GUI: export window: add no. of sequences to results label
This commit is contained in:
gitlost
parent
a232dec4ff
commit
15b8024712
27 changed files with 530 additions and 290 deletions
|
|
@ -185,20 +185,24 @@ To build Zint on Windows from source, see `"win32/README"`.
|
|||
|
||||
## 2.3 Apple macOS
|
||||
|
||||
Zint can be installed using Homebrew. To install Homebrew input the following
|
||||
line into the macOS terminal
|
||||
The latest Zint CLI and `libzint` can be installed using Homebrew.[^1] To
|
||||
install Homebrew input the following line into the macOS terminal
|
||||
|
||||
```bash
|
||||
/usr/bin/ruby -e "$(curl -fsSL
|
||||
https://raw.githubusercontent.com/Homebrew/install/master/install)"
|
||||
/bin/bash -c "$(curl -fsSL \
|
||||
https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
||||
```
|
||||
|
||||
Once Homebrew is installed use the following command to install Zint.
|
||||
Once Homebrew is installed use the following command to install the Zint.
|
||||
|
||||
```bash
|
||||
brew install zint
|
||||
```
|
||||
|
||||
To build from source see `"README.macos"` in the project root directory.
|
||||
|
||||
[^1]: See the Homebrew website [https://brew.sh](https://brew.sh).
|
||||
|
||||
## 2.4 Zint Tcl Backend
|
||||
|
||||
The Tcl backend in the `"backend_tcl"` sub-directory may be built using the
|
||||
|
|
@ -463,7 +467,7 @@ Sequence Equivalent
|
|||
|
||||
`\xNN` 0xNN Any 8-bit character where NN is hexadecimal
|
||||
|
||||
`\uNNNN` Any 16-bit Unicode BMP[^1] character where
|
||||
`\uNNNN` Any 16-bit Unicode BMP[^2] character where
|
||||
NNNN is hexadecimal
|
||||
|
||||
`\UNNNNNN` Any 20-bit Unicode character where NNNNNN
|
||||
|
|
@ -472,7 +476,7 @@ Sequence Equivalent
|
|||
|
||||
Table: {#tbl:escape_sequences tag=": Escape Sequences"}
|
||||
|
||||
[^1]: In Unicode contexts, BMP stands for Basic Multilingual Plane, the plane 0
|
||||
[^2]: In Unicode contexts, BMP stands for Basic Multilingual Plane, the plane 0
|
||||
codeset from U+0000 to U+D7FF and U+E000 to U+FFFF (i.e. excluding surrogates).
|
||||
Not to be confused with the Windows Bitmap file format BMP!
|
||||
|
||||
|
|
@ -526,7 +530,7 @@ Names are treated case-insensitively by the CLI, and the `BARCODE_` prefix and
|
|||
any underscores are optional.
|
||||
|
||||
--------------------------------------------------------------------------------
|
||||
Numeric Name[^2] Barcode Name
|
||||
Numeric Name[^3] Barcode Name
|
||||
Value
|
||||
------- ------------------------ ---------------------------------------------
|
||||
1 `BARCODE_CODE11` Code 11
|
||||
|
|
@ -730,7 +734,7 @@ Value
|
|||
|
||||
Table: {#tbl:barcode_types tag=": Barcode Types (Symbologies)"}
|
||||
|
||||
[^2]: The symbologies marked with an asterisk (`*`) in Table
|
||||
[^3]: The symbologies marked with an asterisk (`*`) in Table
|
||||
{@tbl:barcode_types} above used different names in Zint before version 2.9.0.
|
||||
For example, symbology 29 used the name `BARCODE_RSS14`. These names are now
|
||||
deprecated but are still recognised by Zint and will continue to be supported in
|
||||
|
|
@ -1022,7 +1026,7 @@ Grid Matrix GB 2312 (includes ASCII) N/A
|
|||
Han Xin Latin-1 GB 18030 (includes ASCII)
|
||||
MaxiCode Latin-1 None
|
||||
MicroPDF417 Latin-1 None
|
||||
Micro QR Code Latin-1 Shift JIS (includes ASCII[^3])
|
||||
Micro QR Code Latin-1 Shift JIS (includes ASCII[^4])
|
||||
PDF417 Latin-1 None
|
||||
QR Code Latin-1 Shift JIS (see above)
|
||||
rMQR Latin-1 Shift JIS (see above)
|
||||
|
|
@ -1032,7 +1036,7 @@ All others ASCII N/A
|
|||
|
||||
Table: {#tbl:default_character_sets tag=": Default Character Sets"}
|
||||
|
||||
[^3]: Shift JIS (JIS X 0201 Roman) re-maps two ASCII characters: backslash (`\`)
|
||||
[^4]: Shift JIS (JIS X 0201 Roman) re-maps two ASCII characters: backslash (`\`)
|
||||
to the yen sign (¥), and tilde (`~`) to overline (U+203E).
|
||||
|
||||
If Zint encounters characters which can not be encoded using the default
|
||||
|
|
@ -1126,12 +1130,12 @@ ECI Code Character Encoding Scheme (ISO/IEC 8859 schemes include ASCII)
|
|||
33 UTF-16LE (Low order byte first)
|
||||
34 UTF-32BE (High order bytes first)
|
||||
35 UTF-32LE (Low order bytes first)
|
||||
170 ISO/IEC 646 Invariant[^4]
|
||||
170 ISO/IEC 646 Invariant[^5]
|
||||
899 8-bit binary data
|
||||
|
||||
Table: {#tbl:eci_codes tag=": ECI Codes"}
|
||||
|
||||
[^4]: ISO/IEC 646 Invariant is a subset of ASCII with 12 characters undefined:
|
||||
[^5]: ISO/IEC 646 Invariant is a subset of ASCII with 12 characters undefined:
|
||||
`#`, `$`, `@`, `[`, `\`, `]`, `^`, `` ` ``, `{`, `|`, `}`, `~`.
|
||||
|
||||
An ECI value of 0 does not encode any ECI information in the code symbol (unless
|
||||
|
|
@ -1657,7 +1661,7 @@ Variable Name Type Meaning Default Value
|
|||
|
||||
`height` float Symbol height, excluding Symbol dependent
|
||||
fixed width-to-height
|
||||
symbols.[^5]
|
||||
symbols.[^6]
|
||||
|
||||
`scale` float Scale factor for adjusting 1.0
|
||||
size of image.
|
||||
|
|
@ -1783,7 +1787,7 @@ Variable Name Type Meaning Default Value
|
|||
|
||||
Table: API Structure `zint_symbol` {#tbl:api_structure_zint_symbol tag="$ $"}
|
||||
|
||||
[^5]: The `height` value is ignored for Aztec (including HIBC and Aztec Rune),
|
||||
[^6]: The `height` value is ignored for Aztec (including HIBC and Aztec Rune),
|
||||
Code One, Data Matrix (including HIBC), DotCode, Grid Matrix, Han Xin, MaxiCode,
|
||||
QR Code (including HIBC, Micro QR, rMQR and UPNQR), and Ultracode - all of which
|
||||
have a fixed width-to-height ratio (or, in the case of Code One, a fixed
|
||||
|
|
@ -1948,7 +1952,7 @@ Value Effect
|
|||
0 No options selected.
|
||||
|
||||
`BARCODE_BIND` Boundary bars above and below the symbol and between
|
||||
rows if stacking multiple symbols.[^6]
|
||||
rows if stacking multiple symbols.[^7]
|
||||
|
||||
`BARCODE_BOX` Add a box surrounding the symbol and whitespace.
|
||||
|
||||
|
|
@ -1973,7 +1977,7 @@ Value Effect
|
|||
separate colour channels (`OUT_BUFFER` only).
|
||||
|
||||
`BARCODE_QUIET_ZONES` Add compliant quiet zones (additional to any
|
||||
specified whitespace).[^7]
|
||||
specified whitespace).[^8]
|
||||
|
||||
`BARCODE_NO_QUIET_ZONES` Disable quiet zones, notably those with defaults.
|
||||
|
||||
|
|
@ -1983,10 +1987,10 @@ Value Effect
|
|||
|
||||
Table: API `output_options` Values {#tbl:api_output_options tag="$ $"}
|
||||
|
||||
[^6]: The `BARCODE_BIND` flag is always set for Codablock-F, Code 16K and Code
|
||||
[^7]: The `BARCODE_BIND` flag is always set for Codablock-F, Code 16K and Code
|
||||
49. Special considerations apply to ITF-14 - see [6.1.2.6 ITF-14].
|
||||
|
||||
[^7]: Codablock-F, Code 16K, Code 49, EAN-2 to EAN-13, ISBN, ITF-14, UPC-A and
|
||||
[^8]: Codablock-F, Code 16K, Code 49, EAN-2 to EAN-13, ISBN, ITF-14, UPC-A and
|
||||
UPC-E have compliant quiet zones added by default.
|
||||
|
||||
\clearpage
|
||||
|
|
@ -4124,8 +4128,8 @@ company references in particular.
|
|||
|
||||
This section is intended as a quick reference to the character sets used by
|
||||
Zint. All symbologies use standard ASCII input as shown in section A.1, but
|
||||
some support extended characters as shown in the subsequent [A.2 Latin Alphabet
|
||||
No. 1 (ISO/IEC 8859-1)].
|
||||
some support extended characters as shown in the subsequent section [A.2 Latin
|
||||
Alphabet No. 1 (ISO/IEC 8859-1)].
|
||||
|
||||
## A.1 ASCII Standard
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue