Toshiba Rockbox F Series - Manual (Page 137)

Chapter 11. Advanced Topics 137
Using Images
You can have as many as 52 images in your WPS. There are various ways of displaying
images:
1. Load and always show the image, using the %x tag
2. Preload the image with %xl and show it with %xd. This way you can have your
images displayed conditionally.
3. Load an image and show as backdrop using the %X tag. The image must be of the
same exact dimensions as your display.
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<%xdb|%xdc|%xdd|%xde>
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]”.
11.3 Managing Rockbox Settings
11.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
The Rockbox manual Toshiba Gigabeat F Series