ImageGear .NET v24.12 - Updated
ART Annotations
User Guide > How to Work with... > ART Mark Annotations > ART Annotations

This section describes the marks available in the ImageGear ART namespace:

ART 3.0 set consists of an enhanced list of more flexible marks. These marks are recommended for new applications. The ART 2.0 (Legacy) set consists of the marks backward compatible with the previous ART versions.

The XML schema used for ART 3.0 annotations is defined in ARTXMLStorage.xsd

Only ART 2.0 marks can be loaded from the .ART files created with previous ART versions, and only ART 2.0 marks can be saved into the legacy ART storage format.

Both ART 2.0 and ART 3.0 marks can be saved into the XML storage format, please note however that ART 2.0 marks will be converted to the appropriate ART 3.0 super class marks. Only ART 3.0 marks are loaded from the XML storage format.

Some ART marks, such as Attach-a-Note, Text Stamp may require Wang compatibility mode enabled to be saved properly in legacy storage format. On the contrary, the Highlighter mark should be saved in legacy format without Wang compatibility mode on. 

ART 2.0 Legacy and some 3.0/2.0 Marks of ImageGear .NET have slightly different default styling properties compared to the ART 2.0 Legacy Marks of ImageGear Pro. If it is necessary to make the appearance of ImageGear .NET Marks similar to ImageGear Pro, you can use the control parameter ImGearART.IsLegacyAppearanceModeEnabled.

Setting this parameter to true prior to importing from legacy format .ART file or creating annotations using the toolbar or API calls will enable legacy appearance mode.

This parameter has an effect for WinForms implementation only, as far as WPF does not have legacy annotations.
Rich Text annotation is displayed transparent if legacy appearance mode is enabled.
For already loaded/created annotations: the switching of this flag will not have any effect. It means that this flag will not dynamically switch appearance of existing marks.

In the case of exporting to legacy .ART format, this parameter will not have any effect.

In the case of exporting to XML format, the modified properties of annotations that were imported/created with the ImGearART.IsLegacyAppearanceModeEnabled flag enabled, will be saved to the XML, so upon loading of that XML, the imported annotations will have the same look as they had upon saving.

Highlight Effect

Some legacy annotations have Boolean property Highlight. When it is set to true, the Highlight effect is applied. This effect is used to highlight the annotated area. The behavior of Highlight effect depends on the value of ImGearART.IsLegacyMarkAppearanceEnabled parameter:

The following table shows the style modifications that will be applied to the marks if ImGearART.IsLegacyAppearanceModeEnabled is set to True:

Mark

Property

Value

Arrow

Color

Red

HeadType

ImGearARTLineHeadType.SOLID

Hollow Polygon

JoinStyle

ImGearARTJoinStyle.Round

BorderColor

Red

Line

CapStyle

ImGearARTCapStyle.Round

Color

Red

Opacity

255

Width

2

Attach-a-Note

Padding

Left:2, Top:2, Right:2, Bottom:2

Pin Up Text

Padding

Left: dynamically calculated using icon size, Top:1, Right:1, Bottom:1

TextColor

Red

FontSize

6

Polyline

CapStyle

ImGearARTCapStyle.Round

JoinStyle

ImGearARTJoinStyle.Round

Color

Red

Opacity

255

Width

2

Protractor

CapStyle

ImGearARTCapStyle.Round

JoinStyle

ImGearARTJoinStyle.Round

Color

Red

Arc radius

50

Width

2

Ruler

CapStyle

ImGearARTCapStyle.Round

Color

Red

Width

2

FontSize

6

Text from File

Padding

Left:2, Top:2

TextColor

Red

Text Stamp

Padding

Left:2, Top:2, Right:2, Bottom:2

TextColor

Red

Typed Text

Padding

Left:3, Top:3

TextColor

Red

Rich Text

Border

null

Opacity

255

Filled Ellipse

Highlight

true

Filled Polygon

FillColor

Red

Highlight

true

Filled Rectangle

FillColor

Red

Highlight

true

Freehand Polyline

Color

Red

Width

2

Hollow Ellipse

BorderColor

Red

Hollow Polygon

BorderColor

Red

Hollow Rectangle

BorderColor

Red

Redaction

FillColor

Black

Ruler and Polyline Ruler Legacy Mode

Additional to visual styles, toggled by ImGearART.IsLegacyAppearanceModeEnabled, the ImGearART.IsLegacyRulerAppearanceModeEnabled flag controls the rendering of start/end elements of ImGearARTRuler and ImGearARTPolyRuler marks. In this mode the start/end line length is not being scaled to device resolution, the start/end elements are being rendered by constant size. By default this mode is turned Off. If you need to enable the ImGearARTRuler/ImGearARTPolyRuler legacy appearance mode, you have to set the ImGearART.IsLegacyRulerAppearanceModeEnabled property to True before creating or importing Ruler or Polyline Ruler annotations. 

ImGearART.IsLegacyRulerAppearanceModeEnabled parameter has an effect for WinForms implementation only.
For already loaded/created annotations: the switching of ImGearART.IsLegacyRulerAppearanceModeEnabled flag will not have any effect. It means that this flag will not dynamically switch appearance of existing marks.
In the case of exporting to legacy .ART or .XML format, ImGearART.IsLegacyRulerAppearanceModeEnabled parameter will not have any effect, as far as it controls rendering only, it does not change any property of the mark.