background image

Chapter 10.

Plugins

138

10.3.14. 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.8

(page

44

)).

10.3.15. Text Viewer

Figure 10.44.: Text Viewer

This is a Viewer for text files with word wrap. Just open a

.txt

or

.nfo

file to display it.

The text viewer features controls to handle various styles of text formatting and has top-
of-file and bottom-of-file buttons. You can view files without a

.txt

or

.nfo

extension

by using

Open with

from the

Context Menu

(see section

4.1.2

(page

24

)). You can also

bookmark pages.

The Rockbox manual

Toshiba Gigabeat F and X Series

Summary of Contents for Gigabeat F Series

Page 1: ...The Rockbox Manual for Toshiba Gigabeat F and X Series rockbox org October 30 2010 ...

Page 2: ...José Maria Garcia Valdecasas Bernal Peter Schlenker Version 3 7 Built using pdfL A TEX Permission is granted to copy distribute and or modify this document under the terms of the GNU Free Documentation License Version 1 2 or any later version published by the 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 s...

Page 3: ...Rockbox 16 2 5 1 Automatic Uninstallation 16 2 5 2 Manual Uninstallation 16 2 6 Troubleshooting 17 3 Quick Start 18 3 1 Basic Overview 18 3 1 1 The player s controls 18 3 1 2 Turning the player on and off 19 3 1 3 Putting music on your player 19 3 1 4 The first contact 20 3 1 5 Basic controls 20 3 1 6 Basic concepts 20 3 2 Customising Rockbox 21 3 3 USB Charging 21 4 Browsing and playing 22 4 1 Fi...

Page 4: ...9 4 4 7 Helpful Hints 39 4 5 Hotkeys 40 5 The Main Menu 41 5 1 Introducing the Main Menu 41 5 2 Navigating the Main Menu 42 5 3 Recent Bookmarks 42 5 4 Files 43 5 5 Database 43 5 6 Now Playing Resume Playback 43 5 7 Settings 43 5 7 1 Sound Settings 44 5 7 2 Playback Settings 44 5 7 3 General Settings 44 5 7 4 Theme Settings 44 5 7 5 Manage Settings 44 5 8 Playlist 44 5 9 Plugins 45 5 10 System 45 ...

Page 5: ...one Unplug 58 7 13 Last fm Log 59 7 14 Cuesheet Support 59 7 15 Skip Length 59 7 16 Prevent Track Skipping 59 7 17 Rewind Before Resume 59 8 General Settings 61 8 1 Playlist 61 8 2 File View 61 8 3 Database 63 8 4 Display 63 8 5 System 66 8 5 1 Start Screen 66 8 5 2 Battery 66 8 5 3 Disk 66 8 5 4 Idle Poweroff 67 8 5 5 Limits 67 8 5 6 Car Adapter Mode 67 8 5 7 Button Light Timeout 68 8 5 8 Button ...

Page 6: ...box 95 10 1 18 Pegbox 96 10 1 19 Pong 97 10 1 20 Reversi 98 10 1 21 Robotfindskitten 98 10 1 22 Rockblox 99 10 1 23 Rockblox1d 100 10 1 24 Rocklife 100 10 1 25 Sliding Puzzle 101 10 1 26 Snake 102 10 1 27 Snake 2 103 10 1 28 Sokoban 104 10 1 29 Solitaire 106 10 1 30 Spacerocks 107 10 1 31 Star 108 10 1 32 Sudoku 109 10 1 33 Wormlet 111 10 1 34 Xobox 114 10 2 Demos 115 10 2 1 Bounce 115 10 2 2 Cred...

Page 7: ...ckboy 136 10 3 12 Search 137 10 3 13 Shopper 137 10 3 14 Sort 138 10 3 15 Text Viewer 138 10 3 16 Theme Remove 143 10 3 17 VBRfix 144 10 3 18 ZXBox 145 10 4 Applications 147 10 4 1 Alarm Clock 147 10 4 2 Battery Benchmark 147 10 4 3 Calculator 149 10 4 4 Calendar 150 10 4 5 Chess Clock 151 10 4 6 Clock 152 10 4 7 Disk Tidy 155 10 4 8 Keybox 155 10 4 9 Lamp 156 10 4 10 Lrcplayer 156 10 4 11 md5sum ...

Page 8: ...les 176 11 3 3 The Manage Settings menu 177 11 4 Firmware Loading 177 11 4 1 Using ROLO Rockbox Loader 177 11 5 Optimising battery runtime 177 11 5 1 Display backlight 178 11 5 2 Display power off 178 11 5 3 Anti Skip Buffer 178 11 5 4 Replaygain 178 11 5 5 Audio format and bitrate 178 11 5 6 Sound settings 179 A File formats 180 A 1 Supported file formats 181 A 2 Supported audio formats 182 A 2 1...

Page 9: ... 21 Alignment and language direction 195 B 22 Conditional Tags 195 B 23 Subline Tags 196 B 24 Time and Date 196 B 25 Text Translation 197 B 26 Bar Tags 197 B 26 1 Options 197 B 27 Other Tags 198 C Config file options 199 D Menu Overview 204 E User feedback 205 E 1 Bug reports 205 E 1 1 Rules for submitting new bug reports 205 E 2 Feature ideas 205 E 2 1 Rules for submitting a new feature idea 205 ...

Page 10: ...ut into making Rockbox sound the best it can and improvements are constantly being made All models have access to a large number of plugins including many games applications and graphical demos You can load different configurations quickly for different purposes e g a large font for in your car different sound settings for at home Rockbox features a very wide range of languages and all supported m...

Page 11: ...ons on the margin to help you finding important parts or parts you could skip The following icons are used Note This indicates a note A note starts always with the text Note In order to make b finding notes easier each one is accompanied by an icon in the margin as here Notes are used to mark useful information that may help you to get the most out of Rockbox Warning This is a warning In contrast ...

Page 12: ...2 2 Installing Rockbox There are two ways to install Rockbox automated and manual The automated way is the preferred method of installing Rockbox for the majority of people Rockbox Utility is a graphical application that does almost everything for you However should you encounter a problem then the manual way is still available to you There are three separate components two of which need to be ins...

Page 13: ...k of Rockbox 2 2 1 Automated Installation To automatically install Rockbox download the official installer and housekeeping tool Rockbox Utility It allows you to Automatically install all needed components for using Rockbox Minimal Instal lation Automatically install all suggested components Complete Installation Selectively install optional components Install additional fonts and themes Install v...

Page 14: ... the release version and the current build there is also an archive of daily builds available for download These are built once a day from the latest source code in the SVN repository For a manual install you can download archived builds from http www rockbox org daily shtml Note Because current and archived builds are development versions that change fre b quently they may behave differently than...

Page 15: ...These directories are hidden Make sure that you have configured your browser to show hidden files or you may be unable to see FWIMG In that directory you ll find a file called FWIMG01 DAT This too may be hidden Rename the file to FWIMG01 DAT ORIG Make sure you spelled that name correctly as it is needed for booting the Toshiba firmware Warning If you do not complete this step then you will be unab...

Page 16: ... can be easily updated with Rockbox Utility You can also update Rockbox manually download a Rockbox build as detailed above and unzip the build to the root directory of your player as in the manual installation stage If your unzip program asks you whether to overwrite files choose the Yes to all option The new build will be installed over your current build The bootloader only changes rarely and s...

Page 17: ...y a result of not extracting the contents of the zip file to the proper location and should not happen when Rockbox has been installed with Rockbox Utility 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 Toshiba Gigabeat F and X Series ...

Page 18: ...abeat b X The Gigabeat F is slightly larger and more rectangular shaped while the Gigabeat X is smaller and has a slightly tapered back Hold the player with the screen on top and the controls on the right hand side Below the screen is a cross shaped touch sensitive pad which contains the Up Down Left and Right controls On the Gigabeat X this pad will feel slightly raised up while it will feel slig...

Page 19: ...x 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 See the Reset Settings in section 11 3 3 page 177 for details In the unlikely event of a software failure hardware poweroff or reset can be performed by holding down the battery switch until the player shuts off ...

Page 20: ...he fly playlist To go back to the File Browser stop the playback with the Power button or return to the file browser while keeping playback running using Select In list views you can go back one step with Left 3 1 6 Basic concepts Playlists Rockbox is playlist oriented This means that every time you play an audio file a so called dynamic playlist is generated unless you play a saved playlist You c...

Page 21: ...ll other settings that can be modified using cfg files This topic is discussed in more detail in section 11 3 page 175 The Rockbox distribution comes with some themes that should look nice on your player Note Some of the themes shipped with Rockbox need additional fonts from the fonts b package so make sure you installed them Also if you downloaded additional themes from the Internet make sure you...

Page 22: ... music on your player using categories like album artist genre etc You can select whether to browse using the File Browser or the Database Browser by selecting either Files or Database in the Main Menu If you choose the File Browser the Show Files setting lets you select what types of files you wish to view See section 8 2 page 62 for more information on the Show Files setting Note The File Browse...

Page 23: ...t Forward Execute the default action on the selected file or enter a directory A Play If there is an audio file playing return to the While Playing Screen WPS without stopping playback Power Long Play Stop audio playback Long Select Long Menu Enter the Context Menu Menu Menu Enter the Main Menu Long Menu Long Rewind Switch to the Quick Screen see sec tion 5 11 page 45 A Menu Activate the Hotkey fu...

Page 24: ... a directory it will display options for directories 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 37 Playlist Catalog Enters the Playlist Catalog Submenu see section 4 4 2 page 36 Rename This function lets the user modify the name of a file or directory Cut Copie...

Page 25: ...automatically detects the file type and runs the appropriate plugin The Open With function can be used to override the default action and select a viewer by hand For example this function can be used to view a text file even if the file has a non standard extension i e the file has an extension of something other than txt See section 10 3 page 127 for more details on viewers Create Directory Creat...

Page 26: ... can be easily changed by making a text file with the required layout More information on how to achieve this can be found on the Rockbox website at ZLoadableKeyboardLayouts Also you can switch to Morse code input mode by changing the Use Morse Code Input setting or by pressing A Power in the virtual keyboard Note When the cursor is on the input line Select deletes the preceding character b The Ro...

Page 27: ...ect a character in Morse code input mode 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 The criteria the database u...

Page 28: ...ery on boot up Note If you browse your music frequently using the database you should load to b 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 Initialize Now You can force Rockbox to rescan your disk for tagged files by using t...

Page 29: ...he database If Auto Update is enabled this is per formed automatically when the database is initialized 4 2 4 Using the Database Once the database has been initialized you can browse your music by Artist Album Genre Song Name etc To use the database go to the Main Menu and select Database Note You may need to increase the value of the Max files in dir browser setting b Settings General Settings Sy...

Page 30: ...em length numeric system Lm track len min numeric system Ls track len sec numeric system 4 3 While Playing Screen The While Playing Screen WPS displays various pieces of information about the cur rently playing audio file The appearance of the WPS can be configured using WPS configuration files The items shown depend on your configuration all items can be turned on or off independently Refer to se...

Page 31: ... Left Long Rewind Rewind in track Right Forward Go to the next track Long Right Long Forward Fast forward in track A Play Toggle play pause Power Long Play Stop playback Select Return to the File Browser Database Long Select Long Menu Enter WPS Context Menu Menu Menu Enter Main Menu Long Menu Switch to the Quick Screen see sec tion 5 11 page 45 A Up Down Show Pitch Screen see section 4 3 3 page 34...

Page 32: ...ode each dot is a 10 mark In dBFS mode the dots represent the following values from right to left 0 dB 3 dB 6 dB 9 dB 12 dB 18 dB 24 dB 30 dB 40 dB 50 dB 60 dB 4 3 3 The WPS Context Menu Like the context menu for the File Browser the WPS Context Menu allows you quick access to some often used functions Playlist The Playlist submenu allows you to view save search and reshuffle the current playlist ...

Page 33: ...shortcut to the Sound Settings Menu where you can configure volume bass treble and other settings affecting the sound of your music See section 6 page 47 for more information Playback Settings This is a shortcut to the Playback Settings Menu where you can configure shuffle repeat party mode skip length and other settings affecting the playback of your music Rating The menu entry is only shown if G...

Page 34: ...unction is the same as the Open With function in the file browser s Context Menu Delete Delete the currently playing file The file will be deleted but the playback of the file will not stop immediately Instead the part of the file that has already been buffered i e read into the player s memory will be played This may even be the whole track Pitch The Pitch Screen allows you to change the rate of ...

Page 35: ...any bookmarks you may create see section 8 6 page 68 and will be restored upon playing back those bookmarks Key Remote Key Action Menu Long Play Toggle pitch changing mode cycle through all available modes Up Down Volume Up Volume Down Increase Decrease pitch by 0 1 in pro centual mode or 0 1 semitone in semi tone mode Long Up Long Down Long Volume Up Long Volume Down Increase Decrease pitch by 1 ...

Page 36: ...ifferent ways By selecting playing a song from the File Browser Whenever a song is selected from the File Browser with Select or Right Rockbox will automatically create a playlist containing all of the songs in that directory and start playback with the selected song Note If you already have created a dynamic playlist playing a new song will erase the b current dynamic playlist and create a new on...

Page 37: ... 4 4 3 Adding music to playlists Adding music to a dynamic playlist Figure 4 5 The Playlist Submenu The Playlist Submenu is a submenu in the Context Menu see section 4 1 2 page 24 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 If there is music currently playing Rockbox will...

Page 38: ...at the end of the playlist Play Next Replaces all but the current playing track with track s Current playing track is queued The Playlist Submenu can be used to add either single tracks or entire directories to a playlist If the Playlist Submenu is invoked on a single track it will put only that track into the playlist On the other hand if the Playlist Submenu is invoked on a directory Rockbox add...

Page 39: ...rent Playlist or enter the 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 26 enter a filename for your playlist and accept it and you are done 4 4 6 Loading saved playlists Through the File Browser Playlist files like regular music tracks can be selected through the File Browser When loading a play...

Page 40: ...h with reference to the current file or directory if applicable Each screen has its own assignment If there is no assignment for a given screen the hotkey is ignored The default assignment for the File Browser hotkey is Off while the default for the WPS hotkey is View Playlist The hotkey assignments are changed in the Hotkey menu see section 8 9 page 71 under General Settings The Rockbox manual To...

Page 41: ...press the Menu button All settings are stored on the unit However Rockbox does not access the hard disk solely for the purpose of saving settings Instead Rockbox will save settings when it accesses the hard disk the next time for example when refilling the music buffer or navigating through the File Browser Changes to settings may therefore not be saved unless the player is shut down safely see se...

Page 42: ...ose previous option Select or Right Forward Select option Left or Power Rewind Exit menu or setting or move to parent menu 5 3 Recent Bookmarks Figure 5 2 The list bookmarks screen If the Save a list of recently created bookmarks option is enabled then you can view a list of several recent bookmarks here and select one to jump straight to that track Note Bookmarking only works when tracks are laun...

Page 43: ...entry is not shown in the Main Menu when the option is off the default setting See section 8 6 page 68 for more details on configuring bookmarking in Rockbox 5 4 Files Browse the files on your player see section 4 1 page 22 5 5 Database Browse by the meta data in your audio files see section 4 2 page 27 5 6 Now Playing Resume Playback Go to the While Playing Screen and resume if music playback is ...

Page 44: ...sual apperance of Rock box The details of this menu are covered in section 9 page 72 5 7 5 Manage Settings The Manage Settings option allows the saving and re loading of user configuration settings browsing the hard drive for alternate firmwares and finally resetting your player back to initial configuration The details of this menu are covered in section 11 3 page 175 5 8 Playlist This menu allow...

Page 45: ...s The Sleep Timer is reset on boot Time Format Choose 12 or 24 hour clock Rockbox Info Displays some basic system information This is from top to bottom the amount of memory Rockbox has available for storing music the buffer The battery status Hard disk size and the amount of free space on the disk Credits Display the list of contributors Debug Keep Out This sub menu is intended to be used only by...

Page 46: ...ng Menu to access it and Menu to exit The direction buttons will modify the individual setting values as indicated by the arrow icons Please note that the settings at opposite sides of the screen cycle through the available options in opposite directions Therefore if you select the same setting at e g the top and bottom of the quickscreen then pressing up and down will cycle through this setting i...

Page 47: ...cates the maximum volume that the player can produce without possible distortion clipping All values lower than this reference will be negative and yield a progressively softer volume Values higher than 0 dB are available and can be used to raise the volume more than would otherwise be possible These volume levels will ordi narily lead to distorted sound but might work nicely for music that has an...

Page 48: ... in what manner they will be combined Available options are Stereo Leave the audio signal unmodified Mono Combine both channels and send the resulting signal to both stereo channels resulting in a monophonic output Custom Allows you to manually specify a stereo width with the Stereo Width setting described later in this chapter Mono Left Plays the left channel in both stereo channels Mono Right Pl...

Page 49: ...eakers and might for that reason sound unnatural to some listeners The crossfeed function uses an algorithm to feed a delayed and filtered portion of the signal from the right channel into the left channel and vice versa in order to simulate the spatial cues that the ear and brain receive when listening to a set of loudspeakers placed in front of the listener The result is a more natural stereo im...

Page 50: ...ttings described earlier but the EQ allows you to control the sound much more carefully Rockbox s parametric EQ is composed of five different bands Band 0 Low shelf filter The low shelf filter boosts or lowers all frequencies below a certain frequency limit much as the bass control found on ordinary stereo systems does Adjust the cutoff frequency parameter to decide where the shelving starts to ta...

Page 51: ...n ordinary 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 Enable EQ This option controls whether the EQ is on or off Grap...

Page 52: ...This is the default behaviour and adds distortion to the signal that will vary in character along with the desired sound Dithering adds low level noise to the signal prior to throwing away the surplus bits which gives the resulting signal a uniform noise floor which is independent of the sig nal Most people find this noise preferable to the time varying noise heard when not performing dithering Af...

Page 53: ...up gain is quieter than the input signal Makeup Gain in Auto restores the signal to the maximum possible level and brings the quieter audio up with it This is what makes it possible to hear the quieter audio in noisy environments The Ratio setting determines how aggressively the compressor reduces gain above the threshold For example the 2 1 setting means that for each two decibels of input signal...

Page 54: ... set to Yes Rockbox b will move on to the next directory on your hard drive If the Auto Change Directory option is set to No playback will stop when the current directory or playlist is finished All The current playlist will repeat when it is finished One Repeat one track over and over Shuffle When the current playlist has finished playing it will be shuffled and then repeated A B Repeats between ...

Page 55: ...fer can be set to various values between 5 seconds and 10 minutes Note Having a large anti skip buffer tends to use more power and may reduce your b battery life It is recommended to always use the lowest possible setting that allows correct and continuous playback 7 6 Fade on Stop Pause Enables and disables a fade effect when you pause or stop playing a song If the Fade on Stop Pause option is se...

Page 56: ...ime between when the crossfade process begins and when the new track begins to fade in Fade In Duration The length of time in seconds that it takes your music to fade in once the Fade In Delay has ended Fade Out Delay The fade out delay is the length of time between when the crossfade process begins and when the old track begins to fade out Fade Out Duration The length of time in seconds that it t...

Page 57: ...2 tags are not currently supported b Options for replaygain are Replaygain Type Choose the type of replaygain to apply Album Gain Maintain a constant volume level between albums but keep any intentional volume variations between songs in an album If album gain value is not available uses track gain information Track Gain Maintain a constant volume level between tracks If track gain value is not av...

Page 58: ...ill continue to the next directory If Auto Change Directory is set to No playback will stop at the end of the current playlist Using the Random feature requires you to first generate a folder list via the Random Folder Advance Configuration plugin see section 10 4 13 page 159 Note You must have the Repeat option set to No for Auto Change Directory to b function properly Note This feature only work...

Page 59: ...et Also the information found in the cuesheet file will replace the information from the ID3 tags When you enable this option you ll have to reboot for it to come into effect 7 15 Skip Length Designed to speed up navigation when listening to long audio tracks Skip Length changes the behaviour of the Left and Right buttons so that they skip by a given time instead of skipping to a new track The Ski...

Page 60: ... the rewind can be set to various values between 0 off and 60 seconds Note The rewind is not done when resuming a paused track b Note The actual rewind distance may differ a little from the requested value depending b on the file in question The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 61: ...dynamic playlist all subdirectories will also be inserted If set to Ask Rockbox will prompt the user about whether to include sub directories Warn When Erasing Dynamic Playlist If set to Yes Rockbox will provide a warning if the user attempts to take an action that will cause Rockbox to erase the current dynamic playlist 8 2 File View The File View menu deals with options relating to how the File ...

Page 62: ...ecutive digits to a number used for sorting taking leading zeros into account As digits disables this algorithm and causes every digit to be compared sepa rately The following table demonstrates the two sortings As whole numbers As digits 03 Jackson mp3 03 Jackson mp3 1 Ring Of Fire mp3 1 Ring Of Fire mp3 2 I Walk The Line mp3 10 A Thing Called Love mp3 10 A Thing Called Love mp3 2 I Walk The Line...

Page 63: ...ffect on the Database browser If set to Current Directory Only or Full Path then the title of each menu will be displayed on the first line in the Database Browser 8 3 Database This sub menu allows you to configure the database See section 4 2 page 27 for more information about using the database 8 4 Display LCD Settings This sub menu contains settings that relate to the display of the player Back...

Page 64: ...ometimes useful when carrying the player in a pocket for easy access to the headphone socket Scrolling This feature controls how text will scroll in Rockbox You can configure the following parameters Scroll Speed Sets how many times per second the automatic horizontal scrolling text will move a step Scroll Start Delay Controls how many milliseconds Rockbox should wait before a new text begins auto...

Page 65: ...alues are scaled logarithmically 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 Linear display This setting cannot be displayed in units like volts or watts because such units depend on your headphones Minimum and maximum range These two options define the full va...

Page 66: ...e standard battery shipped with the player Rockbox uses this value for runtime estimation not battery percentage calculation Changing this setting has no effect whatsoever on actual battery life This setting only affects the accuracy of the runtime estimation as shown on screen 8 5 3 Disk Options relating to the hard disk Disk Spindown Rockbox has a timer that makes it spin down the hard disk afte...

Page 67: ...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 Higher values will shorten the music buffer so you should increase this setting only if you have very large playlists 8 5 6 Car Adapter Mode This option turn...

Page 68: ...ry or playlist they reference in a file with the same name as the directory or playlist and a bmark extension To load a bookmark select the bookmark file and then select the bookmark to load There are other ways to load a bookmarks mentioned below Note Bookmarking only works when tracks are launched from the file browser and b does not work for tracks launched via the database In addition they do ...

Page 69: ...abled a list of the most re cently created bookmarks may be accessed through the Recent Bookmarks option in the Main Menu This list contains up to ten entries No Do not keep a list of recently used bookmarks This also removes the Recent Bookmarks from the Main Menu Yes Keep a list of recently used bookmarks Each new bookmark is added to the list of recent bookmarks Unique Only Add each new bookmar...

Page 70: ...ptions are available Spell Speak the directory name by spelling it out letter by letter Support is provided only for the most common letters numbers and punctuation Numbers Each directory is assigned a number based upon its position in the file list They are then announced as Directory 1 Directory 2 etc Off No attempt will be made to speak directory names You can use pre generated talk clips to ha...

Page 71: ...es precedence over other filename voicing Otherwise e g if a talk clip is not available voicing uses the method set under Voice Filenames above Say File Type This option turns on voicing of file types when Voice Filenames is set to Spell or Numbers When Voice Directories is set to Spell Directory will be voiced after each spelled out directory Announce Battery Level When this option is enabled the...

Page 72: ...ts on your player Selecting one will activate it See section 11 1 2 page 167 for further details about fonts While Playing Screen Opens the File Browser in the rockbox wps directory and displays all wps files Selecting one will activate it Left or Power will exit back to the menu For further information about the WPS see section 4 3 page 30 For information about editing a wps file see section 11 2...

Page 73: ... a solid colour the colour is set in the Colours submenu Bar Gradient Colour A bar with a colour gradient the colours are set in the Colours submenu Colours The options in this menu sets the colours for visual elements in Rockbox Line Selector Colours These options sets the colours for the line selector bars Primary Colour Set the primary colour used for the gradient line selector bar and the colo...

Page 74: ...x interface Most plugins will not interfere with music playback but some of them will stop playback while running Plugins have the file ex tension rock Most of them can be started from Browse Plugins in the Main Menu Viewer plugins get started automatically by opening an associated file i e text files chip8 games or from the Open with option on the Context Menu 10 1 Games See also the Chip 8 emula...

Page 75: ... seem difficult blackjack is a game renowned for the strategy involved This version includes the ability to split buy insurance and double down For the full set of rules to the game and other facinating information visit http www blackjackinfo com blackjack rules php Key Remote Key Action Left Right Up Down Enter betting amount Select Hit Draw new card Select Volume down Stay End hand A Double dow...

Page 76: ...ou destroy a brick For a special item to take effect you must catch it with the paddle Look out for the bad ones Special items Displayed Name Description N Normal Returns paddle to normal D Die Ball dies lose a life L Life Gain a life F Fire Allows you to shoot bricks with paddle G Glue Ball sticks to paddle each time it hits B Ball Immediately fires another ball FL Flip Flip left right movement T...

Page 77: ...when a cluster of three of more of the same type is formed The game is over when any bubbles on the board extend below the bottom line To make things more difficult the entire board is shifted down every time a certain number of shots have been fired Points are awarded depending on how quickly the level was completed Key Remote Key Action Up Forward Pause game Left Right Volume Down Volume Up Aim ...

Page 78: ...he game If the menu is invoked while in the viewer the user is allowed to select a new match from the same file or quit the game Force play while the computer is thinking will cause it to make its move immediately If done while it s your turn the computer will move for you and flip the board so that you are playing from the other side If you want you can force play an entire game and watch the art...

Page 79: ...ure 10 5 Clix The aim is to remove all blocks from the board You can only remove blocks if at least two blocks with the same color have a direct connection The more blocks you remove per turn the more points you get Key Remote Key Action Left Right Up Down Move the cursor around the blocks Select Remove a block Power Exit The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 80: ...ure 10 6 Chopper Navigate a cavernous maze without banging into walls the ceiling or the floor How long can you fly your chopper Key Remote Key Action Select Make chopper fly Menu Enter menu The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 81: ...s A red peg signifies a correct peg in the correct position and a white peg signifies a correct peg in the wrong position Key Remote Key Action Power Show menu Select Check suggestion and move to next line Left Right Volume Down Volume Up Select a peg Up Down Forward Rewind Change current peg 10 1 8 Dice Dice is a simple dice rolling simulator Select number and type of dice to roll in a menu and s...

Page 82: ...d from prboom 2 2 6 Your wad files Copy all Doom wads you wish to play into that directory The needed files can be found at ZPluginDoom To play addon wads create the addons directory within the doom directory Place wad files in this directory Currently doom only supports a maximum number of 10 addons A free alternative for Doom 2 is FreeDoom http freedoom sourceforge net This can be used in place ...

Page 83: ...eed on a player Only runs on Doom Shareware Player Bobbing Enable or Disable player up Down movement Translucency Enable or Disable sprite translucency Fireballs Plasma Fake Contrast Enable or Disable modified game lighting Always Run Make the player always run Headsup Display Show the player status when in fullscreen Statusbar Always Red Disable colour response statusbar InGame Main Menu This men...

Page 84: ...Right Turn Right A Shoot Menu Open Power InGame Menu Select Enter Volume down Change Weapon Playing the game After installation of the wad files is complete you can start the game more description is needed 10 1 10 Flipit Figure 10 9 Flipit The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 85: ...u Shuffle Volume up Solve Volume down Solve step by step Power Quit the game 10 1 11 Goban Figure 10 10 Goban Goban is a a plugin for playing viewing and recording games of Go also known as Weiqi Baduk Igo and Goe It uses standard Smart Game Format SGF files for sav ing and loading games You can find a short introduction to Go at http senseis xmp net WhatIsGo and more information about SGF files c...

Page 86: ... b are rare but if you have one don t even try it the file will most likely be corrupted if you save over it You have been warned The file sgf gbn_def sgf is used by the plugin to store any unsaved changes in the most recently loaded game This means that if you forget to save your changes you should load sgf gbn_def sgf immediately to offload the changes to another file If you load another file fi...

Page 87: ... Info View and modify the metadata of the current game Playback Control Control the playback of the current playlist and modify the volume of your player Zoom Level Zoom in or out on the board If you set the zoom level it will be saved and used again the next time you open this plugin Options Open the Options Menu Context Menu Open the Context Menu which allows you to set play modes and other tool...

Page 88: ...r 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 Round If part of a tournament the round number for this game Done Return to the previous menu Options Customize the behavior of the plugin in certain ways Show Child Variations Enable this to mark child variations on he board if there are more than one Note variations which don ...

Page 89: ...variation this will navigate to the next variation after the current one This is the only way to reach variations which start with adding or removing stones as you cannot follow them by playing the same move Force Play Mode The same as Play Mode except that this mode will allow you to play illegal moves such as retaking a ko immediately without a ko threat suicide on rulesets which don t allow it ...

Page 90: ... 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 Key Remote Key Action Left Move left Right Move right Select Fire Power Quit The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 91: ...0 12 Jackpot This is a jackpot slot machine game At the beginning of the game you have 20 Payouts are given when three matching symbols come up Key Remote Key Action Select Play Power Exit the game The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 92: ...s as possible before running out of available moves 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 skilful swapping pairs of jewels Key Remote Key Action Left Right Up Down Move the cursor around the jewels Select Select a jewel Power Men...

Page 93: ...ve the rows only by pushing them and if you move the rows carelessly you will get stuck 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 Key Remote Key Action Up Down Left Right Forward Rewind Volume Down Volume Up Move Character Power Menu The Rockbox manual Toshi...

Page 94: ...nt square is revealed The aim is to use the information you are given to work out where the mines are and avoid them When the player is certain that they know the location of a mine it can be tagged to avoid accidentally stepping on it Key Remote Key Action Up Down Left Right Move the cursor across the minefield A Toggle flag on off Select Reveal the contents of the current square Menu Display the...

Page 95: ...n 5e 2791455babaf26e0b396c78d2b45f8f6 pacman 5f 9240f35d1d2beee0ff17195653b5e405 pacman 6e 290aa5eae9e2f63587b5dd5a7da932da pacman 6f 19a886fcd8b5e88b0ed1b97f9d8659c0 pacman 6h d7cce8bffd9563b133ec17ebbb6373d4 pacman 6j 33c0e197be4c787142af6c3be0d8f6b0 These need to be stored in the rockbox pacman directory on your player In the MAME ROMs collection the necessary files can be found in pacman zip a...

Page 96: ... Start Power 2 Player Start Menu Menu 10 1 18 Pegbox Figure 10 17 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 The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 97: ...Volume down to go down a level Power to quit 10 1 19 Pong Figure 10 18 Pong Pong is a simple two player tennis game Whenever a player misses the ball the other scores Key Remote Key Action Up Left player up Down Left player down Volume up Right player up Volume down Right player down Power Quit The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 98: ...nd dark pieces or to play against a not very smart robot 10 1 21 Robotfindskitten Figure 10 19 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 The game ends when robotfindskitten Key Remote Key Action Up Down Left Right Forward Rewind...

Page 99: ...w is completed it will be cleared away and you gain points 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 Key Remote Key Action A Restart game Left Move left Right Move right Down Move down Volume up Rotate anticlockwise Volume down Rotate clockwise Select Drop Hold switch Pause Power Quit The Rockbox ...

Page 100: ...s_Game_of_Life for a detailed description Rockbox can open files with a configuration description cells files Just play such file and the game configuration stored in it will be loaded into this plugin A cells file is a text file A capital O marks a live cell a dot marks a dead cell all other characters are ignored Everything on a line starting with an exclamation sign and including it is a commen...

Page 101: ... to be the album art of the currently playing music track if one exists see section B 20 page 193 You can also use the sliding puzzle plugin as a viewer for supported image types to turn your own pictures into a puzzle Key controls Key Remote Key Action Left Right Up and Down Move Tile Select Shuffle A Switch between pictures default puz zle album art and your own image if launched via Open With a...

Page 102: ... your snake as large as possible by eating the dots that appear on the screen The game will end when the snake touches either the borders of the screen or itself Key Remote Key Action Up Down Change levels 1 is slowest 9 is fastest Select Toggle Play Pause The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 103: ...nds when the snake hits a wall or runs into itself Key Remote Key Action In menu Up Down Set game speed Right Left Select starting maze Menu Select game type A or B Select Start the game In game Up Down Left Right Steer the snake Select Pause and resume the game Power Quit In game A the maze stays the same in game B after an increasing number of apples eaten the maze is replaced by a new one The R...

Page 104: ...ly be pushed never pulled and only one can be pushed at a time Sokoban may be used as a viewer for viewing saved solutions and playing external level sets with the sok extension Level sets should be in the standard Sokoban text format or RLE Run Length Encoded For more information about the level format see http sokobano de wiki index php title Level_format The Rockbox manual Toshiba Gigabeat F an...

Page 105: ...usly undone move Solution playback Select Pause resume Up Down Increase decrease playback speed Left Right Go backward forward while paused Power Quit 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 The Roc...

Page 106: ...ames exist Though 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 interesting information visit http www solitairecentral com rules klondike html The Rockbox manual T...

Page 107: ...p of the cursor Long Select Put the card under the cursor on one of the 4 final colour stacks A Right Put the card on top of the remains stack on one of the final colour stacks Power Show menu 10 1 30 Spacerocks Figure 10 26 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 appea...

Page 108: ...a rewrite of Star a game written by CDK designed for the hp48 calculator Rules Take all of the o s to go to the next level You can switch control between the filled circle which can take o s and the filled square which is used as a mobile wall to allow your filled circle to get to places on the screen it could not otherwise reach The block cannot take o s The Rockbox manual Toshiba Gigabeat F and ...

Page 109: ... the Browse Plugins menu a random game will be generated automatically and an estimate of its difficulty very easy easy medium hard or fiendish will be displayed on the screen New games can be generated from the Generate menu option When playing an existing Sudoku game file from Rockbox file browser the plugin is invoked as viewer The selected Sudoku will get loaded and you can start solving it Th...

Page 110: ...hen be added If the number was already on the scratchpad it will get removed again The column is stored seperatly for every cell on the board 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 b Key Remote Key Action Up Down Left Right Move the cursor Select Change number under the cursor Long Select ...

Page 111: ... tiny worm into a big worm for as long as possible Game controls Key Remote Key Action Left Turn left Right Turn right Up Turn Up Down Turn Down The game Use the control keys of your worm to navigate around obstacles and find food Worms do not stop moving except when dead Dead worms are no fun Be careful as your worm will try to eat anything that you steer it across It won t distinguish whether it...

Page 112: ...elect to pause the game Press it 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 Power The game will stop immediately and you will return to the game menu If you want to stop the game and still see the screen hit A This freezes the game If you hit A button again a new game starts with the same configura tion To return...

Page 113: ...your worm Try to avoid other worms and crawl far away from them Wait until they curl up themselves and collect the food afterwards Don t worry if the other worms grow longer than yours you can catch up after they ve died 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 i...

Page 114: ...e arena with your trail in order to remove that section from the game Be careful not to get in the way of enemy balls because if they hit you or your trail you lose a life To finish a level you have to section off more than 75 Key Remote Key Action Up Down Left Right Move around the arena A Pause Power Open menu The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 115: ...rent one scrolling from right to left Key Remote Key Action Up Down Moves to next previous option Right Left Increases decreases option value A Toggles Scroll mode Power Exits bounce demo 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 man...

Page 116: ...on from the System section of the Rockbox main menu Exit at any time by pressing Left or Power 10 2 3 Cube Figure 10 32 Cube This is a rotating cube screen saver in 3D Key Remote Key Action A Display at maximum frame rate Select Pause Menu Cycle draw mode Right Left Select axis to adjust Up Down Change speed angle speed can not be changed while paused Power Quit The Rockbox manual Toshiba Gigabeat...

Page 117: ...igure 10 33 Demystify Demystify is a screen saver like demo Key Remote Key Action Left Right Volume Down Volume Up Increase decrease speed Up Down Forward Rewind Add remove polygon Power Quit The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 118: ... Fire is a demo displaying a fire effect Key Remote Key Action Up Down Forward Rewind Increase decrease number of flames Left Volume Down Toggle flame type Right Volume Up Toggle moving flames Power Quit The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 119: ...lect Zoom out Volume down Decrease iteration depth less detail Volume up Increase iteration depth more detail A Reset and return to the default image Power Quit 10 2 7 Logo Demo showing the Rockbox logo bouncing around the screen Key Remote Key Action Right Left Increase decrease speed on the x axis Up Down Increase decrease speed on the y axis Power Quit The Rockbox manual Toshiba Gigabeat F and ...

Page 120: ...pter 10 Plugins 120 10 2 8 Mosaique Figure 10 36 Mosaique This simple graphics demo draws a mosaic picture on the screen of the player Press Power to quit The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 121: ...rates the player is less responsive to user input and music may start to skip Keys Key Remote Key Action Select Toggle filled curve plot Down Toggle whether to scroll or not Up Toggle drawing orientation A Pause the demo Volume up Volume down Increase decrease volume Right Left Increase decrease speed Power Exit demo The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 122: ...un while your tracks are played Requirements PictureFlow uses both the album art see section B 20 page 193 and database see section 4 2 page 27 features of Rockbox It is therefore important that these are working correctly before attempting to use PictureFlow In addition there are some other points of which to be aware PictureFlow will accept album art larger than the dimensions of the screen but ...

Page 123: ... The distance between the front edges of the side slides i e changes the degree of overlap of the side slides A larger number means less overlap Scales with zoom Centre margin The distance in screen pixels with zoom at 100 between the centre and side slides Scales with zoom Number of slides Sets the number of slides at each side including the centre slide Therefore if set to 4 there will be 3 slid...

Page 124: ... albums and may occasionally be needed if albums are removed 10 2 11 Plasma Figure 10 39 Plasma Plasma is a demo displaying a 80 s style retro plasma effect Key Remote Key Action Up Down Forward Rewind Increase decrease Frequency Select Change Color Power Long Power Exit The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 125: ... 12 Snow Figure 10 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 Power to quit The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 126: ... 10 41 Starfield Starfield simulation like the classic screensaver Key Remote Key Action Right Left Increase decrease number of stars Up Down Increase decrease speed Select Change colours Power Quit The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 127: ...all meters in addition to the main display as above From the settings menu the decay time for the meter its memory the meter type and the meter scale can be changed Key Remote Key Action Power Save settings and quit A Help Menu Settings Up Raise Volume Down Lower Volume 10 3 Viewers Viewers are plugins which are associated with specific file extensions They cannot be run directly but are started b...

Page 128: ...is just a text file with every line containing the name of the file or the directory you want to quickly jump to All names should be full absolute names i e they should start with a Directory names should also end with a How to create link files You can use your favourite text editor to create a link file on the PC an then copy the file to the player Or you can use the context menu on either a fil...

Page 129: ... n where n is a number in the beginning of a link file will leave just the last n segments of the entries when they are shown For example if n is chosen to be 1 then the entry MyMusic collection song mp3 will be shown as song mp3 This allows you to hide common path prefixes You can also provide a custom display name for each entry individually To do so append a tabulator character after the entry ...

Page 130: ...lator s emulator for them The original Chip8 had 64 32 pixel graphics and the new superchip emulator supports 128 64 graphics The only problem is that they are based on a 4 4 keyboard but since most games do not use all of the buttons this can easily be worked around To do this one may put a c8k file with the same name as the original program which contains new key mappings for BLINKY ch8 one writ...

Page 131: ...tures colour and Unicode are not currently supported but the interpreter informs the game of this and almost all games will adapt so that they are still playable This port of Frotz attempts to be compliant with the Z Machine Specification version 1 0 Some places where you can find Z Machine games and information about interactive fiction The Interactive Fiction Archive where many free modern works...

Page 132: ...ut for the slideshow between 1 sec ond and 20 seconds Show Playback Menu From the playback menu you can control the playback of the currently loaded playlist and change the volume of your player Display Options From this menu you can force the viewer to render the image in greyscale using the Greyscale option or set the method of dithering used in the Dithering submenu Quit Quits the viewer and re...

Page 133: ...layer 10 3 7 Midiplay To get MIDI file playback a patchset is required This file contains the instruments required to synthesize the music A sample patchset is available through the wiki at ZPluginMidiPlay and needs to be extracted to the rockbox directory in the root of your player There should now be a rockbox patchset directory with the patchset directory containing several pat files and two cf...

Page 134: ... 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 through the video The video playback is started by pressing the select button Quit mpegplayer Exit the plugin Resume Menu Yes min x x Resume video playback at stored resume time x x No Play video from ...

Page 135: ...ode your videos to the supported format ZPluginMpegplayer 10 3 9 PNG viewer This plugin opens png files from the File Browser to display them Note When an audio file is playing the size of the image is limited as the decoding b process needs to share memory with audio tracks To be able to view a bigger file you may need to stop playback Key Remote Key Action Up Down Left Right Move around in zoome...

Page 136: ...button Note Both ASCII PPM P3 and raw PPM P6 files are supported b For more information about PPM files see http netpbm sourceforge net doc ppm html 10 3 11 Rockboy Figure 10 43 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 Toshiba Gigabeat F and X...

Page 137: ...spect ratio should be kept when scaling the picture to the screen or whether it should be displayed unscaled Screen Rotate Rotate the displayed picture by 90 degrees Set Palette Pick one of a few predefined colour palettes Quit RockBoy Quits the Rockboy plugin 10 3 12 Search This plugin can be used on playlists It searches through the playlist that it opened on looking for any occurrences of the s...

Page 138: ... Viewer Figure 10 44 Text Viewer This is a Viewer for text files with word wrap Just open a txt or nfo file to display it The text viewer features controls to handle various styles of text formatting and has top of file and bottom of file buttons You can view files without a txt or nfo extension by using Open with from the Context Menu see section 4 1 2 page 24 You can also bookmark pages The Rock...

Page 139: ...Greek ISO 8859 8 Hebrew CP1251 Cyrillic ISO 8859 11 Thai CP1256 Arabic ISO 8859 9 Turkish ISO 8859 2 Latin Extended CP1250 Central European SJIS Japanese GB 2312 Simple Chinese KSX 1001 Korean BIG5 Traditional Chinese UTF 8 Unicode This setting only applies to the plugin and is independent from the Default Codepage setting see section 8 4 page 65 Word Wrap Toggle word wrap mode On Break lines at t...

Page 140: ... not displayed even if you select Yes No Do not display the status bar Yes Display the status bar Scroll Settings The scrolling settings submenu Horizontal Submenu for horizontal scrolling settings Scrollbar Toggle the horizontal scrollbar for the current mode If the file fits on one screen there is no scrollbar and this setting has no effect No Do not display the horizontal scroll bar Yes Display...

Page 141: ...Key Narrow mode Change the function of the Left and Right buttons when the screen is in narrow mode i e one screen per page Previous Next Page Scroll up or down one full screen Top Bottom Page Move to the top or bottom page Indent Spaces Set the number of spaces to indent the text when line mode is set to Reflow Lines Available options are 0 to 5 spaces If you select 0 a blank line is displayed as...

Page 142: ...ings are stored in rockbox rocks viewers viewer dat 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 Select The bookmark will be displayed as shown below To delete the bookmark press the same button again The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 143: ...ed and which are being kept Exit this screen by pressing any key A file called theme_remove_log txt is created in the root directory of your player listing all the changes Remove Options This menu specifies which items are removed if Remove Theme is selected in the menu One of the following options can be chosen for each setting Ask for Removal Selecting this option brings up a dialogue with two o...

Page 144: ...onging to a theme cfg file is handled Filetype Colours Specifies how the colours colours file belonging to a theme cfg file is handled Create Log File Setting this to No prevents the log file from being created Quit Exits this plugin 10 3 17 VBRfix This function scans a VBR Variable Bitrate MP3 file and updates creates the Xing VBR header The Xing header contains information about the VBR stream u...

Page 145: ...of 48k z80 snapshots is possible b Default keys The emulator is set up for 5 different buttons Up Down Left Right and Jump Fire Each one of these can be mapped to one key of the Spectrum Keyboard or they can be used like a Kempston joystick Per default the buttons including an additional but fixed menu button are assigned as follows Key Remote Key Action Up Down Left Right Directional movement Sel...

Page 146: ...e Spectrum keyboard Display Speed Toggle displaying the emulation speed in percent Invert Colours Inverts the Spectrum colour palette sometimes helps visibility 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 Predefined Keymap Select one of the predef...

Page 147: ... using your player normally Results can be submitted to the ZBatteryRuntime wiki page How it works Once loaded Battery Benchmark runs in the background recording various informa tion about your battery to memory A new point is written to memory every minute Every time the disk is accessed for any reason such as refilling the audio buffer opening a directory or entering USB mode etc then the inform...

Page 148: ...ltage in mV at the moment the measurement was taken C This stands for Charger An A in that column shows if the power adapter was attached to the unit at the time of the measurement 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 Usage The log file can be used to tell you how long the battery lasted with ...

Page 149: ...ks like a standard calculator Pressing the 1st and 2nd buttons will toggle between other available math functions Key Remote Key Action Left Right Up Down Move around the keypad Select Select a button A Delete last entered digit or clear after cal culation Menu Calculate Power Quit The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 150: ...mos The available memo types are one off yearly monthly and weekly memos You can select what day is first day of week by the setting First Day of Week in the menu Key Remote Key Action Left Right Up Down Move the selector Select Show memos for the selected day Volume up Volume down Previous Next month Power Quit The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 151: ...n Increase decrease displayed Value Select Move to next screen Power Move to previous screen First enter the number of players 1 10 Then set the total game time in mm ss 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 The Rockbox manual Toshib...

Page 152: ...ess again to continue Up Switch to next player Down Switch to previous player Menu Open menu Select to select From the menu it is possible to delete a player modify the round time for the current player or set the total time for the game 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 Th...

Page 153: ...he counter Mode Settings Opens a menu from which you can adjust settings pertaining to the current clock mode analog digital binary 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 Backli...

Page 154: ...own at the upper left The Blinking Colon if enabled blinks the colon once every second 12 hour mode if enabled will display the time in a 12 hour format LCD mode Based on the Digital Mode the LCD mode is another imitation of an LCD The settings available in this mode are exactly the same as Digital Mode but they are independent of Digital Mode For example you can have the Date Readout enabled in D...

Page 155: ...es added in by the user Key Remote Key Action Left or Power Rewind Exit Abort 10 4 8 Keybox Keybox is an encrypted password storage using the Tiny Encryption Algorithm with a key derived using md5 Using Keybox To get started start up the plugin and select Enter Keybox The first time you enter Keybox you will be prompted for a master password and for confirmation of the master password The master p...

Page 156: ...mp3 files lrc8 files are the same as lrc files except that they are UTF8 encoded The Lyrics3 tag is not supported Supported tags and formats for lrc files The following tags are supported ti title ar artist offset offset msec Each line should resemble one of the following time tag line time tag time tag line time tag word time tag word word time tag word time tag The time tag must be in the form m...

Page 157: ...yrics The name of this directory can be customized see below If the audio file currently playing is Music Artist Album Title mp3 then the fol lowing 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 A...

Page 158: ...sbar Display Title Show hide the track title Display Time Show hide the current time Inactive Colour Set the colour of the inactive part of the lyrics Backlight Force On Do not turn off the backlight while displaying the lyrics Display Settings Change how the lyrics are displayed Wrap Breaks lines at white space Wipe Wipes the text Alignment Align text to the left centre or right Activate Only Cur...

Page 159: ...rom the plugin menu to create an md5sum of the file the directory s contents or the whole filesystem If the file s extension is md5 or md5sum it will check the md5 sums in the file instead If the file s extension is md5list it will compute md5 sums for all the files listed 10 4 12 Metronome This plugin can be used as a metronome to keep time during music practice Adjust the tempo through the inter...

Page 160: ...der_advance_list txt Import List From Textfile Imports the list from rockbox folder_advance_list txt Play Shuffled Starts playback with the selected directories in random order Tracks within a directory will be played in normal order The plugin will exit after starting playback Quit Folder List Editor Keys Key Remote Key Action Select or Right Forward Delete selected folder Long Select Long Menu B...

Page 161: ...e LED will use the first option is the most common and a safe bet and the current that it will draw likewise with the first option Then use the onscreen keyboard to type in the supply voltage and if selected the custom foreward current This function produces safe estimates but use your own judgement when using these output values Power rating and displayed resistance are rounded up to the nearest ...

Page 162: ...nd of the Colour Picker to the selected colour Pencil Draws as you move the cursor You can change the brush size with the Menu option Brush Size Use the Select key to toggle the tool while editing the image Selection tool Allows you to select a rectangular region once you do you will be shown a menu of options including cancel if you make a mistake Line tool Draws a straight line Curve tool Allows...

Page 163: ...dicate the width will be shown but it doesn t affect drawing Set Height Allows you to change the height of the image Border to indicate the height will be shown but it doesn t affect drawing Brush speed Changes the speed at which the selection cursor moves when you hold down a movement button Brush size Allows you to adjust the drawing size of the pencil tool Choose colour Allows you to manually e...

Page 164: ...tats plugin The stats plugin simply counts the number of files music files and directories on your player Press Power to abort counting and exit the plugin Press it again to quit after counting has finished The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 165: ...e Up Down Scroll through lap times 10 4 18 Text Editor This plugin allows you to view and edit simple text documents on your DAP You can view files by using Open with from the Context Menu see section 4 1 2 page 24 Usage If you start the Text Editor from the plugin browser you will be greeted with a blank screen When started from the Open with menu item your file should be shown on the The Rockbox...

Page 166: ...ighlighted 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 b Key Remote Key Action Select or Right Forward Edit Line Select Character Left or Power Rewind Exit Abort Editing Menu Menu Show Item Menu Long Select Long Menu Delete Line The R...

Page 167: ...an be found in the tools directory of the Rockbox source code See ZCreateFonts ConvBdf for more details Or just run convbdf without any parameters to see the possible options 11 1 3 Loading Languages Rockbox can load language files at runtime Simply copy the lng file do not use the lang file to the player and play it in the Rockbox directory browser or select Settings General Settings Language fro...

Page 168: ...lac ac3 a52 mpc wv m4a m4b mp4 mod shn aif aiff spx sid adx nsf nsfe spc ape mac sap mpg mpeg bmp fnt kbd All file extensions that are not either specifically listed in the colours files or are not in the list above will be set to the colour given by Extensions that are in the above list but not in the colours file will be set to the foreground colour as normal Activating To activate the filetype ...

Page 169: ...open the Context Menu see section 4 1 2 page 24 on it and select the option Set As Backdrop If you want rockbox to remember your backdrop the next time you start your player the backdrop must be placed in the rockbox backdrops directory 11 1 6 UI Viewport By default the UI is drawn on the whole screen This can be changed so that the UI is confined to a specific area of the screen by use of a UI vi...

Page 170: ...me you must save the theme files with UTF 8 character encoding This can be done in most editors for example Notepad in Windows 2000 or XP but not in 9x ME can do this Files Locations Each different themeable aspect requires its own file WPS files have the extension wps FM screen files have the extension fms and SBS files have the extension sbs The main theme file has the extension cfg All files sh...

Page 171: ...ot be displayed at the same time Viewports cannot be layered transparently over one another Subsequent viewports will be drawn over any other viewports already drawn onto that area of the screen Viewport Declaration Syntax V x y width height font Vf fgcolour Vb bgcolour fgcolour and bgcolour are 6 digit RGB888 colours e g FF00FF font is a number 0 is the built in system font 1 is the current menu ...

Page 172: ...ll be displayed in viewport a if it is found Otherwise a red flashing warning will be displayed in viewport b Note The tag to display conditional viewports must come before the tag to preload the b viewport in the wps file 11 2 3 Info Viewport SBS only As mentioned above it is possible to set a UI viewport via the theme cfg file It is also possible to set the UI viewport through the SBS file and t...

Page 173: ...to be specified if no else part is desired The conditionals nest so the text in the if and else part can contain all commands including conditionals Enumerations Syntax xx alt1 alt2 alt3 else For tags with multiple values like Play status the conditional can hold a list of alternatives one for each value the tag can have Example enumeration Example mp Stop Play Pause Ffwd Rew The last else part is...

Page 174: ... 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 Example s t 4 ia s it t 3 pc pr Display id3 artist for 4 seconds Display id3 title for 2 seconds Display current and remaining track time for 3 s...

Page 175: ...ep_one bmp 16 64 xl e rep_shuffle bmp 16 64 mm xd b xd c xd d xd e Four images at the same x and y position are preloaded in the example Which image to display is determined by the mm tag the repeat mode Example File Example s in in it it fn ia ia id id pb pc pt That is tracknum title artist album where most fields are only displayed if available Could also be rendered as filename or tracknum titl...

Page 176: ...le volume 70 bass 11 treble 12 balance 0 time format 12hour volume display numeric show files supported wps rockbox car wps lang rockbox afrikaans lng Note As you can see from the example configuration files do not need to contain all b of the Rockbox options You can create configuration files that change only certain set tings So for example supppose you typically use the player at one volume in ...

Page 177: ...to store all of the user settings that are described throughout this manual Hint Use the Save cfg File feature Main Menu Manage Settings to save the current settings then use a text editor to customize the settings file See Appendix section C page 199 for the full reference of available options Save Sound Settings This option writes a cfg file to your player s disk The config uration file has the ...

Page 178: ...ed 11 5 3 Anti Skip Buffer 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 7 5 page 55 11 5 4 Replaygain Replaygain is a post processing that equalises the playback volume of audio files to the same perceived loudness This post processing appl...

Page 179: ...ty If you have the choice select the best suiting codec when encoding the original source material 11 5 6 Sound settings In general all kinds of sound processing will need more CPU time and therefore consume more power The less sound processing you use the better it is for the battery runtime for options see section 6 page 47 The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 180: ...Appendix A File formats 180 The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 181: ...esheet cue View the cuesheet file Font fnt Change the user interface font to this one Rockbox firmware gigabeat Load the new firmware with ROLO Image jpg View the JPEG image Link link Display list of target files and di rectories selecting one jumps to the target See section 10 3 1 page 128 Language File lng Load the language file Playlist m3u m3u8 Load the playlist and start playing the first fil...

Page 182: ...dvanced Audio Coding m4a m4b mp4 MPEG audio mp1 mpa mp2 mp3 Musepack mpc Supports SV7 and SV8 in mono stereo OGG Vorbis ogg oga Playback of some old floor 0 files may fail Sony Audio oma aa3 RealAudio rm ra rmvb Speex spx Dialogic telephony type vox Windows Media Audio Standard wma wmv asf Windows Media Audio Professional wma wmv asf The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 183: ...au snd Sun Audio supports following for mats linear pcm 8 16 24 32 bit IEEE float 32 64 bit ITU T G 711 a low µ low Free Lossless Audio flac Apple Lossless m4a mp4 Shorten shn Seeking not supported True Audio tta Wave64 w64 Wave Wave64 supports following formats Waveform audio format wav linear pcm 8 16 24 32 bit IEEE float 32 64 bit ITU T G 711 a low µ low Microsoft ADPCM Intel DVI ADPCM IMA ADPC...

Page 184: ... Notes Atari Sound Format cmc cm3 cmr cms dmc dlt mpt mpd Synthetic music Mobile Application Format mmf Supports PCM ADPCM only MOD mod NES Sound Format nsf nsfe Atari SAP sap Sound Interface Device sid SPC700 spc The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 185: ...he status bar They must be noted on their own line which will not be shown in the WPS B 2 Information from the track tags Tag Description ia Artist ic Composer iA Album Artist id Album Name iG Grouping ig Genre Name in Track Number it Track Title iC Comment iv ID3 version 1 0 1 1 2 2 2 3 2 4 or empty if not an ID3 tag iy Year ik Disc Number Remember that this information is not always available so...

Page 186: ...ag B 4 Additional Fonts Tag Description Fl id filename See section 11 2 4 B 5 Power Related Information Tag Description bl Numeric battery level in percents Can also be used in a conditional bl 1 0 1 2 N where the value 1 is used when the battery level isn t known it usually is The value N is only used when the battery level is ex actly 100 percent An image can also be used the propor tion of the ...

Page 187: ... SID ADX NSF Speex SPC APE WMA MOD SAP ff File Frequency in Hz fk File Frequency in kHz fm File Name fn File Name without extension fp File Path fs File Size in Kilobytes fv avg if variable bit rate or empty string if constant bit rate d N N th segment from the end of the file s directory N can be 1 2 3 Example for the d N commands If the file is Rock Kent Isola 11 747 mp3 d 1 is Isola d 2 is Kent...

Page 188: ...v x y width height image bmp pS Track is starting An optional number gives how many seconds the tag remains true for after the start of the track The de fault is 10 seconds if no number is specified pS 7 in the first 7 seconds of track in the rest of the track pE Track is ending An optional number gives how many seconds before the end of the track the tag becomes true The default is 10 seconds if ...

Page 189: ...tion rp Song playcount rr Song rating 0 10 This tag can also be used in a conditional tag rr 0 1 2 3 4 5 6 7 8 9 10 ra Autoscore for the song B 10 Sound DSP settings Tag Description Sp Current playback pitch xf Crossfade setting in the order Off Auto Skip Man Skip Shuffle Shuffle and Man Skip Always rg ReplayGain value in use x y dB If used as a conditional Replaygain type in use rg Off Track Albu...

Page 190: ...a conditional tag For players without some capabilities e g having no FM radio some values will be never yielded Example You are in the cs Main menu WPS Recording screen FM Radio screen B 16 List Title sbs only Tag Description Lt Title text Should be used in a conditional so that non list screens don t show a title when they shouldn t Li Title icon This uses the same order as custom icons see ZCus...

Page 191: ...g on whether the volume is being changed It can produce neat effects when used with conditional viewports Example mv 2 5 Volume changing pv The example above will display the text Volume changing if the volume is being changed and 2 5 seconds after the volume button has been released After that it will display the volume value B 18 Settings Tag Description St setting name The value of the Rockbox ...

Page 192: ...vertically of the same height contained in the bitmap Default is 1 xd n i tag offset Display a preloaded image n image ID a z and A Z as it was specified in x or xl i optional number of the sub image to display a z for 1 26 and A Z for 27 52 ignored when tag is used By default the first i e top most sub image will be used tag optional Another tag to calculate the subimage from e g xd A mh would us...

Page 193: ... not support RLE compressed BMP files nor does it support progressive and multi scan JPEG files JPEG files must consist of a single scan with interleaved components as progessive and multi scan images require much more memory to decode B 20 2 Where to put album art The pictures can be named a number of different ways and placed to a number of different locations You can have pictures specific to t...

Page 194: ... Maximum height maxheight Maximum width hor_align Horizontal alignment enter as l c or r for left centre or right Centre is default vert_align Vertical alignment enter as t c or b for top centre or bottom Centre is default Cd Display the album art as configured C Use in a conditional to determine if an image is available The picture will be rescaled preserving aspect ratio to fit the given maxwidt...

Page 195: ...d texts overlap they are merged Example ax V B 22 Conditional Tags Tag Description xx true false If Else Evaluate for true or false case xx alt1 alt2 alt3 else Enumerations Evaluate for first second third last condition if tag operator operand option count Allows very simple comparisons with other tags tag the tag to check against operator the comparison to perform possible options are operand eit...

Page 196: ...ro padded hour from 01 to 12 am pm format cl Hour from 1 to 12 am pm format cm Month from 01 to 12 cM Minutes cS Seconds cy 2 digit year cY 4 digit year cP Capital AM PM cp Lowercase am pm ca Weekday name cb Month name cu Day of week from 1 to 7 1 is Monday cw Day of week from 0 to 6 0 is Sunday cc Check for presence of the clock hardware The cc tag returns c if the necessary hardware is present a...

Page 197: ...y y co ordinate at which to start drawing the bar width width of the bar for the full viewport width height height of the bar to set to the font height for hori zontal bars and to the viewport height for vertical bars options any of the options set out below B 26 1 Options image the next option is either the filename or image label to use for the fill image horizontal force the bar to be drawn hor...

Page 198: ...ed width and height B 27 Other Tags Tag Description The character The character The character The character The character The character The character The character The character s Indicate that the line should scroll Can occur anywhere in a line 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 ...

Page 199: ... 5s 15s 30s 1min 2min 3min 5min 10min N A volume fade on off N A sort case on off N A show files all supported music playlists N A show filename exts off on unknown view_all N A follow playlist on off N A playlist viewer icons on off N A playlist viewer indices on off N A playlist viewer track display track name full path N A recursive directory insert on off ask N A scroll speed 1 to 25 Hz scroll...

Page 200: ...54 s battery capacity devise a way to get ranges from config h mAh car adapter mode on off N A idle poweroff off 1 2 3 4 5 6 7 8 9 10 15 30 45 60 min max files in playlist 1000 32000 N A max files in dir 50 10000 N A lang path filename lng N A wps path filename wps N A autocreate bookmarks off on N A autoload bookmarks off on N A use most recent bookmarks off on N A pause on headphone unplug off p...

Page 201: ... root files dB wps menu bookmarks N A playlist catalog directory path to dir N A list_accel_start_delay 0 to 10 ms list_accel_wait 1 to 10 s replaygain type track album track shuffle off N A replaygain noclip on off N A replaygain preamp 120 to 120 0 1 dB crossfade off auto track change man track skip shuffle shuffle or man track skip always N A crossfade fade in delay 0 to 7 s crossfade fade out ...

Page 202: ...o 2 1 4 1 6 1 10 1 limit N A compressor knee hard knee soft knee N A compressor release time 100 to 1000 100 ms beep off weak moderate strong N A keyclick off weak moderate strong N A keyclick repeats on off N A dircache on off N A tagcache_ram on off N A 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 N A peak meter clip hold on 1 2 3 4 5 6 7 8...

Page 203: ...ow icons on off N A iconset path filename bmp N A viewers iconset path filename bmp N A backdrop path filename bmp N A foreground colour 000000 to FFFFFF RRGGBB background colour 000000 to FFFFFF RRGGBB line selector start colour 000000 to FFFFFF RRGGBB line selector end colour 000000 to FFFFFF RRGGBB line selector text colour 000000 to FFFFFF RRGGBB filetype colours path filename colours N A time...

Page 204: ...Appendix D Menu Overview 204 D Menu Overview include an overview of the menu structure here The Rockbox manual Toshiba Gigabeat F and X Series ...

Page 205: ...d and what happened Whether the problem is repeatable or a one time occurrence All relevant data regarding the problem such as playlists MP3 files etc IM PORTANT E 2 Feature ideas To suggest an idea for a feature or to read those made by others see http forums rockbox org index php board 49 0 Please keep in mind that this forum is for the discus sion of feature ideas they are not requests and ther...

Page 206: ...nderstand them Add scandisk like features It would be a very slow operation that would drain the batteries and take a lot of useful ram for something that is much better and faster done when connected to a host computer Alphabetical list skipping Skipping around the lists by jumping letters i e skip all C s and go straight to the first D This isn t feasible with the current list implementation if ...

Page 207: ...Frederic Dang Ngoc Pierre De lore Huw Smith Garrett Derner Barry McIntosh Leslie Donald son Lee Pilgrim Zakk Roberts Francois Boucher Matthias Wien tapper Brent Coutts Jens Arnold Gerald Vanbaren Christi Scarbor ough Steve Cundari Mat Holton Jan Gajdos Antoine Cellerier Brian King Jiri Jurecek Jacob Erl beck Jean Philippe Bernardy Dave Hooper Jonas Häggqvist Thom Johansen Rinat Zakirov Manuel Dejo...

Page 208: ...dam Gashlin Robert Kukla David Quesada Jared Stafford Martin Hensel Stéphane Doyon Austin Appel Andre Smith Travis Hyyppa Ian Webber Pavel Gnelitsa Lutz Böhne Will Robertson Robert Carboneau Ye Wei Bryan Childs Mike Schmitt Chris Taylor Tobias Langhoff Steve Gotthardt Greg White Mattieu Favréaux Malcolm Tyrrell Piotr Jafis zow Gary Allen John BouAntoun Tomasz Mon Jakub Matoušek Al bert Veli Chris ...

Page 209: ... Eric Lassauge François Dinel Francesco Rigoni Joël Puik Klaas Bosteels Teruaki Kawashima Marcin Łukasik Le Jin Alex Ben nee Stéphane Quertinmont Bartosz Fabianowski Adam Hogan Andrew Mahone Anton Veretenenko Vi cente Ibarra Rui Araújo Brian Cloutier Olivier Barbut Yoshi hisa Uchida Sanggon Lee Kaspar Rothenfußer Ryan Press Craig El liott Kenderes Tamas Eric Shat tow Joshua Simmons Sei Aoyumi Mart...

Page 210: ...Roosens Hayden Pearce Rodrigo Barretto Daniel Rigby Alexey Polkhirev István Nagy Wojciech Lesniak Tuomas Airaksi nen Calvin Walden Michael Gen try David Fowle The libmad team The wavpack team The FFmpeg team The Ogg Vorbis team The liba52 team The Speex team The libfaad team The Doom team The gnuchess team The gnuboy team The Pacman Instructional Emulator team The Spectemu team The libmpeg2 team T...

Page 211: ...ch is a copyleft license designed for free software We have designed this License in order to use it for manuals for free software be cause free software needs free documentation a free program should come with manuals providing the same freedoms that the software does But this License is not limited to software manuals it can be used for any textual work regardless of subject matter or whether it...

Page 212: ...ation is available to the general public that is suitable for revising the document straightforwardly with generic text editors or for images com posed of pixels generic paint programs or for drawings some widely available drawing editor and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters A copy made in an oth...

Page 213: ...under the same conditions stated above and you may publicly display copies 3 COPYING IN QUANTITY If you publish printed copies or copies in media that commonly have printed covers of the Document numbering more than 100 and the Document s license notice requires Cover Texts you must enclose the copies in covers that carry clearly and legibly all these Cover Texts Front Cover Texts on the front cov...

Page 214: ...vious version if the original publisher of that version gives permission B List on the Title Page as authors one or more persons or entities responsible for authorship of the modifications in the Modified Version together with at least five of the principal authors of the Document all of its principal authors if it has fewer than five unless they release you from this requirement C State on the Ti...

Page 215: ...ew front matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document you may at your option designate some or all of these sections as invariant To do this add their titles to the list of Invariant Sections in the Modified Version s license notice These titles must be distinct from any other section titles You may add a section Entitled Endorse...

Page 216: ...ents released under this License and replace the individual copies of this License in the various docu ments with a single copy that is included in the collection provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects You may extract a single document from such a collection and distribute it individually under this License provided yo...

Page 217: ...es who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 10 FUTURE REVISIONS OF THIS LICENSE The Free Software Foundation may publish new revised versions of the GNU Free Doc umentation License from time to time Such new versions will be similar in spirit to the present version but may differ in deta...

Page 218: ...ons being LIST THEIR TITLES with the Front Cover Texts being LIST and with the Back Cover Texts being LIST If you have Invariant Sections without Cover Texts or some other combination of the three merge those two alternatives to suit the situation If your document contains nontrivial examples of program code we recommend re leasing these examples in parallel under your choice of free software lice...

Page 219: ...ns that forbid anyone to deny you these rights or to ask you to surrender the rights These restrictions translate to certain responsibilities for you if you distribute copies of the software or if you modify it For example if you distribute copies of such a program whether gratis or for a fee you must give the recipients all the rights that you have You must make sure that they too receive or can ...

Page 220: ...ep intact all the notices that refer to this License and to the absence of any warranty and give any other recipients of the Program a copy of this License along with the Program You may charge a fee for the physical act of transferring a copy and you may at your option offer warranty protection in exchange for a fee 2 You may modify your copy or copies of the Program or any portion of it thus for...

Page 221: ...you also do one of the following a Accompany it with the complete corresponding machine readable source code which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange or b Accompany it with a written offer valid for at least three years to give any third party for a charge no more than your cost of physically performing source distrib...

Page 222: ... and conditions You may not impose any further restrictions on the recipients exercise of the rights granted herein You are not responsible for enforcing compliance by third parties to this License 7 If as a consequence of a court judgment or allegation of patent infringement or for any other reason not limited to patent issues conditions are imposed on you whether by court order agreement or othe...

Page 223: ...t version or of any later version published by the Free Software Foundation If the Program does not specify a version number of this License you may choose any version ever published by the Free Software Foundation 10 If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different write to the author to ask for permission For software which is c...

Page 224: ...convey the exclusion of warranty and each file should have at least the copyright line and a pointer to where the full notice is found one line to give the program s name and a brief idea of what it does Copyright C year name of author This program is free software you can redistribute it and or modify it un der the terms of the GNU General Public License as published by the Free Software Foundati...

Page 225: ...lso get your employer if you work as a programmer or your school if any to sign a copyright disclaimer for the program if necessary Here is a sample alter the names Yoyodyne Inc hereby disclaims all copyright interest in the program Gnomovision which makes passes at compilers written by James Hacker signature of Ty Coon 1 April 1989 Ty Coon President of Vice This General Public License does not pe...

Reviews: