Chapter 12. Advanced Topics
153
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]”.
12.3. Managing Rockbox Settings
12.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
12.3.2
(page
153
) below for an explanation of the format for configuration
files. See section
12.3.3
(page
154
) for an explanation of how to create, edit and load
configuration files.
12.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
183
) for available settings. Configuration files
use the following formatting rules:
1. Each setting must be on a separate line.
2. Each line has the format “setting: value”.
3. Values must be within the ranges specified in this manual for each setting.
The Rockbox manual
(version rUnversioned directory-141216)
Iaudio M3
