Specifications

Chapter 13. Advanced Topics 165
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 13.3.2 (page 165) below for an explanation of the format for configuration
files. See section 13.3.3 (page 166) 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 E (page 194) for available settings. Configuration files
use the following formatting rules:
The Rockbox manual (version rUnversioned directory-150517) Iaudio M5