NFX_CONVERT_PARMS

The NFX_CONVERT_PARMS structure specifies attributes that are used by nfxConvertFileDirect.

Dependent function: nfxConvertFileDirect

Field name

Type

Units

Description

badlineaction

DWORD

None

How bad lines that are discovered in the input file appear in the output file.

  • NFX_BAD_LINE_ACTION_REPT: Repeats the picture elements of the nearest previous good line (default).

  • NFX_BAD_LINE_ACTION_DROP: Eliminates the bad line from the destination file.

  • NFX_BAD_LINE_ACTION_TICK: Replaces the bad line with a blank line with a short black mark at either end.

When the source file has 2D encoding, an error in a single line may cause up to three subsequent lines to be considered bad.

encoding

DWORD

None

The encoding of the data to be stored in the output file. The input file data may be in 1D, 2D, or MMR encoding.

NFX_ENCODE_TIFF_S writes the output file according to the TIFF-S specification. Values are overridden to 1D encoding, low resolution, and A4 page width.

The encoding affects the size of image data only; it does not affect the appearance of the image. Values are:

  • NFX_ENCODE_1D (default)

  • NFX_ENCODE_2D

  • NFX_ENCODE_MMR

  • NFX_ENCODE_TIFF_S

pagewidth

DWORD

None

The page width of the data to be stored in the output file. The input file data may have any of the allowed page widths. The number of picture elements (pels) per line is 1728, 2048, and 2432 for NFX_PAGE_WIDTH_A4, NFX_PAGE_WIDTH_B4, and NFX_PAGE_WIDTH_A3, respectively. All are packed with the resolution of 200 picture elements per inch. Converting to a narrower page shrinks each line. Converting to a wider page results in padding the right side of the page with blank space. Values are:

  • NFX_PAGE_WIDTH_A4 (default)

  • NFX_PAGE_WIDTH_B4

  • NFX_PAGE_WIDTH_A3

resolution

DWORD

None

The vertical resolution of the data to be stored in the output file. The input file data may have any of the allowed resolutions:

Scan lines per millimeter

Resolution

3.85

NFX_RESOLUTION_LOW (default)

7.7

NFX_RESOLUTION_HIGH

15.4

NFX_RESOLUTION_SUPER_HIGH

The horizontal resolution of the data is the same for all values. Image appearance is affected by a change in resolution.

type

DWORD

None

The overall format of the output file. NaturalFax supports the TIFF-F format. Specifying a value of NFX_TIFF_S has the same effect as specifying a value of NFX_ENCODE_TIFF_S in the encoding field.

Default: NFX_TIFF_F