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. This function is available in the Document Toolkit.

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.