Unfortunately WANG format supports just limited set of annotation types and annotation properties and due of this not all Vintasoft annotations and/or their properties can be converted to the WANG format without significant changes. Some of Vintasoft annotation types are not comparable to WANG format, the same way as some annotation properties have no WANG analogs, thus these annotations and such properties cannot be saved to WANG. Also some values of some annotation properties can lead to critical changes in annotation appearance by saving to WANG format; because of that such annotations cannot be saved to WANG format either. In other cases, while converting to WANG, the algorithm selects the most similar annotation types and their properties automatically in order to leave the visual appearance of annotations after saving or loading without significant changes.

Save Vintasoft annotations into WANG packet

Here is a list of annotations, which can be saved into WANG packet:

1. Not rotated (AnnotationData.Rotation == 0) rectangle annotation (RectangleAnnotationData) with transparent color fill (*) and border (AnnotationData.Border == true) will be saved as WANG-annotation "Hollow rectangle".
2. Not rotated (AnnotationData.Rotation == 0) rectangle annotation (RectangleAnnotationData) with non-transparent color fill (*) and without border (AnnotationData.Border == false) will be saved as WANG-annotation "Filled rectangle".
3. Rotated (AnnotationData.Rotation != 0) rectangle annotation (RectangleAnnotationData) with transparent color fill (*) and border (AnnotationData.Border == true) will be saved as WANG-annotation "Hollow polygon"; rectangle will be approximated by a poligon.
4. Rotated (AnnotationData.Rotation != 0) rectangle annotation (RectangleAnnotationData) with non-transparent color fill (*) and without border (AnnotationData.Border == false) will be saved as WANG-annotation "Filled polygon"; rectangle will be approximated by a poligon.
5. Ellipse annotation (EllipseAnnotationData) with transparent color fill (*) and border (AnnotationData.Border == true) will be saved as WANG-annotation "Hollow polygon"; ellipse will be approximated by a poligon.
6. Ellipse annotation (EllipseAnnotationData) with non-transparent color fill (*) and without border (AnnotationData.Border == false) will be saved as WANG-annotation "Filled polygon"; ellipse will be approximated by a poligon.
7. Not rotated (AnnotationData.Rotation == 0) link annotation (LinkAnnotationData) with border (AnnotationData.Border == true) will be saved as WANG-annotation "Attach-a-note".
8. Not rotated (AnnotationData.Rotation == 0) link annotation (LinkAnnotationData) without border (AnnotationData.Border == false) will be saved as WANG-annotation "Typed text".
9. Not rotated (AnnotationData.Rotation == 0) text annotation (TextAnnotationData) with border (AnnotationData.Border = true) will be saved as WANG-annotation "Attach-a-note".
10. Not rotated text annotation (TextAnnotationData) without border (AnnotationData.Border == false) will be saved as WANG-annotation "Typed text".
11. Not rotated highlight annotation (HighlightAnnotationData) will be saved as WANG-annotation "Filled rectangle".
12. Not rotated (AnnotationData.Rotation == 0) and not mirrored (AnnotationData.HorizontalMirrored == false and AnnotationData.VerticalMirrored == false) embedded image annotation (EmbeddedImageAnnotationData) will be saved as WANG-annotation "Image embedded".
13. Lines annotation (LineAnnotationData) will be saved as WANG-annotation "Straight line".
14. Lines annotation (LinesAnnotationData) will be saved as WANG-annotation "Freehand line"; lines with interpolation (LinesAnnotationData.UseInterpolation == true) will be approximated by a polyline.
15. Polygon annotation (PolygonAnnotationData) with transparent color fill (*), border (AnnotationData.Border == true) will be saved as WANG-annotation "Hollow polygon"; polygon with interpolation (LinesAnnotationData.UseInterpolation == true) will be approximated by a polyline.
16. Polygon annotation (PolygonAnnotationData) with non-transparent color fill (*), no border (AnnotationData.Border == false) will be saved as WANG-annotation "Filled polygon"; polygon with interpolation (LinesAnnotationData.UseInterpolation == true) will be approximated by a polyline.
17. Group annotation (GroupAnnotationData) will be saved according to the following below guiding principle. All annotations, members of the group, will be saved in full accordance with presented in this article principles of saving into WANG format. If Name property of annotation group is not empty, then for all saved annotation the field "group name" will be rewritten with the value of this property. If Name property is empty, then the value of field "group name" will be generated with the template "$GroupN", where N is a sequence number of group starting from 1. While loading annotations from WANG packet, annotations with the same value of "group name" field will be merged into one GroupAnnotationData annotation, with value of Name property rewritten to the value of this field.

All other annotations, inclusive those derived from above mentioned, cannot be saved into WANG packet.

(*) The annotation's color fill is counted like transparent by fulfilment of any condition listed below:

• FillBrush property of annotation has value null.
• FillBrush property of annotation has type which differs from AnnotationSolidBrush.
• FillBrush property of annotation has type AnnotationSolidBrush and FillBrush.Color has value Color.Transparent.

While saving annotations is possible partial or total loss of some property values:

1. While saving base annotation (AnnotationData)
   • values of the following properties are saved completely:
     • AnnotationData.CreationTime
     • AnnotationData.IsVisible
     • AnnotationData.Location
     • AnnotationData.Size
   • values of the following properties are saved partially:
     • Only color and thickness of outline (AnnotationData.Outline) is saved. Information about DashStyle, StartCap, EndCap, LineJoin will be lost. The deserialized annotation will have solid outline.
     • Only brush color (AnnotationData.FillBrush) is saved.
   • values of the following properties are lost completely:
     • AnnotationData.CanMove
     • AnnotationData.CanRotate
     • AnnotationData.CanResize
     • AnnotationData.CanMirror
     • AnnotationData.Comment
     • AnnotationData.CreatedBy
     • AnnotationData.HorizontalMirrored
     • AnnotationData.Guid
     • AnnotationData.ModifiedBy
     • AnnotationData.ModifiedTime
     • AnnotationData.Name
     • AnnotationData.Rotation
     • AnnotationData.ToolTip
     • AnnotationData.VerticalMirrored
2. While saving rectangle annotation (RectangleAnnotationData)
   • values of the following properties are lost completely:
     • see the list about lost information for AnnotationData
     • RectangleAnnotationData.Symmetry
     • RectangleAnnotationData.ShadowBrush
     • RectangleAnnotationData.ShadowOffset
3. While saving ellipse annotation (EllipseAnnotationData)
   • values of the following properties are lost completely:
     • see the list about lost information for RectangleAnnotationData
4. While saving link annotation (LinkAnnotationData)
   • values of the following properties are lost completely:
     • see the list about lost information for RectangleAnnotationData
     • LinkAnnotationData.Padding
     • LinkAnnotationData.HoveredLinkAppearance
     • LinkAnnotationData.ClickedLinkAppearance
5. While saving text annotation (TextAnnotationData)
   • values of the following properties are saved partially:
     • see the list about saved information for RectangleAnnotationData
     • For TextAnnotationData.FontBrush property, if it has the type which differs from AnnotationSolidBrush, the information about brush will be lost. The deserialized annotation will have transparent text color - text won't be displayed.
   • values of the following properties are lost completely:
     • see the list about lost information for RectangleAnnotationData
     • TextAnnotationData.FontTransparent
     • TextAnnotationData.TextPadding
     • TextAnnotationData.TextAlign
6. While saving highlight annotation (HighlightAnnotationData)
   • values of the following properties are lost completely:
     • see the list about lost information for RectangleAnnotationData
     • HighlightAnnotationData.BlendingMode
     • AnnotationData.Border
7. While saving line annotation (LineAnnotationData)
   • values of the following properties are lost completely:
     • see the list about lost information for AnnotationData
     • AnnotationData.Location
8. While saving lines annotation (LinesAnnotationData)
   • values of the following properties are lost completely:
     • see the list about lost information for AnnotationData
     • AnnotationData.Location
     • LinesAnnotationData.UseInterpolation
9. While saving polygon annotation (PolygonAnnotationData)
   • values of the following properties are lost completely:
     • see the list about lost information for LinesAnnotationData

Load Vintasoft annotations from WANG packet

1. "Hollow rectangle" annotation is converted to RectangleAnnotationData.
2. "Filled rectangle" annotation is converted either to RectangleAnnotationData or HighlightAnnotationData depending on value of Highlighting field.
3. "Text from file", "Typed text", "Attach-a-note" and "Text stamp" annotations are converted either to TextAnnotationData or LinkAnnotationData depending on presence of hyperlink block.
4. "Straight line" annotation is converted to LineAnnotationData.
5. "Freehand line" annotation is converted to LinesAnnotationData.
6. "Hollow polygon" and "Filled polygon" annotations are converted to PolygonAnnotationData.
7. All loaded annotations with the same value of "group name" field will be merged into one GroupAnnotationData annotation, with value of AnnotationData.Name property rewritten to the value of this field.

While loading annotations from WANG packet takes place initialization of the following annotation's properties:

1. For all annotations loaded from WANG packet
   • the following properties are initialized to default values:
     • AnnotationData.CanMove
     • AnnotationData.CanRotate
     • AnnotationData.CanResize
     • AnnotationData.CanMirror
     • AnnotationData.CreatedBy
     • AnnotationData.HorizontalMirrored
     • AnnotationData.Guid
     • AnnotationData.ModifiedBy
     • AnnotationData.Name
     • AnnotationData.ToolTip
     • AnnotationData.VerticalMirrored
   • AnnotationData.ModifiedTime property is initialized to value of AnnotationData.CreationTime property.
   • AnnotationData.FillBrush property is initialized either to value of AnnotationSolidBrush with annotation's color fill, or to null, if annotation color fill is transparent.
   • AnnotationData.Outline property is initialized to width and color only. AnnotationData.Outline property of some annotations without border (AnnotationData.Border == false) is initialized to default value.
2. For RectangleAnnotationData
   • the following properties are initialized to default values:
     • RectangleAnnotationData.Symmetry
     • RectangleAnnotationData.ShadowBrush
     • RectangleAnnotationData.ShadowOffset
   • value of AnnotationData.Border property would be initialized to true, if WANG-annotation had type "Hollow rectangle", otherwise to false.
3. For HighlightAnnotationData
   • HighlightAnnotationData.BlendingMode property is initialized to BlendingMode.Multiply
   • AnnotationData.Border property is initialized to false.
4. For TextAnnotationData
   • the following properties are initialized to default values:
     • TextAnnotationData.FontTransparent
     • TextAnnotationData.TextPadding
     • TextAnnotationData.TextAlign
   • TextAnnotationData.FontBrush property is initialized to AnnotationSolidBrush with text color.
5. For LinkAnnotationData
   • the following properties are initialized to default values:
     • LinkAnnotationData.Padding
   • LinkAnnotationData.HoveredLinkAppearance and LinkAnnotationData.ClickedLinkAppearance properties are initialized to the same font as LinkAnnotationData.LinkAppearance property.
6. For PolygonAnnotationData annotation
   • value of AnnotationData.Border property would be initialized to true, if WANG-annotation had type "Hollow polygon", otherwise to false.