L_NITFAppendImageSegment

Summary

Appends an image data to the image segment inside the NITF file.

Syntax

#include "ltntf.h"

L_LTNTF_API L_INT L_NITFAppendImageSegment(hNitf, pBitmap, nFormat, nBpp, nQFactor)

Parameters

HNITF hNitf

Handle to an existing NITF file, created by calling the L_NITFCreate function.

pBITMAPHANDLE pBitmap

Pointer to a BITMAPHANDLE that references the bitmap that holds the image data to be inserted into the image segment in the NITF file.

L_INT nFormat

Output file format. Possible values are FILE_JPEG and FILE_JPEG_RGB.

L_INT nBpp

Bits per pixel of the image data to be inserted in the image segment into the NITF file. Possible values are 8 and 24-bits.

L_INT nQFactor

Value that represents the degree of loss in the compression process, used when inserting an image into NITF file. Possible values range from 2 to 255, where 2 is the highest quality and 255 is the most compression.

Returns

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

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_NITFAppendGraphicSegment
• L_NITFAppendTextSegment

Topics

• NITF Functions: Appending Data to a NITF File
• Programming with LEADTOOLS NITF Functions

Example

For an example, refer to L_NITFCreate.