Operation Manual

Appendix C. Theme Tags 185
Examples:
1. As a simple tag: %St(skip length)
2. As a conditional: %?St(eq enabled)<Eq is enabled|Eq is disabled>
C.20. 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)
The Rockbox manual (version 3.10) Packard Bell Vibe 500