AnnCodecs Object

Provides support for loading and saving objects to annotation files.

Object Model

Syntax

JavaScript
WinRT JavaScript

function Leadtools.Annotations.Core.AnnCodecs()

!MISSING Scrap '_RTJavaScript_Class_SYNTAX'!

Remarks

This class supports loading and saving annotation objects from/to an XML string as well as getting information on previously saved annotations data.

This class also supports saving and loading multi-page annotation data where each page contains a full Annotation Container.

Use the Save method to save an annotation container as XML data. You can then use the browser capabilities to save this XML data to disk or use a Web Service to store it on a server. The SerializeOptions property can be used to set saving options and monitor the objects being saved.

Use the Load method to load an annotation container from XML data. The XML data must be previously loaded from disk using the browser capabilities or obtained from a server using a Web Service. The DeserializeOptions property can be used to set loading options, monitor the objects being loaded and handle errors.

Use the GetInfo to check if an XML data contains valid annotations data such as the format and number of pages.

LEADTOOLS supports saving multiple annotations into the same data. This can be used to save the annotations of a multi-page document in the same data.

Example

JavaScript

example: function SiteLibrary_DefaultPage$example() {
   // Create a new annotation container, 8.5 by 11 inches
   var container = new Leadtools.Annotations.Core.AnnContainer();
   // Size must be in annotation units (1/720 of an inch)
   container.set_size(Leadtools.LeadSizeD.create(8.5 * 720, 11 * 720));

   var inch = 720.0;
   // Add a red line object, from 1in 1in to 2in 2in
   var lineObj = new Leadtools.Annotations.Core.AnnPolylineObject();
   lineObj.get_points().add(Leadtools.LeadPointD.create(1 * inch, 1 * inch));
   lineObj.get_points().add(Leadtools.LeadPointD.create(2 * inch, 2 * inch));
   lineObj.set_stroke(Leadtools.Annotations.Core.AnnStroke.create(Leadtools.Annotations.Core.AnnSolidColorBrush.create("red"), Leadtools.LeadLengthD.create(1)));
   container.get_children().add(lineObj);

   // Add a blue on yellow rectangle from 3in 3in to 4in 4in
   var rectObj = new Leadtools.Annotations.Core.AnnRectangleObject();
   rectObj.set_rect(Leadtools.LeadRectD.create(3 * inch, 3 * inch, 1 * inch, 1 * inch));
   rectObj.set_stroke(Leadtools.Annotations.Core.AnnStroke.create(Leadtools.Annotations.Core.AnnSolidColorBrush.create("blue"), Leadtools.LeadLengthD.create(1)));
   rectObj.set_fill(Leadtools.Annotations.Core.AnnSolidColorBrush.create("yellow"));
   container.get_children().add(rectObj);

   // Show the container
   this.showContainer("Before save", container);

   // Create the codecs object to save and load annotations
   var codecs = new Leadtools.Annotations.Core.AnnCodecs();

   // Save the container
   var xmlData = codecs.save(container, Leadtools.Annotations.Core.AnnFormat.annotations, null, 1);

   // delete the container
   container = null;

   // Show information about the data we just saved
   var info = codecs.getInfo(xmlData);
   var message;
   if (info.get_format() == Leadtools.Annotations.Core.AnnFormat.annotations) {
      message = "Version: ";
      message += info.get_version();
      message += " No. of pages: ";
      message += info.get_pages().length;
      message += " page nos: ";
      for (var i = 0; i < info.get_pages().length; i++) {
         message += info.get_pages()[i] + " ";
      }
   }
   else {
      message = "Invalid annotations data";
   }

   alert(message);

   // Load the container we just saved
   container = codecs.load(xmlData, 1);

   // Show it
   this.showContainer("After load", container);
},

showContainer: function SiteLibrary_DefaultPage$showContainer(message, container) {
   var str = message + "\nContainer size: ";

   // Add the size
   var inch = 720;
   var width = container.get_size().get_width() / inch;
   var height = container.get_size().get_height() / inch;
   str += width + " by " + height + " inches" + "\n";

   // Add the objects
   str += "Contains " + container.get_children().get_count() + " objects(s)\n";
   for (var i = 0; i < container.get_children().get_count(); i++) {
      var annObj = container.get_children().get_item(i);

      str += "Object: " + annObj.get_friendlyName() + " at ";
      for (var j = 0; j < annObj.get_points().get_count(); j++) {
         var pt = annObj.get_points().get_item(j);
         var x = pt.get_x() / inch;
         var y = pt.get_y() / inch;
         str += "(" + x + ", " + y + ") ";
      }

      str += "\n";
   }

   alert(str);
},

AnnCodecs Object

Reference