Chapter 13. Advanced Topics 181
• ‘fgcolour’ and ‘bgcolour’ are 6-digit RGB888 colours, e.g. FF00FF.
• %Vg defines a gradient fill that can then be used with the %Vs tag. ‘start’ and
‘end’ set the initial and final colours, and the optional ‘text’ sets the text colour.
Colours are 6-digit RGB888, e.g. FF00FF.
• ‘font’ is a number: 0 is the built-in system font, 1 is the current menu font, and
2-9 are additional skin loaded fonts (see section 13.2.4 (page 183)).
• Only the coordinates have to be specified. Leaving the other definitions blank will
set them to their default values.
Note: The correct number of commas with hyphens in blank fields are still needed.
b
Example
%V(12,20,-,-,1) %Vf(000000) %Vb(FFFFFF) %Vg(FFC0CB, FF0000, FFFF00)
%sThis viewport is displayed permanently. It starts 12px from the left and
%s20px from the top of the screen, and fills the rest of the screen from
%sthat point. The lines will scroll if this text does not fit in the viewport.
%sThe user font is used, and the foreground and background are set to black
%sand white respectively. The line gradient is set to pink to red with yellow
%text.
Viewport definition Default value
width/height remaining part of screen
font user defined
foreground/background
colours
defined by theme
Viewport Line Text Styles
Tag Description
%Vs(mode[,param]) Set the viewport text style to ‘mode’ from this point forward
Mode can be the following:
Mode Description
clear Restore the default style
invert Draw lines inverted
color Draw the text coloured by the value given in ‘param’.
Functionally equivalent to using the %Vf() tag
gradient Draw the next ‘param’ lines using a gradient as de-
fined by %Vg. By default the gradient is drawn over
1 line. %Vs(gradient,2) will use 2 lines to fully change
from the start colour to the end colour
The Rockbox manual (version rUnversioned directory-150220)Sansa e200 and e200R Series