Note that this pattern can't be set via the Pattern menu, but only via action code or Info view. Rather it is set via manual editing of the $Pattern attribute or via actions, rules, etc., acting upon it.
In the simplest usage
displays an arc representing 70% of a complete circle. The circle is always drawn centred on a 9-o'clock position; a 50% completion would fill from 6 through 9 to 12.
Additional optional arguments allow specification of a minimum value, a maximum value, and a target value.
All four inputs may be a literal number, an attribute's value or the result of a simple action code expression.
value is a number (between min and max). Progress - as shown by value - is plotted in $PlotColor.
min is the minimum value number (default: 0).
max is the maximum value number (default: 100).
target (no default) is a desired target value (for value) between min and max and which may be smaller or greater than value. If a target is desired, min and max must also be specified. Target is plotted as two narrow black lines, centred as per the progress bar. From v6.6.0, target is always drawn in $PlotBackgroundColor.
Example with all inputs
ring(70, 0, 100, 50)
where the progress is 70%, exceeding the 50% target. The same could be computed:
ring($MyValueNumber, $MyMinNumber, $MyMaxNumber, $MyTargetNumber)