GdPictureImaging.TiffSaveAsMultiPageFile Method (Integer, String, TiffCompression)

Stores a GdPicture image as first page of a new multipage tiff file.

You will be able to append new page to the created file using the TiffAddToMultiPageFile() function.

This is the faster way to create multipage tiff image.

public GdPictureStatus TiffSaveAsMultiPageFile(
    int ImageID, 
    String FilePath, 
    TiffCompression Compression
);

Visual Basic

Public Function TiffSaveAsMultiPageFile(
    ByVal ImageID As Integer, 
    ByVal FilePath As String, 
    ByVal Compression As TiffCompression
) As GdPictureStatus

Parameters

Parameters	Description
ImageID	GdPicture Image Identifier. The GdPicture image to store as the first page of the multipage tiff file. Do not release this image before ending the multipage tiff file with the TiffCloseMultiPageFile() function. (see example).
FilePath	The path of the multipage tiff file to create.
Compression	A member of the TiffCompression enumeration.

Returns

A member of the GdPictureStatus enumeration.

Remarks

Use the TiffCloseMultiPageFile() function when you don't want to append new page to the multipage tiff file.

To access to the data of the new created image file you need first to save & close it using the ReleaseGdPictureImage() function, then reload it using the CreateGdPictureImageFromFile() function.

Example

Create multipage tif image from several existing image files:

Copy Code

Dim ImageID1, ImageID2, ImageID3 As Integer
 
ImageID1 = oGdPictureImaging.CreateGdPictureImageFromFile("image1.tif")
ImageID2 = oGdPictureImaging.CreateGdPictureImageFromFile("image2.jpg")
ImageID3 = oGdPictureImaging.CreateGdPictureImageFromFile("image3.jpg")
 
oGdPictureImaging.TiffSaveAsMultiPageFile(ImageID1, "multipage.tif", TiffCompression.TiffCompressionAUTO)
oGdPictureImaging.TiffAddToMultiPageFile(ImageID1, ImageID2)
oGdPictureImaging.TiffAddToMultiPageFile(ImageID1, ImageID3)
oGdPictureImaging.TiffCloseMultiPageFile(ImageID1)
 
oGdPictureImaging.ReleaseGdPictureImage(ImageID1)
oGdPictureImaging.ReleaseGdPictureImage(ImageID2)
oGdPictureImaging.ReleaseGdPictureImage(ImageID3)