L_ReadFileTransforms

#include "l_bitmap.h"

L_LTFIL_API L_INT L_ReadFileTransforms(pszFile, pTransforms, pLoadOptions)

L_TCHAR* pszFile;	/* file name */
pFILETRANSFORMS pTransforms;	/* pointer to a transform structure */
pLOADFILEOPTION pLoadOptions;	/* pointer to optional extended load options */

Reads the transforms stored with an image in a FlashPix file.

Parameter	Description
pszFile	Character string containing the FlashPix file name.
pTransforms	Pointer to a transform structure.
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

Note:	Page number is specified in the LOADFILEOPTION structure. To load a FlashPix file with or without the transforms, see FlashPix Transforms Options.
	For more information on transforms in general, refer to FILETRANSFORMS.

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.

See Also

Functions:	L_HighPassFilterBitmap
	L_WriteFileTransforms
Topics:	Raster Image Functions: Getting and Setting File Information,
	Raster Image Functions: Doing Geometric Transformations,
	Raster Image Functions: Modifying Intensity Values,
	Raster Image Functions: Loading Files,
	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

 L_INT ReadFileTransformsExample(L_VOID)
{
   L_INT nRet;
   FILETRANSFORMS FileTransforms;

   nRet = L_ReadFileTransforms(MAKE_IMAGE_PATH(TEXT("IMAGE1.FPX")),
                        &FileTransforms, NULL);
   if(nRet != SUCCESS)
      return nRet;

   //Increase the contrast by 20%
   FileTransforms.fContrastAdjustment = FileTransforms.fContrastAdjustment * 1.2f;
   nRet = L_WriteFileTransforms(MAKE_IMAGE_PATH(TEXT("Out_IMAGE1.FPX")),
                         &FileTransforms, FALSE, NULL);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}