L_SetDJVOptions

Support for the DjVu format has been discontinued effective with Version 17.

#include "l_bitmap.h"

L_LTFIL_API L_INT L_SetDJVOptions (pOptions);

/* pointer to a structure */

Sets the current options used by LEADTOOLS when loading DjVu files.

Parameter	Description
pOptions	Pointer to a structure that contains the current DjVu options to set. These options will be used when loading a DjVu file.

Returns

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

Comments

The uStructSize member of the FILEDJVOPTIONS structure must be set before calling this function. If a DjVu file is loaded without first calling this function, the following default value is used:

FILEDJVOPTIONS member	Default Value
nResolution	96

The values set by this function are valid for this thread. To change the values used by the current thread, call this function again, with the new values set in the FILEDJVOPTIONS structure pointed to by the pOptions parameter.

To get the current options used when loading a DjVu file, call L_GetDJVOptions.

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_GetDJVOptions
Topics:	Loading and Saving Images
	Raster Image Functions: Loading Files

Example

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

 L_INT SetDJVOptionsExample(L_TCHAR     * pszDJVFileName,
                                           pBITMAPHANDLE pBitmap,
                                           L_INT         nDisplayDepth)
{
   L_INT nRet;
   FILEDJVOPTIONS DjvOptions;
   UNREFERENCED_PARAMETER(nDisplayDepth);

   /* Get the current DJV option */
   nRet = L_GetDJVOptions(&DjvOptions,sizeof(FILEDJVOPTIONS));
   if(nRet != SUCCESS)
      return nRet;

   /*Change Resolution */
   DjvOptions. nResolution = 120;

   /* Set new DJV option */
   nRet = L_SetDJVOptions(&DjvOptions);
   if(nRet != SUCCESS)
      return nRet;

   /* Now load the DJV file */
   if(pBitmap->Flags.Allocated)
      L_FreeBitmap(pBitmap);
   nRet = L_LoadBitmap(pszDJVFileName, pBitmap, sizeof(BITMAPHANDLE), 0, ORDER_RGB, NULL, NULL);

   return nRet;
}