LineVisualizer.RingOrientation Property
Get or sets the desired orientation of polygon rings and closed line features.
Thread safety: This property is not thread-safe. Show
Syntax
public RingOrientation RingOrientation { get; set; }Property Value
Type: RingOrientation
Default: Any
A value that specifies the desired orientation of polygon rings and closed line features.
Default: Any
A value that specifies the desired orientation of polygon rings and closed line features.
Remarks
This property can be used to force a certain orientation, clockwise or counterclockwise, of polygon rings and closed lines. This can be necessary if the visualization of the line depends on its direction, for instance if OrthogonalOffset is used. If a closed line or polygon ring to be rendered has a different orientation, it will be reversed before it is rendered.
Note
Polygon outlines will get the orientation as specified by this property, while polygon holes will get the opposite orientation. This means that the inside of the polygon will always be to the right (clockwise) or left (counterclockwise) of the line/ring being rendered.
Example
// Set the ring orientation to clockwise
public static void SetClockwiseOrientation(LineVisualizer lineVisualizer)
{
// This property is a member of a type that might be referred to by a View
// or a GlobeView, either directly or indirectly through other objects, which means
// that you must use the Guard class to take the global configuration lock when it
// is modified to synchronize access with any running Carmenta Engine threads.
using (Guard guard = new Guard())
{
// This will ensure that closed line features are always oriented clockwise.
// If the feature to be visualized is not clockwise oriented, the point order
// will be reversed before the feature is visualized. If a polygon feature is
// visualized, the outline will also be clockwise, while all holes will be
// counterclockwise, i.e. the inside of the polygon will always be to the right
// of the line.
lineVisualizer.RingOrientation = RingOrientation.Clockwise;
}
}
Platforms
Windows, Linux, Android