L_SetJ2KOptions

#include "l_bitmap.h"

L_LTFIL_API L_INT L_SetJ2KOptions(pOptions)

/* pointer to a structure */

Sets the file options used by LEADTOOLS when saving J2K or JP2 files.

Parameter	Description
pOptions	Pointer to a structure that contains the options to use when loading J2K or JP2 files.

Returns

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

Comments

The nSize member of the FILEJ2KOPTIONS structure must be set before calling this function.

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, Windows CE.

See Also

Functions:	L_GetJ2KOptions
Topics:	Raster Image Functions: Saving Files
	Programming with JPEG 2000 Features

Example

This example will make it so the next time you save a JPEG2000 or enhanced CMP file, it will be saved with a 100:1 compression ratio get the current values. I only want to change the compression ratio.

 L_INT SetJ2KOptionsExample(L_VOID)
{
   L_INT nRet;
   FILEJ2KOPTIONS J2KOptions;
   nRet = L_GetJ2KOptions( &J2KOptions, sizeof(FILEJ2KOPTIONS));
   if(nRet != SUCCESS)
      return nRet;
   // set the compression control to make sure we will be
   // using the compression control
   J2KOptions.uCompressionControl = J2K_COMPRESSION_RATIO;
   // set the compression ratio to 100
   J2KOptions.fCompressionRatio = 100.0f;
   // set the compression options. The next time I save a 
   // JPEG2000 file, it will be saved with 100:1 compression ratio
   nRet = L_SetJ2KOptions(&J2KOptions);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}