L_Jp2AppendGMLData

#include "l_bitmap.h"

L_LTJP2_API L_INT EXT_FUNCTION L_Jp2AppendGMLData(hJp2, pFileName, pGMLData)

L_HJP2 hJp2;	/* JPEG 2000 engine handle */
L_TCHAR * pFileName;	/* name of the file */
pL_JP2_GMLDATA pGMLData;	/* pointer to the L_JP2_GMLDATA structure */

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

Parameter	Description
hJp2	JPEG 2000 engine handle that was created by the L_Jp2Create function.
pFileName	Character string that contains the name of the JPEG 2000 file to which to append the GML data.
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

L_Jp2AppendGMLData appends GML data to the specified JPEG 2000 part 2 (JPX) file format. If the file is in JP2 format, the function 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:	L_Jp2ReadGMLData, L_Jp2AppendGMLDataMemory, L_Jp2AppendBoxes, L_Jp2AppendBoxesMemory, L_Jp2AppendFrames, L_Jp2AppendFramesMemory, L_Jp2ReadBox, L_Jp2ReadBoxMemory
Topics:	Programming with 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.

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName


L_LTJP2TEX_API L_INT Jp2AppendGMLDataExample(pL_JP2_GMLDATA pGMLData)
{
   L_HJP2 hEngine;

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

   /*Read GML data*/
   L_Jp2AppendGMLData(hEngine, MAKE_IMAGE_PATH(TEXT("image1.jpx")), pGMLData);

   /*Destroy engine handle*/
   L_Jp2Destroy(hEngine);
   return SUCCESS;
}