RadialLegend
(Meter Parts Library)
Description: | Draws a legend (i.e. the text labels) for a radial type meter. They are drawn at a constant radius from the center point of the drawing coordinates, beginning at a defined minimum angle and ending at a defined maximum angle. To be called from within a GUITransform. |
Returns: | Nothing |
Usage: | Steady State only. |
Function Groups: | Graphics |
Related to: | GUITransform | RadialLegend |
Format: | \MeterParts\RadialLegend(TagName[, MinimumAngle, MaximumAngle, NumLabels, Font, Color, Direction, Orientation, UseTagScaling, MinScaleValue, MaxScaleValue]) |
Parameters: |
TagName |
Required. The name of the Tag to use for scaling. If no tag is specified, then tag scaling cannot be used to automatically obtain the minimum and maximum scale values. |
MinimumAngle |
The start angle of the sweep. 0 is defined as up or the 12 o’clock position. The default is 225. |
MaximumAngle |
The end angle of the sweep. 0 is defined as up or the 12 o’clock position. The default is 135. |
NumLabels |
The number of Labels to show. The default is 5. |
Font |
The name of a font tag to use for the legend text. |
Color |
A color index for the color of the legend text. The default is 0 (black). |
Direction |
A flag indicating the direction from the minimum to the maximum value representation. 0 means increase in a clockwise manner while 1 indicates a counter-clockwise manner. The default is 0 (clockwise). |
Orientation |
A reserved parameter and should be set to 0. |
UseTagScaling |
A flag that indicates whether to use the supplied Tag’s scaling values. The default is false. |
MinScaleValue |
The minimum scale value to use if the UseTagScaling flag is not true. The default is 0. |
MaxScaleValue |
The maximum scale value to use if the UseTagScaling flag is not true. The default is 100. |
Comments: | This function must be called within a GUITransform statement in order for it to work correctly. The text should scale with the size of the transform, if it does not, then you might have picked a font that doesn’t scale. Some non true-type fonts won’t scale. |
Example:
GUITransform(478, 616, 628, 466,
1, 1, 1, 1, 1 { Scaling },
0, 0 { Movement },
1, 0 { Visibility, Reserved },
0, 0, 0 { Selectability },
\MeterParts\RadialLegend(Invalid, 225, 135, 5, Invalid,
0, 0, 0, 0, 0, 100));