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 this attribute or via actions, rules, etc., acting upon it.
vbar(value,[min],[max]). The draws as a vertical 'progress bar', using $Color and $Color2. The 'progress' block is drawn in $Color2.
The parameters work this:
- value. If used alone it is a percentage, otherwise it is a value between min and max with the vbar being set using value as a percentage of max-min (which must thus be specified). Thus
vbar(25)
is the same asbar(37.5,25,75)
. - min & max. Numerical minimum and maximum values for computing the degree of 'progress' represented in $Color2 by value; if min is not supplied, a value of 0 is assumed and negative attribute values are plotted as if zero.
The arguments in the brackets may be numbers or expressions that can be evaluated as numbers. As $Pattern is a string parameter, remember to enclose the statement in quotes so the program coerces the output to a string. If a note's $Width is 3.0, then vbar(15*$Width)
is the same as writing vbar(45)
.
If the pattern is written without parameters or brackets, it evaluates as if at 50%, e.g. vbar()
and vbar
are the same as vbar(50)
.