CQTEST(8)

💅 CQTEST — the manual page, but make it make sense

okay so bestie, we're in section 8 of the System Manager's Manual, and today's main character is cqtest. yes it's a Unix man page. yes it's still gonna eat. 🍓

✨ NAME ✨

cqtest — the HylaFAX copy quality checking test program 🎀

🌸 SYNOPSIS 🌸

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

🦋 DESCRIPTION 🦋

so. cqtest is a program for testing the copy quality checking support inside the HylaFAX software — specifically, inside the faxgetty(8) program. iykyk. 💖

here's the vibe: cqtest takes a TIFF/F (that's TIFF Class F) file and generates a brand new TIFF/F file that's a copy of the input file — except any erroneous scanlines get replaced/regenerated. like a glow-up but for corrupted rows. ✨

on top of that, cqtest prints diagnostic messages describing what it's doing, and it tells you whether the input data has acceptable copy quality according to the copy quality checking threshold parameters. options are provided for specifying those copy quality checking threshold parameters. periodt. 💅

👑 OPTIONS 👑

• -m badlines — set the max number of consecutive bad lines of data that can 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. not five. not six. five. 🙈
• -o file — write output to file. by default the output goes to the file cq.tif. 🎀
• -p %goodlines — set 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 into 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. slay. ⭐

🌈 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. bestie, look how well-behaved this is:

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

one bad line per page, four pages, all still passing the vibe check. 🔥

💜 SEE ALSO 💜

faxgetty(8), hylafax-config(5)

and that's the whole page, no notes, no cap. 💖

this icon was written way back on October 3, 1995, and it lives in CQTEST(8) — yeah she's vintage but she's still that girl. mwah. 💅🌸🫶