Operation Manual

Appendix C. Theme Tags 187
2. ./filename.{jpeg,jpg,bmp}
3. ./albumtitle.{jpeg,jpg,bmp}
4. ./cover.{jpeg,jpg,bmp}
5. ./folder.jpg
6. /.rockbox/albumart/albumartist-albumtitle.{jpeg,jpg,bmp}
7. ../albumtitle.{jpeg,jpg,bmp}
8. ../cover.{jpeg,jpg,bmp}
The following characters will be replaced with an underscore (_) when looking for
albumtitle.bmp or albumartist-albumtitle.bmp: \ / : < > ? * |. Doublequotes will be
replaced by single quotes. If no album artist is set, artist will be used instead. See
ZAlbumArt in the wiki for programs that will help you automate the process of putting
album art on your player.
C.21.3. How to display the album art
Once the album art files are present on your player, they can be displayed as follows.
Tag Description
%Cl(x,y,[maxwidth],
[maxheight],
hor_align,
vert_align)
Define the settings for album art
x: x coordinate
y: y coordinate
maxwidth: Maximum height
maxheight: Maximum width
hor_align: Horizontal alignment, enter as ‘l’, ‘c’ or ‘r’ for
left, centre or right. Centre is default
vert_align: Vertical alignment, enter as ‘t’, ‘c’ or ‘b’ for top,
centre or bottom. Centre is default
%Cd Display the album art as configured.
%C Use in a conditional to determine if an image is available.
The picture will be rescaled, preserving aspect ratio to fit the given maxwidth and
maxheight. If the aspect ratio doesn’t match the configured values, the picture will be
placed according to the alignment flags.
Examples:
1. Load albumart at position 20,40 and display it without resizing:
%Cl(20,40„)
2. Load albumart at position 0,20 and resize it to be at most 100×100 pixels. If the
image isn’t square, align it to the bottom-right corner:
%Cl(0,20,100,100,r,b)
The Rockbox manual (version 3.10) Packard Bell Vibe 500