LoadSvgAsync(Uri,int,CodecsLoadSvgOptions,object) Method

Summary

Loads a page from a URI containing an image, document or vector file as SVG asynchronously.

Syntax

C++/CLI

Python

public void LoadSvgAsync( 
   Uri uri, 
   int pageNumber, 
   CodecsLoadSvgOptions options, 
   object userState 
)

public: 
void LoadSvgAsync(  
   Uri^ uri, 
   int pageNumber, 
   CodecsLoadSvgOptions^ options, 
   Object^ userState 
)

def LoadSvgAsync(self,uri,pageNumber,options,userState):

Parameters

uri
The Uri containing the input image data.

pageNumber
The 1-based page number.

options
The options used for loading SVG. This can be null.

userState
A user-defined object that is passed to the method invoked when the asynchronous operation completes.

Remarks

NOTE: This topic is part of RasterCodecs Async support using the .NET System.ComponentMode.AsyncOperation model. For .NET async/await, use Task<ISvgDocument> LoadSvgAsync(ILeadStream stream, int pageNumber, CodecsLoadSvgOptions options).

Use this method to load a page from any supported image, document or vector file as SVG (Scalable Vector Graphics). For more information refer LoadSvg(string fileName, int pageNumber, CodecsLoadSvgOptionsOptions).

The RasterCodecs class supports loading image data as SVG asynchronously using the LoadSvgAsync methods. When calling any of these methods, the caller thread will not be blocked and the method will return instantly. When the RasterCodecs object finishes loading the SVG page (or when an error occur), the LoadSvgAsyncCompleted will occur.

The LoadSvgAsyncCompleted event data will contain the SVG page in the CodecsLoadSvgAsyncCompletedEventArgs property.

To determine whether a file or stream can be loaded as SVG, use CanLoadSvg(string fileName) or CanLoadSvg(Stream stream).

To load as SVG asynchronously from a file, use LoadSvgAsync(string fileName, int pageNumber, CodecsLoadSvgOptions options, object userState).

To load as SVG asynchronously from a stream, use LoadSvgAsync(Stream stream, int pageNumber, CodecsLoadSvgOptions options, object userState).

To load as SVG from a file or stream directly, use LoadSvg.

For more information, refer to Working With SVG.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Svg; 
 
 
public void LoadSvgAsyncExample() 
{ 
   // Address of a document thats supports loading as SVG, for example, a DOCX file 
   string address = @"http://localhost/images/examples/leadtools.docx"; 
 
   EventHandler<CodecsLoadSvgAsyncCompletedEventArgs> loadSvgAsyncCompleted = null; 
 
   loadSvgAsyncCompleted = (sender, e) => 
   { 
      var thisCodecs = sender as RasterCodecs; 
      // Remove the handler 
      thisCodecs.LoadSvgAsyncCompleted -= loadSvgAsyncCompleted; 
 
      Debug.WriteLine("Loading from {0} is done", e.Uri); 
      SvgDocument svgDocument = e.Document as SvgDocument; 
 
      if (svgDocument != null) 
      { 
         // Show its size 
         if (!svgDocument.Bounds.IsValid) 
            svgDocument.CalculateBounds(false); 
 
         Debug.WriteLine("Bounds: {0}", svgDocument.Bounds.Bounds); 
         svgDocument.Dispose(); 
      } 
      else if (e.Error != null) 
      { 
         // Error 
         Debug.WriteLine(e.Error.Message); 
      } 
 
      // Clean up 
      thisCodecs.Dispose(); 
   }; 
 
   var codecs = new RasterCodecs(); 
 
   // Set 300 as the default value for loading document files 
   codecs.Options.RasterizeDocument.Load.Resolution = 300; 
 
   codecs.LoadSvgAsyncCompleted += loadSvgAsyncCompleted; 
   codecs.LoadSvgAsync(new Uri(address), 1, null, null); 
}