DTWAIN_SetJpegXRValues

Top  Previous  Next

The DTWAIN_SetJpegXRValues function sets the quality of an acquired JPEG-XR file as well as whether it is a progressive JPEG-XR.

 

DTWAIN_BOOL DTWAIN_SetJpegXRValues (

DTWAIN_SOURCE

Source,

LONG

Quality,

DTWAIN_BOOL

bProgressive );

 

Parameters

Source

   An open TWAIN Source.

 

Quality

   The JPEG-XR quality factor

 

bProgressive

Determines whether the JPEG-XR file will be a progressive JPEG-XR file.

 

Return Values

The return value is TRUE if successful.  Otherwise FALSE is returned.

 

Comments

The DTWAIN_SetJpegXRValues function sets the current quality and progressive nature of an acquired JPEG-XR file.  The Quality parameter determines the quality of the JPEG-XR image.  The quality determines the amount of detail the image will contain with respect to the original image acquired.  The quality factor is numbered from 1 (low quality) to 100 (no loss, or lossless).  The higher the quality factor, the larger in size the acquired JPEG-XR file will be.  By default, the quality setting is 80, which is adequate for most JPEG-XR files.

 

The bProgressive argument determines whether the JPEG-XR file will be a progressive JPEG-XR file.  In simple terms, a progressive JPEG-XR file is one where the display of such files in a web browser causes it to "progressively" display.  This allows larger JPEG-XR files to partially show themselves when rendered in a browser, improving as more data is recieved by the browser.  By default, the progressive setting is FALSE (no progressive file).  With a non-progressive JPEG-XR file, a browser would have to wait until the entire file is recieved before displaying in a browser.

 

 

TWAIN State Transitions

The Source must be in State 4. or higher

 

Prerequisite Function Call(s)

DTWAIN_SysInitialize

 

DTWAIN Source Selection Function

 

 

See Also

Job Control Support