CQTEST(8C)

💖 CQTEST 💖

okay bestie, buckle up, this is the cqtest page from section 8C — yes it's the HylaFAX copy quality checking test program and yes it's lowkey iconic ✨

---

🌸 NAME 🌸

cqtest — the HylaFAX copy quality checking test program 🎀

---

🦋 SYNOPSIS 🦋

/usr/bin/cqtest [ options ] input.tif

---

✨ DESCRIPTION ✨

so cqtest is literally a program for testing the copy quality checking support in the HylaFAX software — specifically the support that lives inside faxgetty(8C) 🫶

here's the vibe: you hand it a TIFF/F (that's TIFF Class F, bestie) file, and it generates a new TIFF/F file that's a copy of your input file, except every erroneous scanline gets replaced/regenerated 😌✨

and that's not even all of it — cqtest also prints diagnostic messages describing its actions, and it tells you whether the input data has acceptable copy quality according to the copy quality checking threshold parameters 👑

and because it loves you, there are options for specifying those copy quality checking threshold parameters 💅

---

💅 OPTIONS 💅

• -m badlines — sets 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 consecutive bad lines in a page. no cap.
• -o file — writes output to file 🍓 by default the output goes to the file cq.tif.
• -p %goodlines — sets the minimum percentage of "good lines" of data that may appear in an acceptable page of input data. a line counts as 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(5F). by default cqtest requires that 95% of the rows of each page be good. periodt.

---

🌈 EXAMPLES 🌈

the following shows a multi-page, high-resolution document with a single error on each page 📄✨ every page has acceptable copy quality using the default threshold parameters, slay:

hyla% /usr/bin/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) 💜

---

and that's the whole page, bestie!! this lil masterpiece dropped way back on October 3, 1995 — vintage fr fr, and it still ate 💖🦋✨