Specifications

Chapter 13. Advanced Topics 158
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 ZCreateFonts#ConvBdf for more details. Or just run
convbdf without any parameters to see the possible options.
13.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: ZLangFiles
13.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 (160×128×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.
13.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]
The dimensions of the menu that is displayed on the remote control of your player
can be set in the same way. The line to be added to the theme .cfg is the following:
remote 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 13.2.2
(page 160)). Briefly:
The Rockbox manual (version rUnversioned directory-150517) Iaudio M5