This version is out of date, covering development from v6.0.0 to v6.6.5. It is maintained here only for inbound reference links from elsewhere. It is no longer actively updated.

Jump to the current version of aTbRef

TinderboxSix Icon

Pattern: ring()

Pattern: ring()

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) 

A Tinderbox Reference File : Visual Styling : Shapes, borders, patterns and fills : Pattern: ring()