IRiver H320 Manual

IRiver H320 Manual

Rockbox manual
Hide thumbs Also See for H320:
Table of Contents

Advertisement

The Rockbox Manual
for
Iriver H320 and H340
rockbox.org
September 24, 2008

Advertisement

Table of Contents
loading

Summary of Contents for IRiver H320

  • Page 1 The Rockbox Manual Iriver H320 and H340 rockbox.org September 24, 2008...
  • Page 2 Rockbox http://www.rockbox.org/ Open Source Jukebox Firmware Rockbox and this manual is the collaborative effort of the Rockbox team and its contributors. See the appendix for a complete list of contributors. c 2003-2008 The Rockbox Team and its contributors, c 2004 Christi Alice Scarborough, c 2003 Jos´...
  • Page 3: Table Of Contents

    ONTENTS Contents 1 Introduction 1.1 Welcome ........1.2 Getting more help .
  • Page 4: Contents

    ONTENTS 4.2.2 Initializing the Database ......4.2.3 The Database Menu ......4.2.4 Using the Database .
  • Page 5: Contents

    ONTENTS 6.7 Crossfeed ........6.8 Equalizer .
  • Page 6 ONTENTS 10.1.5 Chopper ....... . . 10.1.6 Dice ........10.1.7 Doom .
  • Page 7: Contents

    ONTENTS 10.3.7 Rockboy ....... . . 114 10.3.8 Search ........115 10.3.9 Sort .
  • Page 8: Contents

    ONTENTS B.2 ID3 Info ........140 B.3 Power Related Information .
  • Page 9: Introduction

    1. I HAPTER NTRODUCTION 1 Introduction 1.1 Welcome This is the manual for Rockbox. Rockbox is an open source firmware replacement for a growing number of digital audio players. Rockbox aims to be considerably more functional and efficient than your device’s stock firmware while remaining easy to use and customisable.
  • Page 10: Naming Conventions And Marks

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

    Rockbox. This is the component of Rockbox that is installed to the flash memory of your Iriver. The Rockbox firmware. Unlike the Iriver 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 12: Installing Rockbox

    2. I HAPTER NSTALLATION during automatic installation, you need to know where to access the player. On Windows this means you need to figure out the drive letter associated with the player. On Linux you need to know the mount point of your player. For manual installation and customization additional software is required.
  • Page 13: Manual Installation

    2. I HAPTER NSTALLATION values. The mountpoint indicates the location of the player in your filesystem. On Win- dows, this is the drive letter the player gets assigned, on other systems this is a path in the filesystem. Note: Rockbox Utility currently lacks some guiding messages. Please have a look at the manual installation instructions if you are stuck during installation.
  • Page 14 If you wish to install Rockbox on a US Iriver H320 and H340, you must first install a non-US version of the orig- inal firmware and then install one of the supported versions patched with the Rockbox bootloader.
  • Page 15 2. I HAPTER NSTALLATION Warning: Installing non-US firmware on a US Iriver H320 and H340 will perma- nently remove DRM support from the player. If the file that you downloaded is a .zip file, use an unzip utility like mentioned in the prerequisites section to extract the .hex from the .zip file to your desktop.
  • Page 16: Enabling Speech Support (Optional)

    Note: If you install the Rockbox bootloader but do not install the Rockbox firmware the Rockbox bootloader will load the Iriver firmware when the jukebox is turned on. To load the Iriver firmware press and hold Rec before powering up the player until the Iriver logo appears.
  • Page 17: Automatic Uninstallation

    firmware. If you wish to clean up your disk, you may also wish to delete the .rockbox direc- tory and its contents. Turn the Iriver off. Turn the player back on and the original Iriver software will load. OCKBOX MANUAL...
  • Page 18: Quick Start

    3. Q HAPTER UICK TART 3 Quick Start 3.1 Basic Overview 3.1.1 The player’s controls Throughout this manual, the buttons on the player are labelled according to the pic- ture above. Whenever a button name is prefixed by “Long”, a long press of approxi- mately one second should be performed on that button.
  • Page 19: Turning The Player On And Off

    3. Q HAPTER UICK TART 3.1.2 Turning the player on and off To turn on and off your Rockbox enabled player use the following keys: Action Play Start Rockbox Long Stop Shutdown Rockbox On shutdown, Rockbox automatically saves its settings. If you have problems with your settings, such as accidentally having set the colours to black on black, they can be reset at boot time.
  • Page 20: Basic Concepts

    3. Q HAPTER UICK TART the tree view use Down and Up to move around the selection. Use Navi or Right to select an item. When browsing the file system selecting an audio file plays it. The view switches to the “While playing screen”, usually abbreviated as “WPS” (see section (page 28).
  • Page 21: Charging

    3. Q HAPTER UICK TART 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 get displayed garbled. 3.3 Charging The player can be powered over USB without connecting to your computer by holding A-B while plugging in.
  • Page 22: Browsing And Playing

    4. B HAPTER ROWSING AND PLAYING 4 Browsing and playing 4.1 File Browser Figure 4.1: The file browser Rockbox lets you browse your music in either of two ways. The F lets ROWSER you navigate through the files and directories on your player, entering directories and executing the default action on each file.
  • Page 23: File Browser Controls

    4. B HAPTER ROWSING AND PLAYING 4.1.1 File Browser Controls Action Up/Down Go to previous/next item in list. If you are on the first/last entry, the cursor will wrap to the last/first entry. Play+Up/ Down Move one page up/down in the list. Go to the parent directory.
  • Page 24 4. B HAPTER ROWSING AND PLAYING The C contains the following options (unless otherwise noted, each ONTEXT option pertains both to files and directories): Playlist. Enters the P (see section 4.4.3 (page 35)). LAYLIST UBMENU Playlist Catalog. Enters the P (see section 4.4.2 (page 34)).
  • Page 25: Virtual Keyboard

    4. B HAPTER ROWSING AND PLAYING 4.1.3 Virtual Keyboard Figure 4.3: The virtual keyboard This is the virtual keyboard that is used when entering text in Rockbox, for example when renaming a file or creating a new directory. The virtual keyboard can be easily changed by making a text file with the required layout.
  • Page 26: Database

    4. B HAPTER ROWSING AND PLAYING 4.2 Database 4.2.1 Introduction This chapter describes the Rockbox music database system. Using the information con- tained in the tags (ID3v1, ID3v2, Vorbis Comments, Apev2, etc.) in your audio files, Rockbox builds and maintains a database of the music files on your player and allows you to browse them by Artist, Album, Genre, Song Name, etc.
  • Page 27: Using The Database

    4. B HAPTER ROWSING AND PLAYING ) is ETTINGS ENERAL ETTINGS YSTEM IRECTORY ACHE enabled. U includes that check whether dircache has been enabled or PDATE NOW not. Initialize Now You can force Rockbox to rescan your disk for tagged files by using the function in the D NITIALIZE ATABASE...
  • Page 28: While Playing Screen

    4. B HAPTER ROWSING AND PLAYING Type Origin filename string system album string id tag albumartist string id tag artist string id tag comment string id tag composer string id tag genre string id tag grouping string id tag title string id tag bitrate...
  • Page 29: Wps Key Controls

    4. B HAPTER ROWSING AND PLAYING The ID3 album name. The ID3 artist name. Bit rate. VBR files display average bitrate and “(avg)” Elapsed and total time. A slidebar progress meter representing where in the song you are. Peak meter. See section 11.2 (page 132) for details of customising your WPS (While Playing Screen).
  • Page 30: Peak Meter

    4. B HAPTER ROWSING AND PLAYING 4.3.2 Peak Meter The peak meter can be displayed on the While Playing Screen and consists of several indicators. For a picture of the peak meter, please see the While Recording Screen in section 5.8.1 (page 41).
  • Page 31 4. B HAPTER ROWSING 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 file to a playlist. Select the playlist you want the file to be added to and it will get appended to that playlist.
  • Page 32 4. B HAPTER ROWSING 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 file formats to keep information on artist, album etc.
  • Page 33: Working With Playlists

    4. B HAPTER ROWSING AND PLAYING Action Toggle pitch changing mode Up / Down Increase / Decrease pitch by 0.1% (in pro- centual mode) or a semitone (in semitone mode) Long Up / Long Increase / Decrease pitch by 1% (in pro- Down centual mode) or a semitone (in semitone mode)
  • Page 34 4. B HAPTER ROWSING AND PLAYING By selecting (“playing”) a song from the File Browser Whenever a song is selected from the F with Navi or Right, Rockbox will ROWSER automatically create a playlist containing all of the songs in that directory and start playback with the selected song.
  • Page 35: Adding Music To Playlists

    4. B HAPTER ROWSING AND PLAYING 4.4.3 Adding music to playlists Adding music to a dynamic playlist Figure 4.5: The Playlist Submenu The P is a submenu in the C (see section 4.1.2 (page 23)), LAYLIST UBMENU ONTEXT it allows you to put tracks into a “dynamic playlist”. If there is no music currently play- ing, Rockbox will create a new dynamic playlist and put the selected track(s) into it.
  • Page 36: Modifying Playlists

    4. B HAPTER ROWSING AND PLAYING Play Next. Replaces all but the current playing track with track(s). Current playing track is queued. The P can be used to add either single tracks or entire directories LAYLIST UBMENU to a playlist. If the P is invoked on a single track, it will put only that LAYLIST UBMENU...
  • Page 37: Loading Saved Playlists

    4. B HAPTER ROWSING AND PLAYING 4.4.6 Loading saved playlists Through the F ROWSER Playlist files, like regular music tracks, can be selected through the F ROWSER When loading a playlist from disk it will replace the current dynamic playlist. Through the P LAYLIST CATALOG The P...
  • Page 38: The Main Menu

    5. T HAPTER 5 The Main Menu 5.1 Introducing the Main Menu Figure 5.1: The main menu The M is the screen from which all of the Rockbox functions can be accessed. This is the first screen you will see when starting Rockbox. To return to the M , press the A-B button.
  • Page 39: Navigating The Main Menu

    5. T HAPTER 5.2 Navigating the Main Menu Action Moves up in the menu. Inside a setting, increases the value or chooses next option Down Moves down in the menu. Inside a setting, decreases the value or chooses previous option Navi/Right Selects option Stop/Left...
  • Page 40: Database

    5. T HAPTER 5.5 Database Browse by the meta-data in your audio files (see section (page 26)). 5.6 Now Playing/Resume Playback Go to the W and resume if music playback is stopped or paused HILE LAYING CREEN and there is something to resume (see section (page 28)).
  • Page 41: Recording Settings

    5. T HAPTER 5.7.5 Recording Settings The R menu allows you to configure settings related to recording. ECORDING ETTINGS The details of this menu are covered in detail in section (page 69). 5.8 Recording 5.8.1 While Recording Screen Figure 5.3: The while recording screen Entering the R option in the M brings up a screen in which you...
  • Page 42: Fm Radio

    5. T HAPTER Action Up / Down Select setting. Left / Right Adjust selected setting. Play Start recording. While recording: pause recording (press again to continue). Stop Exit R ECORDING CREEN While recording: Stop recording. Starts recording. While recording: close the current file and open a new one.
  • Page 43: Playlist

    5. T HAPTER Action Left, Right Change frequency in SCAN mode or jump to next/previous station in PRE- SET mode Long Left, Right Seek to next station or preset in SCAN mode. Up, Down Change volume. Leave the radio screen with the radio playing.
  • Page 44: Plugins

    5. T HAPTER 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 mem- ory.
  • Page 45: Quick Screen

    5. T HAPTER 5.13 Quick Screen Whilst not strictly part of the M , it is worth noting that a few of the more commonly used settings are available from the Q . The Q UICK CREEN UICK CREEN screen is accessed with Long A-B and exited with A-B. It allows rapid access to the and R modes (section (page 52)) and the S...
  • Page 46: Sound Settings

    6. S HAPTER OUND ETTINGS 6 Sound Settings Figure 6.1: The sound settings screen The sound settings menu offers a selection of sound settings you may change to cus- tomise your listening experience. 6.1 Volume This setting adjusts the volume of your music. Like most professional audio gear and many consumer audio products, Rockbox uses a decibel scale where 0 dB is a refer- ence that indicates the maximum volume that the player can produce without possible distortion (clipping).
  • Page 47: Treble

    6. S HAPTER OUND ETTINGS 6.3 Treble This setting emphasises the higher (treble) frequencies in the sound. A value of 0 dB means that treble sounds are unaltered (flat response). The minimum setting is 0 dB and the maximum is 6 dB. 6.4 Balance This setting controls the balance between the left and right channels.
  • Page 48: Crossfeed

    6. S HAPTER OUND ETTINGS 6.7 Crossfeed Crossfeed attempts to make the experience of listening to music on headphones more similar to listening to music with stereo speakers. When you listen to music through speakers, each ear will hear sound originating from both speakers. However, the sound from the left speaker reaches your right ear slightly later than it does your left ear, and vice versa.
  • Page 49: Equalizer

    6. S HAPTER OUND ETTINGS 6.8 Equalizer Figure 6.2: The graphical equalizer Rockbox features a parametric equalizer (EQ). As the name suggests, a parametric EQ lets you control several different parameters for each band of the EQ. In some ways the EQ is similar to the B and T settings described earlier, but the EQ allows you...
  • Page 50 6. S HAPTER OUND ETTINGS stereo systems does. The high shelf filter is adjusted the same way as the low shelf filter, except that it works on the high end of the frequency spectrum rather than the low end. As a general guide, EQ band 0 should be used for low frequencies, EQ bands 1 through 3 should be used for mids, and EQ band 4 should be used for highs.
  • Page 51: Dithering

    6. S HAPTER OUND ETTINGS 6.9 Dithering This setting controls the dithering and noise shaping functionality of Rockbox. Most of Rockbox’ audio file decoders work at a higher bit depth than the 16 bits used for output on the player’s audio connectors. The simplest way to convert from one bit depth to another is simply discarding all the surplus bits.
  • Page 52: General Settings

    7. G HAPTER ENERAL ETTINGS 7 General Settings Figure 7.1: The general settings screen 7.1 Playback The P sub menu allows you to configure settings related to audio playback. LAYBACK Shuffle Turning shuffle on will cause Rockbox to randomly re-order the playlist. Thus, to shuffle all of the audio files on the player, you first need to create a playlist con- taining all of them.
  • Page 53 7. G HAPTER ENERAL ETTINGS A-B Repeats between two user defined points within a track, typically used by musicians when attempting to learn a piece of music. 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.
  • Page 54 7. G HAPTER ENERAL ETTINGS Crossfade This setting enables a cross-fader. At the end of a song, the song will fade out as the next song fades in, creating a smooth transition between songs. The crossfade setting is particularly effective when the player is set on shuffle. Options for crossfade settings are: Enable Crossfade If set to O , crossfade is disabled.
  • Page 55 7. G HAPTER ENERAL ETTINGS Replaygain This allows you to control the replaygain function. The purpose of replay- gain is to adjust the volume of the music played so that all songs (or albums, de- pending on your settings) have the same apparent volume. This prevents sudden changes in volume when changing between songs recorded at different volume levels.
  • Page 56: Playlist

    7. G HAPTER ENERAL ETTINGS cause clipping, unless prevent clipping is enabled. The pre-amp can be set to any decibel (dB) value between -12dB and +12dB, in increments of 0.1dB. Beep Volume Controls the volume of the beep that is heard when skipping forward or backward between tracks.
  • Page 57: File View

    7. G HAPTER ENERAL ETTINGS Warn When Erasing Dynamic Playlist. If set to Y , Rockbox will provide a warn- ing if the user attempts to take an action that will cause Rockbox to erase the current dynamic playlist. 7.3 File View The File View menu deals with options relating to how the File Browser displays files.
  • Page 58: Database

    7. G HAPTER ENERAL ETTINGS If F is set to N , when you enter the F from the OLLOW LAYLIST ROWSER WPS, you will find yourself in the directory you were in when you last left the ROWSER Show Path: If this setting is set to F the full path to the current directory will be displayed on the first line in the F .
  • Page 59 7. G HAPTER ENERAL ETTINGS Upside Down: Displays the screen so that the top of the display is nearest the buttons. This is sometimes useful when carrying the player in a pocket for easy access to the headphone socket. Remote-LCD Settings: This sub menu contains settings that relate to the display of the remote.
  • Page 60 7. G HAPTER ENERAL ETTINGS Bidirectional Scroll Limit: Rockbox has two different automatic horizontal scrolling methods: 1) always scrolling the text to the left until the line has ended and then beginning again at the start, and 2) moving to the left until you can read the end of the line and then scrolling right until you see the beginning again.
  • Page 61: System

    7. G HAPTER ENERAL ETTINGS set to L (dB) scale, the volume values are scaled logarithmically. OGARITHMIC The volume meters of digital audio devices usually are scaled this way. On the other hand, if you are interested in the power level that is applied to your headphones you should choose L display.
  • Page 62: Disk

    7. G HAPTER ENERAL ETTINGS ing it O is recommended if the dap is connected through an unpowered USB hub or a laptop port. 7.6.3 Disk Options relating to the hard disk. Disk Spindown: Rockbox has a timer that makes it spin down the hard disk after it is idle for a certain amount of time.
  • Page 63: Car Adapter Mode

    7. G HAPTER ENERAL ETTINGS values will shorten the music buffer, so you should increase this setting only if you have directories with a large number of files. Max Playlist Size: This setting controls the maximum size of a playlist. The playlist size can be between 1,000 and 32,000 files, in steps of 1,000 (default is 10,000).
  • Page 64: Language

    7. G HAPTER ENERAL ETTINGS With the two R options, nothing is written to the .bmark file. If ECENT the M option is enabled, the AINTAIN A LIST OF ECENTLY OOKMARKS bookmarking information will however be added to recent bookmarks list. Note: The R function remembers your position in the most recently ac- ESUME...
  • Page 65 7. G HAPTER ENERAL ETTINGS by the extension .voice. So for English, the file name would be english.voice. This option is on by default, but will do nothing unless the appropriate voice file is installed in the correct place on the player. The Voice Menus have several limi- tations: Setting the Sound Option C to K...
  • Page 66 7. G HAPTER ENERAL ETTINGS Say File Type. This option turns on voicing of file types when V OICE ILENAMES set to S or N . When V is set to S , “Directory” PELL UMBERS OICE IRECTORIES PELL will be voiced after each spelled out directory. Announce Battery Level.
  • Page 67: Theme Settings

    8. T HAPTER HEME ETTINGS 8 Theme Settings The T menu offers options that you can change to customize the visual HEME ETTINGS apperance of Rockbox. Browse Themes. This option will display all the currently installed themes on the player, press Navi or Right to load the chosen theme and apply it. A theme is a configuration file, stored in a specific directory, that typically changes the WPS and remote WPS, font used and on some platforms additional informa- tion such as background image and text colours.
  • Page 68 8. T HAPTER HEME ETTINGS 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. Bar (Solid Colour): A bar with a solid colour, the colour is set in the C OLOURS submenu.
  • Page 69: Recording Settings

    9. R HAPTER ECORDING ETTINGS 9 Recording Settings Figure 9.1: The recording settings screen Note: To change the location where recordings are stored open the C ONTEXT (see section 4.1.2 (page 23)) on the directory where you want to store them in the F and select S ROWSER ECORDING...
  • Page 70: Source

    9. R HAPTER ECORDING ETTINGS 9.4 Source Choose the source of the recording. The options are: M , and L . For recording from the radio see section (page 42). 9.5 Channels This allows you to select mono or stereo recording. Please note that for mono recording, only the left channel is recorded.
  • Page 71: Clipping Light

    9. R HAPTER ECORDING ETTINGS 9.9 Clipping Light Causes the backlight to flash on when clipping has been detected. Options: O AIN UNIT ONLY AIN AND REMOTE UNIT EMOTE UNIT ONLY 9.10 Trigger When you record a source you often are only interested in the sound and not the silence in between.
  • Page 72: Automatic Gain Control

    9. R HAPTER ECORDING ETTINGS you record via a digital input as even the noise of the device itself would exceed this threshold immediately. for at least The start duration defines the minimal duration that a signal must exceed the start threshold to start the recording. Depending on your situation you may want to set this setting to 0 (e.g.
  • Page 73: Agc Clip Time

    9. R HAPTER ECORDING ETTINGS DJ-Set (slow): This preset heads for a nominal target peak level of -5dB and will slowly increase or decrease gain to reach it. Medium: This preset heads for a nominal target peak level of -6dB and will increase or decrease gain to reach it.
  • Page 74: Plugins

    10. P HAPTER LUGINS 10 Plugins Plugins are programs that Rockbox can load and run. Only one plugin can be loaded at a time. Plugins have exclusive control over the user interface. This means you cannot switch back and forth between a plugin and Rockbox. When a plugin is loaded, you need to exit it to return to the Rockbox interface.
  • Page 75: Brickmania

    10. P HAPTER LUGINS For the full set of rules to the game, and other facinating information visit http://www.blackjackinfo.com/blackjack-rules.php Action In menu Play Start new game Resume saved game Navi Show high scores Stop Quit In game Left / Right / Up / Down Enter betting amount Play...
  • Page 76: Bubbles

    10. P HAPTER LUGINS Special items Displayed Name Description Normal Returns paddle to normal. Ball dies; lose a life. Life Gain a life. Fire Allows you to shoot bricks with pad- dle. Glue Ball sticks to paddle each time it hits. Ball Immediately fires another ball.
  • Page 77: Chessbox

    10. P HAPTER LUGINS Action In menu Play Start new game Resume saved game Navi Show high scores Up / Down Select starting level Stop Quit In game Play Pause game Left / Right Aim the bubble Navi Fire bubble Save game Stop Exit to menu...
  • Page 78: Chopper

    10. P HAPTER LUGINS game and watch the artificial intelligence fight against itself. When you quit the game the current state will be saved and restored when you re- sume the game. The menu also allows the user to reload the last game saved, save the current position and start a new game without having to quit the game.
  • Page 79: Doom

    10. P HAPTER LUGINS 10.1.7 Doom Figure 10.5: Doom This is the famous Doom game. Getting started For the game to run you need .wad game files located in /.rockbox/doom/ on your player. Create the directory and save the following files there: rockdoom.wad.
  • Page 80 10. P HAPTER LUGINS directory) Demos. Select which demo file to play on game start Options. Configure low-level Doom options Play Game. Launch the wad/addon/Demo chosen Options Menu. This menu has the following options: Sound. Enable or Disable sound in Doom Set Keys.
  • Page 81: Flipit

    10. P HAPTER LUGINS Keys Action Move Forward Down Down Left Turn Left Right Turn Right Shoot Open Stop Escape Navi Enter Change Weapon Play Playing the game After installation of the wad files is complete you can start the game. 10.1.8 Flipit Figure 10.6: Flipit Flipping the colour of the token under the cursor also flips the tokens above, below, left...
  • Page 82: Jewels

    10. P HAPTER LUGINS Action Up / Down / Left Move the cursor / Right Navi Flip Shuffle Play Solve Solve step by step Stop Quit the game 10.1.9 Jewels Figure 10.7: Jewels Jewels is a simple yet addicting game which involves swapping pairs of jewels in order to form connected segments of three or more of the same type.
  • Page 83: Mazezam

    10. P HAPTER LUGINS 10.1.10 MazezaM Figure 10.8: MazezaM The goal of this puzzle game is to escape a dungeon consisting of ten “mazezams”. These are rooms containing rows of blocks which can be shifted left or right. You can move the rows only by pushing them and if you move the rows carelessly, you will get stuck.
  • Page 84: Minesweeper

    10. P HAPTER LUGINS 10.1.11 Minesweeper Figure 10.9: Minesweeper plugin The classic game of minesweeper. Use the Up and Down keys to select the required percentage of mines to set the difficulty then press the Navi key to begin. The aim of the game is to uncover all of the squares on the board. If a mine is un- covered then the game is over.
  • Page 85: Pacbox

    10. P HAPTER LUGINS 10.1.12 Pacbox Figure 10.10: Pacbox Pacbox is an emulator of the Pacman arcade machine hardware. It is a port of PIE – Pacman Instructional Emulator (http://www.ascotti.org/programming/pie/pie.htm). ROMs To use the emulator to play Pacman, you need a copy of ROMs for “Midway Pacman”. Filename MD5 checksum pacman.5e...
  • Page 86: Pegbox

    10. P HAPTER LUGINS Keys Action Move Up Right Left Move Down Move Left Down Move Right Insert Coin Navi 1-Player Start Play 2-Player Start Menu 10.1.13 Pegbox Figure 10.11: pegbox To beat each level, you must destroy all of the pegs. If two like pegs are pushed into each other they disappear except for triangles which form a solid block and crosses which allow you to choose a replacement block.
  • Page 87: Pong

    10. P HAPTER LUGINS Action In game Up, Down, to move around Left, Right Navi to select/save Play to restart level to go up a level to go down a level Stop to quit 10.1.14 Pong Figure 10.12: Pong Pong is a simple two player “tennis game”. Whenever a player misses the ball the other scores.
  • Page 88: Robotfindskitten

    10. P HAPTER LUGINS 10.1.15 Robotfindskitten Figure 10.13: Robotfindskitten In this game, you are robot (#). Your job is to find kitten. This task is complicated by the existence of various things which are not kitten. Robot must touch items to determine if they are kitten or not.
  • Page 89: Rockblox1D

    10. P HAPTER LUGINS Rockblox is a rockbox version of the classic falling blocks game. The aim of the game is to make the falling blocks of different shapes form full rows. Whenever a row is com- plete it will be cleared and the game score will increase. For every ten lines completed the game level increases, making the blocks fall faster.
  • Page 90: Sliding Puzzle

    10. P HAPTER LUGINS 10.1.18 Sliding Puzzle Figure 10.15: Sliding puzzle The classic sliding puzzle game. Rearrange the pieces so that you can see the whole picture, or switch to number tiles if you like it a little easier Key controls: Action Left, Right, Up Move Tile...
  • Page 91: Snake

    10. P HAPTER LUGINS 10.1.19 Snake Figure 10.16: 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.
  • Page 92: Sokoban

    10. P HAPTER LUGINS ends when the snake hits a wall, or runs into itself. Action In menu Up / Down Set game speed Right / Left Select starting maze Select game type (A or B) Start the game Play In game Up / Down / Left Steer the snake...
  • Page 93: Solitaire

    10. P HAPTER LUGINS Action In game Up, Down, Left, Move the “sokoban” up, down, left, or Right right Stop Menu Play+Down Back to previous level Play Restart level Play+Up Go to next level Undo last movement Redo previously undone move Solution playback Play Pause/resume...
  • Page 94: Spacerocks

    10. P HAPTER LUGINS the name may not be familiar, the game itself certainly is. This is due in no small part to Microsoft’s inclusion of the the game in every version of Windows. Though popular, the odds of winning are rather low, perhaps one in thirty hands. For the full set of rules to the game, and other facinating information visit http://www.solitairecentral.com/rules/klondike.html Action...
  • Page 95: Star

    10. P HAPTER LUGINS Action Navi Shoot Thrust Left/ Right Turn left/right Down Teleport Pause game Stop Quit 10.1.24 Star Figure 10.21: Star game This is a puzzle game. It is actually a rewrite of Star, a game written by CDK designed for the hp48 calculator.
  • Page 96: Sudoku

    10. P HAPTER LUGINS Action Left Move Left Right Move Right Move Up Down Move Down Switch between circle and square A-B+Left Previous level A-B+Up Reset level A-B+Right Next level Stop Exit the game 10.1.25 Sudoku Figure 10.22: Sudoku Sudoku in Rockbox is implemented as both a plugin and a viewer. When you start Sudoku in plugin mode from the B menu, a random game will be ROWSE...
  • Page 97: Wormlet

    10. P HAPTER LUGINS The thing on the left (AKA the scratchpad) When you play Sudoku on paper most people like to mark numbers in cells that are possible candidates for the cells. This can be done with the column on the left. Change the number under the cursor to a number which might be valid and press the scratch- pad button, the number will then be added on the left.
  • Page 98 10. P HAPTER LUGINS argh-tiles. The goal is to turn your tiny worm into a big worm for as long as possible. Menu controls: Action Left / Right Controls number of worms in the game Game controls: Action Turn left Left Right Turn right...
  • Page 99 10. P HAPTER LUGINS Pause the game. Press Navi to pause the game. Press Navi again to resume the game. Stop the game. There are two ways to stop a running game. If you want to quit Wormlet entirely simply hit Stop . The game will stop immediately and you will return to the game menu.
  • Page 100: Xobox

    10. P HAPTER LUGINS When you are more experienced watch the tactics of other worms. Those worms controlled by artificial stupidity head straight for the nearest piece of food. Let the other worm have its next piece of food and head for the food it would probably want next.
  • Page 101: Demos

    10. P HAPTER LUGINS 10.2 Demos 10.2.1 Bounce Figure 10.25: Bounce This demo is of the word “Rockbox” bouncing across the screen. There is also an ana- logue clock in the background. In S the bouncing text is replaced by a CROLL MODE different one scrolling from right to left.
  • Page 102: Cube

    10. P HAPTER LUGINS 10.2.3 Cube Figure 10.26: Cube This is a rotating cube screen saver in 3D. Action Navi Display at maximum frame rate Play Pause Cycle draw mode Right / Left Select axis to adjust Up / Down Change speed/angle (speed can not be changed while paused) Quit...
  • Page 103: Demystify

    10. P HAPTER LUGINS 10.2.4 Demystify Figure 10.27: Demystify Demystify is a screen saver like demo. Action Up / Down Increase / decrease speed Right / Left Add / remove polygon Stop Quit 10.2.5 Fire Figure 10.28: Fire Fire is a demo displaying a fire effect. OCKBOX MANUAL RIVER...
  • Page 104: Logo

    10. P HAPTER LUGINS Action Up / Down Increase / decrease number of flames Toggle flame type Toggle moving flames Stop Quit 10.2.6 Logo Demo showing the Rockbox logo bouncing around the screen. Action Right / Left Increase / decrease speed on the x-axis Up / Down Increase / decrease speed on the y-axis Stop...
  • Page 105: Mosaique

    10. P HAPTER LUGINS Action Direction keys Move about the image Navi Zoom in Zoom out Play+Left Decrease iteration depth (less detail) Play+Right Increase iteration depth (more detail) Reset and return to the default image Stop Quit 10.2.8 Mosaique Figure 10.30: Mosaique This simple graphics demo draws a mosaic picture on the screen of the player.
  • Page 106: Oscilloscope

    10. P HAPTER LUGINS 10.2.9 Oscilloscope Figure 10.31: Oscilloscope This demo shows the shape of the sound samples that make up the music being played. At faster speed rates, the player is less responsive to user input and music may start to skip.
  • Page 107: Plasma

    10. P HAPTER LUGINS 10.2.10 Plasma Figure 10.32: Plasma Plasma is a demo displaying a 80’s style retro plasma effect. Action Up / Down Adjust frequency Navi Change colours Stop Quit 10.2.11 Snow Figure 10.33: Have you ever seen snow falling? This demo replicates snow falling on your screen.
  • Page 108: Starfield

    10. P HAPTER LUGINS 10.2.12 Starfield Figure 10.34: Starfield Starfield simulation (like the classic screensaver). Action Right / Left Increase / decrease number of stars Up / Down Increase / decrease speed Navi Change colours Stop Quit 10.2.13 VU meter Figure 10.35: VU-Meter OCKBOX MANUAL RIVER...
  • Page 109: Viewers

    10. P HAPTER LUGINS This is a VU meter, which displays the volume of the left and right audio channels. 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).
  • Page 110: Chip-8 Emulator

    10. P HAPTER LUGINS the directory selected, or with the file selected in the file browser. You can then play the file or do with it whatever you want. The file will not be “played” automatically. If the .link file contains only one entry no list will be shown, you will directly jump to that location.
  • Page 111: Jpeg Viewer

    10. P HAPTER LUGINS Chip8 Some places where can you can find .ch8 files: ZPluginChip8 The PluginChip8 page on www.rockbox.org has several attached: Check out the HP48 chip games section: http://www.hpcalc.org/hp48/games/chip/ PC emulator by the guy who wrote the HP48 emulator: http://www.pdc.kth.se/ lfo/chip8/CHIP8.htm Links to other chip8 emulators:...
  • Page 112: Midiplay

    10. P HAPTER LUGINS Return. Returns you to the image Note: Progressive scan and other unusual JPEG files are not supported, and will result in various “unsupported xx” messages. Processing could also fail if the image is too big to decode which will be explained by a respective message. 10.3.4 Midiplay To get MIDI file playback, a patchset is required.
  • Page 113 10. P HAPTER LUGINS Play from beginning Resume information is discarded and the video plays from the start. Resume time (min): x.x Resume video playback at stored resume time x.x (start of the video if no resume time is found). Set start time (min) A preview screen is presented consisting of a thumbnail preview and a progress bar where the user can select a start time by ’seeking’...
  • Page 114: Ppm Viewer

    10. P HAPTER LUGINS 10.3.6 PPM viewer Open a PPM file in the F to view it. ROWSER ppmviewer exits when any button is pressed. Note: Both ASCII PPM (P3) and raw PPM (P6) files are supported. For more information about PPM files, see http://netpbm.sourceforge.net/doc/ppm.
  • Page 115: Search

    10. P HAPTER LUGINS Rockboy menu Load Game. . . Loads a previously saved game. Save Game. . . Saves your current state. Options. . . Max Frameskip. Change frameskip setting to improve speed. Sound. Toggle sound on or off. Stats.
  • Page 116 10. P HAPTER LUGINS Action Scroll-up Down Scroll-down Left Top of file (Narrow mode) / One screen left (Wide mode) Right Bottom of file (Narrow mode) / One screen right (Wide mode) Play+Up One line up Play+Down One line down Play+Left One column left Play+Right...
  • Page 117: Vbrfix

    10. P HAPTER LUGINS On has a scrollbar by default, until toggled. Off has no scrollbar by default, until toggled. Overlap Pages toggles between Normal and Overlap. Yes tells page-down/page-up to retain one line from previous screen. No sets page-down/page-up to one full screen. Scroll Mode controls the function of the “Scroll-up”...
  • Page 118: Zxbox

    10. P HAPTER LUGINS 10.3.12 ZXBox Figure 10.37: ZXBox ZXBox is a port of the “Spectemu” ZX Spectrum 48k emulator for Rockbox (Zproject’s homepage). To start a game open a tape file or snapshot saved as .tap, .tzx, .z80 or .sna in the file browser.
  • Page 119: Applications

    10. P HAPTER LUGINS Save Quick Snapshot. Saves snapshot into /.rockbox/zxboxq.z80. Load Quick Snapshot. Loads snapshot from /.rockbox/zxboxq.z80. Save Snapshot. Saves a snapshot of the current state. You would enter the full path and desired name - for example /games/zx/snapshots/chuckie.sna. The snapshot format will be chosen after the extension you specified, per default .z80 will be taken in case you leave it open.
  • Page 120 10. P HAPTER LUGINS How it works After you load the plug-in the operation of your player continues as normal. You can do whatever you could do before loading the plugin except loading another plugin. If you happen to load a plugin while benchmarking, a splash screen will inform you about the termination of the benchmark.
  • Page 121: Calculator

    10. P HAPTER LUGINS M/DA (Measurements per Disk Activity) The number of measurements stored tem- porarily in memory, before written on the log file. This can give you an idea of how many voltage changes there are between disk activity (or one hour). C Stands for Charger.
  • Page 122: Chess Clock

    10. P HAPTER LUGINS Action Left / Right / Up Move around the keypad / Down Navi Select a button Delete last entered digit or clear after cal- culation Cycle through the 4 basic operators Play Calculate Stop Quit 10.4.3 Chess Clock Figure 10.39: Chess Clock The chess clock plugin is designed to simulate a chess clock, but it can be used in any kind of game with up to ten players.
  • Page 123: Clock

    10. P HAPTER LUGINS Then the maximum round time is entered. For example, this could be used to play Scrabble for a maximum of 15 minutes each, with each round taking no longer than one minute. Done. Player 1 starts in paused mode. While playing The number of the current player is displayed on the top line.
  • Page 124 10. P HAPTER LUGINS This is a fully featured analogue and digital clock plugin. Key configuration Action Left / Right Cycle through modes Up / Down Cycle through skins Main Menu Navi Start / Stop Counter Long Navi Reset Counter Stop Save Settings (if enabled) and Exit Clock Menu...
  • Page 125: Disk Tidy

    10. P HAPTER LUGINS at the lower left. The Counter, if enabled, is displayed at the lower right. The second hand, if enabled, is displayed along with the hour and minute hands. Digit display, if enabled, places “12”, “3”, “6”, and “9” around the face of the clock in their respective positions.
  • Page 126: Keybox

    10. P HAPTER LUGINS Cleaning’ to begin to process. The settings are stored in .rockbox/rocks/apps/disktidy.config, in a plain text file that is user-modifiable to allow more entries to be added. Available Options All selects all Linux, OS X, and Windows files. None deselects all file options.
  • Page 127: Lamp

    10. P HAPTER LUGINS 10.4.7 Lamp Lamp is a simple plugin to use your player as a lamp (flashlight, torch). You get an empty screen with maximum brightness. Action Toggle between colours Left/Right Stop Quit 10.4.8 Metronome This plugin can be used as a metronome to keep time during music practice. Adjust the tempo through the interface or by tapping it out on the appropriate button.
  • Page 128: Stats

    10. P HAPTER LUGINS Quit Folder List Editor Keys Action Navi or Right Delete selected folder Long Navi Bring up the context menu which allows you to remove the selected folder or it’s entire folder tree Left or Stop Exit 10.4.10 Stats Figure 10.41: The stats-plugin The stats-plugin simply counts the number of files, music files and directories on your...
  • Page 129: Stopwatch

    10. P HAPTER LUGINS 10.4.11 Stopwatch Figure 10.42: Stopwatch A simple stopwatch program with support for saving times. Action Quit Plugin Stop Navi Start / stop Down Reset timer (only when timer is stopped) Play Take lap time Left / Right Scroll through lap times 10.4.12 Text Editor This plugin allows you to view and edit simple text documents on your DAP.
  • Page 130 10. P HAPTER LUGINS Note: When you have not changed the file the Text Editor will quit immediately. Action Navi or Right Edit Line / Select Character Left or Stop Exit / Abort Editing Show Item Menu Long Navi Delete Line OCKBOX MANUAL RIVER...
  • Page 131: Advanced Topics

    11. A HAPTER DVANCED OPICS 11 Advanced Topics 11.1 Customising the User Interface 11.1.1 Getting Extras Rockbox supports custom fonts. A collection of fonts is available for download in the font package at http://www.rockbox.org/daily.shtml. 11.1.2 Loading Fonts Rockbox can load fonts dynamically. Simply copy the .fnt file to the player and “play” it in the F .
  • Page 132: Changing Filetype Colours

    11. A HAPTER DVANCED OPICS 11.1.5 Changing Filetype Colours Rockbox has the capability to modify the File Browser to show different filetypes in ZCustomFiletypeColours different colours depending upon the file extension. See the Wiki page for details. 11.1.6 Loading Backdrops Rockbox supports showing an image as a backdrop in the F and the ROWSER...
  • Page 133 11. A HAPTER DVANCED OPICS Windows 2000 or XP (but not in 9x/ME) can do this. See appendix section (page 140) for all the tags that are available. All characters not preceded by % are displayed as typed. Lines beginning with # are comments and will be ignored. Maximum file size used is 1600 bytes.
  • Page 134 11. A HAPTER DVANCED OPICS Alternating Sublines It is possible to group items on each line into 2 or more groups or “sublines”. Each subline will be displayed in succession on the line for a specified time, alternating con- tinuously through each defined subline. Items on a line are broken into sublines with the semicolon ’;’...
  • Page 135: Managing Rockbox Settings

    11. A HAPTER DVANCED OPICS Using Images You can have as many as 52 images in your WPS. There are various ways of displaying images: 1. Load and always show the image, using the %x tag 2. Preload the image with %xl and show it with %xd. This way you can have your images displayed conditionally.
  • Page 136: Specifications For .Cfg Files

    11. A HAPTER DVANCED OPICS A configuration file may reside anywhere on the disk. Multiple configuration files are permitted. So, for example, you could have a car.cfg file for the settings that you use while playing your jukebox in your car, and a headphones.cfg file to store the settings that you use while listening to your player through headphones.
  • Page 137: The Manage Settings Menu

    11.4.1 Using ROLO (Rockbox Loader) Rockbox is able to load and start another firmware file without rebooting. You just “play” a file with the extension .iriver. This can be used to test new firmware versions without deleting your current version.
  • Page 138: A File Formats

    .cue Playlist Rockbox loads .m3u, .m3u8 playlist and starts play- ing the first file Rockbox firmware ROLO will load the new .iriver firmware While Playing Screen The new WPS display .wps configuration will loaded Language File Loads a language file .lng...
  • Page 139: Supported Audio Formats

    A. F PPENDIX ILE FORMATS A.2 Supported audio formats Format Extension Notes Lossy codecs MPEG audio .mp1, .mpa, .mp2, .mp3 OGG/Vorbis Some old “floor 0” files .ogg may crash Rockbox. Musepack .mpc Advanced Audio Coding .m4a, .m4b, .mp4 Windows Media Audio .wma, .wmv, .asf ATSC A/52 Supports downmixing...
  • Page 140: B Wps Tags

    B. WPS T PPENDIX B WPS Tags B.1 Status Bar Description Status Bar Enabled Status Bar Disabled These tags override the player setting for the display of the status bar. They must be noted on their own line. B.2 ID3 Info Description ID3 Artist ID3 Composer...
  • Page 141: Power Related Information

    B. WPS T PPENDIX B.3 Power Related Information Description Show numeric battery level in percent. Can also be used in a conditional: %?bl -1 0 1 2 ... N Where the -1 value is used when the battery level isn’t known (it usually is). Show the battery level in volts Show estimated battery time left “p”...
  • Page 142: Playlist/Song Info

    B. WPS T PPENDIX B.5 Playlist/Song Info Description Progress Bar This will replace the entire line with a progress bar. You can set the height, position and width of the progressbar (in pixels): %pb height leftpos rightpos toppos Percentage Played In Song Current Time In Song Total Number of Playlist Entries Peak Meter.
  • Page 143: Hold Switches

    B. WPS T PPENDIX B.8 Hold Switches Description “h” if the main unit hold switch is on “r” if the remote hold switch is on B.9 Virtual LED Description “h” if the hard disk is accessed B.10 Repeat Mode Description Repeat mode, 0-4, in the order: Off, All, One, Shuffle Example: %?mm Off All One Shuffle A-B B.11 Playback Mode Tags...
  • Page 144: Images

    B. WPS T PPENDIX B.12 Images Description Load and set a backdrop image for the WPS. %X filename.bmp This image must be exactly the same size as your LCD. Load a Progress bar image for the WPS. Use %P filename.bmp %pb tag to show the progress bar Load and display an image %x n filename x y...
  • Page 145: Alignment

    B. WPS T PPENDIX %xl M volume.bmp 134 153 5 %?pv<%xdMa %xdMb %xdMc %xdMd %xdMe> Note: The images must be in a rockbox compatible format (1 bit per pixel BMP) The image tag must be on its own line The ID is case sensitive, giving 52 different ID’s The size of the LCD screen for each player varies.
  • Page 146: Real Time Clock

    B. WPS T PPENDIX B.15 Real Time Clock Description Day of month Zero padded day of month Zero padded hour from 00 to 24 Hour from 0 to 24 Zero padded hour from 12 to 12 Hour from 12 to 12 Month Minutes Seconds...
  • Page 147: C Config File Options

    C. C PPENDIX ONFIG FILE OPTIONS C Config file options Setting Allowed Values Unit volume -84 to 0 bass 0 to +24 treble 0 to +6 balance -100 to +100 channels stereo, mono, custom, mono left, mono right, karaoke stereo width 0 to 250 shuffle on, off...
  • Page 148 C. C PPENDIX ONFIG FILE OPTIONS Setting Allowed Values Unit show path in browser off, current directory, full path contrast 0 to 63 backlight timeout off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, seconds 20, 25, 30, 45, 60, 90, 120 backlight timeout plugged off, on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, seconds...
  • Page 149 C. C PPENDIX ONFIG FILE OPTIONS Setting Allowed Values Unit usb charging on, off skip length track, 1, 2, 3, 4, 5, 10, 15 minutes start in screen previous, root, files, db, wps, menu, recording, radio, bookmarks playlist catalog directory /path/to/dir replaygain on, off...
  • Page 150 C. C PPENDIX ONFIG FILE OPTIONS Setting Allowed Values Unit dircache on, off tagcache ram on, off peak meter release 1 to 126 peak meter hold off, 200ms, 300ms, 500ms, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 30, 1min peak meter clip hold on, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 45, 60, 90, 2min, 3min,...
  • Page 151 C. C PPENDIX ONFIG FILE OPTIONS Setting Allowed Values Unit remote scroll delay 0 to 2500 remote bidir limit 0 to 200 backlight filters first remote on, off keypress remote iconset /path/filename.bmp remote viewers iconset /path/filename.bmp remote reduce ticking on, off time format 12hour, 24hour rec quality...
  • Page 152: D User Feedback

    D. U PPENDIX SER FEEDBACK D User feedback D.1 Bug reports If you experience inappropriate performance from any supported feature, please file a bug report on our web page. Do not report missing features as bugs, instead file them as feature ideas (see below). For open bug reports refer to http://www.rockbox.org/tracker/index.php?type=2 D.1.1 Rules for submitting new bug reports...
  • Page 153: Features We Will Not Implement

    D. U PPENDIX SER FEEDBACK D.2.2 Features we will not implement This is a list of Feature Requests we get repeatedly that we simply cannot do. View it as the opposite of a TODO! Support other file systems than FAT32 (like NTFS or ext2 or whatever)! No.
  • Page 154: E Changelog

    E. C PPENDIX HANGELOG E Changelog E.1 What is new since v2.5? E.1.1 New features 2008-07-07: Added keybox plugin 2008-05-04: Added study mode 2008-04-23: Lamp (originally ”flashlight”) plugin 2008-03-23: New bitmap strips feature in the WPS 2008-03-21: Viewport tag added for WPS 2008-03-18: The Olympus m:robe 100 is now a supported target 2007-12-09: PictureFlow: A nice animated visualization for album art 2007-11-26: Matrix Demo...
  • Page 155: Enhancements

    E. C PPENDIX HANGELOG 2006-12-29: Toshiba Gigabeat X and F series support 2006-11-30: File properties in context menu 2006-11-06: Samplerate and format selection added to recording settings. En- coders can be configured individually on a menu specific to the encoder in the recording menu 2006-11-06: Pitch adjustment in semitone steps 2006-10-27: Audio dithering option...
  • Page 156: New Codecs Supported

    E. C PPENDIX HANGELOG 2007-01-23: Settings are now saved to /.rockbox/config.cfg and the hidden config sector is not used anymore 2006-11-29: Playlists are saved with the extension .m3u8, extension .m3u is now read using the chosen codepage 2006-09-16: New scheduler. Audio playback is now prioritised over other tasks 2006-09-02: Enhanced statusbar in recording screen 2006-08-15: Support for displaying the path in the file browser 2006-02-07: Equalizer configuration for software codec platforms...
  • Page 157: F Credits

    F. C PPENDIX REDITS F Credits People that have contributed to the project, one way or another. Friends! ¨ · B · L · F · M TENBERG INUS IELSEN ELTZ RANCOIS OUCHER ATTHIAS · A · A · B ·...
  • Page 158 F. C PPENDIX REDITS ´ · N · N · S · S · A · A ATHAN ANHAM E PHANE OYON USTIN PPEL · M · T · I BASTIAN ENRIKSEN ARTIN CARRATT MITH RAVIS YYPPA EBBER B ¨ ·...
  • Page 159 F. C PPENDIX REDITS · P · D · J · M RAAM RZEMYSŁAW OŁUBOWSKI AVIDE ENTILE AMES ASILE · S · J · M · M TEPAN OSKOVCHENKO HAMED AREK URKE ICHAEL · B · S · M · T J.
  • Page 160: G Licenses

    G. L PPENDIX ICENSES G Licenses G.1 GNU Free Documentation License Version 1.2, November 2002 Copyright c 2000,2001,2002 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
  • Page 161 G. L PPENDIX ICENSES A ”Modified Version” of the Document means any work containing the Document or a portion of it, either copied verbatim, or with modifications and/or translated into another language. A ”Secondary Section” is a named appendix or a front-matter section of the Doc- ument that deals exclusively with the relationship of the publishers or authors of the Document to the Document’s overall subject (or to related matters) and contains noth- ing that could fall directly within that overall subject.
  • Page 162 G. L PPENDIX ICENSES is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language. (Here XYZ stands for a specific section name mentioned below, such as ”Acknowledgements”, ”Dedications”, ”Endorsements”, or ”History”.) To ”Pre- serve the Title” of such a section when you modify the Document means that it remains a section ”Entitled XYZ”...
  • Page 163 G. L PPENDIX ICENSES begin 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.
  • Page 164 G. L PPENDIX ICENSES as given on its Title Page, then add an item describing the Modified 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.
  • Page 165 G. L PPENDIX ICENSES 5. COMBINING DOCUMENTS You may combine the Document with other documents released under this License, under the terms defined in section 4 above for modified versions, provided that you include in the combination all of the Invariant Sections of all of the original documents, unmodified, and list them all as Invariant Sections of your combined work in its license notice, and that you preserve all their Warranty Disclaimers.
  • Page 166 G. L PPENDIX ICENSES 8. TRANSLATION Translation is considered a kind of modification, so you may distribute translations of the Document under the terms of section 4. Replacing Invariant Sections with trans- lations requires special permission from their copyright holders, but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections.
  • Page 167 G. L PPENDIX ICENSES Copyright c YEAR YOUR NAME. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documen- tation License, Version 1.2 or any later version published by the Free Soft- ware Foundation;...
  • Page 168: The Gnu General Public License

    G. L PPENDIX ICENSES G.2 The GNU General Public License Version 2, June 1991 Copyright c 1989, 1991 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
  • Page 169 G. L PPENDIX ICENSES GNU G ENERAL UBLIC ICENSE ERMS AND ONDITIONS OPYING ISTRIBUTION AND ODIFICATION 0. This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this Gen- eral Public License.
  • Page 170 G. L PPENDIX ICENSES (Exception: if the Program itself is interactive but does not normally print such an announcement, your work based on the Program is not required to print an announcement.) These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Program, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works.
  • Page 171 G. L PPENDIX ICENSES tem on which the executable runs, unless that component itself accompanies the executable. If distribution of executable or object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place counts as distribution of the source code, even though third parties are not compelled to copy the source along with the object code.
  • Page 172 G. L PPENDIX ICENSES sole purpose of protecting the integrity of the free software distribution system, which is implemented by public license practices. Many people have made gen- erous contributions to the wide range of software distributed through that system in reliance on consistent application of that system;...
  • Page 173 G. L PPENDIX ICENSES 12. I N NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRIT ING WILL ANY COPYRIGHT HOLDER OR ANY OTHER PARTY WHO MAY MODIFY OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE BE LIABLE TO YOU FOR DAMAGES INCLUDING ANY GENERAL SPECIAL...
  • Page 174 G. L PPENDIX ICENSES Gnomovision version 69, Copyright (C) year name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type ‘show w’. This is free software, and you are welcome to redistribute it under certain conditions; type ‘show c’ for details. The hypothetical commands show w and show c should show the appropriate parts of the General Public License.

This manual is also suitable for:

H340

Table of Contents