Chapter 11.
Advanced Topics
169
Editing
The built-in
Text Editor
(see section
10.4.18
(page
165
)) automatically understands
the
.colours
file format, but an external text editor can also be used. To edit the
.colours
file using Rockbox, “play” it in the
File Browser
. The file will open in the
Text Editor
. Upon selecting a line, the following choices will appear:
Extension
Colour
If
Extension
is selected, the
virtual keyboard
(see section
4.1.3
(page
26
)) appears,
allowing the file extension to be modified. If
Colour
is selected, the colour selector screen
appears. Choose the desired colour, then save the
.colours
file using the standard
Text
Editor
controls.
11.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 (240
×
320
×
16 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
24
)) 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.
11.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],[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
11.2.2
(page
171
)). 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.
The Rockbox manual
Toshiba Gigabeat F and X Series