In This Topic ▼

ILMJ2KEncoder Interface

This is the interface for the LEAD MJ2K Encoder.

Data Types:

MJ2KQUALITYFACTOR

typedef enum 
{ 
   Lossless = 1, 
   PerfectQuality_1 = 18, 
   PerfectQuality_2 = 24, 
   QualityFarMoreImportantThanSize = 30, 
   QualityMoreImportantThanSize = 40, 
   QualityAndSizeAreEquallyImportant = 55, 
   SizeMoreImportantThanQuality_1 = 70, 
   SizeMoreImportantThanQuality_2 = 90, 
   HighCompressionKeepQuality = 110, 
   HighCompression = 140, 
   HighcompressionFast = 180, 
   HypercompressionFast = 220, 
   Custom = 18 
} MJ2KQUALITYFACTOR;

Describes the predefined quality factors for video compression.

Member	Description
Lossless	Lossless compression, the data is encoded without changing any pixel values. The decoded data will be an exact duplicate of the original input data. The compression ratio is about 3:1.
PerfectQuality_1	Compresses all colors of a 24-bit file and maintains the quality of the original image at a smaller file size. There is no visual loss of color at this setting. This results in a compression ratio of about 18:1.
PerfectQuality_2	This produces a smaller file size than PerfectQuality_1 while maintaining similar quality. This results in a compression ratio of about 24:1.
QualityFarMoreImportantThanSize	Removes colors not noticed by the human eye. Most viewers cannot tell the difference between an image compressed at this level and the original image. This results in a compression ratio of about 30:1.
QualityMoreImportantThanSize	Removes more colors than QualityFarMoreImportantThanSize, most of which are colors or shades close to one another. The compressed image appears very much like the original image. Requires very close examination to see the difference. This results in a compression ratio of about 40:1.
QualityAndSizeAreEquallyImportant	Provides the highest compression while maintaining good image quality. Try this option first, and then move up or down the list accordingly to obtain acceptable compression size and image quality. This results in a compression ratio of about 55:1.
SizeMoreImportantThanQuality_1	Sharp. - Recommended for images that have sharp edges, such as an image with a text overlay or an image with many straight lines. While it creates a larger file than SizeMoreImportantThanQuality_2, it retains better edges. This results in a compression ratio of about 70:1.
SizeMoreImportantThanQuality_2	Less tiling. Produces less tiling in the image than the previous options. However, it may distort text or straight lines. It is a good option for image database applications. This results in a compression ratio of about 90:1.
HighCompressionKeepQuality	Provides maximum compression while maintaining the highest image quality possible. This results in a compression ratio of about 110:1.
HighCompression	Provides near-maximum compression. This results in a compression ratio of about 140:1.
HighcompressionFast	Provides near-maximum compression. This results in a compression ratio of about 180:1.
HypercompressionFast	Provides maximum compression. This results in a compression ratio of about 220:1.

Interface Properties:

Type	Name	Description
MJ2KQUALITYFACTOR	QualityFactor	Contains a value that represents a predefined quality factor for video compression.
DWORD	CompressionRatio	Contains a value that represents a compression ratio. Possible values are from 1 to 500, where 1 represents the best quality and lowest compression and 500 represents the highest compression and lowest quality.
DWORD	AvgTimePerFrame	(Read Only) Contains a value that represents the Average Time Per Frame for the input stream.
DWORD	FrameWidth	(Read Only) Contains a value that represents the Frame Width for the input stream.
DWORD	FrameHeight	(Read Only) Contains a value that represents the Frame Height for the input stream.
DWORD	BitsPerPixel	(Read Only) Contains a value that represents the Bits Per Pixel for the input stream.