Managing Rockbox Settings; Introduction To .Cfg Files - SanDisk Sansa Clip v2 Manual

Rockbox firmware manual
Table of Contents

Advertisement

Chapter 13. Advanced Topics
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:
%X(background.bmp)
The image with filename background.bmp is loaded and used in the WPS.
Example on bitmap preloading and use:
%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
%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
files. See section
13.3.3
configuration files.
The Rockbox manual
Example
Example
Example
(page 164) below for an explanation of the format for configuration
(page 164) for an explanation of how to create, edit and load
(version 3.14)
163
Sansa Clip v2

Advertisement

Table of Contents
loading

This manual is also suitable for:

Sansa clip+

Table of Contents