Tinderbox 8 Icon

Pattern: ring()

Pattern: ring()

Note that this pattern cannot be set via the Interior Inspector, use the Plot Inspector. The pattern requires configuration via its parameters. This pattern can be used in shaped notes.

ring(value[,min,max,target])

In the simplest usage

ring(70) 

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. 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)