Chapter 13. Advanced Topics
173
Example on background image use:
Example
%X(background.bmp)
The image with filename
background.bmp
is loaded and used in the WPS.
Example on bitmap preloading and use:
Example
%x(a,static_icon.bmp,50,50)
%xl(b,rep_off.bmp,16,64)
%xl(c,rep_all.bmp,16,64)
%xl(d,rep_one.bmp,16,64)
%xl(e,rep_shuffle.bmp,16,64)
%?mm<%xd(b)|%xd(c)|%xd(d)|%xd(e)>
Four images at the same x and y position are preloaded in the example. Which image
to display is determined by the
%mm
tag (the repeat mode).
Example File
Example
%s%?in<%in - >%?it<%it|%fn> %?ia<[%ia%?id<, %id>]>
%pb%pc/%pt
That is, “tracknum – title [artist, album]”, where most fields are only displayed if avail-
able. Could also be rendered as “filename” or “tracknum – title [artist]”.
13.3. Managing Rockbox Settings
13.3.1. Introduction to
.cfg
Files
Rockbox allows users to store and load multiple settings through the use of configuration
files. A configuration file is simply a text file with the extension
.cfg
.
A configuration file may reside anywhere on the disk. Multiple configuration files are
permitted. So, for example, you could have a
car.cfg
file for the settings that you use
while playing your jukebox in your car, and a
headphones.cfg
file to store the settings
that you use while listening to your player through headphones.
See section
(page
) below for an explanation of the format for configuration
files. See section
(page
) for an explanation of how to create, edit and load
configuration files.
13.3.2. Specifications for
.cfg
Files
The Rockbox configuration file is a plain text file, so once you use the
Save .cfg file
option to create the file, you can edit the file on your computer using any text editor
program. See Appendix section
(page
) for available settings. Configuration files
use the following formatting rules:
The Rockbox manual
(version 3.14)
Iaudio M5
