Chapter 13. Advanced Topics
152
13.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
13.2.2
(page
153
)). 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.
Example
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.
13.2. Configuring the Theme
13.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
→
Browse Theme Files
. It is also possible to
set individual items of a theme from within the
Settings
→
Theme Settings
menu.
13.2.2. Themes – Create Your Own
The theme files are simple text files, and can be created (or edited) in your favourite
text editor. To make sure non-English characters display correctly in your theme you
must save the theme files with UTF-8 character encoding. This can be done in most
editors, for example Notepad in Windows 2000 or XP (but not in 9x/ME) can do this.
The Rockbox manual
(version 3.13)
Sansa c200v2 Series
Содержание Sansa c200v2 Series
Страница 1: ...The Rockbox Manual for Sansa c200v2 Series rockbox org March 5 2013...
Страница 162: ...Appendix A File formats 162 The Rockbox manual version 3 13 Sansa c200v2 Series...
Страница 194: ...Appendix E Config file options 194 Setting Allowed Values Unit The Rockbox manual version 3 13 Sansa c200v2 Series...