mirror of
https://git.code.sf.net/p/zint/code
synced 2025-12-18 10:27:09 +00: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
@@ -241,10 +241,10 @@ Below is a brief guide to Zint Barcode Studio.
|
||||
tab](images/gui_main.png)
|
||||
|
||||
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
|
||||
@@ -268,9 +268,9 @@ 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.
|
||||
`"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.
|
||||
|
||||
|
||||
@@ -1318,17 +1318,25 @@ zint -b 58 --binary -d "UTF-8 data"
|
||||
|
||||
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
|
||||
`--batch` switch together with `-i` to select the input file from which to read
|
||||
data. For example
|
||||
|
||||
```bash
|
||||
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.
|
||||
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
|
||||
--------------- ------------------------------------------
|
||||
@@ -1339,15 +1347,21 @@ Any other Insert literally
|
||||
|
||||
Table: {#tbl:batch_filename_formatting tag=": Batch Filename Formatting"}
|
||||
|
||||
For instance
|
||||
|
||||
```bash
|
||||
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: {#tbl:batch_filename_examples tag=": Batch Filename Examples"}
|
||||
|
||||
@@ -1356,11 +1370,14 @@ 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: {#tbl:batch_dir_examples tag=": 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
|
||||
@@ -1409,7 +1426,9 @@ 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).
|
||||
giving 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
|
||||
|
||||
@@ -1489,7 +1508,8 @@ be used 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:
|
||||
|
||||
|
||||
|
||||
@@ -1851,8 +1871,8 @@ Variable Name Type Meaning Default Value
|
||||
dotty mode (in
|
||||
X-dimensions).
|
||||
|
||||
`text_gap` float Gap between barcode and 0 (font-specific
|
||||
text (HRT) in X-dimensions. default)
|
||||
`text_gap` float Gap between barcode and 0 (default 1X)
|
||||
text (HRT) in X-dimensions.
|
||||
|
||||
`guard_descent` float Height of guard bar 5.0
|
||||
descent (EAN/UPC only) in
|
||||
|
||||
Reference in New Issue
Block a user