1DMTXREAD(1)                 General Commands Manual                DMTXREAD(1)
2
3
4

NAME

6       dmtxread - scan Data Matrix barcodes
7

SYNOPSIS

9       dmtxread [options] [FILE]...
10

DESCRIPTION

12       dmtxread  searches the named input FILEs (or standard input if no files
13       are named or the filename "-" is given) for  ECC200  Data  Matrix  bar‐
14       codes,  reads  their contents, and writes the decoded messages to stan‐
15       dard output.
16

OPTIONS

18       -c, --codewords
19              Only print the codewords extracted from a Data Matrix,  and  not
20              the actual decoded message.
21
22       -e, --minimum-edge=N
23              Pixel length of smallest expected edge in image.
24
25       -E, --maximum-edge=N
26              Pixel length of largest expected edge in image.
27
28       -g, --gap=N
29              Use scan grid with gap of N pixels (or less) between lines.
30
31       -l, --list-formats
32              List the supported input image formats.
33
34       -m, --milliseconds=N
35              Stop scan after N milliseconds (per image).
36
37       -n, --newline
38              Print a newline character at the end of decoded data.
39
40       -p, --page=N
41              Only scan Nth page of images.
42
43       -q, --square-deviation=N
44              Maximum  deviation  (degrees)  from  squareness between adjacent
45              barcode sides. Default value is N=40, but  N=10  is  recommended
46              for  flat  applications  like faxes and other scanned documents.
47              Barcode regions found with corners <(90-N) or  >(90+N)  will  be
48              ignored by the decoder.
49
50       -r, --resolution=N
51              Decoding resolution in dots per inch (DPI). Only used for vecto‐
52              rial input images such as SVG, PDF, etc... This option accepts a
53              single  argument  (eg:  300)  as well as horizontal and vertical
54              resolutions (eg: 300x150). The default resolution is 72dpi.
55
56       -s, --symbol-size=[asr|RxC]
57              Only consider barcodes of specific size or shape.
58                 a = All sizes     [default]
59                 s = Only squares
60                 r = Only rectangles
61               RxC = Exactly this many rows and columns (10x10, 8x18, etc...)
62
63       -t, --threshold=N
64              Set the minimum edge threshold as a percentage of  maximum.  For
65              example, an edge between a pure white and pure black pixel would
66              have an intensity of 100. Edges with intensities below the indi‐
67              cated  threshold will be ignored by the decoding process. Lower‐
68              ing the threshold will increase the amount of work to  be  done,
69              but may be necessary for low contrast or blurry images.
70
71       -x, --x-range-min=N[%]
72              Do not scan pixels to the left of pixel column N (or N%).
73
74       -X, --x-range-max=N[%]
75              Do not scan pixels to the right of pixel column N (or N%).
76
77       -y, --y-range-min=N[%]
78              Do not scan pixels below pixel row N (or N%).
79
80       -Y, --y-range-max=N[%]
81              Do not scan pixels above pixel row N (or N%).
82
83       -C, --corrections-max=N
84              Correct at most N errors per image (0 = correction disabled).
85
86       -D, --diagnose
87              Make copy of image with additional diagnostic data.
88
89       -M, --mosaic (experimental)
90              Interpret detected regions as Data Mosaic barcodes.
91
92       -N, --stop-after=N
93              Stop scanning after Nth barcode is returned.
94
95       -P, --page-numbers
96              Print each decoded message with its fax/tiff page number.
97
98       -R, --corners
99              Prefix the decoded message with the barcode's corner locations.
100
101       -S, --shrink=N
102              Internally  shrink  image  by  factor  of N. Shrinking is accom‐
103              plished by skipping N-1 pixels at a time, often  producing  sig‐
104              nificantly faster scan times. It also improves scan success rate
105              for images taken with poor camera focus provided  the  image  is
106              sufficiently large.
107
108       -U, --unicode
109              Print Extended ASCII characters in UTF-8 Unicode.
110
111       -v, --verbose
112              Use verbose messages.
113
114       -V, --version
115              Print program version information.
116
117       --help Display this help message and quit.
118

STANDARDS

120       ISO/IEC 16022:2000
121
122       ANSI/AIM BC11 ISS
123

DIAGNOSTICS

125       Exit status has following possible meanings:
126          0  At least one barcode was found and decoded
127          1  No barcodes were found
128         >1  Error occurred that prevented command from executing normally
129

BUGS

131       Email bug reports to mike@dragonflylogic.com
132

AUTHOR

134       Copyright (C) 2008, 2009 Mike Laughton
135
136
137
138                                 June 2, 2011                      DMTXREAD(1)
Impressum