GetInformation(Stream,bool,int) Method

Summary

Gets the specific image page information from a stream.

Syntax

Objective-C

C++/CLI

Java

Python

public CodecsImageInfo GetInformation( 
   Stream stream, 
   bool totalPages, 
   int pageNumber 
)

- (nullable LTCodecsImageInfo *)imageInformationForStream:(LTLeadStream *)stream  
                                               totalPages:(BOOL)totalPages  
                                               pageNumber:(NSInteger)pageNumber  
                                                    error:(NSError **)error

public CodecsImageInfo getInformation(ILeadStream stream, boolean totalPages, int pageNumber)

public: 
CodecsImageInfo^ GetInformation(  
   Stream^ stream, 
   bool totalPages, 
   int pageNumber 
)

def GetInformation(self,stream,totalPages,pageNumber):

Parameters

stream
Stream containing the input image data.

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

pageNumber
Page number in the file 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.

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

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Svg; 
 
 
public void GetInformationStreamExample() 
{ 
   RasterCodecs codecs = new RasterCodecs(); 
 
   // Get Information on a GIF image file and write it out 
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "eye.gif"); 
   FileStream fileInMemory = new FileStream(srcFileName, FileMode.Open); 
 
   CodecsImageInfo info = codecs.GetInformation(fileInMemory, true); 
   Debug.WriteLine("Information for: {0}", srcFileName); 
   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("Fax: {0}", info.Fax); 
   Debug.WriteLine("Format: {0}", info.Format); 
   if (info.Gif.HasAnimationBackground) 
      Debug.WriteLine("Gif.AnimationBackground: {0}", info.Gif.AnimationBackground.ToString()); 
   Debug.WriteLine("Gif.AnimationHeight: {0}", info.Gif.AnimationHeight); 
   Debug.WriteLine("Gif.AnimationWidth: {0}", info.Gif.AnimationWidth); 
   if (info.Gif.HasAnimationLoop) 
      Debug.WriteLine("Gif.AnimationLoop: {0}", info.Gif.AnimationLoop.ToString()); 
   if (info.Gif.HasAnimationPalette) 
   { 
      RasterColor[] pal = info.Gif.GetAnimationPalette(); 
      Debug.WriteLine("GifAnimationPalette:\n"); 
      for (int x = 0; x < pal.Length; x++) 
      { 
         Console.Write("{0},", pal[x]); 
      } 
      Debug.WriteLine("\n"); 
   } 
   Debug.WriteLine("Gif.IsInterlaced: {0}", info.Gif.IsInterlaced.ToString()); 
   Debug.WriteLine("PageNumber: {0}", info.PageNumber); 
   Debug.WriteLine("TotalPages: {0}", info.TotalPages); 
 
   // Clean up 
   codecs.Dispose(); 
   fileInMemory.Close(); 
   fileInMemory.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}