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: |
|
|
|
Example
For an example, refer to L_NITFCreate.