(Page 10 of 15 in this chapter) Version
nfxMergeFile
Description
- Combines multiple TIFF-F or TIFF-S files into a single TIFF-F or TIFF-S file.
Prototype
- DWORD nfxMergeFile ( CTAHD ctahd,
char output_file_name,
DWORD number_input_files,
char *input_files[],
DWORD *number_of_pages)
- ctahd Context handle returned by ctaCreateContext.
- output_file_name Name of output file.
- number_input_files Number of input file names being passed to the function.
- input_files Pointer to an array of input file names.
- number_of_pages Pointer to the location which stores the number of pages moved to the output file.
Return Values
Events
Details
- Although TIFF-F files may contain pages with different attributes, nfxMergeFile copies whole pages from one file to another. It does not convert or examine attributes. All pages of input files are copied sequentially into the single output_file_name. At least one input_file. must exist. The contents of the input files do not change.
- The resulting TIFF-F or TIFF-S output file can have different attributes on different pages.
- Use nfxCheckTIFF to examine the attributes of all input files before operating on them with either nfxMergeFile or nfxSplitFile.
Note: Make sure the application continues processing events during an active fax session. If file I/O intensive operations such as merging files interfere with the handling of events, the fax session could time out. Events should be processed within three seconds.
See Also
- nfxCheckTIFF
, nfxSplitFile
(Page 10 of 15 in this chapter) Version
Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2001, NMS Communications Corporation. All rights
reserved.