Atalasoft Knowledgebase : Annotations : Storage

Add annotations to a Pdf without rasterizing

Stewart Basler-Francis — Wed, 15 May 2013 09:44:00 GMT

Abstract:

Using our PdfAnnotationDataExporter allows you to export your annotations over your pdf without altering the underlying pdf. This allows you to add annotations over an already searchable pdf and to leave a non-image pdf at its already small file size. Here is a snippit of code that uses the exporter on a pdf:

//Best practices is to encode our PDF first and then export the annos over the top.
//If you haven't created your PDF yet, do so now. If you're annotating over an existing PDF, acquire a Stream to it.

Stream saveDoc = Stream.Null; //This will be our stream that contains the PDF. Can be any kind of seekable stream.
//Just make sure you don't leave it as Stream.Null.
saveDoc.Position = 0;

//Get our generated pagecount. Note: we're resetting our filestream position after each access.
int pageCount = RegisteredDecoders.GetImageInfo(saveDoc).FrameCount;
saveDoc.Position = 0;

SizeF[] sizes =

Transparent Highlight Annotations in PDF

Stewart Basler-Francis — Wed, 21 Nov 2012 07:05:00 GMT

Abstract:

Some annotation features offered by AnnotationUI objects may be incompatible with particular image formats. A translucent RectangleAnnotation embedded in a PDF, for instance, renders as an opaque annotation in most PDF viewing applications.

We can sometimes get around limitations like this by substituting incompatible annotations with annotations that support more of the desired features. The code below demonstrates how to convert all the translucent RectangleAnnotations in a LayerCollection into a suitable PdfMarkupAnnotation with similar properties.

public static AnnotationDataCollection ConvertForPdfExport(LayerCollection origLayers)
{
AnnotationDataCollection annotationData = new AnnotationDataCollection();

foreach (LayerAnnotation layer in origLayers)
{
LayerAnnotation convertedLayer = new LayerAnnotation();
foreach (AnnotationUI anno in layer.Items)
{
if (anno is RectangleAnnotation)
{
RectangleAnnotation rectangleAnno = anno as RectangleAnnotation;
if (rectangleAnno != null && rectangleAnno.Translucent)
{
PdfMarkupAnnotation replacementAnno = new PdfMarkupAnnotation(null, PdfMarkupType.Highlight);
&

Embed XMP data into a TIFF file.

Robin Sale — Tue, 13 Mar 2012 06:26:00 GMT

Abstract:

This document is for DotAnnotate 5.0 or higher. Instructions for earlier versions can be found at http://www.atalasoft.com/KB/article.aspx?id=10111.

XMP annotation data can be embedded into a TIFF file rather than saving it as a separate file. This is done by saving the annotations into an XMP packet with the XmpFormatter and embedding the data into the XMP TIFF tag. Below is a code example:

[C#]using Atalasoft.Annotate;using Atalasoft.Annotate.UI;using Atalasoft.Annotate.Formatters;using Atalasoft.Imaging;using Atalasoft.Imaging.Codec;using System.IO;//...private void SaveXmpToTiff(Stream outputStream, AnnotateViewer viewer){  SaveXmpToTiff(outputStream, viewer.Annotations, viewer.Image);}private void SaveXmpToTiff(Stream outputStream, AnnotationController controller, AtalaImage image){  // Create an XmpFormatter and tell it to create a packet.  // Packets are required when embedding the data into an image.  XmpFormatter formatter = new XmpFormatter();  formatter.CreateXmpPacket = true;
  // Create a TiffEncoder and set its Xmp property to the annotation data.  TiffEncoder tif = new TiffEncoder();  tif.Xmp = controller.Save(formatter);
  // Save the Tiff.  tif.Save(outputStream, image, null);}[VB.NET]Imports Atalasoft.AnnotateImports Atalasoft.Annotate.UIImports Atalasoft.Annotate.FormattersImports Atalasoft.ImagingImports Atalasoft.Imaging.CodecImports System.IO'...Private Sub SaveXmpToTiff(ByVal outputStream As Stream, ByVal viewer As AnnotateViewer)  SaveXmpToTiff(outputStream, viewer.Annotations, viewer.Image)End Sub Private Sub SaveXmpToTiff(ByVal outputStream As Stream, ByVal controller As AnnotationController, ByVal image As AtalaImage)  ' Create an XmpFormatter and tell it to create a packet.  ' Packets are requi

Freehand Annotations Embedded into PDF Don''t Render As Expected

Robin Sale — Tue, 18 Oct 2011 08:56:00 GMT

Abstract:

When you create various annotations (notably Freehand)in our annotation aware viewers and embed them into PDF files, you would expect that re-opening them in our annotation viewers would have them render the same as they looked when they went in. (In other words, that annotations created in our viewers would properly "Round-trip" to embedded PDF annotations and back).

This happens because by default, when embedding annotations into a PDF using our PDFAnnotationExporter, it tries to only include properties available withing native PDF annotation for the types that you're embedding. This helps to ensure that all PDF readers will see the annotations the same way. However, a side effect is that the embedded annotations no longer contain all settings that were present at creation time. This can lead to annotations that "look wrong" when re-opened as seen in the example images.


Annotation You Saved	Annotation You See

You can override this default behavior by setting the PdfAnnotationDataExporter.AlwaysEmbedAnnotationData property to TRUE.

Note that this means that some PDF viewers may not render the annotations in exactly the same way, but it will ensure that DotImage does.

Autosave Web Text Annotation edits without hiding the editor

Elaine Gorham — Fri, 06 May 2011 10:31:00 GMT

Abstract:

Problem: User edits text and does not hide the editor by clicking off the annotation. The text then does not persist on the server when a RemoteInvoke is done (like saving the annotations to a file or database).

Solution: Keep track of text changes and force the annotation to update after a period of inactivity. In this example, we'll update after 1 second.

Atalasoft.Utils.InitClientScript(myPageLoad);

function myPageLoad() {

WebAnnotationViewer1.AnnotationEditorShown = OnEditorShown;

}

function OnEditorShown(e) {

if (e.annotation && e.annotation.getType() == 'TextData') {
AutoSaveTextEdits(e.annotation);
}

}

function AutoSaveTextEdits(ann) {

var _ann = ann;
This article is designed to be used with the Load methodology described in this KB article http://www.atalasoft.com/KB/article.aspx?id=10308
Jpeg and Tiff formats allow for custom tags to be added during encoding. This allows a user of DotImage to embed XMP annotation data into an image file using the JpegEncoder or TiffEncoder. The example below is an abstractified version of saving that removes the role of the AnnotationController. This allows the same code to be used to save and load in different viewers.
C#
public void Save(System.IO.Stream s, Atalasoft.Imaging.AtalaImage image, Atalasoft.Annotate.UI.LayerCollection layers)
This article is designed to do the loading when using this article’s Save() methodology http://www.atalasoft.com/KB/article.aspx?id=10274&cNode=0I8H4F
To load annotations from an embedded source (either Tiff or Jpeg), the LayerCollection must be Imported from the stream. Here is a method to convert from the stream to an object that contains a ImageCollection and a LayerCollection:
C#
public AnnotationLoadResults Load(System.IO.Stream s)
{
XmpAnnotationDataImporter imp = new
<rdf:Description about="" xmlns:ann="http://ns.atalasoft.com/annotate/1.0/">

The annotation data is placed inside this rdf:Description and follows the attached schema. There can be any number of Layer objects, each containing any number of annotations.

Cursors, Fonts and Images are stored serialized in hex format; all other values are stored as strings.

The Type tag for Brush objects has the following values:

0 = Solid Brush
1 = Hatch Brush
2 = Texture Brush
3 = Linear Gradient Brush

All other tags represent properties of their respective object.

Save and Load annotation data for multipage tiff files

Kevin Hulse — Tue, 08 Sep 2009 15:00:00 GMT

Abstract:

There are many different ways to save annotation data for a multi page file. One of the best ways to do this is by saving the annotation data as metadata into a tiff tag. With the help of the class TiffFile, this is acctualy really simply to do.

When saving the annotation data, once you have the data into byte array form('data' in this case), this is all you need to do:

[C#]
FileStream tiffStream = new FileStream(@"..\..\image.tif", FileMode.Open, FileAccess.ReadWrite);
TiffFile tf = new TiffFile();
tf.Read(tiffStream);
TiffTagCollection tagCol = new TiffTagCollection();
tagCol = tf.Images[i].Tags;
TiffTag tag = tagCol.LookupTag(TiffTagID.WangAnnotationData);
if (tag != null)
tagCol.Remove(tag);
tag = new TiffTag(TiffTagID.WangAnnotationData, data, TiffTagDataType.Byte);
tagCol.Add(tag);
// save the tifffile
string tempPath = System.IO.Path.GetTempFileName();
tf.Save(tempPath);
tiffStream.Close();
File.Copy(tempPath, @"..\..\image.tif", true);

When loading the data into the annotate viewer, this requires a few more steps. Remember to set the MultipageAnnotateMode property to true, so that the viewer knows to switch the annotation layers with the images. The coralation between the layer index number and the image inde

Save XMP annotation data into a TIFF file

Kevin Hulse — Tue, 08 Sep 2009 14:40:00 GMT

Abstract:

This article is for DotAnnotate 4.0 or earlier. Instructions for version 5.0 and later can be found at http://www.atalasoft.com/KB/article.aspx?id=10220.

Use the Save method of the AnnotationController (or AnnotateViewer.Annotations) to get the annotation data. Once you have the data, set the TiffEncoder.Xmp property and save the image. Here is an example:

[C#]
// Save the annotation data to XMP format.
byte[] data = this.annotateViewer1.Annotations.Save();

// Add the XMP data to a TiffEncoder.
Atalasoft.Imaging.Codec.TiffEncoder tif = new Atalasoft.Imaging.Codec.TiffEncoder();
tif.Xmp = data;

// Save the file.
this.annotateViewer1.Save(@"C:\myfile.tif", tif);

--------------------------------------------------------------

[Visual Basic]
' Save the annotation data to XMP format.
Dim data() As Byte = Me.annotateViewer1.Annotations.Save()

' Add the XMP data to a TiffEncoder.
Dim tif As Atalasoft.Imaging.Codec.TiffEncoder = New Atalasoft.Imaging.Codec.TiffEncoder()
tif.Xmp = data

' Save the file.
Me.annotateViewer1.Save("C:\myfile.tif", tif)

Burn transparent Annotations on a 1 bit Image

Kevin Hulse — Tue, 08 Sep 2009 14:39:00 GMT

Abstract:

So, you think that transparency is impossible with 1 bit images? Well, you're right. But that doesn't mean that we can't fake it. A clever trick is to burn the annotation, with transparency, into an 8-bit greyscale image. Then convert that image to 1 bit. This will create the illusion that the annotation is transparent.

For this example I started off with an 8-bit greyscale image and drew a red rectangleAnnotation with alpha value of 100. The Code for this is simply,

[C#]

this.annotateViewer1.Annotations.CreateAnnotation(new RectangleAnnotation(new Pen(Color.Red),new SolidBrush(Color.FromArgb(100, 255,0,0))));

[VB.NET]

Me.annotateViewer1.Annotations.CreateAnnotation(New RectangleAnnotation(New Pen(Color.Red),New SolidBrush(Color.FromArgb(100, 255,0,0))))

Next, I burned the annotation onto the greyscale image. Finally, I converted the Image to 1-bit.

[C#]

this.annotateViewer1.Burn();
foreach(Layer l in this.annotateViewer1.Annotations.Layers)
this.annotateViewer1.Refresh();
AtalaImage tmpImage = this.annotateViewer1.Image;
this.annotateViewer1.Image = tmpImage.GetChangedPixelFormat(PixelFormat.Pixel1bppIndexed);

[VB.NET]

Save and retrieve an image with XMP Annotations

Kevin Hulse — Tue, 08 Sep 2009 09:36:00 GMT
Abstract:
When integrating DotAnnotate with DotImage, XMP annotations can be stored and loaded from a TIFF or JPEG image. Saving annotations to XMP and embedding into an image requires setting the XMP property of the TIFF or JPEG codec. The following is a VB example of saving an image with Annotations using the SaveFileDialog to specify the filename.
Dim xmpBytes As Byte() = Me.AnnotateViewer1.Annotations.Save()
Dim tiff As Codec.TiffEncoder = New Codec.TiffEncoder(Codec.TiffCompression.Group4FaxEncoding)
tiff.Xmp = xmpBytes
Dim fs As SaveFileDialog = New SaveFileDialog
If fs.ShowDialog(Me) = DialogResult.OK Then
Me.AnnotateViewer1.Save(fs.FileName, tiff)
End If
To load the image with annotations back into the Viewer, use the XMP Parser as follows:
Dim fd As OpenFileDialog = New OpenFileDialog
If fd.ShowDialog(Me) = DialogResult.OK Then
Me.AnnotateViewer1.Open(fd.FileName)
Dim parse As XmpParser = New XmpParser
Dim xmpData As Byte() = parse.BytesFromImage(fd.FileName)
Me.AnnotateViewer1.Annotations.Load(xmpData, Atalasoft.Imaging.Annotate.AnnotationDataFormat.Xmp)
End If

Burning annotations with the WebAnnotationViewer

Kevin Hulse — Tue, 08 Sep 2009 09:27:00 GMT
Abstract:
This code sample shows how you can burn all of the annotations contained in the WebAnnotationViewer's LayerCollection onto an AtalaImage.
AtalaImage img = BurnAnnotations(this.WebAnnotationViewer1.Annotations.Layers, this.WebAnnotationViewer1.Image);
// Burns the given LayerCollection onto the given image if possible
// otherwise, burns the LayerCollection onto a copy of the given image
private AtalaImage BurnAnnotations(LayerCollection layers, AtalaImage image)
{
AtalaImage burn = image;
if (burn != null)
{
// Can't render annotations on indexed PixelFormats
if (burn.PixelFormat != PixelFormat.Pixel24bppBgr && burn.PixelFormat != PixelFormat.Pixel32bppBgra)
{
ChangePixelFormatCommand cmd = new ChangePixelFormatCommand(PixelFormat.Pixel32bppBgra);
burn = cmd.Apply(image).Image;
}
RenderEnvironment re = new RenderEnvironment(RenderDevice.Display, burn.GetGraphics(), new PointF(1, 1), AnnotationUnit.Pixel, null, new PointF((float)image.Resolution.X, (float)image.Resolution.Y));
foreach (LayerAnnotation layer in layers)
{
foreach (AnnotationUI ann in layer.Items)
{
IAnnotationRenderer renderer = AnnotationRenderers.Get(ann.Data.GetType());
rendere

Atalasoft Knowledgebase : Annotations : Storage

Add annotations to a Pdf without rasterizing

Transparent Highlight Annotations in PDF

Embed XMP data into a TIFF file.

Freehand Annotations Embedded into PDF Don''t Render As Expected

Autosave Web Text Annotation edits without hiding the editor

Save and Load annotation data for multipage tiff files

Save XMP annotation data into a TIFF file

Burn transparent Annotations on a 1 bit Image

Save and retrieve an image with XMP Annotations

Burning annotations with the WebAnnotationViewer