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;
}