In This Topic ▼

L_SetLoadResolution

Summary

Specifies the physical resolution (width and height) of the file to load.

#include "l_bitmap.h"

L_LTFIL_API L_INT L_SetLoadResolution(nFormat, nWidth, nHeight)

File format. The following are possible values:

Value	Meaning
FILE_PCD	[57] Kodak PhotoCD
FILE_FPX	[80] Kodak FlashPix
FILE_FPX_SINGLE_COLOR	[81] Kodak FlashPix
FILE_FPX_JPEG	[82] Kodak FlashPix
FILE_FPX_JPEG_QFACTOR	[83] Kodak FlashPix
FILE_JBIG	[115] JBIG
FILE_JBIG2	[183] JBIG 2
FILE_JP2	[163] JPEG 2000. This file format contains image data and extra information about the contents and organization of the file.
FILE_J2K	[164] JPEG 2000. This file format contains only a stream of image data.
FILE_CMW	[165] Wavelet CMP.
FILE_ECW	[277] Enhanced Compressed Wavelet

Width of the bitmap to load. Pass 0 to get the default.

Height of the bitmap to load. Pass 0 to get the default.

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

For PhotoCD files, you can do either of the following:

Specify one of the exact sets of dimensions in the file. You can determine the available dimensions using the L_ReadLoadResolutions function.
Specify 0 for both dimensions to load the default resolution.

For FlashPix files, you can do any of the following:

Specify one of the exact sets of dimensions in the file. You can determine the available dimensions using the L_ReadLoadResolutions function.
Specify either the desired width or desired height to load, and use 0 to get the default for the other dimension. The default preserves the aspect ratio. The load procedure resizes the bitmap while loading it if necessary.
Specify 0 for both dimensions to load the default resolution.

For JBIG files, you can do any of the following:

Specify 0 for both dimensions to load the default resolution, which is the highest resolution layer, which corresponds to the image with its FULL DIMENSIONS.
Ex: If the file contains the image at the following dimensions: 800X600, 400X 300 and 200X150, then in the default case the filter will load the image at 800X600.
Specify either the desired width or desired height to load, and use 0 to get the default for the other dimension. The load procedure will determine the closest resolution layer, which best fits the user's request.
Ex: If the file contains the image at the following dimensions: 800X600, 400X 300 and 200X150 and the user requests an image with width equal to 780 for example, then LEADTOOLS will automatically know that the proper width is 800 and load the image at the (800X600) resolution.
Specify one of the exact sets of dimensions in the file. You can determine the available dimensions using the L_ReadLoadResolutions function.

For ECW files, you can do any of the following:

Specify 0 for both dimensions to load the default resolution.
Determine the max width/height that can be set by using L_ReadLoadResolutions function.

Note: You cannot set width/height larger than max values returned by L_ReadLoadResolutions function

LTFIL
File format DLLs
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.