Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
DMTXREAD(1)		     General Commands Manual		     DMTXREAD(1)

NAME
     dmtxread - scan Data Matrix barcodes

SYNOPSIS
     dmtxread [options] [FILE]...

DESCRIPTION
     dmtxread  searches the named input FILEs (or standard input if no files are
     named or the filename "-" is given) for ECC200 Data Matrix barcodes,  reads
     their contents, and writes the decoded messages to standard output.

OPTIONS
     -c, --codewords
	    Only  print  the codewords extracted from a Data Matrix, and not the
	    actual decoded message.

     -e, --minimum-edge=N
	    Pixel length of smallest expected edge in image.

     -E, --maximum-edge=N
	    Pixel length of largest expected edge in image.

     -g, --gap=N
	    Use scan grid with gap of N pixels (or less) between lines.

     -l, --list-formats
	    List the supported input image formats.

     -m, --milliseconds=N
	    Stop scan after N milliseconds (per image).

     -n, --newline
	    Print a newline character at the end of decoded data.

     -p, --page=N
	    Only scan Nth page of images.

     -q, --square-deviation=N
	    Maximum deviation (degrees) from squareness between adjacent barcode
	    sides. Default value is N=40, but N=10 is recommended for  flat  ap-
	    plications	like  faxes and other scanned documents. Barcode regions
	    found with corners <(90-N) or >(90+N) will be  ignored  by	the  de-
	    coder.

     -r, --resolution=N
	    Decoding  resolution in dots per inch (DPI). Only used for vectorial
	    input images such as SVG, PDF, etc... This option accepts  a  single
	    argument  (eg:  300)  as well as horizontal and vertical resolutions
	    (eg: 300x150). The default resolution is 72dpi.

     -s, --symbol-size=[asr|RxC]
	    Only consider barcodes of specific size or shape.
	       a = All sizes	 [default]
	       s = Only squares
	       r = Only rectangles
	     RxC = Exactly this many rows and columns (10x10, 8x18, etc...)

     -t, --threshold=N
	    Set the minimum edge threshold as a percentage of maximum. For exam-
	    ple, an edge between a pure white and pure black pixel would have an
	    intensity of 100. Edges with intensities below the indicated thresh-
	    old will be ignored by the decoding process. Lowering the  threshold
	    will  increase  the  amount of work to be done, but may be necessary
	    for low contrast or blurry images.

     -x, --x-range-min=N[%]
	    Do not scan pixels to the left of pixel column N (or N%).

     -X, --x-range-max=N[%]
	    Do not scan pixels to the right of pixel column N (or N%).

     -y, --y-range-min=N[%]
	    Do not scan pixels below pixel row N (or N%).

     -Y, --y-range-max=N[%]
	    Do not scan pixels above pixel row N (or N%).

     -C, --corrections-max=N
	    Correct at most N errors per image (0 = correction disabled).

     -D, --diagnose
	    Make copy of image with additional diagnostic data.

     -M, --mosaic (experimental)
	    Interpret detected regions as Data Mosaic barcodes.

     -N, --stop-after=N
	    Stop scanning after Nth barcode is returned.

     -P, --page-numbers
	    Print each decoded message with its fax/tiff page number.

     -R, --corners
	    Prefix the decoded message with the barcode's corner locations.

     -S, --shrink=N
	    Internally shrink image by factor of N. Shrinking is accomplished by
	    skipping N-1 pixels at a time, often producing significantly  faster
	    scan times. It also improves scan success rate for images taken with
	    poor camera focus provided the image is sufficiently large.

     -U, --unicode
	    Print Extended ASCII characters in UTF-8 Unicode.

     -v, --verbose
	    Use verbose messages.

     -V, --version
	    Print program version information.

     --help
	    Display this help message and quit.

STANDARDS
     ISO/IEC 16022:2000

     ANSI/AIM BC11 ISS

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

BUGS
     Email bug reports to mike@dragonflylogic.com

AUTHOR
     Copyright (C) 2008, 2009 Mike Laughton

				  June 2, 2011			     DMTXREAD(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dmtxread&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help