Mpio HD300 Manual

Rockbox firmware manual
Hide thumbs Also See for HD300:
Table of Contents

Advertisement

The Rockbox Manual
for
MPIO HD300
rockbox.org
April 30, 2017

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the HD300 and is the answer not in the manual?

Questions and answers

Summary of Contents for Mpio HD300

  • Page 1 The Rockbox Manual MPIO HD300 rockbox.org April 30, 2017...
  • Page 2 Free Software Foundation; with no Invariant Sec- tions, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled “GNU Free Documentation License”. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 3: Table Of Contents

    4.2.1. Introduction ......26 The Rockbox manual MPIO HD300 (version 3.14)
  • Page 4: Contents

    ........48 The Rockbox manual MPIO HD300 (version 3.14)
  • Page 5: Contents

    ....... . . 68 8.5.6. Advanced Key Lock ......69 The Rockbox manual MPIO HD300 (version 3.14)
  • Page 6: Contents

    ....... . 97 The Rockbox manual MPIO HD300 (version 3.14)
  • Page 7 ......127 12.3.5. Lua scripting language ......128 The Rockbox manual MPIO HD300 (version 3.14)
  • Page 8: Contents

    ......165 13.1.5. Loading Backdrops ......165 The Rockbox manual MPIO HD300 (version 3.14)
  • Page 9: Contents

    ....... . 187 The Rockbox manual MPIO HD300 (version 3.14)
  • Page 10: Contents

    ..... . 214 I.2. The GNU General Public License ..... . . 222 The Rockbox manual MPIO HD300 (version 3.14)
  • Page 11: Introduction

    To search the list archives simply use the search field that is located on the left side of the website. Furthermore, you can ask on IRC. The The Rockbox manual MPIO HD300 (version 3.14)
  • Page 12: Naming Conventions And Marks

    Manufacturer and product names are formatted in accordance with the standard rules of English grammar, e.g. “MPIO playback is currently unsupported”. Manufacturer and model names are proper nouns, and thus are written beginning with a capital letter.
  • Page 13: Installation

    This is the component of Rockbox that is installed to the flash memory of your MPIO. The Rockbox firmware. Unlike the MPIO firmware, which runs entirely from flash memory, most of the Rockbox code is contained in a “build” that resides on your player’s drive.
  • Page 14: Automated Installation

    Instead, we have to patch the MPIO firmware with the Rockbox bootloader. Download a supported version of the MPIO firmware for your MPIO HD300 from the MPIO website, links can be found on MPIOHD300Port.
  • Page 15: Manual Installation

    2. Connect your player to the computer via USB as described in the manual that came with your player. 3. Take the .zip file that you downloaded and use the “Extract all” command of your unzip program to extract the files onto your player. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 16: Finishing The Install

    Installing the bootloader is the trickiest part of the installation. As explained above, we cannot distribute the bootloader directly, and thus need to patch a compatible version of the MPIO firmware, which can be downloaded as described above. 1. Download official Rockbox bootloader for MPIO HD300 from http://download.
  • Page 17: Running Rockbox

    2.5.2. Manual Uninstallation If you wish to clean up your disk, you may also wish to delete the .rockbox directory and its contents. Turn the MPIO off. Turn the player back on and the original MPIO software will load. 2.6. Troubleshooting “File Not Found”...
  • Page 18 To fix this, either install Rockbox with the Rockbox Utility which will take care of this for you, or recheck the Manual Install section to see where the files need to be located. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 19: Quick Start

    Rockbox website at BlindFAQ. 3.1.2. Turning the player on and off To turn on and off your Rockbox enabled player use the following keys: Action Long Play Start Rockbox Long Play Shutdown Rockbox The Rockbox manual MPIO HD300 (version 3.14)
  • Page 20: Starting The Original Firmware

    Rec button, and then press the Play button. This will bring you to the short menu where you can choose among: Boot Rockbox, Boot MPIO firmware and Shutdown. Select the option you need with Rewind and Forward and confirm with long Play.
  • Page 21: Basic Concepts

    Note: Some of the themes shipped with Rockbox need additional fonts from the fonts package, so make sure you installed them. Also, if you downloaded additional themes from the Internet make sure you have the needed fonts installed as otherwise the theme may not display properly. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 22: Browsing And Playing

    Note: The File Browser allows you to manipulate your files in ways that are not available within the Database Browser. Read more about Database in section (page 26). The remainder of this section deals with the File Browser. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 23: File Browser Controls

    The Context Menu contains the following options (unless otherwise noted, each option pertains both to files and directories): Playlist. Enters the Playlist Submenu (see section 4.4.3 (page 35)). The Rockbox manual MPIO HD300 (version 3.14)
  • Page 24 files. Note: If you have Auto-Change Directory and Constrain Auto-Change enabled, the directories returned will be constrained to the directory you have chosen here and those below it. See section 7.12 (page 59) The Rockbox manual MPIO HD300 (version 3.14)
  • Page 25: Virtual Keyboard

    Enter Insert the selected keyboard letter at the current line cursor position. Play Exit the virtual keyboard and save any changes. Menu Exit the virtual keyboard without saving any changes. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 26: Database

    RAM, as this will reduce the overall battery consumption because the disk will not need to spin on each search. Auto Update If Auto update is set to on, each time the player boots, the database will automatically be updated. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 27: Using The Database

    There is no option to turn off database completely. If you do not want to use it just do not do the initial build of the database and do not load it to RAM. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 28: While Playing Screen

    In contrast to all other items, the status bar is always at the top of the screen. (Scrolling) path and filename of the current song. The ID3 track name. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 29: Wps Key Controls

    For a picture of the peak meter, please see the While Recording Screen in section 5.8.1 (page 41). The bar: This is the wide horizontal bar. It represents the current volume value. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 30: The Wps Context Menu

    Add to playlist. Adds the currently playing file to a playlist. Select the playlist you want the file to be added to and it will get appended to that playlist. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 31 This info is known as meta data and is stored in audio file formats to keep information on artist, album etc. To access this screen, press Long Enter to access the WPS Context Menu and select Show Track Info. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 32 100%. However, the rate, pitch and speed information will be stored in any bookmarks you may create (see section (page 71)) and will be restored upon playing back those bookmarks. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 33: Working With Playlists

    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. 4.4.2. Creating playlists Rockbox can create playlists in four different ways. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 34 To create a playlist containing all music on your player, you can use the Create Playlist command in the Playlists menu found in the Main Menu. The created playlist will be named root.m3u8 and saved in the root of your player’s disk. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 35: Adding Music To Playlists

    Queue Next. Queue track(s) immediately after current playing track. Queue Last. Queue track(s) at end of playlist. Queue Shuffled. Queue track(s) in a random order. Queue Last Shuffled. Queue tracks in a random order at the end of the playlist. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 36: Modifying Playlists

    Playlist Options menu in the Main Menu and select Save Current Playlist. Either method will bring you to the Virtual Keyboard (see section 4.1.3 (page 25)), enter a filename for your playlist and accept it and you are done. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 37: Loading Saved Playlists

    When loading a playlist from disk it will replace the current dynamic playlist. Through the Playlist catalogue The Playlist catalogue offers a shortcut to all playlists in your player’s specified playlist directory. It can be used like the File Browser. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 38: The Main Menu

    Scroll Up Select the previous option in the menu. Inside a setting,decrease the value or choose previous option. Enter Select option. Menu Exit menu or setting, or move to parent menu. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 39: Recent Bookmarks

    This entry is not shown in the Main Menu when the option is off (the default setting). See section (page 71) for more details on configuring bookmarking in Rockbox. 5.4. Files Browse the files on your player (see section (page 22)). The Rockbox manual MPIO HD300 (version 3.14)
  • Page 40: Database

    Rockbox. The details of this menu are covered in section (page 76). 5.7.5. Recording Settings The Recording Settings menu allows you to configure settings related to recording. The details of this menu are covered in detail in section (page 78). The Rockbox manual MPIO HD300 (version 3.14)
  • Page 41: Manage Settings

    This is expected behaviour, and nothing to worry about. The recording continues during the spin up. The frequency and channels settings are shown in the status bar. The controls for this screen are: The Rockbox manual MPIO HD300 (version 3.14)
  • Page 42: Fm Radio

    FM radio settings menu with Long Enter and then select Recording. At this point, you will be switched to the Recording Screen. Further information on Recording can be found in section (page 41). The Rockbox manual MPIO HD300 (version 3.14)
  • Page 43: Playlists

    Playing a file in a directory causes all the files 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 23)) or using the Playlist menu. Both automatically and manually created playlists can be edited using this menu. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 44: Plugins

    fixing a problem with Rockbox. If you think you have messed up your settings by use of this menu please try to reset all settings before asking for help. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 45: Shortcuts

    (see section (page 202) for the list of the possible settings) debug data is the name of the debug menu item to display The Rockbox manual MPIO HD300 (version 3.14)
  • Page 46 “Add to shortcuts”. A reboot is needed for manual changes to shortcuts.txt to be applied. Shortcuts can be manually removed by selecting the one you wish to remove and pressing Long Enter. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 47: Sound Settings

    To set a volume limit, select a volume from the list and the maximum volume will be limited to the selected value all over the system. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 48: Treble

    0%. Values above 100% will progressively remove components in one channel that is also present in the other. This has the effect of widening the stereo field. A value of 100% will leave the stereo field unaltered. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 49: Enhancement

    Cross Gain setting. High-Frequency Cutoff. Decides at which frequency the cross path audio will start to be cut by the amount described by the High-Frequency Attenuation setting. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 50: Equalizer

    (often 12+) needed in a non-parametric EQ. The graphic below illustrates how the width of 10kHz band can be adjusted to cover a wider (lower Q) or narrower (higher Q) range of frequencies. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 51 Graphical EQ. This option brings up a graphic EQ screen, which allows adjustment of each of the three parameters described above (gain, centre frequency, and Q) for each of the five EQ bands. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 52: Dithering

    Dithering adds low-level noise to the signal prior to throwing away the surplus bits, which gives the resulting signal a uniform noise floor which is independent of the sig- The Rockbox manual MPIO HD300 (version 3.14)
  • Page 53: Timestretch

    EQ gain. The defult precut value is set to -2.5 dB and can be adjust from 0 dB to -4.5 dB. Note that this effect will stack with any other EQ applied. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 54: Auditory Fatigue Reduction

    “pumping.” Instead, the gain is allowed to return to normal at the chosen rate. Release Time is the time for the gain to recover by 10 dB. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 55: Playback Settings

    This option is more complicated to use than the others as the player must first be placed into A-B repeat mode and then the start and end points defined. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 56: Play Selected First

    This section controls the behavior of the crossfader. The crossfader, when enabled, smoothly fades one track into the next. This can occur in two situations: an automatic track change or a manual track skip. An automatic track change occurs at the end of The Rockbox manual MPIO HD300 (version 3.14)
  • Page 57 Out Duration is less then Fade In Delay (which would create a gap in the audio). In this case, the Fade In Delay is reduced to eliminate the gap. The graphic below illustrates how the different settings work in practice. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 58: Replaygain

    Off. Do not process replaygain information, i.e. turn off the replaygain function. Prevent Clipping. Avoid clipping of a song’s waveform. If a song would clip during playback, the volume is lowered for that song. Replaygain information is needed for this to work. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 59: Track Skip Beep

    The log-file is called .scrobbler.log,and is to be found in the root directory of your player. Note: See LastFMLog for a further description, and for tools you can use to submit your Last.fm log. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 60: Cuesheet Support

    Note: This option does not apply to resuming a paused track. Use the next option for rewinding on pause. Note: The actual rewind distance may differ a little from the requested value, depending on the file in question. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 61: Rewind On Pause

    Chapter 7. Playback Settings 7.18. Rewind on Pause This option rewinds the current track by a small amount whenever it is paused (not stopped). The amount to rewind can be set between 0 and 15 seconds. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 62: General Settings

    Sort Files. This option controls how Rockbox sorts files. All of the options for Sort Directories are available in this option. In addition, there is a By type option which sorts files alphabetically by their type (such as .mp3) then alphabetically within each type. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 63 Follow Playlist. This option determines what directory the File Browser displays first. If Follow Playlist is set to Yes, when you enter the File Browser from the WPS, you will find yourself in the same directory as the currently playing file. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 64: Database

    When disabled the first keypress will also perform its appropriate action. Selective Backlight This option allows some selected actions in While Playing Screen and FM screen to not turn on the backlight in order to save power. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 65 . Setting this option to Yes will keep the list entries at their fixed positions and allow them to be scrolled out of view, whereas No will only scroll those entries which surpass the right margin. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 66 (dB) setting are -40 dB for minimum and 0 dB for maximum. Recommended values for Linear display are 0 and 100%. Note that -40 dB is approxi- mately 1% in linear value, but if you change the minimum setting in linear The Rockbox manual MPIO HD300 (version 3.14)
  • Page 67: System

    Note: The first time you enable the directory cache, Rockbox will request a reboot of the player and upon restarting take a few minutes to scan the drive. After this, the directory cache will work in the background. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 68: Limits

    8.5.5. Keyclick This menu controls key clicks on button presses. Keyclick. This setting controls how strong the keyclicks are. If set to Off, the keyclicks will be disabled. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 69: Advanced Key Lock

    Set the screen that Rockbox will start in. The default is the main menu but the following options are available: Previous Screen. Start Rockbox in the same screen as when it was shut off. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 70: Idle Poweroff

    Start Sleep Timer On Boot: If set, a Sleep Timer will be initiated when the device starts. Restart Sleep Timer On Keypress: If set, when a Sleep Timer is active and a key is pressed, the Sleep Timer will be restarted with the initial duration. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 71: Bookmarking

    Update on Stop to “Yes”. Load Last Bookmark. This option controls if Rockbox should automatically load a bookmark for a file, when that file is played. No Always start from the beginning of the track or playlist. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 72: Automatic Resume

    When automatic resume is enabled, manually selected tracks resume playback at their last playback position. It does not matter in which way you start the track; tracks are resumed whether they are navigated to through the database browser or file browser, The Rockbox manual MPIO HD300 (version 3.14)
  • Page 73: Language

    (page 165) for further details about languages. 8.10. 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 file must be present in the The Rockbox manual MPIO HD300 (version 3.14)
  • Page 74 file with an extra .talk extension (e.g. Punkadiddle.mp3 would require a file called Punkadiddle.mp3.talk). Off. No checking is made for file .talk clips; they are not used even if present. This can reduce disk activity. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 75 Announce Battery Level. When this option is enabled the battery level is announced when it falls under 50%, 30% and 15%. VoiceHowto for more details on configuring speech support in Rockbox. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 76: Theme Settings

    Scroll Bar. Allows you to choose where the vertical scroll bar should appear. Scroll Bar Width. Allows you to choose the width of the scroll bar (in pixels). Default value is 6. Status Bar. Allows you to choose where to display the statusbar. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 77 Line Selector Type. This option allows you to select which type of line selector to use. Pointer. A small arrow to the left of the menu text. Bar (inverse). A bar with inverted foreground and background colour. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 78: Recording Settings

    Choose the recording frequency (sample rate). are available. Higher sample rates use up more disk space, but give better sound quality. Note: The 11.025 kHz setting is not available when using MPEG Layer 3 format. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 79: Source

    This setting buffers 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. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 80: Clear Recording Directory

    In the peak meter at the bottom of the screen the start threshold is displayed graphically by a little triangle The Rockbox manual MPIO HD300 (version 3.14)
  • Page 81 By specifying a short presplit gap you still can split the recording into separate tracks whenever the trigger start condition is met. More information can be found at VolumeTriggeredRecording. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 82: Time And Date

    If the player is turned on again before the alarm occurs, the alarm will be cancelled. Alarm Wake Up Screen: This option controls what the player does when it is woken up by the alarm. Time Format: Choose 12 or 24 hour clock. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 83: Plugins

    2 or 4 is created in an empty spot on the grid. The game is won when a tile with a value of 2048 is created, and the player loses when there are no more possible moves. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 84: Blackjack

    Rewind / Enter betting amount Forward / Scroll Up / Scroll Down Enter Hit (Draw new card) / Select Play Stay (End hand) Double down Menu Pause game and go to menu / Cancel The Rockbox manual MPIO HD300 (version 3.14)
  • Page 85: Boomshine

    Ball sticks to paddle each time it hits. Ball Immediately fires another ball. Flip Flip left / right movement. Action Rewind / Moves the paddle Forward Enter Release the ball / Fire Menu Open menu / Quit The Rockbox manual MPIO HD300 (version 3.14)
  • Page 86: Bubbles

    fired. Points are awarded depending on how quickly the level was completed. Action Scroll Up Pause game Rewind / Aim the bubble Forward Enter Fire bubble Menu or Long Exit to menu Menu 12.1.6. Chessbox Figure 12.5.: Chessbox The Rockbox manual MPIO HD300 (version 3.14)
  • Page 87: Chopper

    Keys Action Rewind, Move the cursor Forward, Scroll Up, Scroll Down Enter Pick up / Drop piece Change level Play Force play Menu Show the menu 12.1.7. Chopper Figure 12.6.: Chopper The Rockbox manual MPIO HD300 (version 3.14)
  • Page 88: Dice

    Create the directory and save the following files there: rockdoom.wad. The Rockbox .wad, based on prboom.wad from prboom-2.2.6 Your wad files. Copy all Doom wads you wish to play into that directory. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 89 Load Game. Load a saved game Save Game. Save the current game Quit. Quit the game InGame Options Menu. This menu has the following options: End Game. Ends the current game Messages. Enable or Disable in game messages The Rockbox manual MPIO HD300 (version 3.14)
  • Page 90: Flipit

    Flipping the colour of the token under the cursor also flips the tokens above, below, left and right of the cursor. The aim is to end up with a screen containing tokens of only one colour. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 91: Goban

    Note: The plugin does NOT support SGF files with multiple games in one file. These are rare, but if you have one don’t even try it (the file will most likely be corrupted if The Rockbox manual MPIO HD300 (version 3.14)
  • Page 92 New. Create a new game with your choice of board size and handicaps. Save. Save the current state of the game. It will be saved to /sgf/gbn_def.sgf unless otherwise set. Save As. Save to a specified file. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 93 SGF readers. Event. The name of the event which this game was a part of, if any. Place. The place that this game took place. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 94 (including single stone suicide), and playing a move where there is already a stone. Mark Mode. Add generic marks to the board, or remove them. Circle Mode. Add circle marks to the board, or remove them. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 95: Invadrox

    Invadrox is a clone of the classic arcade game Space Invaders. Kill those pesky aliens before they get to you. Remember, they increase speed, drop down and reverse direction after every pass! Action Rewind Move left Forward Move right Enter Fire Menu Quit The Rockbox manual MPIO HD300 (version 3.14)
  • Page 96: Jackpot

    Higher points are awarded to larger combos. The game advances to the next level after every one hundred points and randomly clears several jewels. In puzzle mode the aim of the game is to connect the puzzles, by skillfully swapping pairs of jewels. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 97: Maze

    You can have another go by selecting “retry level” from the menu, but this will cost you a life. You start the game with three lives. Luckily, there are checkpoints at levels four and eight. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 98: Minesweeper

    Move the cursor across the minefield Down/ Rewind/ Forward Enter Toggle flag on / off Play Reveal the contents of the current square Menu Display the current game status Long Menu Exit the game The Rockbox manual MPIO HD300 (version 3.14)
  • Page 99: Pegbox

    Down, Rewind, Forward Enter to choose peg Menu to restart level Play to go up a level to go down a level Long Menu to quit 12.1.19. Pong Figure 12.16.: Pong The Rockbox manual MPIO HD300 (version 3.14)
  • Page 100: Puzzles

    The game rules can be found in the internet. You can choose to play manually (you place both the white and dark pieces) or to play against a (not very smart) robot. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 101: Robotfindskitten

    For every ten lines completed, the game level increases, making the blocks fall faster. If the pile of blocks reaches the ceiling, the game is over. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 102: Rockblox1D

    Includes one picture puzzle, but you can switch the puzzle picture to be the album art of the currently playing music The Rockbox manual MPIO HD300 (version 3.14)
  • Page 103: Snake

    The game will end when the snake touches either the borders of the screen or itself. Action Rewind/ Move snake Forward/ Scroll Up/ Scroll Down Play Toggle Play/Pause Go to the plugin’s menu The Rockbox manual MPIO HD300 (version 3.14)
  • Page 104: Snake 2

    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. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 105: Solitaire

    Some places where can you can find 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. 12.1.29. Solitaire Figure 12.25.: Klondike solitaire The Rockbox manual MPIO HD300 (version 3.14)
  • Page 106: Spacerocks

    Spacerocks is a clone of the old arcade game Asteroids. The goal of the game is to blow up the asteroids and avoid being hit by them. Once in a while, a UFO will appear – shoot this for extra points. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 107: Star

    Move Right Scroll Up Move Up Scroll Down Move Down Enter Switch between circle and square Play+ Rewind Previous level Long Play Reset level Play+ Forward Next level Long Menu Exit the game The Rockbox manual MPIO HD300 (version 3.14)
  • Page 108: Sudoku

    The stored values can be displayed inline as small dots by enabling the Show Markings settings. Note: The scratchpad is not saved when saving the game. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 109: Superdom

    Each year you are allocated an amount of food based on the number of farms you control. Food is used to feed your men, but if you do not have enough food to feed your The Rockbox manual MPIO HD300 (version 3.14)
  • Page 110: Wormlet

    You navigate a hungry little worm. Help your worm to find food and to avoid poisoned argh-tiles. The goal is to turn your tiny worm into a big worm for as long as possible. Game controls: The Rockbox manual MPIO HD300 (version 3.14)
  • Page 111 If you hit Long Play button again a new game starts with the same configuration. To return to the games menu you can hit Long Menu. A stopped game can not be resumed. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 112 1 pixel wide U-turn. You also could move from food to food and make sure you keep between your opponent and the food. So you can always reach it before your opponent. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 113: Xobox

    World” PC game to be copied into the .rockbox/xworld/ directory before the game can be played. Additionally, “extra” data files that modify the in-game strings and font can be placed in the .rockbox/xworld/ directory with the names xworld.strings and xworld.font, respectively. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 114: Demos

    Available options are: Xdist/Ydist. The distance to X axis and Y axis respectively Xadd/Yadd. How fast the code moves on the sine curve on each axis Xsane/Ysane. Changes the appearance of the bouncing. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 115: Credits

    Display at maximum frame rate Play Pause Menu Cycle draw mode Rewind/ Select axis to adjust Forward Scroll Down/ Change speed/angle (speed can not be Scroll Up changed while paused) Long Menu Quit The Rockbox manual MPIO HD300 (version 3.14)
  • Page 116: Demystify

    Menu Quit 12.2.5. FFT This plugin is a basic frequency analyzer with 3 different frequency-amplitude plots (lines, bars, and spectrogram). 12.2.6. Fire Figure 12.34.: Fire Fire is a demo displaying a fire effect. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 117: Fractals

    Decrease iteration depth (less detail) Play+ Forward Increase iteration depth (more detail) Reset and return to the default image Long Menu Quit 12.2.8. Logo Demo showing the Rockbox logo bouncing around the screen. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 118: Matrix

    This simple graphics demo draws a mosaic picture on the screen of the player. Action Scroll Up Change the gap between the drawing lines. Enter Restart the drawing process. Menu or Long Exits Mosaique demo Menu The Rockbox manual MPIO HD300 (version 3.14)
  • Page 119: Oscilloscope

    Toggle whether to scroll or not Menu Toggle drawing orientation Play Pause the demo Scroll Up / Increase / decrease volume Scroll Down Forward / Increase / decrease speed Rewind Long Menu Exit demo The Rockbox manual MPIO HD300 (version 3.14)
  • Page 120: Pictureflow

    Scroll through albums / track list Scroll Down Enter Enter track list / Play album from se- lected track Menu Exit track list Long Menu Long Enter menu Menu Long Menu Exit PictureFlow The Rockbox manual MPIO HD300 (version 3.14)
  • Page 121: Plasma

    Rebuild cache. Rebuild the PictureFlow cache. This is needed in order for PictureFlow to pick up new albums, and may occasionally be needed if albums are removed. 12.2.13. Plasma Figure 12.39.: Plasma The Rockbox manual MPIO HD300 (version 3.14)
  • Page 122: Rocklife

    Figure 12.40.: Have you ever seen snow falling? This demo replicates snow falling on your screen. If you love winter, you will love this demo. Or maybe not. Press Menu or Long Menu to quit. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 123: Starfield

    There are 3 types of meter selectable. The analogue meter is a classic needle style. The digital meter is modelled after LED volume displays, and the mini-meter option allows for the display of small meters in addition to the main display (as above). From the The Rockbox manual MPIO HD300 (version 3.14)
  • Page 124: Viewers

    12.3.1. Shortcuts The Shortcuts Plugin allows you to jump to places within the file browser without having to navigate there manually. The plugin works with .link files. A .link file is just a The Rockbox manual MPIO HD300 (version 3.14)
  • Page 125: Chip-8 Emulator

    12.3.2. Chip-8 Emulator Chip8 is a kind of assembly language for a long-gone architecture. This plugin runs games written using the chip8 instructions. To start a game open a .ch8 file in the File Browser The Rockbox manual MPIO HD300 (version 3.14)
  • Page 126: Frotz

    Z-Machine games are text based and most depend heavily on typed commands. The virtual keyboard is used for text entry, both for typing entire lines and for typing single characters when the game requires single character input. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 127: Image Viewer

    Supported formats are as follows. Format File-extension(s) .bmp JPEG .jpg, .jpe, .jpeg .png .gif Note: When an audio file is playing the size of the image is limited as the decoding The Rockbox manual MPIO HD300 (version 3.14)
  • Page 128: Lua Scripting Language

    There are a few exceptions/additions to the Lua support in Rockbox: No floating point support. The number type in Lua is usually float, however in the Rockbox implementation it is integer. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 129: Midiplay

    To play a video file, you just select it in the Rockbox File Browser. If your file does not have the .mpg extension but is encoded in the supported format, you will need to use the Open With... context menu option and choose mpegplayer. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 130 Audio Options Open Audio Options submenu – see below. Resume Options (default: Start menu) Enable/disable the start menu. Play Mode (default: Single) Set to All to play multiple .mpg files in the directory continuously. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 131: Mp3 Encoder

    PCM with 16 bit per sample and a maximum of 2 channels. Allowed sample rates are 16, 22.05, 24, 32, 44.1 and 48 kHz. The user will be asked to select the desired output bitrate of the compressed MP3 file. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 132: Rockboy

    Rockboy is a Nintendo Game Boy and Game Boy Color emulator for Rockbox based on the gnuboy emulator. To start a game, open a ROM file saved as .gb or .gbc in the file browser. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 133: Search

    40 characters) and save the file as <name>.shopper. If you want to separate the items you can do so by creating categories, which are prepended with ‘#’. To open a .shopper file just “play” it from the file browser. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 134: Sort

    This plugin takes a file and sorts it in ascending alphabetical order. Case is ignored. This is useful for ordering playlists generated by the Create Playlist menu option (see section 5.10 (page 43)). The Rockbox manual MPIO HD300 (version 3.14)
  • Page 135: Speedread

    You can view files without a .txt or .nfo extension by using Open with from the Context Menu (see section 4.1.2 (page 23)). You can also bookmark pages. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 136 files. Reflow 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. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 137 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. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 138 Quit Exits the plugin. The text viewer automatically stores its settings, the current position and bookmarks in .rockbox/rocks/viewers/viewer_file.dat. Bookmarks To add a bookmark, press . The bookmark will be displayed as shown below. To delete the bookmark press the same button again. The Rockbox manual (version 3.14) MPIO HD300...
  • Page 139: Theme Remove

    WPS. Specifies how the .wps file belonging to a theme .cfg file is handled. Statusbar Skin. Specifies how the .sbs file belonging to a theme .cfg file is han- dled. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 140: Vbrfix

    //sourceforge.net/projects/spectemu/). To start a game open a tape file or snapshot saved as .tap, .tzx, .z80 or .sna in the file browser. Note: As ZXBox is a 48k emulator only loading of 48k z80 snapshots is possible. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 141 Frameskip Sets the number of frames to skip before displaying one. With zero frameskip ZXBox tries to display 50 frames per second. Sound. Turns sound on or off. Volume. Controls volume of sound output. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 142: Applications

    12.4.2. Battery Benchmark The Battery Benchmark plugin enables you to test your battery’s performance whilst using your player normally. Results can be submitted to the BatteryRuntime wiki page. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 143 U USB powered. Only for targets that support this. A “U” will indicate if the unit was using the USB port for power at the time of the measurement. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 144: Calculator

    Pressing the “1st” and “2nd” buttons will toggle between other available math functions. Action Rewind/ Move around the keypad Forward/ Scroll Up/ Scroll Down Enter Select a button Menu Delete last entered digit or clear after cal- culation Play Calculate Long Menu Quit The Rockbox manual MPIO HD300 (version 3.14)
  • Page 145: Calendar

    Move the selector Scroll Down Enter Show memos for the selected day Rewind/ Previous / Next week Forward Rec / Play Previous / Next month Long Menu Quit 12.4.5. Chess Clock Figure 12.51.: Chess Clock The Rockbox manual MPIO HD300 (version 3.14)
  • Page 146 When the round time is up for a player the message “ROUND UP!” is shown (press NEXT to continue). When the total time is up for a player the message “TIME UP!”is shown. The player will then be removed from the timer. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 147: Clock

    General Settings Reset Settings Reset all settings to their default values. Save Settings Save all settings to disk. Show Counter Toggle Counter display. Save Choose whether to disable automatic saving, saving to disk on exit, or saving to disk every settings change. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 148 (1 to 12 inclusive). Invert Seconds, if enabled, will invert the LCD as the seconds pass. Second Hand, if enabled, will draw a second hand among the hour and minute hands. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 149: Dict

    first asterisk will be recognised as a wild-card with any additional uses being taken as literal. Warning: Be careful when you use custom entries as you could accidentally delete important files. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 150: Keybox

    Entries are automatically saved when the plugin is exited. 12.4.10. Lamp Lamp is a simple plugin to use your player as a lamp (flashlight, torch). You get an empty screen with maximum brightness. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 151: Lrcplayer

    The time tag must be in the form [mm:ss], [mm:ss.xx], or [mm:ss.xxx] where mm is minutes, ss is seconds, xx is tenth of milliseconds, and xxx is milliseconds. Any other tags and lines without time tags are ignored. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 152 files will be searched for, in this order. .ext is one of the supported extensions from the list above, and will be searched for in the same order as in that list. /Music/Artist/Album/Title.ext /Music/Artist/Title.ext /Music/Title.ext /Title.ext /Music/Artist/Album/Lyrics/Title.ext /Music/Artist/Lyrics/Title.ext /Music/Lyrics/Title.ext /Lyrics/Title.ext /Lyrics/Musics/Artist/Album/Title.ext /Lyrics/Musics/Artist/Title.ext /Lyrics/Musics/Title.ext /Lyrics/Title.ext The Rockbox manual MPIO HD300 (version 3.14)
  • Page 153 Encoding. Sets the codepage used in the plugin. Read ID3 tag. Read lyrics from id3 tags in mp3 files. Lrc Directory. Set the directory where lyrics files are stored, must be a maximum of 63 bytes. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 154: Main Menu Configuration

    In addition, the display also indicates the beats while playing so that you can discreetly place the device in your sight for checking the tempo instead of wearing headphones at a concert. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 155 – smooth tempo changes with configurable acceleration, and custom beat patterns (tick/tock/silence on each beat), default being emphasis (tick) on first beat, normal sound (tock) on others. The button mapping is different to enable navigation in the programmed track. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 156 The first one goes from 90 to 150 bpm in an endless part with 0.25 bpm increase per bar. The second one goes down from 150 to 90 with 4 bars per bpm change, which is The Rockbox manual MPIO HD300 (version 3.14)
  • Page 157 8 2/4 90-150 # speeding up to 150 bpm again flow: 4 # steady 4/4 at 150 bpm death: 8 150-60 # going down to 60 final: 1 1/1 60 # one last hit The Rockbox manual MPIO HD300 (version 3.14)
  • Page 158: One-Time Password Client

    (TOTP). If you answer “yes” to this question, it will ask for further information regarding the account. Usually it is safe to accept the defaults here. However, if your device lacks a real-time clock, the plugin’s functionality will be The Rockbox manual (version 3.14) MPIO HD300...
  • Page 159: Advanced Settings

    Menu Open menu Long Menu Exit 12.4.19. Random Folder Advance Configuration This plugin is used to configure the folders which will be considered when the Auto- Change Directory feature is set to Random. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 160: Resistor Calculator

    Enter Delete selected folder Long Enter Bring up the context menu which allows you to remove the selected folder or its entire folder tree Menu Exit 12.4.20. Resistor Calculator Figure 12.53.: Resistor calculator The Rockbox manual MPIO HD300 (version 3.14)
  • Page 161: Stats

    The stats plugin counts the directories and files (the total number as well as the number of audio, playlist, image and video files) on your player. Press Menu or Long Menu to abort counting and exit the plugin. Press it again to quit after counting has finished. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 162: Stopwatch

    Edit the highlighted text line or insert a new one using the Item Menu. When finished editing exit the Text Editor. You’ll be shown a list of save options. Note: When you have not changed the file the Text Editor will quit immediately. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 163 Chapter 12. Plugins Action Enter Edit Line / Select Character Menu Exit / Abort Editing Long Menu Show Item Menu Long Enter Delete Line The Rockbox manual MPIO HD300 (version 3.14)
  • Page 164: Advanced Topics

    File Browser. If you want a font to be loaded automatically every time you start up, it must be located in the /.rockbox/fonts directory and the filename must be at most 24 characters long. You can browse the fonts in /.rockbox/fonts under The Rockbox manual MPIO HD300 (version 3.14)
  • Page 165: Loading Languages

    ‘-’ as a placeholder. The syntax is very similar to WPS viewports (see section 13.2.2 (page 167)). Briefly: ‘fgshade’ and ‘bgshade’ are numbers in the range 0 (= black) to 3 (= white). The Rockbox manual MPIO HD300 (version 3.14)
  • Page 166: Configuring The Theme

    All full list of the available tags are given in appendix section (page 185); some of the more powerful concepts in theme design are discussed below. All characters not preceded by % are displayed as typed. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 167 %sthat point. The lines will scroll if this text does not fit in the viewport. %sThe user font is used, the foreground colour is set to black and the %sbackground is set to white. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 168 Viewports can share identifiers so that you can display multiple viewports with one %Vd line. Example %?C<%Vd(a)|%Vd(b)> %Vl(a,10,10,50,50,-) %Cl(0,0,50,50,c,c) %Vl(a,0,70,70,14,1) %s%acThere you have it: Album art. %Vl(b,20,14,50,14,1) %t(1)%acWarning:;%t(.1) %Vl(b,20,30,50,50,1) %sNo album art found %scheck your filenames. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 169: Info Viewport (Sbs Only)

    If the tag specified by “xx” has a value, the text between the “<” and the “|” is displayed (the true part), else the text between the “|” and the “>” is displayed (the false part). The else part is optional, so the “|” does not have to be specified The Rockbox manual MPIO HD300 (version 3.14)
  • Page 170 Each alternating subline can still be optionally scrolled while it is being displayed, and scrollable formats can be displayed on the same line with non-scrollable formats (such as track elapsed time) as long as they are separated into different sublines. Example subline definition: The Rockbox manual MPIO HD300 (version 3.14)
  • Page 171 3. Load an image and show as backdrop using the %X tag. The image must be of the same exact dimensions as your display. Example on background image use: Example %X(background.bmp) The image with filename background.bmp is loaded and used in the WPS. Example on bitmap preloading and use: The Rockbox manual MPIO HD300 (version 3.14)
  • Page 172: Managing Rockbox Settings

    1. Each setting must be on a separate line. 2. Each line has the format “setting: value”. 3. Values must be within the ranges specified in this manual for each setting. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 173: The Manage Settings Menu

    Save .cfg File This option writes a .cfg file to your player’s disk. The configuration file has the .cfg extension and is used to store all of the user settings that are described throughout this manual. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 174: Firmware Loading

    Having a large anti-skip buffer 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 (page 56)). The Rockbox manual MPIO HD300 (version 3.14)
  • Page 175: Replaygain

    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 (page 47)). The Rockbox manual MPIO HD300 (version 3.14)
  • Page 176: File Formats

    Start the plugin .rock Text File Display the text file using the text .txt viewer plugin Voice file Allow Rockbox to speak menus .voice While Playing Screen Load the new WPS display config- .wps uration The Rockbox manual MPIO HD300 (version 3.14)
  • Page 177: Audio And Metadata Formats

    Dialogic telephony type .vox Windows Media Audio Standard .wma, .wmv, .asf Windows Media Audio Professional .wma, .wmv, .asf Note: AAC-HE profiles might not play in realtime on all devices due to CPU perfor- The Rockbox manual MPIO HD300 (version 3.14)
  • Page 178: Lossless Codecs

    DVI ADPCM (IMA ADPCM) 2/3/4/5 bit, Dialogic OKI AD- PCM, YAMAHA ADPCM, Adobe SWF ADPCM Wavpack Note: Free Lossless Audio multichannel tracks may not play in realtime on all devices due to CPU performance requirements. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 179: Other Codecs

    Atari SAP .sap Sound Interface Device Progress .sid seek use subtracks instead of seconds. SPC700 .spc Note: NSF and VGM might not play in realtime on all devices due to CPU performance requirements. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 180: Codec Featureset

    Note: The seek implementations of NES Sound Format, Sound Interface Device, Game Boy Sound Format, AY Sound Chip Music, Hudson Entertainment System Sound, For- mat, MSX Konami Sound System and SMS/GG/CV Sound Format use subtracks instead of seconds, whereas each subtrack equals a second. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 181: Supported Metadata Tags

    Disc (string or number) Track (string or number) Year (string or number) Composer (string) Comment (string) Albumartist (string) Grouping (string) Note: Embedded album art for ASF is limited to pictures of maximum 64 KB size. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 182: Featureset For Codec Specific Metadata

    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. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 183: Album Art

    (a list in braces means that those file extensions are tried in that order): 1. embedded (JPEG images in ID3v2 or MP4 tags only) 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 Rockbox manual MPIO HD300 (version 3.14)
  • Page 184 If no album artist is set, artist will be used instead. See AlbumArt in the wiki for programs that will help you automate the process of putting album art on your player. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 185: Theme Tags

    When used conditionally, the “true” branch is completely ignored if it does not apply. Example: %?cc<%cH:%cM|No clock detected> The Rockbox manual MPIO HD300 (version 3.14)
  • Page 186: Information From The Track Tags

    %V tag explained above. See section 13.2.2. Set the Info Viewport to use the viewport called label, as %VI(’label’) declared with the previous tag. Draw this viewport on the backdrop layer. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 187: Additional Fonts

    “p” if the charger is connected (only on targets that can charge batteries) “c” if the unit is currently charging the battery (only on tar- gets that have software charge control or monitoring) Remaining time of the sleep timer (if it is set) The Rockbox manual MPIO HD300 (version 3.14)
  • Page 188: Information About The File

    %d(1) is “Isola”, %d(2) is “Kent” and %d(3) is “Rock”. These tags, when written with the first letter capitalized (e.g. %Fn or %D(2)), produce the information for the next file to be played. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 189: Playlist/Song Info

    10 seconds if no number is specified. %?pE(7)<in the last 7 seconds of track|in the rest of the track> Current playback pitch D.10. Playlist Viewer Description Display the playlist viewer in the current viewport. %Vp(start,code to render) The Rockbox manual MPIO HD300 (version 3.14)
  • Page 190: D.11.Runtime Database

    Crossfade setting, in the order: Off, Auto Skip, Man Skip, Shuffle, Shuffle and Man Skip, Always ReplayGain value (x.y dB). used conditional, Replaygain type use: %?rg<Off|Track|Album|TrackShuffle|AlbumShuffle|No tag> D.13. Hold Description “h” if the main unit keys are locked The Rockbox manual MPIO HD300 (version 3.14)
  • Page 191: D.14.Virtual Led

    Play status, 0-4, in the order: Stop, Play, Pause, Fast For- ward, Rewind, Recording, Recording paused, FM Radio play- ing, FM Radio muted Example: %?mp<Stop|Play|Pause|Ffwd|Rew|Rec|Rec pause|FM|FM pause> D.17. Current Screen Description The current screen, 1-20, in the order shown below The Rockbox manual MPIO HD300 (version 3.14)
  • Page 192: D.18.List Title (.Sbs Only)

    %?Lt<%Lt> to display the title within the viewport. If %Lt is present anywhere in the .sbs, then the %Vi viewport will not show the title. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 193: D.19.Changing Volume

    Draw a bar using from the setting. See section D.28 (page 199) %St(...) for details. Examples: 1. As a simple tag: %St(skip length) 2. As a conditional: %?St(eq enabled)<Eq is enabled|Eq is disabled> The Rockbox manual MPIO HD300 (version 3.14)
  • Page 194: D.21.Images

    9-patch images are bitmaps split into 9 segments where the four corners are unscaled, the four middle sections are scaled along one axis and the middle section is scaled on both axis. n: image ID Examples: The Rockbox manual MPIO HD300 (version 3.14)
  • Page 195: How To Display The Album Art

    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„) The Rockbox manual MPIO HD300 (version 3.14)
  • Page 196: D.22.Fm Radio

    They need to be in either .bmp or .jpg format, and the radio must be in preset mode and tuned to a preset (and not recording) in order for them to be shown. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 197: D.23.Alignment And Language Direction

    Logical “and” operator. Will be evaluate to true if all the tag %and(tag1, tag2, parameters are true.., tagN) Logical “or” operator. Will be evaluate to true if any of the %or(tag1, tag2, tag parameters are true.., tagN) Examples of the %if tag: The Rockbox manual MPIO HD300 (version 3.14)
  • Page 198: D.25.Subline Tags

    Seconds 2-digit year 4-digit year Capital AM/PM Lowercase am/pm Weekday name Month name Day of week from 1 to 7, 1 is Monday Day of week from 0 to 6, 0 is Sunday The Rockbox manual MPIO HD300 (version 3.14)
  • Page 199: D.27.Text Translation

    – draw a preloaded image under the bar. The full image will be displayed and must be the same size as the bar. This must be followed by the label of the desired image. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 200: D.29.Other Tags

    – tag to get number – OPTIONAL. if this is present it will assume the substring is a number so it can be used with conditionals. (i.e %cM). 0 is the first conditional option The Rockbox manual MPIO HD300 (version 3.14)
  • Page 201 (given that the text is displayed; see conditionals above). You can specify up to ten scrolling lines. Scrolling lines can not contain dynamic content such as timers, peak meters or progress bars. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 202: Config File Options

    0 to 2500 scroll step devise a way to get ranges pixels from config-*.h screen scroll step devise a way to get ranges pixels from config-*.h Screen Scrolls Out Of on, off View The Rockbox manual MPIO HD300 (version 3.14)
  • Page 203 0 to 15 disable autoresume if off, on phones not present Last.fm Logging off, on talk dir off, number, spell talk dir clip off, on talk file off, number, spell The Rockbox manual MPIO HD300 (version 3.14)
  • Page 204 0 to 60 0.1 dB crossfeed cross gain 30 to 120 0.1 dB crossfeed hf attenuation 60 to 240 0.1 dB crossfeed hf cutoff 500 to 2000 eq enabled on, off The Rockbox manual MPIO HD300 (version 3.14)
  • Page 205 0 to 89 (dB) or 0 to 100 (%) dB or % peak meter max 0 to 89 /(dB) or 0 to 100 (%) dB or % statusbar off, top, bottom scrollbar off, left, right The Rockbox manual MPIO HD300 (version 3.14)
  • Page 206 0 to 15 editable recordings off,on rec timesplit off, 0:05, 0:10, 0:15, 0:30, 1:00, h:mm 2:00, 4:00, 6:00, 8:00, 16:00, 24:00 pre-recording time off, 1 to 30 rec path /path/to/dir force fm mono off, on The Rockbox manual MPIO HD300 (version 3.14)
  • Page 207: Menu Overview

    Appendix F. Menu Overview F. Menu Overview include an overview of the menu structure here The Rockbox manual MPIO HD300 (version 3.14)
  • Page 208: User Feedback

    2. Check that the feature has not already been implemented. Download the latest current/daily build and/or search the mail list archive. 3. Check that the feature is possible to implement (see section G.2.2 (page 209)). The Rockbox manual MPIO HD300 (version 3.14)
  • Page 209: Features We Will Not Implement

    Re- member, DRM achieves part of its security through obscurity, and publishing the keys necessary to decrypt DRM’d media would essentially render it useless. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 210: Credits

    Jonathan Gordon Tat Tang Toshi- lore Huw Smith Garrett Derner hiko Itoh David J. Song Jeong Taek Barry McIntosh Leslie Donald- Anders Kagerin Peter D’Hoye Lee Pilgrim Zakk Roberts Ben Basha Brandon Low Nathan The Rockbox manual MPIO HD300 (version 3.14)
  • Page 211 Andrew Cupper Thilo-Alexander ulea Peter Harley Max Kel- Ginkel Adam Gashlin Robert Kukla Alexander Eickhoff Ken Faz- David Quesada Jared Stafford zone David Bishop Hein-Pieter Martin Hensel Stéphane Doyon van Braam Przemysław Hołubowski The Rockbox manual MPIO HD300 (version 3.14)
  • Page 212 Rafaël Carré Denes Balatoni Hughes Laurent Gautier Simon Wallace Eric Lassauge François Zhukovsky Daniel Kluz Phinit- Dinel Francesco Rigoni Joël Puik nun Chanasabaeng Tse-Hsien Chiang Klaas Bosteels Teruaki Kawashima Szymon Dziok Domenico Di Misa The Rockbox manual MPIO HD300 (version 3.14)
  • Page 213 Maksim others) The Fabother World team Postolati Stanislav Chizhik Desu (Fabien Sanglard and others) Rozen Olivier Kaloudoff Kessia sgt-puzzles team (Simon Tatham and Pinheiro Jean-Louis Biasini Lorenzo others) Miori James Hunt Artur Juraszek The Rockbox manual MPIO HD300 (version 3.14)
  • Page 214: Licenses

    Any member of the public is a licensee, and is addressed as “you”. You accept the license if you copy, modify or distribute the work in a way requiring permission under copyright law. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 215 A section “Entitled XYZ” means a named subunit of the Document whose title ei- The Rockbox manual MPIO HD300 (version 3.14)
  • Page 216 Transparent copy of the Document, free of added material. If you use the latter option, you must take reasonably prudent steps, when you begin The Rockbox manual MPIO HD300 (version 3.14)
  • Page 217 Modified 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 The Rockbox manual MPIO HD300 (version 3.14)
  • Page 218 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 Modified Version. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 219 Cover Texts may be placed on covers that bracket the Document within the aggregate, or the electronic equivalent of covers if the Document is in electronic form. Otherwise they must appear on printed covers that bracket the whole aggregate. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 220 ADDENDUM: How to use this License for your documents To use this License in a document you have written, include a copy of the License in the document and put the following copyright and license notices just after the title page: The Rockbox manual MPIO HD300 (version 3.14)
  • Page 221 If your document contains nontrivial examples of program code, we recommend re- leasing these examples in parallel under your choice of free software license, such as the GNU General Public License, to permit their use in free software. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 222: The Gnu General Public License

    To prevent this, we have made it clear that any patent must be licensed for everyone’s free use or not licensed at all. The precise terms and conditions for copying, distribution and modification follow. GNU General Public License The Rockbox manual MPIO HD300 (version 3.14)
  • Page 223 License. (Exception: if the Program itself is interactive but does not normally print The Rockbox manual MPIO HD300 (version 3.14)
  • Page 224 (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable. The Rockbox manual MPIO HD300 (version 3.14)
  • Page 225 Many people have made generous contributions to the wide range of software distributed through that system in The Rockbox manual MPIO HD300 (version 3.14)
  • Page 226 12. In no event unless required by applicable law or agreed to in writ- ing will any copyright holder, or any other party who may modify The Rockbox manual MPIO HD300 (version 3.14)
  • Page 227 If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) <year> <name of author> Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type The Rockbox manual MPIO HD300 (version 3.14)
  • Page 228 If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Library General Public License instead of this License. The Rockbox manual MPIO HD300 (version 3.14)

Table of Contents