COMPRESSIONOPTIONS

typedef struct _tagCOMPRESSIONOPTIONS
{
   L_UINT uStructSize;
   L_INT nMaskCoder;
   L_INT nPictureCoder;
   L_INT nPictureQFactor;
   L_INT nGrayscale2BitCoder; 
   L_INT nGrayscale8BitCoder;
   L_INT nGrayscale8BitFactor;
   L_INT nText2BitCoder;
} COMPRESSIONOPTIONS,  * pCOMPRESSIONOPTIONS;

The COMPRESSIONOPTIONS structure contains compression information used with picture segments.

Member

Description

uStructSize

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

nMaskCoder

Flag that indicates the mask compression. Possible values are:

 

Value

Meaning

 

MRC_MASK_COMPRESSION_JBIG

[0x00] JBIG compression. This flag is used only if FILE_LEAD_MRC, FILE_TIF_LEAD_MRC, FILE_MRC, or FILE_TIF_MRC is set in the nFormat of either LSegment::MrcSaveBitmap, LSegment::MrcSaveBitmapT44 or LSegment::MrcSaveBitmapList.

 

MRC_MASK_COMPRESSION_FAX_G4

[0x01] Fax group 4 compression. This flag is used only if FILE_LEAD_MRC, FILE_TIF_LEAD_MRC, FILE_MRC, or FILE_TIF_MRC is set in the nFormat of either LSegment::MrcSaveBitmap, LSegment::MrcSaveBitmapT44 or LSegment::MrcSaveBitmapList.

 

MRC_MASK_COMPRESSION_FAX_G3_1D

[0x02] Fax group 3 (1D) compression. This flag is used only if FILE_LEAD_MRC, FILE_TIF_LEAD_MRC, FILE_ MRC, or FILE_TIF_MRC is set in the nFormat of either LSegment::MrcSaveBitmap, LSegment::MrcSaveBitmapT44 or LSegment::MrcSaveBitmapList.

 

MRC_MASK_COMPRESSION_FAX_G3_2D

[0x03] Fax group 3 (2D) compression. This flag is used only if FILE_LEAD_MRC, FILE_TIF_LEAD_MRC, FILE_ MRC, or FILE_TIF_MRC is set in the nFormat of either LSegment::MrcSaveBitmap, LSegment::MrcSaveBitmapT44 or LSegment::MrcSaveBitmapList.

 

MRC_PDF_ONEBIT_COMPRESSION_ZIP

[0x04] ZIP compression. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_ONEBIT_COMPRESSION_LZW

[0x05] LZW compression. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_ONEBIT_COMPRESSION_CCITT_G3_1D

[0x06] Fax group 3 (1D) compression. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_ONEBIT_COMPRESSION_CCITT_G3_2D

[0x07] Fax group 3 (2D) compression. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_ONEBIT_COMPRESSION_CCITT_G4

[0x08] Fax group 4 compression. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_ONEBIT_COMPRESSION_JBIG2

[0x09] JBIG2 compression. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

nPictureCoder

Flag that indicates the background (picture) compression type. Possible values are:

 

Value

Meaning

 

MRC_PICTURE_COMPRESSION_CMW

[0x00] LEAD Wavelet (CMW) compression. This flag is used only if FILE_LEAD_MRC or FILE_TIF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PICTURE_COMPRESSION_LOSSLESS_CMW

[0x01] LEAD Wavelet lossless compression. This flag is used only if FILE_LEAD_MRC or FILE_TIF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PICTURE_COMPRESSION_CMP

[0x02] LEAD CMP compression. This flag is used only if FILE_LEAD_MRC or FILE_TIF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PICTURE_COMPRESSION_JPEG

[0x03] JPEG Compression. This flag is used only if FILE_LEAD_MRC, FILE_TIF_LEAD_MRC, FILE_MRC, or FILE_TIF_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap, LSegment::MrcSaveBitmapT44 or LSegment::MrcSaveBitmapList.

 

MRC_PICTURE_COMPRESSION_LOSSLESS_JPEG

[0x04] JPEG Lossless Compression. This flag is used only if FILE_LEAD_MRC, or FILE_TIF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap, LSegment::MrcSaveBitmapT44 or LSegment::MrcSaveBitmapList.

 

MRC_PICTURE_COMPRESSION_JPEG_YUV422

[0x05] JPEG Compression with YUV 4:2:2 color space. This flag is used only if FILE_LEAD_MRC, or FILE_TIF_LEAD_MRC, is set in the nFormat parameter of either LSegment::MrcSaveBitmap, or LSegment::MrcSaveBitmapList.

 

MRC_PICTURE_COMPRESSION_JPEG_YUV411

[0x06] JPEG Compression with YUV 4:1:1 color space. This flag is used only if FILE_LEAD_MRC, or FILE_TIF_LEAD_MRC, is set in the nFormat parameter of either LSegment::MrcSaveBitmap, or LSegment::MrcSaveBitmapList.

 

MRC_PICTURE_COMPRESSION_JPEG_PROGRESSIVE

[0x07] JPEG Progressive Compression. This flag is used only if FILE_LEAD_MRC, or FILE_TIF_LEAD_MRC, is set in the nFormat parameter of either LSegment::MrcSaveBitmap, or LSegment::MrcSaveBitmapList.

 

MRC_PICTURE_COMPRESSION_JPEG_PROGRESSIVE_YUV422

[0x08] JPEG Progressive Compression. This flag is used only if FILE_LEAD_MRC, or FILE_TIF_LEAD_MRC, is set in the nFormat parameter of either LSegment::MrcSaveBitmap, or LSegment::MrcSaveBitmapList.

 

MRC_PICTURE_COMPRESSION_JPEG_PROGRESSIVE_YUV411

[0x09] JPEG Progressive Compression. This flag is used only if FILE_LEAD_MRC, or FILE_TIF_LEAD_MRC, is set in the nFormat parameter of either LSegment::MrcSaveBitmap, or LSegment::MrcSaveBitmapList.

 

MRC_PDF_PICTURE_COMPRESSION_JPEG

[0x05] JPEG Compression. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_PICTURE_COMPRESSION_YUV422

[0x0B] JPEG Compression with YUV 4:2:2 color space.  This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_PICTURE_COMPRESSION_YUV411

[0x0C] JPEG Compression with YUV 4:1:1 color space. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_PICTURE_COMPRESSION_PROGRESSIVE

[0x0D] JPEG Progressive Compression. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_PICTURE_COMPRESSION_PROGRESSIVE_YUV422

[0x0E] JPEG Progressive Compression with YUV 4:2:2 color space. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_PICTURE_COMPRESSION_PROGRESSIVE_YUV411

[0x0F] JPEG Compression with YUV 4:1:1 color space. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_PICTURE_COMPRESSION_ZIP

[0x06] ZIP Compression. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_PICTURE_COMPRESSION_LZW

[0x07] LZW Compression. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

nPictureQFactor

Compression quality for JPEG, CMP and CMW compression for colored images. Possible values are between 2 and 255, where 2 is the highest quality and 255 is the most compression.

nGrayscale2BitCoder

Flag that indicates the background (grayscale 8 bit) compression type. This value is valid only when saving in LEAD Proprietary T44 format using the LSegment::MrcSaveBitmap function.

(when using the LSegment::MrcSaveBitmapT44 function, all 2-bit grayscale segments are treated as picture segments). This member is used only if FILE_LEAD_MRC or FILE_TIF_LEAD_MRC is set. in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapT44. Possible values are:

 

Value

Meaning

 

MRC_GRAYSCALE_COMPRESSION_JBIG_2BIT

[0x00] 2 bpp grayscale JBIG compression.

 

nGrayscale8BitCoder

Flag that indicates the background (grayscale 8 bit) compression type.  This value is valid only when saving in LEAD Proprietary T44 format using the LSegment::MrcSaveBitmap function.(when using the LSegment::MrcSaveBitmapT44 function, all 8-bit grayscale segments are treated as picture segments). This member is used only if FILE_LEAD_MRC or FILE_TIF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.  Possible values are:

 

Value

Meaning

 

MRC_GRAYSCALE_COMPRESSION_LOSSLESS_CMW_8BIT

[0x00] 8 bpp Lossless grayscale LEAD CMW compression.

 

MRC_GRAYSCALE_COMPRESSION_GRAYSCALE_CMW_8BIT

[0x01] 8 bpp grayscale LEAD CMW compression.

 

MRC_GRAYSCALE_COMPRESSION_GRAYSCALE_CMP_8BIT

[0x02] 8 bpp grayscale LEAD CMP compression.

 

MRC_GRAYSCALE_COMPRESSION_LOSSLESS_JPEG_8BIT

[0x03] 8 bpp Lossless grayscale JPEG compression.

 

MRC_GRAYSCALE_COMPRESSION_GRAYSCALE_JPEG_8BIT

[0x04] 8 bpp grayscale JPEG compression.

 

MRC_GRAYSCALE_COMPRESSION_JPEG_PROGRESSIVE

[0x05] 8 bpp grayscale JPEG progressive compression.

 

nGrayscale8BitFactor

Compression quality for JPEG, CMP and CMW compression for 8-bit grayscale images. This value is valid only when saving in LEAD Proprietary T44 format using the LSegment::MrcSaveBitmap function (when using the LSegment::MrcSaveBitmapT44 function, all 8-bit grayscale segments are treated as picture segments). Possible values are between 2 and 255, where 2 are the highest quality and 255 is the most compression. If the nPictureCoder is CMW or JPEG lossless compression, the nGrayscaleFactor should be 0. This member is used only if FILE_LEAD_MRC or FILE_TIF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapT44.

nText2BitCoder

Flag that indicates the text 2-bit compression type.  This value is valid only when saving in LEAD Proprietary T44 format using the LSegment::MrcSaveBitmap function. This member is used only if FILE_LEAD_MRC, FILE_TIF_LEAD_MRC, or FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.  Possible values are:

 

Value

Meaning

 

MRC_TEXT_COMPRESSION_JBIG_2BIT

[0x00] 2 bpp JBIG compression. This flag is used only if FILE_LEAD_MRC or FILE_TIF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_TEXT_COMPRESSION_GIF_2BIT

[0x00] 2 bpp GIF compression. This flag is used only if FILE_LEAD_MRC or FILE_TIF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_TEXT_COMPRESSION_ZIP

[0x02] ZIP compression. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

 

MRC_PDF_TEXT_COMPRESSION_LZW

[0x03] LZW compression. This flag is used only if FILE_PDF_LEAD_MRC is set in the nFormat parameter of either LSegment::MrcSaveBitmap or LSegment::MrcSaveBitmapList.

Comments

pCOMPRESSIONOPTIONS is a pointer to a COMPRESSIONOPTIONS structure. Where the message parameter type is pCOMPRESSIONOPTIONS, you can declare a COMPRESSIONOPTIONS variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pCOMPRESSIONOPTIONS variable is necessary only if your program requires a pointer.

When saving in standard T44 format using the LSegment::MrcSaveBitmapT44 function, the only valid background compression is JPEG.

COMPRESSIONOPTIONS is used with the LSegment::MrcSaveBitmap and LSegment::MrcSaveBitmapT44 functions.