Appendix D. Theme Tags
198
D.23. Conditional Tags
Tag
Description
%?xx<true|false>
If / Else: Evaluate for true or false case
%?xx<alt1|alt2|
alt3|...|else>
Enumerations: Evaluate for first / second / third / . . . / last
condition
%if(tag,
operator,
operand, [option
count])
Allows very simple comparisons with other tags.
tag
: the tag to check against.
operator
: the comparison to perform - possible options are
=, !=, >, >=, <, <=
operand
: either a second tag, a number, or text.
[option count]
: optional parameter used to select which pa-
rameter of a tag to use when the tag has multiple options, e.g.
%?pv<a|b|c|d>
%and(tag1, tag2,
..., tagN)
Logical “and” operator. Will be evaluate to true if all the tag
parameters are true.
%or(tag1, tag2,
..., tagN)
Logical “or” operator. Will be evaluate to true if any of the
tag parameters are true.
Examples of the %if tag:
%?if(%pv, >=, 0)<Clipping possible|Volume OK>
will display “Clipping possible”
if the volume is higher than or equal to 0 dB, “Volume OK” if it is lower.
%?if(%ia, =, %Ia)<same artist>
– this artist and the next artist are the same.
Note:
When performing a comparison against a string tag such as %ia, only = and !=
b
work, and the comparison is not case sensitive.
D.24. Subline Tags
Tag
Description
%t(time)
Set the subline display cycle time (%t(5) or %t(3.4) formats)
;
Split items on a line into separate sublines
Allows grouping of several items (sublines) onto one line, with the display cycling
round the defined sublines. See section
(page
) for details.
The Rockbox manual
(version 3.14)
Iaudio M5