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.
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.
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.
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 |
---|---|---|
Color |
Red | |
HeadType |
||
JoinStyle |
||
BorderColor |
Red | |
CapStyle |
||
Color |
Red | |
Opacity |
255 | |
Width |
2 | |
Padding |
Left:2, Top:2, Right:2, Bottom:2 | |
Padding |
Left: dynamically calculated using icon size, Top:1, Right:1, Bottom:1 | |
TextColor |
Red | |
FontSize |
6 | |
CapStyle |
||
JoinStyle |
||
Color |
Red | |
Opacity |
255 | |
Width |
2 | |
CapStyle |
||
JoinStyle |
||
Color |
Red | |
Arc radius |
50 | |
Width |
2 | |
CapStyle |
||
Color |
Red | |
Width |
2 | |
FontSize |
6 | |
Padding |
Left:2, Top:2 | |
TextColor |
Red | |
Padding |
Left:2, Top:2, Right:2, Bottom:2 | |
TextColor |
Red | |
Padding |
Left:3, Top:3 | |
TextColor |
Red | |
Border |
null | |
Opacity |
255 | |
Highlight |
true | |
FillColor |
Red | |
Highlight |
true | |
FillColor |
Red | |
Highlight |
true | |
Color |
Red | |
Width |
2 | |
BorderColor |
Red | |
BorderColor |
Red | |
BorderColor |
Red | |
FillColor |
Black |
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.