In This Topic ▼

L_ReadFileStamp2

Summary

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

Syntax

#include "l_bitmap.h"

L_LTFIL_API L_INT L_ReadFileStamp2(pszFile, pBitmap, uStructSize, pLoadOptions, pFileInfo)

Parameters

L_TCHAR * pszFile

Character string containing the file name.

pBITMAPHANDLE pBitmap

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

L_UINT uStructSize

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

pLOADFILEOPTION pLoadOptions

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

pFILEINFO pFileInfo

Optional pointer to information about the file. Pass NULL if you do not have this information.

Returns

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

Comments

Only EXIF, CMP, JPEG, FlashPix, HEIF/HEIC and PNG formats support stamps. However, not all files of these formats contain stamps.

At this time, the only multipage format that supports stamps is HEIF/HEIC.

L_ReadFileStamp2 is like L_ReadFileStamp. The difference is that L_ReadFileStamp2 takes a pFILEINFO parameter in order to reduce the number of calls to L_FileInfo. If pFileInfo is NULL, LEADTOOLS has to call L_FileInfo to find out the file format. If pFileInfo is not NULL and contains information about the file format, LEADTOOLS can read the stamp without calling L_FileInfo. In other words, you can speed up the operation by passing a FILEINFO structure using the pFileInfo parameter.

Required DLLs and Libraries

LTFIL
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, Linux.