Chapter 12. Advanced Topics
149
Viewport definition
Default value
width/height
remaining part of screen
font
user defined
shade
black
foreground
on
white
background
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
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)
%t(1)%acWarning:;%t(.1)
%Vl(b,20,30,50,50,1)
%sNo album art found
%scheck your filenames.
The Rockbox manual
(version rUnversioned directory-141216)
Iaudio M3