The parameters work this way:
- value. If used alone it is a percentage, otherwise it is a value between min and max with the bar being set using value as a percentage of max-min (which must thus be specified). Thus
bar(25)is the same as
- min & max. Numerical minimum and maximum values for computing the degree of 'progress' represented in $Color2 by value. Both parameters may be negative numbers; if min is not supplied, a value of 0 is assumed and negative attribute values are plotted as if zero.
- target. The target represents a nominal or desired result. For example, if normally writing between 0 and 4000 words on any given day, it might be useful to set a target at 1500 words/day. If setting a target, a min and max must also be set. The target line is drawn in a dashed link alternating $PlotColor and either $Color or $Color2 )whichever is the current background colour in the postition of the target line.
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
is the same as writing
If the pattern is written without parameters or brackets, it evaluates as if at 50%, e.g.
bar are the same as