L_ReadFileStamp

#include "l_bitmap.h"

L_INT EXT_FUNCTION L_ReadFileStamp(pszFile, pBitmap, uStructSize, pLoadOptions)

L_TCHAR, L_FAR * pszFile;

/* file name*/

pBITMAPHANDLE pBitmap;

/* pointer to the target bitmap handle */

L_UINT uStructSize;

/* size in bytes, of the structure pointed to by pBitmap */

pLOADFILEOPTION pLoadOptions;

/* pointer to optional extended load options */

Reads a thumbnail image stored in a file and loads it into a specified bitmap.

Parameter

Description

pszFile

Character string containing the file name.

pBitmap

Pointer to the bitmap handle referencing the bitmap that will contain the thumbnail image.

uStructSize

Size in bytes, of the structure pointed to by pBitmap, for versioning. Use sizeof(BITMAPHANDLE).

pLoadOptions

Pointer to optional extended load options. Pass NULL to use the default load options.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Only EXIF, CMP, JFIF and FlashPix formats support stamps. However, not all file of these formats contain stamps.

Required DLLs and Libraries

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.

Platforms

Windows 95 / 98 / Me, Windows 2000 / XP, Windows CE.

See Also

Functions:

L_GetExtFileOption,

 

L_SetExtFileOption,

 

L_WriteFileStamp,

 

L_GetCompressFileStamp

Topics:

Raster Image Functions: Loading and Saving Stamp Images,

 

Loading and Saving Images

 

For a list of functions that utilize the LOADFILEOPTION or SAVEFILEOPTION structures, refer to Functions Utilizing the LOADFILEOPTION or SAVEFILEOPTION structures.

Example

Reads a thumbnail image stored in a FlashPix file and loads it into a specified bitmap.

BITMAPHANDLE StampBitmap;
L_ReadFileStamp
(TEXT("TEST1.FPX"), &StampBitmap, sizeof(BITMAPHANDLE), NULL);