(Page 13 of 19 in this chapter)
nfxMergeFile
Description
- This function combines multiple TIFF-F files into a single
TIFF-F file.
Prototype
- DWORD nfxMergeFile (ctahd ctahd,
char output_file_name,
DWORD number_input_files,
char *input_files[],
DWORD *number_of_pages)
- ctahd 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.
- Note that the resulting TIFF-F output file could have different attributes on different pages. In this case, it could not be transmitted as a single file by NaturalFax.
- 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: Keep in mind that you must continue processing events during an active fax session. Make sure that file I/O intensive operations, such as merging files, do not interfere with the handling of events and cause the fax session to time out. Events should be processed within three seconds.
See Also
(Page 13 of 19 in this chapter)
tech_support@nmss.com
Copyright © 1997, Natural MicroSystems, Inc. All rights
reserved.