Appendix B. Theme Tags
192
B.19. Images
Tag
Description
%X(filename.bmp)
Load and set a backdrop image for the WPS. This image must
be exactly the same size as your LCD.
%x(n,filename,x,y)
Load and display an image
n
: image ID (a-z and A-Z) for later referencing in
%xd
filename
: file name relative to
/.rockbox/
and including
“.bmp”
x
: x coordinate
y
: y coordinate.
%xl(n,filename,x,y,
[nimages])
Preload an image for later display (useful for when your im-
ages are displayed conditionally).
n
: image ID (a-z and A-Z) for later referencing in
%xd
filename
: file name relative to
/.rockbox/
and including
“.bmp”
If the filename is “__list_icons__” the list icon bitmap will
be used instead
x
: x coordinate
y
: y coordinate
nimages
: (optional) number of sub-images (tiled vertically, of
the same height) contained in the bitmap. Default is 1.
%xd(n[i] [,tag]
[,offset])
Display a preloaded image.
n
: image ID (a-z and A-Z) as it
was specified in
%x
or
%xl
i
: (optional) number of the sub-image to display (a-z for 1-26
and A-Z for 27-52). (ignored when
tag
is used) By default the
first (i.e. top most) sub-image will be used.
tag
: (optional) Another tag to calculate the subimage from
e.g
%xd(A, %mh)
would use the first subimage when
%mh
is on
and the second when it is off
offset
: (optional) Add this number to the value from the
tag
when chosing the subimage (may be negative)
Examples:
1. Load and display the image
/.rockbox/bg.bmp
with ID “a” at 37, 109:
%x(a,bg.bmp,37,109)
2. Load a bitmap strip containing 5 volume icon images (all the same size) with image
ID “M”, and then reference the individual sub-images in a conditional:
%xl(M,volume.bmp,134,153,5)
%?pv<%xd(Ma)|%xd(Mb)|%xd(Mc)|%xd(Md)|%xd(Me)>
Note:
b
The Rockbox manual
Toshiba Gigabeat F and X Series
