General questions:

• For which purposes can I use the VintaSoftAnnotation.NET Plug-in?
• From which parts does the plug-in consist?
• In which programming languages can I use the plug-in?
• What restrictions does the unregistered version have?
• I have problems. What should I do?

 

Redistribution:

• What files do I need to include in the setup package of my program?
• Can I re-distribute the Vintasoft.Annotation.dll with my application without royalties?

 

Programming:

• How can I get information about all annotations saved in multipage TIFF file from my program?
• How can I create square annotation? I cannot see such class in the hierarchy.
• How can I know the number of annotations on the image?
• How can I know if an annotation is selected?
• Can I annotate and save each individual page of multipage TIFF file?
• I want to place annotation at the exact position where the person will click on the image, but the annotation is always drawn with some displacement. How can I resolve this?
• Can I rotate Image with annotations?

 

For which purposes can I use the VintaSoftAnnotation.NET Plug-in?

You can use it as a plug-in for VintaSoftImaging.NET Library and it will allow you to work with annotations: create, process, delete, merge with the image, save or load from XML or TIFF file.

 

From which parts does the plug-in consist?

The library contains:

• Vintasoft.Annotation.dll assembly - a 100% .NET assembly
• Documentation in CHM format (VintaSoft.Imaging.chm file)
• Examples for MS Visual Basic.NET, MS Visual C#, ASP.NET (files in the Examples directory)
• Demo applications (files in Bin\v2.0 directory)

 

Redistribution:

With Single Developer license or Site license you can use component in:

• Microsoft Visual Studio .NET : Visual Basic, Visual C#, Visual C++, Visual J#
• Borland Delphi 8.0, Borland C# Builder, Borland C++ BuilderX
• any other languages which are compatible with .NET Framework.

With Server license you can use component in:

• Intranet / internet applications on a server-side (ASP.NET or PHP)

 

What restrictions does the unregistered version have?

Unregistered version has the following restrictions:

• nag screen

All these restrictions are removed in registered version.

 

I have problems. What should I do?

Answers to most of questions can be found in the documentation or in this FAQ. Please write to our support team to get more help.

 

What files do I need to include in the setup package of my program?

You need include two files: VintaSoft.Imaging.dll and VintaSoft.Annotation.dll. These files must be placed in the same folder as the assembly that references it. Make sure that the version you distribute is the version your assembly was compiled with.

 

Can I re-distribute the Vintasoft.Annotation.dll with my application without royalties?

Yes, this component is royalty free. You pay only for registration one time. Only the Vintasoft.Annotation.dll can be re-distributed with your application. Site license has no limitations in re-distribution. Single Developer license has limitation in re-distribution. Server license is not royalty free. Please read the license agreement for more info.

 

How can I get information about all annotations saved in multipage TIFF file from my program?

Here is a simple code:

[VB.NET]
Dim images As ImageCollection = New ImageCollection()
Dim annotations As AnnotationController = new AnnotationController(images)
images.Add("c:\multipage.tif");

For page = 0 To images.Count - 1
  MsgBox("Page " + page.ToString());
  Dim currentAnnotations As AnnotationCollection = annotations(i)
  For anno = 0 To currentAnnotations.Count - 1
    MessageBox.Show("Annotation " + anno.ToString() + _
                    ", Type = " + currentAnnotations(anno).GetType().ToString())
  Next anno
Next page

[C#]
ImageCollection images = new ImageCollection();
AnnotationController annotations = new AnnotationController(images);
images.Add(@"c:\multipage.tif");

for (int page = 0; page < images.Count; page++)
{
  MessageBox.Show("Page " + page.ToString());
  AnnotationCollection currentAnnotations = annotations[i];
  for (int anno = 0; anno < currentAnnotations.Count; anno++)
  {
    MessageBox.Show("Annotation " + anno.ToString() +
                    ", Type = " + currentAnnotations[anno].GetType().ToString());
  }
}

 

How can I create square annotation? I cannot see such class in the hierarchy.

You should create the Rectangle annotation object and set its Symmetry property to True.

 

How can I know the number of annotations on the image?

AnnotationViewer class has the Annotations property - it's an object of the AnnotationController class. AnnotationController object contains information about collection of annotations associated with the image.

 

How can I know if an annotation is selected?

AnnotationViewer class has the SelectedAnnotationChanged event, this event occurs when the selected annotation is changed.

 

Can I annotate and save each individual page of multipage TIFF file?

Here is a simple code:

[C#]
...
  annotationViewer1.Images.ImageSaved += new ImageSavedEventHandler(images_ImageSaved);

  for (int iPageCount = 0; iPageCount < annotationViewer1.Images.Count; iPageCount++)
  {
  annotationViewer1.Annotations.MergeImageWithAnnotations(iPageCount);
  }

  annotationViewer1.Images.Save(@"C:\new.tif");
...

  void images_ImageSaved(object sender, ImageSavedEventArgs e)
  {
  this.Text = e.Progress.ToString();
  }
...

 

I want to place annotation at the exact position where the person will click on the image, but the annotation is always drawn with some displacement. How can I resolve this?

The starting point of annotation is in center of its bounding rectangle, not in the upper left corner. So you need recalculate params of annotation's location with subject to this fact, and this should resolve the issue.

 

Can I rotate Image with annotations?

Here is a simple code:

[C#]
...
  annotationViewer1.Annotations.RotateImageWithAnnotations(0, 10);
...