PointVisualizer.RingOrientation Property
Gets or sets the desired orientation of polygon rings and closed line features.
Syntax
public RingOrientation RingOrientation { get; set; }Property Value
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 before the point visualizer is applied. This can be necessary if the visualization of the line depends on its direction, for instance if a text label or symbol should be rotated along the line. If a closed line or polygon ring to be rendered has a different orientation, it will be reversed before it is rendered.
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(PointVisualizer pointVisualizer)
{
// 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
// before the point visualizer is applied it. 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.
pointVisualizer.RingOrientation = RingOrientation.Clockwise;
}
}
Platforms
Windows, Linux, Android