LNITFFile::GetImageHeader

Summary

Retrieves the image header information of a specific graphic segment.

Syntax

#include "ltwrappr.h"

L_INT LNITFFile::GetImageHeader(uIndex, pImageHeader)

Parameters

L_UINT uIndex

A zero-based index of the image segment in the NITF file.

pIMAGEHEADER pImageHeader

Pointer to an IMAGEHEADER structure to be updated with the image header information of the specified image segment at the index uIndex.

Returns

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

Comments

To retrieve the number of the image segments available in the NITF file, call the LNITFFile::GetImageHeaderCount function.

To change the image header information for a specific graphic segment, call the LNITFFile::SetImageHeader function.

Required DLLs and Libraries

See Also

Functions

Topics

Example

L_INT LNITFFile_GetImageHeaderExample() 
{ 
 
   //Parse the NITF file 
   LNITFFile Nitf;  
   Nitf.Create (MAKE_IMAGE_PATH(TEXT("test.ntf"))); 
 
   L_UINT uFlags = 0;  
   IMAGEHEADER ImageHeader;  
   L_UINT uCount;  
   L_UINT i = 0;  
 
   memset(&ImageHeader, 0, sizeof(IMAGEHEADER));  
   // Check if the NITF File is empty or invalid 
 
   uFlags = Nitf.GetStatus (); 
   if((uFlags & NITF_FILE_EMPTY) == NITF_FILE_EMPTY)  
   { 
      MessageBox(NULL, TEXT("NITF file is empty"), 0, 0); 
      return SUCCESS; 
   } 
 
   if((uFlags & NITF_FILE_VALID) != NITF_FILE_VALID)  
   { 
      MessageBox(NULL, TEXT("NITF file is invalid"), 0, 0); 
      return SUCCESS; 
   } 
 
 
 
   // Update the graphic header 
 
   uCount = Nitf.GetImageHeaderCount (); 
 
   for( i = 0; i < uCount; ++i)  
 
   { 
 
      if(Nitf.GetImageHeader(i, &ImageHeader) == SUCCESS)  
 
      { 
 
         ImageHeader.nILOCCol = 50;  
 
         ImageHeader.nILOCRow = 50;  
 
 
 
         Nitf.SetImageHeader (i, &ImageHeader);  
         Nitf.FreeImageHeader(&ImageHeader); 
 
      } 
 
   } 
 
 
 
   Nitf.SaveFile (MAKE_IMAGE_PATH(TEXT("test1.ntf"))); 
 
   Nitf.Destroy (); 
 
   return SUCCESS; 
} 
Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS NITF C++ Class Library Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.