GroupDocs.Merger allows developers to combine multiple TIF documents in the preferred order and save them as a single file.
About TIF File Format
TIF (or TIFF) is an image format used for containing high quality graphics. It stands for “Tagged Image File Format” or “Tagged Image Format”. The format was created by Aldus Corporation, but Adobe acquired the format later and made subsequent update in this format. TIF file is capable of holding both lossy JPEG compression and lossless image data. It can also contain vector based graphics data. TIF file format is widely supported in image editing applications. For that it’s a very popular image format among Graphic artists, Photographers, and Publishing authorities. PaintShop Pro is one of the most popular applications available for handling TIF images.
Download and Configure
Use the downloads section to download API DLLs or MSI installer or NuGet:
PM>Install-PackageGroupDocs.Merger
How to merge TIF files
The following example demonstrates how to merge TIF files with several lines of C# code:
Create an instance of Merger class and pass source TIF file path as a constructor parameter. You may specify absolute or relative file path as per your requirements.
Add another TIF file to merge with Join method. Repeat this step for other TIF documents you want to merge.
Call Merger class Save method and specify the filename for the merged TIF file as parameter.
// Load the source TIF fileusing(Mergermerger=newMerger(@"c:\sample1.tif")){// Add another TIF file to mergemerger.Join(@"c:\sample2.tif");// Merge TIF files and save resultmerger.Save(@"c:\merged.tif");}
NOTE: You may merge other TIF formats like TIFF in the same way as shown above. For this provide files by specifying their names with extension.
How to merge TIF files page by page
A TIF file can contain several pages (frames). When you join TIF files without ImageJoinOptions, their pages are appended one after another into a multi-page TIF:
// Load the source TIF fileusing(Mergermerger=newMerger(@"c:\sample1.tif")){// Append all pages of another TIF filemerger.Join(@"c:\sample2.tif");// Save the multi-page resultmerger.Save(@"c:\merged.tif");}
To choose which pages to keep and in which order, use PageBuilder. Pages can be taken from any of the files, including the first one. The document is identified by its index (starting from 0) and the page by its number (starting from 1):
using(Mergermerger=newMerger(@"c:\sample1.tif")){merger.Join(@"c:\sample2.tif");PageBuilderpageBuilder=merger.CreatePageBuilder();// Page 3 of the first file, page 2 of the second file, then page 1 of the first filepageBuilder.AddPage(pageBuilder.Documents[0].Index,3);pageBuilder.AddPage(pageBuilder.Documents[1].Index,2);pageBuilder.AddPage(pageBuilder.Documents[0].Index,1);merger.ApplyPageBuilder(pageBuilder);merger.Save(@"c:\merged.tif");}
Warning
PageBuilder is not available after a join with ImageJoinOptions: the images are then composed into one layout rather than a page sequence, so CreatePageBuilder and ApplyPageBuilder throw GroupDocsMergerException. Join TIF files without ImageJoinOptions to compose them page by page.