L_NITFGetImageHeader
#include "ltntf.h"
L_LTNTF_API L_INT L_NITFGetImageHeader(hNitf, uIndex, pImageHeader)
HNITF hNitf; |
/* handle to an existing NITF file */ |
L_UINT uIndex; |
/* index of the image segment*/ |
pIMAGEHEADER pImageHeader; |
/* pointer to a IMAGEHEADER structure */ |
Retrieves the image header information of a specific graphic segment. This function is available in the Document Toolkit.
Parameter |
Description |
hNitf |
Handle to an existing NITF file, created by calling the L_NITFCreate function. |
uIndex |
A zero-based index of the image segment in the hNitf handle. |
pImageHeader |
Pointer to an IMAGEHEADER structure to be updated with the image header information of the specified image segment at the index uIndex. |
Returns
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 hNitf handle, call the L_NITFGetImageHeaderCount function.
To change the image header information for a specific graphic segment, call the L_NITFSetImageHeader function.
Required DLLs and Libraries
LTNTF For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
See Also
Functions: |
L_NITFCreate, L_NITFGetImageHeaderCount, L_NITFSetImageHeader |
Topics: |
|
|
Example
L_INT NITFGetImageHeaderExample(L_VOID) { L_INT nRet = SUCCESS; HNITF hNitf; L_UINT uFlags = 0; IMAGEHEADER ImageHeader; L_UINT uCount; L_UINT i = 0; memset(&ImageHeader, 0, sizeof(IMAGEHEADER)); // Create hNitf handle and parse the NITF file nRet =L_NITFCreate (&hNitf, TEXT("C:\\Program Files\\LEAD Technologies\\LEADTOOLS 15\\Images\\test.ntf")); if(nRet !=SUCCESS) return nRet; // Check if the hNITF is empty or invalid uFlags = L_NITFGetStatus(hNitf); if((uFlags & NITF_FILE_EMPTY) == NITF_FILE_EMPTY) { MessageBox(NULL ,TEXT("NITF file is empty"),NULL,MB_OK); return FAILURE; } if((uFlags & NITF_FILE_VALID) != NITF_FILE_VALID) { MessageBox(NULL,TEXT("NITF file is invalid"),NULL,MB_OK); return FAILURE; } // Update the image header uCount = L_NITFGetImageHeaderCount(hNitf); for( i = 0; i < uCount; ++i) { memset(&ImageHeader, 0, sizeof(ImageHeader)); nRet = L_NITFGetImageHeader(hNitf, i, &ImageHeader); if(nRet == SUCCESS) { ImageHeader.nILOCCol = 50; ImageHeader.nILOCRow = 50; nRet =L_NITFSetImageHeader(hNitf, i, &ImageHeader); if(nRet !=SUCCESS) return nRet; } else return nRet; } nRet =L_NITFDestroy(&hNitf); if(nRet !=SUCCESS) return nRet; return SUCCESS; }