Chapter 11.
Advanced Topics
135
•
Lines beginning with # are comments and will be ignored.
•
Maximum file size used is 1600 bytes. If you have a bigger WPS file, only the first
part of it will be loaded and used.
Note:
Keep in mind that your player resolution is 240x320x16 (with the last number
b
giving the colour depth in bits) when designing your own WPS, or if you use a WPS
designed for another target.
Conditional Tags
If/else:
Syntax:
%?xx
<
true
|
false
>
If the tag specified by “
xx
” has a value, the text between the “
<
” and the “
|
” is
displayed (the true part), else the text between the “
|
” and the “
>
” is displayed
(the false part). The else part is optional, so the “
|
” does not have to be specified
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.
The Rockbox manual
Toshiba Gigabeat F Series