LFileSettings::SetJ2KOptions

#include "ltwrappr.h"

static L_INT LFileSettings::SetJ2KOptions(pOptions)

const pFILEJ2KOPTIONS 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 saving 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.

See Also

Functions:

LFileSettings::GetJ2KOptions, LFileSettings::GetDefaultJ2KOptions, Class Members

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. 

L_INT LFileSettings__SetJ2KOptionsExample() 
{
   L_INT nRet;
   FILEJ2KOPTIONS J2KOptions;
   // Get the current values. Change the 
   // compression ratio
   nRet = LFileSettings::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 = LFileSettings::SetJ2KOptions(&J2KOptions);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}