L_SetPTKOptions

#include "l_bitmap.h"

L_LTFIL_API L_INT L_SetPTKOptions(pOptions);

pFILEPTKOPTIONS pOptions;

/* pointer to a structure */

Sets the file options used by LEADTOOLS when loading PTOCA and AFP:PTOCA files.

Parameter

Description

pOptions

Pointer to a structure that contains the options to use when loading PTOCA and AFP:PTOCA files.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The uStructSize member of the FILEPTKOPTIONS structure must be set before calling this function. If a PTOCA and AFP:PTOCA file is loaded without first calling this function, the following default values will be used:

FILEPTKOPTIONS Member:

Default value:

nPTKResolution

96

The values set by this function are valid for the current thread. To change the values used by the current thread, this function must be called again.

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 2000 / XP/Vista.

See Also

Functions:

L_GetPTKOptions

Topics:

Loading and Saving Images

 

Raster Image Functions: Loading Files

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

Example

This example loads a PTK file, with a resolution defined by the user 

 L_INT SetPTKOptionsExample(L_TCHAR     * pszPTKFileName,
                                           pBITMAPHANDLE pBitmap,
                                           L_INT         nDisplayDepth)
{
   L_INT nRet;
   FILEPTKOPTIONS PtkOptions;

   UNREFERENCED_PARAMETER(nDisplayDepth);

   /* Get the current PTK option */
   nRet = L_GetPTKOptions(&PtkOptions,sizeof(FILEPTKOPTIONS));
   if(nRet != SUCCESS)
      return nRet;

   /*Change Resolution */
   PtkOptions. nPTKResolution = 120;

   /* Set new PTK option */
   nRet = L_SetPTKOptions(&PtkOptions);
   if(nRet != SUCCESS)
      return nRet;

   /* Now load the PTK file */
   nRet = L_LoadBitmap(pszPTKFileName, pBitmap, sizeof(BITMAPHANDLE), 0, ORDER_RGB, NULL,     NULL);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}