Ui Viewport; Configuring The Theme; Themeing - General Info - Toshiba Gigabeat F Manual

Rockbox firmware manual
Table of Contents

Advertisement

Chapter 12. Advanced Topics
Menu (see section
4.1.2
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.7. 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],[fgcolour],[bgcolour]
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
(page 192)). Briefly:
'fgcolour' and 'bgcolour' are 6-digit RGB888 colours, e.g. FF00FF.
'font' is a number: 0 is the built-in system font, 1 is the user-selected font.
ui viewport: 15,20,100,150,-,-,-
This displays the menu starting at 15px from the left of the screen and 20px from the top
of the screen. It is 100px wide and 150px high. The font and the foreground/background
colours are defined in the theme .cfg file or in the Theme Settings menu.
12.2. Configuring the Theme
12.2.1. Themeing – General Info
There are various different aspects of the Rockbox interface that can be themed – the
WPS or While Playing Screen, the FMS or FM Screen (if the player has a tuner),
and the SBS or Base Skin. The WPS is the name used to describe the information
displayed on the player's screen whilst an audio track is being played, the FMS is the
screen shown while listening to the radio, and the SBS lets you specify a base skin that is
shown in the menus and browsers, as well as the WPS and FMS. The SBS also allows you
to control certain aspects of the appearance of the menus/browsers. There are a number
of themes included in Rockbox, and you can load one of these at any time by selecting
it in Settings
Theme Settings
set individual items of a theme from within the Settings
The Rockbox manual
(page 25)) on it and select the option Set As Backdrop. If
Example
Browse Theme Files. It is also possible to
(version 3.14)
Theme Settings menu.
Toshiba Gigabeat F and X Series
191
12.2.2

Advertisement

Table of Contents
loading

This manual is also suitable for:

Gigabeat x

Table of Contents