Chapter 4. Browsing and playing Playlist catalog
View catalog. This lists all playlists that are part of the Playlist catalog. You can load a new playlist directly from this list. Add to playlist. Adds the currently playing le to a playlist. Select the playlist you want the le to be added to and it will get appended to that playlist. Add to new playlist. Similar to the previous entry this will add the currently playing track to a playlist. You need to enter a name for the new playlist rst. Sound Settings This is a shortcut to the Sound Settings Menu, where you can congure volume, bass, treble, and other settings aecting the sound of your music. See section 6 (page 49) for more information. Playback Settings This is a shortcut to the Playback Settings Menu, where you can congure shue, repeat, party mode, skip length and other settings aecting the playback of your music. Rating The menu entry is only shown if Gather Runtime Information is enabled. It allows the assignment of a personal rating value (0 10) to a track which can be displayed in the WPS and used in the Database browser. The value wraps at 10. Bookmarks This allows you to create a bookmark in the currently-playing track.
Chapter 4. Browsing and playing Show Track Info
Figure 4.4.: The track info viewer
This screen is accessible from the WPS screen, and provides a detailed view of all the identity information about the current track. This info is known as meta data and is stored in audio le formats to keep information on artist, album etc. To access this screen, press Play + A-B. Open With. This Open With function is the same as the Open With function in the le browsers Context Menu. Delete Delete the currently playing le. The le will be deleted but the playback of the le will not stop immediately. Instead, the part of the le that has already been buered (i.e. read into the players memory) will be played. This may even be the whole track. Pitch The Pitch Screen allows you to change the rate of playback (i.e. the playback speed and at the same time the pitch) of your player. The rate value can be adjusted between 50% and 200%. 50% means half the normal playback speed and a pitch that is an octave lower than the normal pitch. 200% means double playback speed and a pitch that is an octave higher than the normal pitch. The rate can be changed in two modes: procentual and semitone. Initially, procentual mode is active. If youve enabled the Timestretch option in Sound Settings and have since rebooted, you can also use timestretch mode. This allows you to change the playback speed without aecting the pitch, and vice versa.

In timestretch mode there are separate displays for pitch and speed, and each can be altered independently. Due to the limitations of the algorithm, speed is limited to be between 35% and 250% of the current pitch value. Pitch must maintain the same ratio as well as remain between 50% and 200%. The value of the rate, pitch and speed is not persistent, i.e. after the player is turned on it will always be set to 100%. However, the rate, pitch and speed information will be stored in any bookmarks you may create (see section 8.6 (page 70)) and will be restored upon playing back those bookmarks.

Key A-B Up / Down

Action Toggle pitch changing mode (cycle through all available modes). Increase / Decrease pitch by 0.1% (in procentual mode) or 0.1 semitone (in semitone mode). Increase / Decrease pitch by 1% (in procentual mode) or a semitone (in semitone mode). Temporarily change pitch by 2% (beatmatch), or modify speed (in timestretch mode). Reset pitch and speed to 100%. Leave the Pitch Screen.
Long Up / Long Down Left / Right

Navi Play or Stop

4.4. Working with Playlists
4.4.1. Playlist terminology
Some common terms that are used in Rockbox when referring to playlists: Directory. A playlist! One of the keys to getting the most out of Rockbox is understanding that Rockbox always considers the song that it is playing to be part of a playlist, and in some situations, Rockbox will create a playlist automatically. For example, if you are playing the contents of a directory, Rockbox will automatically create a playlist containing all songs in it. This means that just about anything that is described in this chapter with respect to playlists also applies to directories. Dynamic playlist. A dynamic playlist is a playlist that is created On the y. Any time you insert or queue tracks using the Playlist submenu (see section 4.4.3 (page 37)), you are creating (or adding to) a dynamic playlist.
Insert. In Rockbox, to Insert an item into a playlist means putting an item into a playlist and leaving it there, even after it is played. As you will see later in this chapter, Rockbox can Insert into a playlist in several places. Queue. In Rockbox, to Queue a song means to put the song into a playlist and then to remove the song from the playlist once it has been played. The only dierence between Insert and Queue is that the Queue option removes the song from the playlist once it has been played, and the Insert option does not.

Stop Rec

5.9. FM Radio
Figure 5.4.: The FM radio screen
This menu option switches to the radio screen. The FM radio has the ability to remember station frequency settings (presets). Since stations and their frequencies vary depending on location, it is possible to load these settings from a le. Such les should have the lename extension.fmr and reside in the directory /.rockbox/fmpresets (note that this directory does not exist after the initial Rockbox installation; you should create it manually). To load the settings, i.e. a set of FM stations, from a preset le, just play it from the le browser. Rockbox will remember and use it in PRESET mode until another le has been selected. Some preset les are available here: ZFmPresets. It is also possible to record the FM radio while listening. To start recording, enter the FM radio settings menu with Long Navi and then select Recording. At this point,
you will be switched to the Recording Screen. Further information on Recording can be found in section 5.8 (page 44). Key Left, Right Action Change frequency in SCAN mode or jump to next/previous station in PRESET mode. Seek to next station in SCAN mode. Change volume. Leave the radio screen with the radio playing. Stop the radio and return to Main Menu. Mute radio playback. Switch between SCAN and PRESET mode. Open a list of radio presets. You can view all the presets that you have, and switch to the station. Display the FM radio settings menu.
Long Left, Long Right Up, Down A-B Stop Play Long Play Navi

Long Navi

Saving a preset: Up to 64 of your favourite stations can be saved as presets. Long Navi to go to the menu, then select Add preset. Enter the name (maximum number of characters is 32). Press Play to save. Selecting a preset: Navi to go to the presets list. Use Up and Down to move the cursor and then press Navi or Right to select. Use Left or Stop to leave the preset list without selecting anything. Removing a preset: Navi to go to the presets list. Use Up and Down to move the cursor and then press Long Navi on the preset that you wish to remove, then select Remove Preset. Note: The radio will turn o when starting playback of an audio le.

5.10. Playlists

This menu allows you to work with playlists. Playlists can be created in three ways. Playing a le in a directory causes all the les in it to be placed in a playlist. Playlists can be created manually by either using the Context Menu (see section 4.1.2 (page 24)) or using the Playlist menu. Both automatically and manually created playlists can be edited using this menu.
Create Playlist: Rockbox will create a playlist with all tracks in the current directory and all sub-directories. The playlist will be created one directory level up from where you currently are. View Current Playlist: Displays the contents of the playlist currently stored in memory. Save Current Playlist: Saves the current dynamic playlist, excluding queued tracks, to the specied le. If no path is provided then playlist is saved to the current directory. View Catalog: Provides a simple interface to maintain several playlists (see section 4.4 (page 35)).

Pre-cut. If too much gain is added through the graphical EQ, your music may distort. The Precut setting allows you to adjust the overall gain of the EQ. If your music distorts when using the EQ, trying changing this setting to a negative value. Simple EQ. This option provides an easier alternative for those who are daunted by all of the parameters that can be adjusted using the graphical EQ. With the Simple EQ, the only parameter that can be adjusted is the gain. Advanced EQ. This sub menu provides options for adjusting the same parameters as the Graphical EQ. The only dierence is that the parameters are adjusted through textual menus rather than through a graphic interface. Save EQ Preset. This option saves the current EQ conguration in a.cfg le. Browse EQ Presets. This menu displays a list of EQ presets, as well as any EQ congurations saved using the Save EQ Preset option. Users unfamiliar with the operation of a parametric EQ may wish to use the presets instead of trying to congure the EQ, or use the presets for designing their own custom EQ settings.

6.9. Dithering

This setting controls the dithering and noise shaping functionality of Rockbox. Most of Rockbox audio le decoders work at a higher bit depth than the 16 bits used for output on the players audio connectors. The simplest way to convert from one bit depth to another is simply discarding all the surplus bits. This is the default behaviour, and adds distortion to the signal that will vary in character along with the desired sound. Dithering adds low-level noise to the signal prior to throwing away the surplus bits, which gives the resulting signal a uniform noise oor which is independent of the signal. Most people nd this noise preferable to the time-varying noise heard when not performing dithering. After dithering, noise shaping is performed. This basically just pushes the dithering noise to the parts of the frequency spectrum humans cannot hear so easily. In Rockbox case, some of the noise is pushed up to above 10 kHz. This setting will be put to its best use when listening to dynamic music with frequently occuring quiet parts, classical music being a typical example. It is worth noting that the eects of dithering and noise shaping are very subtle, and not easily noticable. Rockbox uses highpass triangular distribution noise as the dithering noise source, and a third order noise shaper.

6.10. Timestretch

Enabling Timestretch allows you to change the playback speed without it aecting the pitch of the recording. After enabling this feature and rebooting, you can access this via the Pitch Screen. This function is intended for speech playback and may signicantly dilute your listening experience with more complex audio. See section 4.3.3 (page 34) for more details about how to use the feature.

8.8. Language

This setting controls the language of the Rockbox user interface. Selecting a language will activate it. The language les must be in the /.rockbox/langs/ directory. See section 12.1.3 (page 162) for further details about languages.

8.9. Voice

Voice Menus. This option controls the voicing of menus/settings as they are selected by the cursor. In order for this to work, a voice le must be present in the /.rockbox/langs/ directory on the player. Voice les are large and are not shipped with Rockbox by default. The voice le is the name of the language for which it is made, followed by the extension.voice. So for English, the le name would be english.voice. This option is on by default, but will do nothing unless the appropriate voice le is installed in the correct place on the player. The Voice Menus have several limitations: Setting the Sound Option Channels to Karaoke may disable voice menus. Plugins and the wake up alarm do not support voice features. Voice Directories. This option controls voicing of directory names. A voice le must be present for this to work. Several options are available. Spell. Speak the directory name by spelling it out letter by letter. Support is provided only for the most common letters, numbers and punctuation. Numbers. Each directory is assigned a number based upon its position in the le list. They are then announced as Directory 1, Directory 2 etc. O. No attempt will be made to speak directory names. You can use pre-generated.talk clips to have directory names spoken properly, but you must enable this explicitly (see below). Use Directory.talk Clips. This option turns on the use of.talk clips for directories. On. Use special pre-recorded les (_dirname.talk) in each directory. These must be generated in advance, and are typically produced synthetically using a text-to-speech engine on a PC. O. No checking is made for directory.talk clips; they are not used even if present. This can reduce disk activity. Use of a.talk clip takes precedence over other directory name voicing. Otherwise (e.g. if a.talk clip is not available), voicing uses the method set under Voice Directories above. Voice Filenames. This option controls voicing of lenames. Again, a voice le must be present for this to work. The options provided are Spell, Numbers, and Off which function the same as for Voice Directories. You can use pre-generated
.talk clips to have lenames spoken properly, but you must enable this explicitly (see below). Use File.talk Clips. This option turns on the use of.talk clips for les. On. Use special pre-recorded les for each le. This functions the same as for directories except that the.talk clip le must have the same name as the described le with an extra.talk extension (e.g. Punkadiddle.mp3 would require a le called Punkadiddle.mp3.talk). O. No checking is made for le.talk clips; they are not used even if present. This can reduce disk activity. Use of a.talk clip takes precedence over other lename voicing. Otherwise (e.g. if a.talk clip is not available), voicing uses the method set under Voice Filenames above. Say File Type. This option turns on voicing of le types when Voice Filenames is set to Spell or Numbers. When Voice Directories is set to Spell, Directory will be voiced after each spelled out directory. Announce Battery Level. When this option is enabled the battery level is announced when it falls under 50%, 30% and 15%. See ZVoiceHowto for more details on conguring speech support in Rockbox.

10.8. Prerecord Time

This setting buers a small amount of audio so that when the record button is pressed, the recording will begin from that number of seconds earlier. This is useful for ensuring that a recording begins before a cue that is being waited for.
10.9. Clear Recording Directory
Resets the location where the recorded les are saved to the root of your players drive.

10.10. Clipping Light

Causes the backlight to ash on when clipping has been detected. Options: Off, Main unit only, Main and remote unit, Remote unit only.

10.11. Trigger

When you record a source you often are only interested in the sound and not the silence in between. The recording trigger provides you with a tool to automatically distinguish between sound and silence and record the sound only. Unfortunately it is not very easy to make this distinction between silence and sound because you hardly ever encounter real silence. There always are background noises. What is considered as background noise depends on the situation. For example during a lecture the very low noise of rustling paper might be considered as background noise. During a rock concert the murmur of the audience might be considered background noise which is much louder compared to rustling paper. Also the duration of the signal matters. When you record speech you want to record every syllable. When you record live music you may not be interested in that chord the guitarist plays for two minutes before the show to verify his amp is turned on. The trigger features numerous parameters to adapt its behaviour to the desired situation. Trigger. This parameter species the trigger mode. When set to Off the recording must be started manually and apart from the Prerecord time no other parameter has any eect. Once will have the trigger start one recording only; after the recording has nished the input signal will not start another recording. Repeat will have the trigger start multiple recordings. Trigtype. Add description of Trigtype Options: Stop, Pause, New File. Prerecord Time. This species the time that is included into the recording before the trigger event occurs. This is very useful if you record a signal that fades in. Usually you want to set the prerecord time greater than or equal to the start duration. That ensures that you record the entire sound. Strictly speaking the prerecord time is not a special parameter of the trigger. It is available during normal recordings too. Start Above. The start threshold denes the minimal volume a sound must have to start the recording. It is displayed numerically in the line Start Above. Note that the unit of the threshold depends on the settings of the peak meter. (i.e. When the peak meter displays dB you can adjust the level in dB and when the peak meter is set to linear the threshold is displayed as percentage.) In the peak meter at the bottom of the screen the start threshold is displayed graphically by a little triangle

Figure 11.22.: Snake
This is the popular snake game. The aim is to grow your snake as large as possible by eating the dots that appear on the screen. The game will end when the snake touches either the borders of the screen or itself. Key Up/Down Play Action Change levels (1 is slowest, 9 is fastest) Toggle Play/Pause

11.1.27. Snake 2

Figure 11.23.: Snake 2 The Snake Strikes Back
Another version of the Snake game. Move the snake around, and eat the apples that pop up on the screen. Each time an apple is eaten, the snake gets longer. The game ends when the snake hits a wall, or runs into itself. Key Up / Down Right / Left A-B Play Up / Down / Left / Right Play Stop Action In menu Set game speed Select starting maze Select game type (A or B) Start the game In game Steer the snake Pause and resume the game Quit
In game A, the maze stays the same, in game B after an increasing number of apples eaten the maze is replaced by a new one.

11.1.28. Sokoban

Figure 11.24.: Sokoban
The object of the game is to push boxes into their correct position in a crowded warehouse with a minimal number of pushes and moves. The boxes can only be pushed, never pulled, and only one can be pushed at a time. Sokoban may be used as a viewer for viewing saved solutions and playing external level sets with the.sok extension. Level sets should be in the standard Sokoban text format or RLE (Run Length Encoded). For more information about the level format, see http://sokobano.de/wiki/index.php?title=Level_format
Chapter 11. Plugins Key Up, Down, Left, Right Stop Play+Down Play Play+Up Rec A-B Play Up/Down Left/Right Stop Action In game Move the sokoban up, down, left, or right Menu Back to previous level Restart level Go to next level Undo last movement Redo previously undone move Solution playback Pause/resume Increase/decrease playback speed Go backward/forward (while paused) Quit
Some places where can you can nd level sets: http://www.sourcecode.se/sokoban/levels.php http://sokobano.de/en/levels.php Note that some level sets may contain levels that are too large for this version of Sokoban and are unplayable as a result.

11.1.29. Solitaire

Figure 11.25.: Klondike solitaire
This is the classic Klondike solitaire game for Rockbox. This is probably the best-known solitaire in the world. Many people do not even realize that other games exist. Though

Chapter 11. Plugins Normal Break lines at newline characters. Join Join lines together.
Expand Add a blank line at newlines. Useful for making paragraphs clearer in some book style text les. Reow Lines Justify the text. Screens Per Page Set the number of screens per page. Available options are 1 to 5 screens per page. Alignment Set the text alignment. Right Set the text alignment to the right. (Useful for displaying right-to-left languages, such as Arabic or Hebrew) Left Set the text alignment to the left. Show Header Select whether to show the header. The header displays the le path. No Do not display the header. Yes Display the header. Show Footer Select whether to show the footer. The footer dispays the page number. No Do not display the footer. Yes Display the footer. Font Select the font to be used by the Text Viewer. Show Statusbar Select whether to show the status bar. If you select a theme settings that the status bar does not display (see section 9 (page 75)), the status bar is not displayed even if you select Yes. No Do not display the status bar. Yes Display the status bar. Scroll Settings The scrolling settings submenu. Horizontal Submenu for horizontal scrolling settings. Scrollbar Toggle the horizontal scrollbar for the current mode. If the le ts on one screen, there is no scrollbar and this setting has no eect. No Do not display the horizontal scroll bar. Yes Display the horizontal scroll bar. Scroll Mode Change the function of the Left and Right buttons. Scroll by Screen Move to the previous/next screen. Scroll by Column Move to the previous/next column. Vertical Submenu for vertical scrolling settings.
Scrollbar Toggle the vertical scrollbar for the current mode. If the le ts on one screen, there is no scrollbar and this setting has no eect. No Do not display the vertical scroll bar. Yes Display the vertical scroll bar. Scroll Mode Change the function of the Scroll-up and Scroll-down buttons. Scroll by Page Scroll up or down one full screen. Scroll by Line Scroll up or down one line. Overlap Pages Set whether the last line from the previous screen is retained when scrolling pages. No Do not retain previous line. Yes Retain previous line. Auto-scroll Speed Control the speed of auto-scrolling in number of lines per second. Available options are 1 to 10 lines per second. As an example, 4 will scroll the text at four lines per second. Left/Right Key (Narrow mode) Change the function of the Left and Right buttons when the screen is in narrow mode (i.e. one screen per page). Previous/Next Page Scroll up or down one full screen. Top/Bottom Page Move to the top or bottom page. Indent Spaces Set the number of spaces to indent the text when line mode is set to Reflow Lines. Available options are 0 to 5 spaces. If you select 0, a blank line is displayed as an indent. Show Playback Menu Display the playback menu to allow control of the currently playing music without leaving the plugin. Select Bookmark Select a saved bookmark. In the screenshot below, the * denotes the current page.

12.4. Firmware Loading

12.4.1. Using ROLO (Rockbox Loader)
Rockbox is able to load and start another rmware le without rebooting. You just play a le with the extension.iriver. This can be used to test new rmware versions without deleting your current version.
12.5. Optimising battery runtime
Rockbox oers a lot of settings that have high impact on the battery runtime of your player. The largest power savings can be achieved through disabling unneeded hardware components for some of those there are settings available. Another area of savings is avoiding or reducing CPU boosting through disabling computing intense features (e.g. sound processing) or using eective audio codecs. The following provides a short overview of the most relevant settings and rules of thumb.
12.5.1. Display backlight
The active backlight consumes a lot of power. Therefore choose a setting that disables the backlight after timeout (for setting Backlight see section 8.4 (page 64)). Avoid to have the backlight enabled all the time.

12.5.2. Anti-Skip Buer

Having a large anti-skip buer tends to use more power, and may reduce your battery life. It is recommended to always use the lowest possible setting that allows correct and continuous playback (see section 7.5 (page 57)).

12.5.3. Replaygain

Replaygain is a post processing that equalises the playback volume of audio les to the same perceived loudness. This post processing applies a factor to each single PCM sample and is therefore consuming additional CPU time. If you want to achieve some (minor) savings in runtime, switch this feature o (see section 7.9 (page 59)).
12.5.4. Audio format and bitrate
In general the fastest decoding audio format will be the best in terms of battery runtime on your player. An overview of dierent codecs performance on dierent players can be found at ZCodecPerformanceComparison. Your target uses a hard disk which consumes a large amount of power while spinning up to several hundred mA. The less often the hard disk needs to spin up for buering and the shorter the buering duration is, the lower is the power consumption. Therefore the bitrate of the audio les does have an impact on the battery runtime as well. Lower bitrate audio les will result in longer battery runtime. Please do not re-encode any existing audio les from one lossy format to another based upon the above mentioned. This will reduce the audio quality. If you have the choice, select the best suiting codec when encoding the original source material.

12.5.5. Sound settings

In general all kinds of sound processing will need more CPU time and therefore consume more power. The less sound processing you use, the better it is for the battery runtime (for options see section 6 (page 49)).

Appendix A. File formats

A. File formats
A.1. Supported le formats

Feature Embedded albumart.bmp Embedded albumart.jpg Embedded albumart.png Replaygain information Title (string) Artist (string) Album (string) Genre (string) Disc (string or number) Track (string or number) Year (string or number) Composer (string) Comment (string) Albumartist (string) Grouping (string) ID3 x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x APE Vorbis MP4 x x x x x x x x x x x x x x x x x x x x x x x ASF
B.2.2. Featureset for codec specic metadata
Feature Embedded.bmp Embedded.jpg Embedded.png Replaygain Title Artist Album Genre Disc Track Year Composer Comment Albumartist Grouping Codec specic metadata (le extension) None None None.mpc.tta,.tta,.spc,.tta,.tta.tta.spc,.mmf.spc, None None
.spc,.mmf,.sid,.rm,.ra,.rmvb,.nsf,.nsfe,.mod,.sap.spc,.mmf,.sid,.rm,.ra,.rmvb,.nsf,.nsfe,.sap.sid,.nsf,.nsfe.spc,.sap

.sid,.sap.rm,.ra,.rmvb

B.2.3. Limitations of metadata handling
1. Multiple tags (e.g. for Genre) are not supported. The rst tag item of a set of multiple tags is used. 2. Only one tag type is supported for each audio format. 3. Overall there are 900 bytes available to load metadata strings. 4. The maximum size of each metadata item (e.g. Artists) is limited to 240 bytes.

Appendix C. Theme Tags

C. Theme Tags
Themeing is discussed in detail in section section 12.2 (page 165), what follows is a list of the available tags. Note: The bar-type tags (such as %pb, %pv, %bl etc.) can be further themed see section C.28 (page 195).

C.1. Status Bar

Tag %we %wd %wi Description Display Status Bar Hide Status Bar Display the inbuilt Status Bar in the current viewport
These tags override the player setting for the display of the status bar. They must be noted on their own line (which will not be shown in the WPS).
C.2. Hardware Capabilities
Tag %cc %tp %Tp Description Check for presence of a real time clock, returns c when used unconditionally Does this target have a radio? Indicates that the target has a touchscreen
With the above tags it is possible to nd out about the presence of certain hardware and make the theme adapt to it. This can be very useful for designing a theme that works on multiple targets with diering hardware capabilities, e.g. targets that do and do not have a clock. When used conditionally, the true branch is completely ignored if it does not apply. Example: %?cc<%cH:%cM|No clock detected>
C.3. Information from the track tags
Tag %ia %ic %iA %id %iG %ig %in %it %iC %iv %iy %ik Description Artist Composer Album Artist Album Name Grouping Genre Name Track Number Track Title Comment ID3 version (1.0, 1.1, 2.2, 2.3, 2.4, or empty if not an ID3 tag) Year Disc Number
Remember that this information is not always available, so use the conditionals to show alternate information in preference to assuming. These tags, when written with a capital I (e.g. %Ia or %Ic), show the information for the next song to be played.

C.18. Changing Volume

Tag %mv(t) Description v if the volume is being changed
The tag produces the letter v while the volume is being changed and some amount of time after that, i.e. after the volume button has been released. The optional parameter t species that amount of time, in seconds. If it is not specied, 1 second is assumed. The tag can be used as the switch in a conditional tag to display dierent things depending on whether the volume is being changed. It can produce neat eects when used with conditional viewports. Example: %?mv(2.5)<Volume changing|%pv> The example above will display the text Volume changing if the volume is being changed and 2.5 seconds after the volume button has been released. After that, it will display the volume value.

C.19. Settings

Tag %St(<setting name>) Examples: 1. As a simple tag: %St(skip length) 2. As a conditional: %?St(eq enabled)<Eq is enabled|Eq is disabled> Description The value of the Rockbox setting with the specied name. See section D (page 198) for the list of the available settings.

C.20. Images

Tag %X(filename.bmp) Description
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: le name relative to /.rockbox/ and including.bmp x: x coordinate y: y coordinate. %xl(n,filename,x,y, Preload an image for later display (useful for when your im[nimages]) ages are displayed conditionally). n: image ID (a-z and A-Z) for later referencing in %xd filename: le name relative to /.rockbox/ and including.bmp If the lename 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] Display a preloaded image. n: image ID (a-z and A-Z) as it [,offset]) was specied 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 rst (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 rst subimage when %mh is on and the second when it is o 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:

Hand Nick Lanham Sebastian Henriksen Martin Scarratt Karl Kurbjun Tomasz Malesinski Andrew Pilley Matt v.d. Westhuizen Tim Crist Jvo Studer Dan Everton Imre Herceg Seven Le Mesle Craig Bachelor Nikolaj Christensen Mikael Magnusson Dominik Wenger Henrico Witvliet Andrew Scott Miguel A. Arvalo Aaron F. Gonzalez Aleksey Kozyulin Jani Kinnunen Rui Marinho Alun Thomas Nils Wallmnius Naoaki Okazaki Will Dyson Matthias Mohr Christian Marg Eli Sherer Fredrik hrn Nicolas Pennequin Ralf Herz Michael DiFebbo David Rothenberger Robert Keevil Mark Bright Dominik Riebeling Alexander Bondar Peter Cawley Rani Hod Tom Ross Anton Romanov Jean-Luc Ohl Steve Bavin Marianne Arnold Gaetano Vocca Frederik Vestre Wenbin Leo Tom Evans Ewan Davies Frdric Franois MarcAndr Moreau Ioannis Koutoulakis Alistair Marshall Karl Ove Hufthammer Vctor Zabalza Ulrich Pegelow Andreas Mattsson Daniel Ankers Paul Louden Rainer Sinsch Plcido Revilla Michael Sevakis Lukas Sabota Emanuel Zephir Alexander Levin Barry Wardell Lars van de Klomp Philippe Miossec Jochen Kemnade Corry Lazarowitz Tom Meyer Laurent Baum James Teh Liam Nattrass Christian Hack Wade Brown Vadim Chekan Christopher Borcsok Victor Cardenas Andrew Melville Pengxuan Liu Andrew Cupper Thilo-Alexander Ginkel Adam Gashlin Robert Kukla David Quesada Jared Stafford Martin Hensel Stphane Doyon
Austin Appel Andre Smith Travis Hyyppa Ian Webber Pavel Gnelitsa Lutz Bhne Will Robertson Robert Carboneau Ye Wei Bryan Childs Mike Schmitt Chris Taylor Tobias Langhoff Steve Gotthardt Greg White Mattieu Favraux Malcolm Tyrrell Piotr Jafiszow Gary Allen John BouAntoun Tomasz Mon Jakub Matouek Albert Veli Chris Dohan Takashi Obara Rene Peinthor Roan Horning Ben Keroack Sean Morrisey Shay Green Nick Vanderweit Simon Menzel Timo Horstschfer Jacco Koning Chris Ham Jose Ramon Garcia Simon Descarpentries Douglas Valentine Jacob Gardner Pascal Briehl Denis Stanishevskiy Eddy Coman Luke Blaney Mark Reiche Michal Jevjak Philippe Latulippe Mauricio Peccorini Nathan Hepting Akio Idehara Dagni McPhee Alex Gerchanovsky Gerhard Dirschl Ivan Zupan Alexander Papst Christoph Reiter Rhino Banga Paul Jones Michael Giacomelli Alex Wenger Andree Buschmann Johnathon Mihalop Rene Allkivi Tobias Schladt John Zhou Charles Voelger Gerritt Gonzales Dieter Pellkofer Evgeniy Kachalin Lenny Koepsell Harry Tu Pawel Wysocki Xinlu Huang Daniel Dalton Boris Gjenero Sylvain Fourmanoit Alex Parker Mario Lang Justin Foell Igor Kuzmin Adilson Vicente Xavier Jesse Lockwood Jonathan Backer Sofian Babai Costas Calamvokis Catalin Patulea Peter Harley Max Kelley Alexander Eickhoff Ken Fazzone David Bishop Hein-Pieter van Braam Przemysaw Houbowski

distribution of Opaque copies in quantity, to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy (directly or through your agents or retailers) of that edition to the public. It is requested, but not required, that you contact the authors of the Document well before redistributing any large number of copies, to give them a chance to provide you with an updated version of the Document.

4. MODIFICATIONS

You may copy and distribute a Modied Version of the Document under the conditions of sections 2 and 3 above, provided that you release the Modied Version under precisely this License, with the Modied Version lling the role of the Document, thus licensing distribution and modication of the Modied Version to whoever possesses a copy of it. In addition, you must do these things in the Modied Version: A. Use in the Title Page (and on the covers, if any) a title distinct from that of the Document, and from those of previous versions (which should, if there were any, be listed in the History section of the Document). You may use the same title as a previous version if the original publisher of that version gives permission. B. List on the Title Page, as authors, one or more persons or entities responsible for authorship of the modications in the Modied Version, together with at least ve of the principal authors of the Document (all of its principal authors, if it has fewer than ve), unless they release you from this requirement. C. State on the Title page the name of the publisher of the Modied Version, as the publisher. D. Preserve all the copyright notices of the Document. E. Add an appropriate copyright notice for your modications adjacent to the other copyright notices. F. Include, immediately after the copyright notices, a license notice giving the public permission to use the Modied Version under the terms of this License, in the form shown in the Addendum below. G. Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Documents license notice. H. Include an unaltered copy of this License. I. Preserve the section Entitled History, Preserve its Title, and add to it an item stating at least the title, year, new authors, and publisher of the Modied Version as given on the Title Page. If there is no section Entitled History in the Document, create one stating the title, year, authors, and publisher of the Document as given
on its Title Page, then add an item describing the Modied Version as stated in the previous sentence. J. Preserve the network location, if any, given in the Document for public access to a Transparent copy of the Document, and likewise the network locations given in the Document for previous versions it was based on. These may be placed in the History section. You may omit a network location for a work that was published at least four years before the Document itself, or if the original publisher of the version it refers to gives permission. K. For any section Entitled Acknowledgements or Dedications, Preserve the Title of the section, and preserve in the section all the substance and tone of each of the contributor acknowledgements and/or dedications given therein. L. Preserve all the Invariant Sections of the Document, unaltered in their text and in their titles. Section numbers or the equivalent are not considered part of the section titles. M. Delete any section Entitled Endorsements. Such a section may not be included in the Modied Version. N. Do not retitle any existing section to be Entitled Endorsements or to conict in title with any Invariant Section. O. Preserve any Warranty Disclaimers. If the Modied Version includes new front-matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document, you may at your option designate some or all of these sections as invariant. To do this, add their titles to the list of Invariant Sections in the Modied Versions license notice. These titles must be distinct from any other section titles. You may add a section Entitled Endorsements, provided it contains nothing but endorsements of your Modied Version by various partiesfor example, statements of peer review or that the text has been approved by an organization as the authoritative denition of a standard. You may add a passage of up to ve words as a Front-Cover Text, and a passage of up to 25 words as a Back-Cover Text, to the end of the list of Cover Texts in the Modied Version. Only one passage of Front-Cover Text and one of Back-Cover Text may be added by (or through arrangements made by) any one entity. If the Document already includes a cover text for the same cover, previously added by you or by arrangement made by the same entity you are acting on behalf of, you may not add another; but you may replace the old one, on explicit permission from the previous publisher that added the old one. The author(s) and publisher(s) of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modied Version.