(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 CTA 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 location which stores number of pages that have been moved to the output file.
Return Values
Events
Details
- Although TIFF-F files may contain pages with different attributes, this function does not convert or examine attributes. It simply copies whole pages from one file to another. All pages of input files are copied sequentially into the single output_file_name. There must be at least one input_file. 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.
- It is recommended that you 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
tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights
reserved.