L_Jp2AppendBoxesMemory

#include "l_bitmap.h"

L_LTJP2_API L_INT EXT_FUNCTION L_Jp2AppendBoxesMemory(hJp2, pBuffer, uBufferSize, lpOutBuffer, puOutBufferSize, uBoxType, pBoxes, uNumOfBoxes)

Appends boxes of uBoxType to the file in buffer.

Parameters

L_HJP2 hJp2

JPEG 2000 engine handle that was created by the L_Jp2Create function.

L_UINT8 * pBuffer

Pointer to a JPEG 2000 file in the memory.

L_SIZE_T uBufferSize

Size of the JPEG 2000 file in bytes.

L_UINT8 ** lpOutBuffer

Pointer to a pointer to be updated with an array of bytes that contains a JPEG 2000 file with new appended boxes. You must free this buffer by calling the Windows GlobalFree() function.

L_SIZE_T * puOutBufferSize

Address of a variable to be updated with the size of the output memory buffer in bytes.

eJP2BOXTYPE uBoxType

Type of the boxes to be appended.

L_VOID * pBoxes

Point to an array of boxes of type uBoxType.

L_UINT uNumOfBoxes

Number of boxes in the array.

Returns

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

Comments

The L_Jp2AppendBoxesMemory appends JPEG 2000 boxes to a file in memory buffer.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

This example appends a box to already existing JPEG 2000 file.

L_INT Jp2AppendBoxesMemoryExample(L_UINT8* pFileBuffer, L_SIZE_T uFileSize, L_UINT8** lpOutBuffer, L_SIZE_T * puOutSize, L_UINT8 * pXMLData, L_SIZE_T uSize) 
{ 
   L_HJP2 hEngine; 
   L_INT  nRet; 
   L_JP2_XML_BOX XMLBox; 
 
   /*Create JPEG  2000 engine handle*/ 
   hEngine = L_Jp2Create(); 
    
   /*Create an XML box*/ 
   XMLBox.uStructSize = sizeof(L_JP2_XML_BOX); 
   XMLBox.pData = pXMLData; 
   XMLBox.uDataSize = uSize; 
   /*Append XML box to a JPX file*/ 
   nRet = L_Jp2AppendBoxesMemory(hEngine, pFileBuffer, uFileSize,lpOutBuffer, puOutSize, L_JP2B_XML,&XMLBox,1); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   /*Destroy engine handle*/ 
   L_Jp2Destroy(hEngine); 
 
   return SUCCESS; 
} 

Help Version 21.0.2023.2.15
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.