Chapter 13. Advanced Topics
159
Viewports
By default, a viewport filling the whole screen contains all the elements defined in each
theme file. The text is rendered in the same font as in the main menu. To change this
behaviour a custom viewport can be defined. A viewport is a rectangular window on the
screen. This window also has variable dimensions. To define a viewport a line starting
%V(...
has to be present in the theme file. The full syntax will be explained later in
this section. All elements placed before the line defining a viewport are displayed in
the default viewport. Elements defined after a viewport declaration are drawn within
that viewport. Loading images (see Appendix section
(page
)) should be done
within the default viewport. A viewport ends either with the end of the file, or with the
next viewport declaration line. Viewports sharing the same coordinates and dimensions
cannot be displayed at the same time. Viewports cannot be layered
transparently
over
one another. Subsequent viewports will be drawn over any other viewports already
drawn onto that area of the screen.
Viewport Declaration Syntax
%V(x,y,[width],[height],[font]
•
‘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
(page
•
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)
%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.
Viewport definition
Default value
width/height
remaining part of screen
font
user defined
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.
The Rockbox manual
(version 3.14)
Sansa Clip v2
