mirror of
https://github.com/zint/zint
synced 2024-11-16 20:57:25 +13:00
vector: reduce SMALL_TEXT font height 6 -> 5 to be more like raster;
reduce antialiasing allowance for `textoffset`; adjust text to baseline using values for Arimo rather than percentage GUI: fix not enabling font combo "Small Bold (vector only)" by default raster/vector: rename `text_height` -> `font_height`
This commit is contained in:
gitlost
@ -408,10 +408,10 @@ Below is a brief guide to Zint Barcode Studio.
|
||||
[Zint Barcode Studio on startup - main window with Data tab]
|
||||
|
||||
This is the main window of Zint Barcode Studio. The top of the window shows a
|
||||
preview of the barcode which the current settings would create. These settings
|
||||
preview of the barcode that the current settings would create. These settings
|
||||
can be changed using the controls below. The text box in the "Data to Encode"
|
||||
groupbox on this first Data tab allows you to enter the data to be encoded. When
|
||||
you are happy with your settings you can use the "Save As" button to save the
|
||||
you are happy with your settings you can use the "Save..." button to save the
|
||||
resulting image to a file.
|
||||
|
||||
The "Symbology" drop-down box gives access to all of the symbologies supported
|
||||
@ -433,9 +433,9 @@ reset all settings for the barcode to defaults.
|
||||
|
||||
The "BMP" and "SVG" buttons at the bottom will copy the image to the clipboard
|
||||
in BMP format and SVG format respectively. Further copy-to-clipboard formats are
|
||||
available by clicking the "Menu" button, along with "CLI Equivalent", "Save As",
|
||||
"Factory Reset", "Help", "About" and "Quit" options. Most of the options are
|
||||
also available in a context menu by right-clicking the preview.
|
||||
available by clicking the "Menu" button, along with "CLI Equivalent...",
|
||||
"Save As...", "Factory Reset...", "Help", "About..." and "Quit" options. Most of
|
||||
the options are also available in a context menu by right-clicking the preview.
|
||||
|
||||
[Zint Barcode Studio main menu (left) and context menu (right)]
|
||||
|
||||
@ -1379,16 +1379,22 @@ by default and do not support ECI. In this case supply UTF-8 data and use the
|
||||
|
||||
Data can be batch processed by reading from a text file and producing a separate
|
||||
barcode image for each line of text in that file. To do this use the --batch
|
||||
switch. To select the input file from which to read data use the -i option. Zint
|
||||
will automatically detect the end of a line of text (in either Unix or Windows
|
||||
formatted text files) and produce a symbol each time it finds this. Input files
|
||||
should end with a line feed character - if this is not present then Zint will
|
||||
not encode the last line of text, and will warn you that there is a problem.
|
||||
switch together with -i to select the input file from which to read data. For
|
||||
example
|
||||
|
||||
zint -b EANX --batch -i ean13nos.txt
|
||||
|
||||
where "ean13nos.txt" contains a list of EAN-13 numbers (GTINs), each on its own
|
||||
line. Zint will automatically detect the end of a line of text (in either Unix
|
||||
or Windows formatted text files) and produce a symbol each time it finds this.
|
||||
|
||||
Input files should end with a line feed character - if this is not present then
|
||||
Zint will not encode the last line of text, and will warn you that there is a
|
||||
problem.
|
||||
|
||||
By default Zint will output numbered filenames starting with 00001.png,
|
||||
00002.png etc. To change this behaviour use the -o option in combination with
|
||||
--batch using special characters in the output filename as shown in the table
|
||||
below:
|
||||
00002.png etc. To change this behaviour specify the -o option using special
|
||||
characters in the output filename as shown in the table below:
|
||||
|
||||
Input Character Interpretation
|
||||
----------------- ----------------------------------------
|
||||
@ -1399,15 +1405,19 @@ below:
|
||||
|
||||
: Table : Batch Filename Formatting:
|
||||
|
||||
For instance
|
||||
|
||||
zint -b EANX --batch -i ean13nos.txt -o file~~~.svg
|
||||
|
||||
The following table shows some examples to clarify this method:
|
||||
|
||||
Input Filenames Generated
|
||||
----------------- -----------------------------------------------
|
||||
-o file~~~.svg file001.svg, file002.svg, file003.svg
|
||||
-o @@@@bar.png ***1.png, ***2.png, ***3.png (except Windows)
|
||||
-o @@@@bar.png +++1.png, +++2.png, +++3.png (on Windows)
|
||||
-o my~~~bar.eps my001.bar.eps, my002.bar.eps, my003bar.eps
|
||||
-o t@es~t~.png t*es0t1.png, t*es0t2.png, t*es0t3.png
|
||||
----------------- -----------------------------------------------------
|
||||
-o file~~~.svg "file001.svg", "file002.svg", "file003.svg"
|
||||
-o @@@@bar.png "***1.png", "***2.png", "***3.png" (except Windows)
|
||||
-o @@@@bar.png "+++1.png", "+++2.png", "+++3.png" (on Windows)
|
||||
-o my~~~bar.eps "my001bar.eps", "my002bar.eps", "my003bar.eps"
|
||||
-o t#es~t~.png "t es0t1.png", "t es0t2.png", "t es0t3.png"
|
||||
|
||||
: Table : Batch Filename Examples:
|
||||
|
||||
@ -1415,12 +1425,15 @@ The special characters can span directories also, which is useful when creating
|
||||
a large number of barcodes:
|
||||
|
||||
Input Filenames Generated
|
||||
--------------------- -----------------------------------------
|
||||
-o dir~/file~~~.svg dir0/file001.svg, dir0/file002.svg, …
|
||||
, dir0/file999.svg, dir1/file000.svg, …
|
||||
--------------------- ---------------------------------------------
|
||||
-o dir~/file~~~.svg "dir0/file001.svg", "dir0/file002.svg", …
|
||||
, "dir0/file999.svg", "dir1/file000.svg", …
|
||||
|
||||
: Table : Batch Directory Examples:
|
||||
|
||||
For an alternative method of naming output files see the --mirror option in 4.13
|
||||
Automatic Filenames below.
|
||||
|
||||
4.12 Direct Output
|
||||
|
||||
The finished image files can be output directly to stdout for use as part of a
|
||||
@ -1468,7 +1481,8 @@ characters, for example, and may be shortened if the data input is long.
|
||||
|
||||
To set the output file format use the --filetype option as detailed above in
|
||||
4.12 Direct Output. To output to a specific directory use the -o option giving
|
||||
the name of the directory (any filename will be ignored).
|
||||
the name of the directory (any filename will be ignored, unless --filetype is
|
||||
not specified, in which case the filename’s extension will be used).
|
||||
|
||||
4.14 Working with Dots
|
||||
|
||||
@ -1540,7 +1554,8 @@ together if required, but only for vector output.
|
||||
|
||||
The gap between the barcode and the text can be adjusted using the --textgap
|
||||
option, where the gap is given as a multiple of the X-dimension (maximum 10X). A
|
||||
zero value uses the default gap.
|
||||
zero value uses the default gap (1X). Note that a very small gap may cause
|
||||
accented texts to overlap with the barcode:
|
||||
|
||||
[zint -d "Áccent" --textgap=0.1]
|
||||
|
||||
@ -1876,8 +1891,8 @@ encoding stages. The zint_symbol structure consists of the following variables:
|
||||
dotty mode (in
|
||||
X-dimensions).
|
||||
|
||||
text_gap float Gap between barcode and text 0 (font-specific
|
||||
(HRT) in X-dimensions. default)
|
||||
text_gap float Gap between barcode and text 0 (default 1X)
|
||||
(HRT) in X-dimensions.
|
||||
|
||||
guard_descent float Height of guard bar descent 5.0
|
||||
(EAN/UPC only) in
|
||||
@ -4887,8 +4902,8 @@ OPTIONS
|
||||
--textgap=NUMBER
|
||||
|
||||
Adjust the gap between the barcode and the Human Readable Text (HRT). NUMBER
|
||||
is in multiples of the X-dimension, and may be floating-point. Maximum is 5;
|
||||
zero results in the default being used.
|
||||
is in multiples of the X-dimension, and may be floating-point. Maximum is
|
||||
10; zero results in the default 1X being used.
|
||||
|
||||
--vers=INTEGER
|
||||
|
||||
@ -4962,6 +4977,10 @@ EXIT STATUS
|
||||
Success (including when given informational options -h | --help, -e |
|
||||
--ecinos, -t | --types, -v | --version).
|
||||
|
||||
1
|
||||
Human Readable Text was truncated (maximum 159 bytes)
|
||||
(ZINT_WARN_HRT_TRUNCATED)
|
||||
|
||||
2
|
||||
Invalid option given but overridden by Zint (ZINT_WARN_INVALID_OPTION)
|
||||
|
||||
@ -5001,6 +5020,9 @@ EXIT STATUS
|
||||
14
|
||||
Error counterpart of warning if --werror given (ZINT_ERROR_NONCOMPLIANT)
|
||||
|
||||
15
|
||||
Error counterpart of warning if --werror given (ZINT_ERROR_HRT_TRUNCATED)
|
||||
|
||||
EXAMPLES
|
||||
|
||||
Create “out.png” (or “out.gif” if zint built without PNG support) in the current
|
||||
@ -5012,11 +5034,11 @@ Create “qr.svg” in the current directory, as a QR Code symbol.
|
||||
|
||||
zint -b QRCode -d 'This Text' -o 'qr.svg'
|
||||
|
||||
Use batch mode to read from an input file “ean_nos.txt” containing 13-digit
|
||||
Use batch mode to read from an input file “ean13nos.txt” containing 13-digit
|
||||
GTINs, to create a series of EAN-13 barcodes, formatting the output filenames to
|
||||
“ean001.gif”, “ean002.gif” etc. using the special character “~”.
|
||||
|
||||
zint -b EANX --batch -i 'ean_nos.txt' -o 'ean~~~.gif'
|
||||
zint -b EANX --batch -i 'ean13nos.txt' -o 'ean~~~.gif'
|
||||
|
||||
BUGS
|
||||
|
||||
|
||||
Reference in New Issue
Block a user