Image Property

Summary

Gets the RasterImage class instance that is being loaded.

Syntax

C++/CLI

Java

Python

public RasterImage Image { get; }

public RasterImage getImage()

public: 
property RasterImage^ Image { 
   RasterImage^ get(); 
}

Image # get  (CodecsLoadAsyncCompletedEventArgs)

Property Value

A RasterImage object that is being loaded, or a null reference if an error occurred. The default value is null.

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 instance is the same object returned from the RasterCodecs.LoadAsync 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 image data and should not be used. When the asynchronous operation completes, the RasterCodecs.LoadAsyncCompleted event will fire and Image 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 LoadAsyncCompletedExample() 
{ 
   string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
   Uri uri = new Uri(srcFileName); 
 
   RasterCodecs codecs = new RasterCodecs(); 
 
   // Now load the image asynchronously 
   codecs.LoadAsyncCompleted += new EventHandler<CodecsLoadAsyncCompletedEventArgs>(LoadAsyncCompletedExample_LoadAsyncCompleted); 
   object rasterImageObject = codecs.LoadAsync(uri, null); 
 
   // Notice that the returned rasterImageObject is a RasterImage with IsLoading set to true at this point 
   // The IsLoading will be false (and hence, the object will be usable) when the LoadAsyncCompleteted 
   // fires. 
} 
 
private void LoadAsyncCompletedExample_LoadAsyncCompleted(object sender, CodecsLoadAsyncCompletedEventArgs e) 
{ 
   if (e.Cancelled) 
   { 
      Debug.WriteLine("User canceled"); 
   } 
   else if (e.Error != null) 
   { 
      Debug.WriteLine("Error: " + e.Error.Message); 
   } 
   else 
   { 
      // Everything is OK, get the image 
      RasterImage image = e.Image; 
      Debug.WriteLine("Image at {0} loaded OK, size: {1} by {2}", e.Uri, image.Width, image.Height); 
      image.Dispose(); 
   } 
 
   // Unsubscribe to the event and dispose the RasterCodecs object 
   RasterCodecs codecs = sender as RasterCodecs; 
   codecs.LoadAsyncCompleted -= new EventHandler<CodecsLoadAsyncCompletedEventArgs>(LoadAsyncCompletedExample_LoadAsyncCompleted); 
   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 loadAsyncCompletedExample() throws IOException, URISyntaxException { 
   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 load the image asynchronously 
   codecs.addLoadAsyncCompletedListener(loadAsyncCompletedExampleLoadAsyncCompleted); 
   ILeadStream uriStream = LeadStreamFactory.create(uri); 
 
   assertTrue("Check that URI exists", uri != null); 
   System.out.println("The URI exists"); 
 
   uriStream.close(); 
} 
 
CodecsLoadAsyncCompletedListener loadAsyncCompletedExampleLoadAsyncCompleted = new CodecsLoadAsyncCompletedListener() { 
 
   @Override 
   public void onLoadAsyncCompleted(CodecsLoadAsyncCompletedEvent e) { 
      if (e.getCancelled()) { 
         System.out.println("User canceled"); 
      } else if (e.getError() != null) { 
         System.out.println("Error: " + e.getError().getMessage()); 
      } else { 
         // Everything is OK, get the image 
         RasterImage image = e.getImage(); 
         System.out.printf("Image loaded OK, size: %s by %s%n", image.getWidth(), image.getHeight()); 
         image.dispose(); 
      } 
 
      // Unsubscribe to the event and dispose the RasterCodecs object 
      RasterCodecs codecs = (RasterCodecs) e.getSource(); 
      codecs.removeLoadAsyncCompletedListener(loadAsyncCompletedExampleLoadAsyncCompleted); 
      codecs.dispose(); 
   } 
 
};

Requirements

Target Platforms

Reference

CodecsLoadAsyncCompletedEventArgs Class

CodecsLoadAsyncCompletedEventArgs Members

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.Codecs Assembly

Introduction

Getting Started

Namespaces

Leadtools.Codecs Namespace

Assemblies