---
name: "tiffcheck"
section: "8"
platform: "linux"
package: "hylafax-server"
version: "3:6.0.7-11.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/tiffcheck"
---

# tiffcheck(8)

check TIFF for HylaFAX conversion requirements

## 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*(8)](/tiff2fax/8.md) script that is used by the *HylaFAX* scheduler to prepare TIFF documents submitted for transmission.

The first line of output is a series of \`\`+''-separated words that indicate if the input file should be:

- •

  rejected (\`\`REJECT''),

- •

  reformatted with a different data-encoding scheme (\`\`REFORMAT''),

- •

  scaled to different page dimensions (\`\`RESIZE''),

- •

  reimaged in a different vertical resolution (\`\`REVRES''), or

- •

  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 descriptive 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 TIFF.

## 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*(8)](/tiff2fax/8.md), [*faxq*(8)](/faxq/8.md), [*hylafax-server*(5)](/hylafax-server/5.md)