cqtest(8c) [suse man page]
CQTEST(8C) CQTEST(8C) NAME
cqtest - HylaFAX copy quality checking test program SYNOPSIS
/usr/sbin/cqtest [ options ] input.tif DESCRIPTION
cqtest is a program for testing the copy quality checking support in the HylaFAX software (specifically, in the faxgetty(8C) program). cqtest takes a TIFF/F (TIFF Class F) file and generates a new TIFF/F file that is a copy of the input file, but with any erroneous scan- lines replaced/regenerated. In addition, cqtest prints diagnostic messages describing its actions and indicates whether the input data has acceptable copy quality according to the copy quality checking threshold parameters. Options are provided for specifying copy quality checking threshold parameters OPTIONS
-m badlines Set the maximum consecutive bad lines of data that may appear in each acceptable page of input data. This is equivalent to the MaxConsecutiveBadLines configuration parameter; c.f. hylafax-config(5F). By default cqtest accepts no more than 5 con- secutive bad lines in a page. -o file Write output to file. By default output is written to the file cq.tif. -p %goodlines Set the minimum percentage of ``good lines'' of data that may appear in acceptable page of input data. A line is good if it decodes without error to a row of pixels that is the expected width. This is equivalent to the PercentGoodLines configura- tion parameter; c.f. hylafax-config(5F). By default cqtest requires that 95% of the rows of each page be good. EXAMPLES
The following shows a multi-page, high-resolution document with a single error on each page. Each page has acceptable copy quality using the default threshold parameters. hyla% /usr/sbin/cqtest ~/tiff/pics/faxix.tif 1728 x 297, 7.7 line/mm, 1-D MH, lsb-to-msb RECV/CQ: Bad 1D pixel count, row 245, got 1616, expected 1728 RECV: 2234 total lines, 1 bad lines, 1 consecutive bad lines 1728 x 297, 7.7 line/mm, 1-D MH, lsb-to-msb RECV/CQ: Bad 1D pixel count, row 148, got 3023, expected 1728 RECV: 2234 total lines, 1 bad lines, 1 consecutive bad lines 1728 x 297, 7.7 line/mm, 1-D MH, lsb-to-msb RECV/CQ: Bad 1D pixel count, row 151, got 1722, expected 1728 RECV: 2234 total lines, 1 bad lines, 1 consecutive bad lines 1728 x 297, 7.7 line/mm, 1-D MH, lsb-to-msb RECV/CQ: Bad 1D pixel count, row 148, got 1776, expected 1728 RECV: 2234 total lines, 1 bad lines, 1 consecutive bad lines SEE ALSO
faxgetty(8C), hylafax-config(5F) October 3, 1995 CQTEST(8C)
Check Out this Related Man Page
TIFFCHECK(8C) TIFFCHECK(8C) NAME
tiffcheck - check TIFF for HylaFAX conversion requirements SYNOPSIS
/usr/sbin/tiffcheck [ options ] file.tif DESCRIPTION
tiffcheck takes TIFF input and writes a multi-line text message to the standard output describing any work needed to prepare the images for facsimile transmission. tiffcheck is usually invoked by tiff2fax(8C) script that is used by the HylaFAX scheduler to prepare TIFF docu- ments submitted for transmission. The first line of output is a series of ``+''-separated words that indicate if the input file should be: o rejected (``REJECT''), o reformatted with a different data-encoding scheme (``REFORMAT''), o scaled to different page dimensions (``RESIZE''), o reimaged in a different vertical resolution (``REVRES''), or o reimaged for other reasons such as conversion from color to black&white (``REIMAGE''). The conversion requirements string will always have keywords in the above order; e.g. ``RESIZE+REVRES'' if the input file needs to be scaled and converted to a different resolution. Information following the first line is descriptive text that explains the reason(s) for the file conversion(s); this text is suitable for return to a client (should document conversion fail or not be attempted). The descrip- tive text is ordered identically to the keywords in the conversion string; this makes it possible to match up conversion requirements to reasons. OPTIONS
The following operations are recognized: -1 Set output to be Group 3 1D-encoded. -2 Set output to be Group 3 2D-encoded. -3 Set output to be Group 4 MMR-encoded. -w width Set the output page width, in pixels. By default, pages are 1728 pixels wide. -l length Set the output page length in millimeters. By default, pages are 297 millimeters long. -r vres Set the vertical resolution, in lines/inch, at which to image the . EXAMPLES
The following color image needs to be converted to black&white, resized to the output page dimensions, and reformatted to use Group 3 1D- encoded data. hyla% /usr/sbin/tiffcheck jello.tif REFORMAT+RESIZE+REIMAGE Document is not a bilevel image (bits/sample 8). Document requires reformatting, not in Group 3 format. Document requires resizing to adjust page width (convert to 1728, document is 256). This image is a facsimile received at high resolution (196 lpi); it only needs to be converted to 98 lpi. hyla% /usr/sbin/tiffcheck faxix.tif REVRES Document requires reformatting to adjust vertical resolution (convert to 98, document is 196). SEE ALSO
tiff2fax(8C), faxq(8C), hylafax-server(5F) January 18, 1996 TIFFCHECK(8C)