L_NITFAppendImageSegment

#include "ltntf.h"

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

HNITF hNitf;

/* handle to an existing NITF file */

 pBITMAPHANDLE pBitmap;

/* pointer to a bitmap handle */

L_INT nFormat;

/* file format */

L_INT nBpp;

/* resulting bitmap pixel depth */

L_INT nQFactor;

/* quality factor */

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

Parameter

Description

hNitf

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

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.

nFormat

Output file format. Possible values are FILE_JPEG and FILE_JPEG_RGB.

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.

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

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.