Collapse All Expand All

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

• ART 3.0/ART 2.0 Marks
• ART 2.0 Legacy Marks

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.

ART 2.0 Legacy and some 3.0/2.0 Marks of ImageGear for .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 for .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 using toolbar or function calls will enable legacy appearance mode.

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
	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. 

 

 

---

©2014. Accusoft Corporation. All Rights Reserved.

Send Feedback