Chapter 12. Advanced Topics
146
Note:
Advanced Users Only: Any BDF font should be usable with Rockbox. To convert
b
from
.bdf
to
.fnt
, use the
convbdf
tool. This tool can be found in the
tools
directory
of the Rockbox source code. See
Z
CreateFonts#ConvBdf
for more details. Or just run
convbdf
without any parameters to see the possible options.
12.1.4. Loading Languages
Rockbox can load language files at runtime. Simply copy the
.lng
file
(do not use the
.lang file)
to the player and “play” it in the Rockbox directory browser or select
Set-
tings
→
General Settings
→
Language
from the
Main Menu
.
Note:
If you want a language to be loaded automatically every time you start up, it
b
must be located in the
/.rockbox/langs
directory and the filename must be a maximum
of 24 characters long.
If your language is not yet supported and you want to write your own language file
find the instructions on the Rockbox website:
Z
LangFiles
12.1.5. Loading Backdrops
Rockbox supports showing an image as a backdrop in the
File Browser
and the menus.
The backdrop image must be a
.bmp
file of the exact same dimensions as the display in
your player (128
×
96
×
2 with the last number giving the colour depth in bits). To use an
image as a backdrop browse to it in the
File Browser
and open the
Context Menu
(see section
4.1.2
(page
23
)) on it and select the option
Set As Backdrop
. If you want
rockbox to remember your backdrop the next time you start your player the backdrop
must be placed in the
/.rockbox/backdrops
directory.
12.1.6. UI Viewport
By default, the UI is drawn on the whole screen. This can be changed so that the UI is
confined to a specific area of the screen, by use of a UI viewport. This is done by adding
the following line to the
.cfg
file for a theme:
ui viewport:
X,Y,[width],[height],[font],[fgshade],[bgshade]
Only the first two parameters
have
to be specified, the others can be omitted using
‘-’ as a placeholder. The syntax is very similar to WPS viewports (see section
12.2.2
(page
148
)). Briefly:
•
‘fgshade’ and ‘bgshade’ are numbers in the range 0 (= black) to 3 (= white).
•
‘font’ is a number: 0 is the built-in system font, 1 is the user-selected font.
The Rockbox manual
(version rUnversioned directory-141216)
Iaudio M3