Provided by: hylafax-server_4.2.5-1_i386 bug

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)