GetInformation(Uri,bool,int) Method

Summary

Gets the specific image page information from the specified Uri.

Syntax

C++/CLI

Python

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

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

def GetInformation(self,uri,totalPages,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

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Svg; 
 
 
public void GetInformationUriExample() 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
 
   // Get Information on an image in an HTTP url 
   Uri uri = new Uri(@"https://www.leadtools.com/images/page_graphics/leadlogo.png"); 
   CodecsImageInfo info = codecs.GetInformation(uri, true); 
 
   Debug.WriteLine("Information for: {0}", uri); 
   Debug.WriteLine("BitsPerPixel: {0}", info.BitsPerPixel); 
   Debug.WriteLine("BytesPerLine: {0}", info.BytesPerLine); 
   Debug.WriteLine("ColorSpace: {0}", info.ColorSpace.ToString()); 
   Debug.WriteLine("Compression: {0}", info.Compression); 
   Debug.WriteLine("Format: {0}", info.Format); 
 
   // Clean up 
   codecs.Dispose(); 
}

 
import java.io.*; 
import java.net.*; 
import java.nio.file.Paths; 
import java.util.*; 
import java.time.Instant; 
import java.time.Duration; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
import static org.junit.Assert.*; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.codecs.RasterCodecs.FeedCallbackThunk; 
import leadtools.drawing.internal.*; 
import leadtools.imageprocessing.*; 
import leadtools.imageprocessing.color.ChangeIntensityCommand; 
import leadtools.svg.*; 
 
 
public void getInformationUriExample() throws URISyntaxException { 
   RasterCodecs codecs = new RasterCodecs(); 
 
   // Get Information on an image in an HTTP url 
   URI uri = new URI("https://www.leadtools.com/images/page_graphics/leadlogo.png"); 
   ILeadStream uriStream = LeadStreamFactory.create(uri); 
   CodecsImageInfo info = codecs.getInformation(uriStream, true); 
 
   System.out.println("Information for: " + uri); 
   System.out.println("BitsPerPixel: " + info.getBitsPerPixel()); 
   System.out.println("BytesPerLine: " + info.getBytesPerLine()); 
   System.out.println("ColorSpace: " + info.getColorSpace().toString()); 
   System.out.println("Compression: " + info.getCompression()); 
   System.out.println("Format: " + info.getFormat()); 
 
   assertTrue("info has incorrect format", info.getFormat().equals(RasterImageFormat.PNG)); 
 
   // Clean up 
   codecs.dispose(); 
}