GetInformation(Uri,bool,int) Method

Summary

Gets the specific image page information from the specified Uri.

Syntax

C++

public CodecsImageInfo GetInformation( 
   Uri uri, 
   bool totalPages, 
   int pageNumber 
)

Public Overloads Function GetInformation( _ 
   ByVal uri As Uri, _ 
   ByVal totalPages As Boolean, _ 
   ByVal pageNumber As Integer _ 
) As CodecsImageInfo

public: 
CodecsImageInfo^ GetInformation(  
   Uri^ uri, 
   bool totalPages, 
   int pageNumber 
)

Parameters

uri
The Uri containing the input image data.

totalPages
true to query the URI for total number of pages; false, otherwise.

pageNumber
Page number in the URI to query.

Return Value

A CodecsImageInfo object that contains the information about the specified image.

Remarks

Specifying true for totalPages can cause the process to be slow for files with large number of pages.

LEADTOOLS supports the following URI schemes:

Scheme	Description
UriSchemeFile	Specifies that the URI is a disk file in local machine or universal naming convention (UNC) path.
UriSchemeHttp	Specifies that the URI is accessed through the Hypertext Transfer Protocol (HTTP).
UriSchemeHttps	Specifies that the URI is accessed through the Secure Hypertext Transfer Protocol (HTTPS).
UriSchemeFtp	Specifies that the URI is accessed through the File Transfer Protocol (FTP).

If uri points to a resource in a UriSchemeHttp, UriSchemeHttps or UriSchemeFtp, then this RasterCodecs will attempt to download image data in an iterative fashion by creating a temporary buffer. The size of this buffer can be determined and changed by setting up the UriOperationBufferSize prior to calling this method.

For authenticity and proxy settings, refer to UriOperationCredentials and UriOperationProxy.

To quickly query the number of an image, use GetTotalPages or GetTotalPagesAsync.

To quickly query the format of an image, use GetFormat or GetFormatAsync.

Example

For an example, refer to GetInformation.

Requirements

Target Platforms