The Polyline Ruler mark enables the end user to create a polyline (several connected straight lines) that displays its total length.

Edit Mode

In Edit mode, end users create this mark as follows:

1. Click the Polyline Ruler button.
2. Click at the point where the polyline ruler starts.
3. Drag to the location of a vertice and click to create the vertice.
4. Drag and click to create each additional vertice.
5. Double-click the location where the polyline ruler ends.
6. Right-click the mark after it is created to activate the popup Edit menu.   

Polyline Ruler Length Measuring Modes

ImageGear provides two different length measuring modes for Ruler and PolyRuler annotations – Absolute and Relative, which can be changed using ImGearARTPage.AspectKind property.

• Absolute – In this mode, a change to the resolution of the underlying image will not affect the physical measurements of your marks (such as length of the ruler or poly-ruler) on the screen. The physical measurements of your marks on the screen are absolute.

If the physical measurements of your marks need to reflect the changes to the resolution of the underlying image, you should work with pages and marks in Relative mode instead.

• Relative – In this mode, a change to the resolution of the underlying image will affect the physical measurements of your marks (such as length of the ruler or poly-ruler) on the screen. The physical measurements of your marks on the screen are relative to the resolution of the underlying image.

If the physical measurements of your marks need to remain constant regardless of the resolution of the underlying image, you should work with pages and marks in Absolute mode instead.