LabelOrganizingSettings.MaximumTextCurvature Property
Gets or sets a value that influences how texts that follow lines are placed.
Syntax
public AttributeVariable< System.Double > MaximumTextCurvature { get; set; }Property Value
Default: 0.0
A maximum angle, in degrees, that a text that follows a line is allowed to curve (ignored when zero). This property has no effect in 3D views.
Remarks
In normal operation the label placement algorithm ignores how much the line curves at the insertion position of a text that follows a line (texts that are generated by a TextVisualizer whose TextVisualizer.FollowLine property has been set to True) due to the performance cost that is required to take the curvature into account.
It is however possible to tell the label placement algorithm that it should prioritize the label candidates so that candidates that curve less are considered before candidates that curve more. This is done by changing the value of MaximumTextCurvature according to the following table:
MaximumTextCurvature | Behavior when placing texts that follow lines |
|---|---|
0 | Default behavior. Curvature is not considered for label placement. |
Greater than 0 and less than 360. | Candidates with less curvature are preferred. Label candidates where the maximum angle between two adjacent characters are greater than the given value in degrees are removed from consideration. |
Greater than or equal to 360. | Candidates with less curvature are preferred. Label candidates are not discarded. |
If curvature is considered, label candidates with maximum angle greater than 90 degrees are considered after candidates with lesser maximum angles that extends beyond the line if those are allowed by the RemoveNonFitting property.
Platforms
Windows, Linux, Android