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(8) 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
       scanlines 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(5).  By
                     default cqtest accepts no more than 5 consecutive 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   configuration  parameter;  c.f.   hylafax-config(5).   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(8), hylafax-config(5)

                                         October 3, 1995                                CQTEST(8)