LJp2FileFormat::AppendGMLDataMemory

#include "ltwrappr.h"

L_INT LJp2FileFormat::AppendGMLDataMemory(pBuffer, uBufferSize, lpOutBuffer, puOutBufferSize, pGMLData)

L_UINT8 * pBuffer;	/* pointer to a JPEG 2000 file in memory */
L_SIZE_T uBufferSize;	/* size of the JPEG 2000 file*/
L_UINT8 ** lpOutBuffer;	/* pointer to a pointer */
L_SIZE_T * puOutBufferSize;	/* pointer to a variable to be updated */
pL_JP2_GMLDATA pGMLData;	/* pointer to the L_JP2_GMLDATA structure */

Appends GML data to the specified JPEG 2000 part 2 (JPX) file format in memory.

Parameter	Description
pBuffer	Pointer to a JPEG 2000 file in memory.
uBufferSize	Size of the JPEG 2000 file in bytes.
lpOutBuffer	Pointer to a pointer to be updated with an array of bytes that contains a JPEG 2000 file with new appended GML data. You must free this buffer by calling the Windows LocalFree() function.
puOutBufferSize	Address of a variable to be updated with the size of the output memory buffer in bytes.
pGMLData	Pointer to the L_JP2_GMLDATA structure that has the GML data to be appended.

Returns

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

Comments

LJp2FileFormat::AppendGMLDataMemory appends GML data to the specified JPEG 2000 part 2 (JPX) file format in memory. If the file is JPX format, the functions returns: ERROR_FILE_FORMAT.

Required DLLs and Libraries

LTJP2
LFJ2K
LTIMGEFX

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:	LJp2FileFormat::ReadGMLData, LJp2FileFormat::AppendGMLData, LJp2FileFormat::AppendBoxes, LJp2FileFormat::AppendBoxesMemory , LJp2FileFormat::AppendFrames, LJp2FileFormat::AppendFramesMemory, LJp2FileFormat::ReadBox, LJp2FileFormat::ReadBoxMemory
Topics:	Implementing JPEG 2000 Features
	Raster Image Functions: Working with JPEG 2000
	Programming with JPX Features
	JPX File Comments
	Raster Image Functions: Working with JPX

Example

This example appends user GML data to a JPEG 2000 file.

L_INT LJp2FileFormat__AppendGMLDataMemoryExample(L_UINT8* pFileBuffer, L_SIZE_T uFileSize, L_UINT8** lpOutBuffer, L_SIZE_T * puOutSize, pL_JP2_GMLDATA pGMLData)
{
   LJp2FileFormat Engine;
   L_INT nRet = 0;
   /*Read GML data*/
   nRet = Engine.AppendGMLDataMemory( pFileBuffer, uFileSize, lpOutBuffer, puOutSize, pGMLData);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}