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:

If it is true, the Highlight effect changes background color of the mark’s underlying elements and image – it applies AND operation for each background and foreground pixel of the annotation.
If it is false (legacy mark appearance is disabled), the Highlight effect makes the current annotation semi-transparent.

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
Hollow Polygon	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
Text from File	TextColor	Red
Text Stamp	Padding	Left:2, Top:2, Right:2, Bottom:2
Text Stamp	TextColor	Red
Typed Text	Padding	Left:3, Top:3
Typed Text	TextColor	Red
Rich Text	Border	null
Rich Text	Opacity	255
Filled Ellipse	Highlight	true
Filled Polygon	FillColor	Red
Filled Polygon	Highlight	true
Filled Rectangle	FillColor	Red
Filled Rectangle	Highlight	true
Freehand Polyline	Color	Red
Freehand Polyline	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.