GdPictureImaging.TiffAddToMultiPageFile Method

Adds a page to a multipage tiff file created with the TiffSaveAsMultiPageFile() function.

public GdPictureStatus TiffAddToMultiPageFile(
    int ImageID, 
    int ImageToAddID
);

Visual Basic

Public Function TiffAddToMultiPageFile(
    ByVal ImageID As Integer, 
    ByVal ImageToAddID As Integer
) As GdPictureStatus

Parameters

Parameters	Description
ImageID	GdPicture Image Identifier. The GdPicture image used with the TiffSaveAsMultiPageFile() function. This must be the first image ot the file.
ImageToAddID	GdPicture Image Identifier. The image to append within multipage tiff file. You will be able to release this image after calling this function.

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.

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)