TiffExtractPage(Int32,Int32,String,TiffCompression) Method

In This Topic

This method allows you to directly extract a specified page from a multipage TIFF image, that is represented by its unique image identifier. The required page is easily extracted to a TIFF image file without the need to decode and re-encode the bitmap.

This method only handles multipage TIFF images, both editable or opened as read-only.

Be aware that when working with the multipage TIFF format using GdPicture images, the resulting image files created from individual pages are compressed in memory using the TIFF CCITT 4 compression when they are bitonal, otherwise they are compressed using the TIFF LZW compression.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Overloads Function TiffExtractPage( _
   ByVal ImageID As Integer, _
   ByVal Page As Integer, _
   ByVal FilePath As String, _
   Optional ByVal Compression As TiffCompression _
) As GdPictureStatus

public GdPictureStatus TiffExtractPage( 
   int ImageID,
   int Page,
   string FilePath,
   TiffCompression Compression
)

public function TiffExtractPage( 
    ImageID: Integer;
    Page: Integer;
    FilePath: String;
    Compression: TiffCompression
): GdPictureStatus;

public function TiffExtractPage( 
   ImageID : int,
   Page : int,
   FilePath : String,
   Compression : TiffCompression
) : GdPictureStatus;

public: GdPictureStatus TiffExtractPage( 
   int ImageID,
   int Page,
   string* FilePath,
   TiffCompression Compression
)

public:
GdPictureStatus TiffExtractPage( 
   int ImageID,
   int Page,
   String^ FilePath,
   TiffCompression Compression
)

Parameters

ImageID: A unique image identifier of the GdPicture image representing the multipage TIFF image.
Page: The page number of a page you want to extract. It must be a value from 1 to TiffGetPageCount.
FilePath: The file path where the TIFF image of the extracted page will be saved. If the specified file already exists, it will be overwritten.
Compression

Return Value

A member of the GdPictureStatus enumeration. If the method has been successfully followed, then the return value is GdPictureStatus.OK. We strongly recommend always checking this status first.

Remarks

Be aware that this method only supports multipage TIFF images, both editable or opened as read-only. If the specified image is not a multipage image, this method will fail.

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
TiffCreateMultiPageFromFile(String) Method
TiffSaveMultiPageToFile(Int32,String,TiffCompression) Method
TiffIsMultiPage Method