Info Property

Summary

Gets the CodecsImageInfo class instance that contains the information about the image file.

Syntax

C++/CLI

Java

Python

public CodecsImageInfo Info { get; }

public CodecsImageInfo getInfo()

public: 
property CodecsImageInfo^ Info { 
   CodecsImageInfo^ get(); 
}

Info # get  (CodecsGetInformationAsyncCompletedEventArgs)

Property Value

A CodecsImageInfo object that contains the information about the image file, or a null reference if an error occurred.

Remarks

NOTE: This topic is part of RasterCodecs Async support using the .NET System.ComponentMode.AsyncOperation model. For .NET async/await support this type/member is not used. Instead, refer to RasterCodecs Async Operations.

This property contains the information about the image file. This instance is the same object returned from the RasterCodecs.GetInformationAsync method. While the asynchronous operation is running, the value of theRasterImage.IsLoading property will be true indicating that the object is being populated with the information and should not be used. When the asynchronous operation completes, the RasterCodecs.GetInformationAsyncCompleted event will fire and Info will contain the final and ready to use object. If an error occurs, this property will be set to null and the object is disposed internally by the toolkit.

When an error occur, either the Error property is not a null reference or the Cancelled property is true.

Example

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Svg; 
 
 
public void GetInformationAsyncCompletedExample() 
{ 
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
   Uri uri = new Uri(srcFileName); 
 
   RasterCodecs codecs = new RasterCodecs(); 
 
   // Now get information about the file asynchronously 
   codecs.GetInformationAsyncCompleted += new EventHandler<CodecsGetInformationAsyncCompletedEventArgs>(GetInformationAsyncCompletedExample_GetInformationAsyncCompleted); 
   object imageInfoObject = codecs.GetInformationAsync(uri, true, 1, null); 
 
   // Notice that the returned imageInfoObject is a CodecsImageInfo with IsLoading set to true at this point 
   // The IsLoading will be false (and hence, the object will be usable) when the GetInformationAsyncCompleted 
   // fires. 
} 
 
private void GetInformationAsyncCompletedExample_GetInformationAsyncCompleted(object sender, CodecsGetInformationAsyncCompletedEventArgs e) 
{ 
   if (e.Cancelled) 
   { 
      Debug.WriteLine("User canceled"); 
   } 
   else if (e.Error != null) 
   { 
      Debug.WriteLine("Error: " + e.Error.Message); 
   } 
   else 
   { 
      // Get the image info 
      CodecsImageInfo info = e.Info; 
      Debug.WriteLine("Image info obtainted asynchronously:\n{0}", info.ToString()); 
      info.Dispose(); 
   } 
 
   // Unsubscribe to the event and dispose the RasterCodecs object 
   RasterCodecs codecs = sender as RasterCodecs; 
   codecs.GetInformationAsyncCompleted -= new EventHandler<CodecsGetInformationAsyncCompletedEventArgs>(GetInformationAsyncCompletedExample_GetInformationAsyncCompleted); 
   codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}

 
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 getInformationAsyncCompletedExample() throws URISyntaxException, IOException { 
   final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
   String srcFileName = combine(LEAD_VARS_IMAGES_DIR, "Image1.cmp"); 
   URI uri = Paths.get(srcFileName).toUri(); 
 
   RasterCodecs codecs = new RasterCodecs(); 
 
   // Now get information about the file asynchronously 
   codecs.addGetInformationAsyncCompletedListener(getInformationAsyncCompletedExampleGetInformationAsyncCompleted); 
   ILeadStream uriStream = LeadStreamFactory.create(uri); 
   codecs.getInformationAsync(uriStream, true, 1, null); 
 
   assertTrue("Check that URI exists", uri != null); 
   System.out.println("The URI exists"); 
 
   uriStream.close(); 
} 
 
CodecsGetInformationAsyncCompletedListener getInformationAsyncCompletedExampleGetInformationAsyncCompleted = new CodecsGetInformationAsyncCompletedListener() { 
 
   @Override 
   public void onGetInformationAsyncCompleted(CodecsGetInformationAsyncCompletedEvent e) { 
      if (e.getCancelled()) { 
         System.out.println("User canceled"); 
      } else if (e.getError() != null) { 
         System.out.println("Error: " + e.getError().getMessage()); 
      } else { 
         // Get the image info 
         CodecsImageInfo info = e.getInfo(); 
         System.out.println("Image info obtainted asynchronously:\n" + info.toString()); 
      } 
 
      // Unsubscribe to the event and dispose the RasterCodecs object 
      RasterCodecs codecs = (RasterCodecs) e.getSource(); 
      codecs.removeGetInformationAsyncCompletedListener( 
            getInformationAsyncCompletedExampleGetInformationAsyncCompleted); 
      codecs.dispose(); 
   } 
 
};

Requirements

Target Platforms

Reference

CodecsGetInformationAsyncCompletedEventArgs Class

CodecsGetInformationAsyncCompletedEventArgs Members

Download our FREE evaluation

Help Version 23.0.2024.2.29