L_ReadFileStamp

#include "l_bitmap.h"

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

L_TCHAR* 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.

NOTE: At this time, there are no multipage formats that support 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

Win32, x64, Mobile.

See Also

Functions:	L_ReadFileStamp
	L_WriteFileStamp,
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. Then saves the thumbnail image into bmp image.

 L_INT ReadFileStampExample(L_VOID)
{
   L_INT nRet;
   BITMAPHANDLE StampBitmap;
   nRet = L_ReadFileStamp(MAKE_IMAGE_PATH(TEXT("STAMP.CMP")),
                   &StampBitmap, sizeof(BITMAPHANDLE), NULL);
   if(nRet != SUCCESS)
      return nRet;

   nRet = L_SaveBitmap(MAKE_IMAGE_PATH(TEXT("Thumbnail.BMP")),
                &StampBitmap, FILE_BMP, 24, 0, NULL);
   
   if(StampBitmap.Flags.Allocated)
      L_FreeBitmap(&StampBitmap);

   return nRet;
}