Chapter 12. Advanced Topics
151
if no else part is desired. The conditionals nest, so the text in the if and else part
can contain all
%
commands, including conditionals.
Enumerations:
Syntax:
%?xx<alt1|alt2|alt3|...|else>
For tags with multiple values, like Play status, the conditional can hold a list of
alternatives, one for each value the tag can have. Example enumeration:
Example
%?mp<Stop|Play|Pause|Ffwd|Rew>
The last else part is optional, and will be displayed if the tag has no value. The
WPS parser will always display the last part if the tag has no value, or if the list
of alternatives is too short.
Next Song Info
You can display information about the next song – the song that is about to play after
the one currently playing (unless you change the plan).
If you use the upper-case versions of the three tags:
F
,
I
and
D
, they will instead refer
to the next song instead of the current one. Example:
%Ig
is the genre name used in
the next song and
%Ff
is the mp3 frequency.
Note:
The next song information
will not
be available at all times, but will most likely
b
be available at the end of a song. We suggest you use the conditional display tag a lot
when displaying information about the next song!
Alternating Sublines
It is possible to group items on each line into 2 or more groups or “sublines”. Each subline
will be displayed in succession on the line for a specified time, alternating continuously
through each defined subline.
Items on a line are broken into sublines with the semicolon ‘
;
’ character. The display
time for each subline defaults to 2 seconds unless modified by using the ‘
%t
’ tag to
specify an alternate time (in seconds and optional tenths of a second) for the subline to
be displayed.
Subline related special characters and tags:
;
Split items on a line into separate sublines
%t
Set the subline display time. The ‘
%t
’ is followed by either integer seconds (
%t5
),
or seconds and tenths of a second within () e.g. (
%t(3.5)
).
Each alternating subline can still be optionally scrolled while it is being displayed, and
scrollable formats can be displayed on the same line with non-scrollable formats (such
as track elapsed time) as long as they are separated into different sublines. Example
subline definition:
The Rockbox manual
(version rUnversioned directory-141216)
Iaudio M3
