DRAFT
VERSION
C
HAPTER
8. A
DVANCED
T
OPICS
49
/.rockbox
folder, it will be remembered and used after reboot. The
.wps
file-
name must be no more than 24 characters long for it to be remembered.
8.2.2. WPS – Build Your Own
Quite simply, enter the WPS code in your favourite text editor, Notepad on Windows
works fine. When you save it, instead of saving it as a
.txt
file, save it as a
.wps
file. Example: Instead of
Rockbox.txt
, save the file as
Rockbox.wps
. To make sure
non english characters display correctly in your WPS you must save the .wps file with
UTF-8 character encoding. This can be done in most editors, for example Notepad in
Windows 2000 or XP (but not in 9x/ME) can do this. See appendix section
B
(page
61
)
for all the tags that are available.
•
All characters not preceded by % are displayed as typed.
•
Lines beginning with # are comments and will be ignored.
•
Maximum file size used is 400 bytes. If you have a bigger WPS file, only the first
part of it will be loaded and used.
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:
E
XAMPLE
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).
T
HE
R
OCKBOX MANUAL
A
RCHOS
S
TUDIO
/P
LAYER
