Chapter 13. Advanced Topics
203
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
Conditional Viewports
Any viewport can be displayed either permanently or conditionally. Defining a viewport
as
%V(...
will display it permanently.
•
%Vl(’identifier’,...)
This tag preloads a viewport for later display. ‘identifier’
is a single lowercase letter (a-z) and the ‘. . . ’ parameters use the same logic as the
%V
tag explained above.
•
%Vd(’identifier’)
Display the ‘identifier’ viewport.
Viewports can share identifiers so that you can display multiple viewports with one
%Vd line.
Example
%?C<%Vd(a)|%Vd(b)>
%Vl(a,10,10,50,50,-)
%Cl(0,0,50,50,c,c)
%Cd
%Vl(a,0,70,70,14,1)
%s%acThere you have it: Album art.
%Vl(b,20,14,50,14,1) %Vf(ff0000) %Vb(ffffff)
%t(1)%acWarning:;%t(.1)
%Vl(b,20,30,50,50,1) %Vf(000000) %Vb(ffffff)
%sNo album art found
%scheck your filenames.
This example checks for album art. Album art will be displayed in viewport ‘a’, if it is
found. Otherwise a red flashing warning will be displayed in viewport ‘b’.
Note:
The tag to display conditional viewports must come before the tag to preload the
b
viewport in the
.wps
file.
The Rockbox manual
(version 3.14)
Sansa Fuze+
