COMPRESSIONOPTIONS (Document/Medical only)

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 mask/picture segments and quality compression factor for the pictures area.

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 L_MrcSaveBitmap, L_MrcSaveBitmapT44 or L_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 L_MrcSaveBitmap, L_MrcSaveBitmapT44 or L_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 L_MrcSaveBitmap , L_MrcSaveBitmapT44 or L_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 L_MrcSaveBitmap, L_MrcSaveBitmapT44 or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap, L_MrcSaveBitmapT44 or L_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 L_MrcSaveBitmap, L_MrcSaveBitmapT44 or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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. If the nPictureCoder is CMW or JPEG lossless compression, the nPictureQFactor should be 0.

nGrayscale2BitCoder

Flag that indicates the background (grayscale 2 bit) compression type. This value is valid only when saving in LEAD Proprietary T44 format using the L_MrcSaveBitmap function (when using the L_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 L_MrcSaveBitmap or L_MrcSaveBitmapList... 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 L_MrcSaveBitmap function (when using the L_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 L_MrcSaveBitmap or L_MrcSaveBitmapT44. 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_JPEG_PROGRESSIVE

[0x05] 8 bpp grayscale JPEG progressive compression.

 

MRC_GRAYSCALE_COMPRESSION_GRAYSCALE_JPEG_8BIT

[0x04] 8 bpp grayscale JPEG 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 L_MrcSaveBitmap function (when using the L_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 nGrayscale8BitCoder 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 L_MrcSaveBitmap or L_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 L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmap or L_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 L_MrcSaveBitmapT44 function, the only valid background compression is JPEG.

COMPRESSIONOPTIONS is used with the L_MrcSaveBitmap and L_MrcSaveBitmapT44 functions.