EPNRASTEROPTIONS

Member

Description

uStructSize

Size of this structure in bytes, for versioning. Use the sizeof() macro to calculate this value.

nBitsPerPixel

Resulting file's pixel depth. Note that not all bits per pixel are available for all file formats. For valid values, refer to Formats of Output Files. If nBitsPerPixel is 0, the file will be stored using the closest bits per pixel value supported by that format. For example, if a file format supports 1, 4, and 24 bits per pixel, and the input image data is 5 BPP, the file will be stored as 24 bit. Likewise, if the input image data is 2 BPP, the file will be stored as 4 bit.

nQFactor

nQfactor is a number that indicates the degree of loss in the compression process. This parameter is used when saving an image file to formats that support lossy compression, such as JPEG and LEAD CMP. For possible values, refer to Compression Quality Factors.

bSaveInterlaced

Flag that indicates whether to save a GIF file as an interlaced file. Possible values are:

Value

Meaning

TRUE

Save GIF file as interlaced.

FALSE

Do not save GIF file as interlaced.

nPasses

The number of passes (scans through the image) when saving a JPEG or LEAD CMP file. (This value is not used when saving interlaced PNG files.)

Possible values when saving:

Value

Meaning

Any positive number

Save the file as a progressive file with the specified number of passes.

0

Save the file as an ordinary JPEG or LEAD CMP file (not a progressive file).

Any negative number

Save the file as a progressive file with the LEADTOOLS default number of passes.

Possible values when saving non-progressive files:

Value

Meaning

0

Save the file with fixed Huffman tables (faster save, lower compression).

<>0

Save the file with optimized Huffman tables (2-pass compression, lower speed, higher compression).

bSaveStamp

Flag that indicates whether to save CMP, JPEG, or Exif files with a stamp (thumbnail image), in addition to the normal image. Possible values are:

Value

Meaning

TRUE

Save Stamp.

FALSE

Do not save stamp.

nStampBits

Bits per pixel of the stamp image intended to be saved. A stamp will be saved only if the bSaveStamp member value is set to TRUE.

nStampWidth

Value that represents the width, in pixels, of the stamp image intended to be saved. A stamp will be saved only if the bSaveStamp member value is set to TRUE.

nStampHeight

Value that represents the height, in pixels, of the stamp image intended to be saved. A stamp will be saved only if the bSaveStamp member value is set to TRUE.

bUseFileSize

Flag that indicates whether to save JPEG 2000 files using the quality factor value specified in nQFactor for compression or using the uTargetFileSize value for compression.

Value

Meaning

TRUE

Save JPEG 2000 files using the uTargetFileSize value for compression.

FALSE

Save JPEG 2000 files using the quality factor value specified in nQFactor for compression.

uTargetFileSize

Value that represents the size of the target file, in bytes. Use this member only if the bUseFileSize member value is set to TRUE.

bMultiPageFile

Flag that indicates whether to save a multi-page file, each page in a separate file or save them all in one file. It appends the image as the last one in the file. You can save multi-page images in PCX, GIF, and most TIFF file formats (including JTIF, but excluding EXIF). For more information on multi-page files refer to Multipage File Formats. Possible values are:

Value

Meaning

TRUE

Save multi pages.

FALSE

Save single page.

uFlags

Reserved for future use. Pass 0.