L_Jp2ReadGMLDataMemory

#include "l_bitmap.h"

L_LTJP2_API L_INT EXT_FUNCTION L_Jp2ReadGMLDataMemory(hJp2, pBuffer, uBufferSize, pGMLData)

L_HJP2 hJp2;	/* JPEG 2000 engine handle */
L_UINT8 * pBuffer;	/* pointer to a JPEG 2000 file in memory */
L_SIZE_T uBufferSize;	/* file size in bytes */
pL_JP2_GMLDATA pGMLData;	/* pointer to the L_JP2_GMLDATA structure */

Reads GML data stored in a JPEG 2000 file in memory.

Parameter	Description
hJp2	JPEG 2000 engine handle.
pBuffer	Pointer to a JPEG 2000 file in memory.
uBufferSize	Size of the JPEG 2000 file in bytes.
pGMLData	Pointer to the L_JP2_GMLDATA structure that is filled by GML data stored in the file.

Returns

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

Comments

L_Jp2ReadGMLDataMemory reads GML data stored in a JPEG 2000 file in memory. You must free this structure by calling the L_Jp2FreeGMLData function.

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:	L_Jp2FreeGMLData, L_Jp2ReadGMLData, L_Jp2AppendGMLData, L_Jp2AppendGMLDataMemory
Topics:	Programming with JPEG 2000 Features
`	Programming with JPX Features
	Raster Image Functions: Working with JPEG 2000
	Raster Image Functions: Working with JPX

Example

This example reads GML data stored in JPEG 2000 file format

L_LTJP2TEX_API L_INT Jp2ReadGMLDataMemoryExample(L_UINT8* pFileBuffer, L_SIZE_T uFileSize)
{
   L_HJP2 hEngine;
   L_JP2_GMLDATA GMLData;

   /*Create JPEG  2000 engine handle*/
   hEngine = L_Jp2Create();

   /*Read GML data*/
   GMLData.uStructSize = sizeof(L_JP2_GMLDATA);
   L_Jp2ReadGMLDataMemory(hEngine, pFileBuffer, uFileSize, &GMLData);

   /*Free GML data*/
   L_Jp2FreeGMLData(hEngine, &GMLData);
   /*Destroy engine handle*/
   L_Jp2Destroy(hEngine);
   return SUCCESS;
}