2 \section{\label{ref:WPS
}While Playing Screen
}
3 The While Playing Screen (WPS) displays various pieces of information about the
4 currently playing audio file.
7 The appearance of the WPS can be configured using WPS configuration files.
8 The items shown depend on your configuration -- all items can be turned on
9 or off independently. Refer to
\reference{ref:wps_tags
} for details on how
10 to change the display of the WPS.
13 \item Status bar: The Status bar shows Battery level, charger status,
14 volume, play mode, repeat mode, shuffle mode
\opt{rtc
}{ and clock
}.
15 In contrast to all other items, the status bar is always at the top of
19 \item Status bar: The Status bar shows Battery level, USB power mode, key
20 lock status, memory access indicator. In contrast to all other items, the
21 status bar is always at the top of the screen.
23 \item (Scrolling) path and filename of the current song.
24 \item The ID3 track name.
25 \item The ID3 album name.
26 \item The ID3 artist name.
27 \item Bit rate. VBR files display average bitrate and ``(avg)''
28 \item Elapsed and total time.
29 \item A slidebar progress meter representing where in the song you are.
33 \opt{recorder,recorderv2fm,ondio
}{
36 \item The number of lines shown depends on the size of the font used.
37 \item The peak meter is only visible if you turn off the status bar or if
38 using a small font that gives
8 or more display lines.
46 \item Playlist index/Playlist size: Artist
{}- Title.
47 \item Current
{}-time Progress
{}-indicator Left.
52 See
\reference{ref:ConfiguringtheWPS
} for details of customising
53 your WPS (While Playing Screen).
56 \subsection{\label{ref:WPS_Key_Controls
}WPS Key Controls
}
59 \ActionWpsVolUp{} /
\ActionWpsVolDown
60 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsVolUp{} /
\ActionRCWpsVolDown}
64 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsSkipPrev}
65 & Go to beginning of track, or if pressed while in the
66 first seconds of a track, go to the previous track.\\
69 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsSeekBack}
73 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsSkipNext}
74 & Go to the next track.\\
77 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsSeekFwd}
78 & Fast forward in track.\\
81 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsPlay}
82 & Toggle play/pause.\\
85 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsStop}
89 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsBrowse}
90 & Return to the
\setting{File Browser
} /
\setting{Database
}.\\
93 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsContext}
94 & Enter
\setting{WPS Context Menu
}.\\
96 \opt{ONDIO_PAD
}{\ActionWpsContext{} twice
}%
97 \nopt{ONDIO_PAD
}{\ActionWpsMenu}%
98 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsMenu}
99 & Enter
\setting{Main Menu
}%
100 \opt{ONDIO_PAD
}{ via the
\setting{WPS Context Menu
}}.\\%
103 \ActionWpsQuickScreen
104 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsQuickScreen}
105 & Switch to the
\setting{Quick Screen
}
106 (see
\reference{ref:QuickScreen
}). \\
}%
108 % software hold targets
110 \opt{RECORDER_PAD
}{\ButtonFOne+
\ButtonDown}
111 \opt{PLAYER_PAD
}{\ButtonMenu+
\ButtonStop}
112 \opt{ONDIO_PAD
}{\ButtonMenu+
\ButtonDown}
113 \opt{SANSA_CLIP_PAD
}{\ButtonHome+
\ButtonSelect}
114 \opt{SANSA_FUZEPLUS_PAD
}{\ButtonPower}
115 & Key lock (software hold switch) on/off.\\
117 %These actions need definitions for the other targets
119 \ButtonFThree & Toggles Display quick screen.\\%
120 \ButtonFOne+
\ButtonPlay & Mute on/off.\\%
123 \ButtonMenu+
\ButtonPlay & Mute on/off.\\%
125 % We explicitly list all the appropriate targets here and do no condition
126 % on the 'pitchscreen' feature since some players have the feature but do
127 % not have the button to go from the WPS to the pitch screen.
128 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IRIVER_H10_PAD,MROBE100_PAD
%
129 ,GIGABEAT_PAD,GIGABEAT_S_PAD,SANSA_E200_PAD,SANSA_C200_PAD,SANSA_FUZEPLUS_PAD
}{%
130 \ActionWpsPitchScreen
131 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsPitchScreen}
132 & Show
\setting{Pitch Screen
} (see
\reference{sec:pitchscreen
}).\\%
134 \opt{GIGABEAT_PAD,GIGABEAT_S_PAD,SANSA_CLIP_PAD,MROBE100_PAD,PBELL_VIBE500_PAD
}{%
136 \opt{HAVEREMOTEKEYMAP
}{&
}
137 & Show current
\setting{Playlist
}.\\%
139 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IRIVER_H10_PAD
%
140 ,SANSA_E200_PAD,SANSA_C200_PAD,SANSA_FUZEPLUS_PAD
}{%
141 \ActionWpsIdThreeScreen
142 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCWpsIdThreeScreen}
143 & Enter
\setting{ID3 Viewer
}.\\%
146 \ActionWpsHotkey \opt{HAVEREMOTEKEYMAP
}{&
}
147 & Activate the
\setting{Hotkey
} function (see
\reference{ref:Hotkeys
}).\\
149 \opt{ab_repeat_buttons
}{%
150 \ActionWpsAbSetBNextDir{} or
}%
151 % not all targets have the above action defined but the one below works on all
152 Short
\ActionWpsSkipNext{} + Long
\ActionWpsSkipNext
153 \opt{HAVEREMOTEKEYMAP
}{
155 \opt{IRIVER_RC_H100_PAD
}{\ActionRCWpsAbSetBNextDir{} or
}
156 Short
\ActionRCWpsSkipNext{} + Long
\ActionRCWpsSkipNext}
157 & Skip to the next directory.\\
159 \opt{ab_repeat_buttons
}{%
160 \ActionWpsAbSetAPrevDir{} or
}%
161 Short
\ActionWpsSkipPrev{} + Long
\ActionWpsSkipPrev
162 \opt{HAVEREMOTEKEYMAP
}{
164 \opt{IRIVER_RC_H100_PAD
}{\ActionRCWpsAbSetAPrevDir{} or
}
165 Short
\ActionRCWpsSkipPrev{} + Long
\ActionRCWpsSkipPrev}
166 & Skip to the previous directory.\\
168 \opt{SANSA_E200_PAD,SANSA_C200_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD
}{
170 \opt{HAVEREMOTEKEYMAP
}{&
}
171 & Switch to the
\setting{Recording Screen
}.\\
177 \subsection{\label{ref:peak_meter
}Peak Meter
}
178 The peak meter can be displayed on the While Playing Screen and consists of
181 For a picture of the peak meter, please see the While
182 Recording Screen in
\reference{ref:while_recording_screen
}.
185 \note{Especially the
\playerman{} \playertype{}'s performance and battery runtime
186 suffers when this feature is enabled. For this
\dap{} it is highly recommended
187 to not use peak meter.
}
192 This is the wide horizontal bar. It represents the current volume value.
193 \item [The peak indicator:
]
194 This is a little vertical line at the right end of the bar. It indicates
195 the peak volume value that occurred recently.
196 \item [The clip indicator:
]
197 This is a little black block that is displayed at the very right of the
198 scale when an overflow occurs. It usually does not show up during normal
199 playback unless you play an audio file that is distorted heavily.
201 If you encounter clipping while recording, your recording will sound distorted.
202 You should lower the gain.
204 \note{Note that the clip detection is not very precise.
205 Clipping might occur without being indicated.
}
207 Between the indicators of the right and left channel there are little dots.
208 These dots represent important volume values. In linear mode each dot is a
209 10\% mark. In dBFS mode the dots represent the following values (from right
210 to left):
0~dB,
{}-
3~dB,
{}-
6~dB,
{}-
9~dB,
{}-
12~dB,
{}-
18~dB,
{}-
24~dB,
{}-
30~dB,
211 {}-
40~dB,
{}-
50~dB,
{}-
60~dB.
214 \subsection{\label{sec:contextmenu
}The WPS Context Menu
}
215 Like the context menu for the
\setting{File Browser
}, the
\setting{WPS Context Menu
}
216 allows you quick access to some often used functions.
218 \subsubsection{Playlist
}
219 The
\setting{Playlist
} submenu allows you to view, save, search and
220 reshuffle the current playlist. To change settings for the
221 \setting{Playlist Viewer
} press
\ActionStdContext{} while viewing the current
222 playlist to bring up the
\setting{Playlist Viewer Menu
}. In this menu, you
223 can find the
\setting{Playlist Viewer Settings
}.
225 \subsubsection{Playlist Viewer Settings
}
227 \item[Show Icons.
] This toggles display of the icon for the currently
228 selected playlist entry and the icon for moving a playlist entry
229 \item[Show Indices.
] This toggles display of the line numbering for
231 \item[Track Display.
] This toggles between filename only and full path
233 \item[Save Current Playlist.
] Allows the current playlist to be saved as
234 a
\fname{.m3u8
} playlist file
238 \subsubsection{Playlist catalogue
}
240 \item [View catalogue.
] This lists all playlists that are part of the
241 Playlist catalogue. You can load a new playlist directly from this list.
242 \item [Add to playlist.
] Adds the currently playing file to a playlist.
243 Select the playlist you want the file to be added to and it will get
244 appended to that playlist.
245 \item [Add to new playlist.
] Similar to the previous entry this will
246 add the currently playing track to a playlist. You need to enter a name
247 for the new playlist first.
250 \subsubsection{Sound Settings
}
251 This is a shortcut to the
\setting{Sound Settings Menu
}, where you can configure volume,
252 bass, treble, and other settings affecting the sound of your music.
253 See
\reference{ref:configure_rockbox_sound
} for more information.
255 \subsubsection{Playback Settings
}
256 This is a shortcut to the
\setting{Playback Settings Menu
}, where you can configure shuffle,
257 repeat, party mode, skip length and other settings affecting the playback of your music.
259 \subsubsection{Rating
}
260 The menu entry is only shown if
\setting{Gather Runtime Information
} is
261 enabled. It allows the assignment of a personal rating value (
0 --
10)
262 to a track which can be displayed in the WPS and used in the Database
263 browser. The value wraps at
10.
265 \subsubsection{Bookmarks
}
266 This allows you to create a bookmark in the currently-playing track.
268 \subsubsection{\label{ref:trackinfoviewer
}Show Track Info
}
269 \screenshot{rockbox_interface/images/ss-id3-viewer
}{The track info viewer
}{}
270 This screen is accessible from the WPS screen, and provides a detailed view of
271 all the identity information about the current track. This info is known as
272 meta data and is stored in audio file formats to keep information on artist,
273 album etc. To access this screen,
%
274 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IRIVER_H10_PAD,
%
275 SANSA_C200_PAD,SANSA_E200_PAD,SANSA_FUZE_PAD,SANSA_FUZEPLUS_PAD
}{
276 press
\ActionWpsIdThreeScreen.
}%
277 \opt{PLAYER_PAD,ONDIO_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IAUDIO_X5_PAD,IAUDIO_M3_PAD,
%
278 GIGABEAT_PAD,GIGABEAT_S_PAD,MROBE100_PAD,SANSA_CLIP_PAD,PBELL_VIBE500_PAD,
%
279 MPIO_HD200_PAD,MPIO_HD300_PAD
}{press
\ActionWpsContext{} to access the
280 \setting{WPS Context Menu
} and select
\setting{Show Track Info
}.
}
281 \opt{RECORDER_PAD,PLAYER_PAD,ONDIO_PAD
}{Use
\ButtonLeft\ and
\ButtonRight\
282 to move through the information.
}%
284 \subsubsection{Open With...
}
285 This
\setting{Open With
} function is the same as the
\setting{Open With
}
286 function in the file browser's
\setting{Context Menu
}.
288 \subsubsection{Delete
}
289 Delete the currently playing file. The file will be deleted but the playback
290 of the file will not stop immediately. Instead, the part of the file that
291 has already been buffered (i.e. read into the
\daps\ memory) will be played.
292 This may even be the whole track.
295 \subsubsection{\label{sec:pitchscreen
}Pitch
}
297 The
\setting{Pitch Screen
} allows you to change the rate of playback
298 (i.e. the playback speed and at the same time the pitch) of your
299 \dap. The rate value can be adjusted
300 between
50\% and
200\%.
50\% means half the normal playback speed and a
301 pitch that is an octave lower than the normal pitch.
200\% means double
302 playback speed and a pitch that is an octave higher than the normal pitch.
304 The rate can be changed in two modes: procentual and semitone.
305 Initially, procentual mode is active.
308 If you've enabled the
\setting{Timestretch
} option in
309 \setting{Sound Settings
} and have since rebooted, you can also use
310 timestretch mode. This allows you to change the playback speed
311 without affecting the pitch, and vice versa.
313 In timestretch mode there are separate displays for pitch and
314 speed, and each can be altered independently. Due to the
315 limitations of the algorithm, speed is limited to be between
35\%
316 and
250\% of the current pitch value. Pitch must maintain the
317 same ratio as well as remain between
50\% and
200\%.
320 The value of the
\opt{swcodec
}{rate, pitch and speed
}\nopt{swcodec
}{rate
}
321 is not persistent, i.e. after the
\dap\ is turned on it will
322 always be set to
100\%.
\opt{swcodec
}{ However, the rate, pitch and speed
323 information will be stored in any bookmarks you may create
324 (see
\reference{ref:Bookmarkconfigactual
}) and will be restored upon
325 playing back those bookmarks.
}
330 & Toggle pitch changing mode. \\
332 \ActionPsIncSmall{} /
\ActionPsDecSmall
333 & Increase~/ Decrease pitch by
0.1\% (in procentual mode) or by
0.1
334 semitone (in semitone mode).\\
336 \ActionPsIncBig{} /
\ActionPsDecBig
337 & Increase~/ Decrease pitch by
1\% (in procentual mode) or a semitone
338 (in semitone mode).\\
340 \ActionPsNudgeLeft{} /
\ActionPsNudgeRight
341 & Temporarily change pitch by
2\% (beatmatch). \\
344 & Reset rate to
100\%. \\
347 & Leave the
\setting{Pitch Screen
}. \\
351 \warn{Changing the pitch can cause audible `Artifacts' or `Dropouts'.
}
357 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCPsToggleMode}
358 & Toggle pitch changing mode (cycle through all available modes).\\
360 \ActionPsIncSmall{} /
\ActionPsDecSmall
361 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCPsIncSmall{} /
\ActionRCPsDecSmall}
362 & Increase~/ Decrease pitch by
0.1\% (in procentual mode) or
0.1
363 semitone (in semitone mode).\\
365 \nopt{PBELL_VIBE500_PAD
}{ % there is no long scroll up or down because of slide
366 \ActionPsIncBig{} /
\ActionPsDecBig
367 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCPsIncBig{} /
\ActionRCPsDecBig}
368 & Increase~/ Decrease pitch by
1\% (in procentual mode) or a semitone
369 (in semitone mode).\\
372 \ActionPsNudgeLeft{} /
\ActionPsNudgeRight
373 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCPsNudgeLeft{} /
\ActionRCPsNudgeRight}
374 & Temporarily change pitch by
2\% (beatmatch), or modify speed (in timestretch mode).\\
377 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCPsReset}
378 & Reset pitch and speed to
100\%. \\
381 \opt{HAVEREMOTEKEYMAP
}{&
\ActionRCPsExit}
382 & Leave the
\setting{Pitch Screen
}. \\
389 %********************QUICKSCREENS***********************************************
391 \section{\label{ref:QuickScreens
}Quick Screens
}
392 \screenshot{rockbox_interface/images/ss-quick-screen-
112x64x1.png
}{The F2 quick screen
}{}
393 \screenshot{rockbox_interface/images/ss-quick-screen2-
112x64x1.png
}{The F3 quick screen
}{}
394 Rockbox handles function buttons in a different way to the Archos software.
395 \ButtonFOne\ is always bound to the menu function, while
\ButtonFTwo\ and
396 \ButtonFThree\ enable two quick screens.
398 \ButtonFTwo\ displays some browse and play settings which are likely to be
399 changed frequently. This settings are Shuffle mode, Repeat mode and the Show
402 Shuffle mode plays each track in the currently playing list in a random order
403 rather than in the order shown in the browser.
405 Repeat mode repeats either a single track (One) or the entire playlist (All).
407 Show files determines what type files can be seen in the browser. This can be
408 just MP3 files and directories (Music), Playlists, MP3 files and directories
409 (Playlists), any files that Rockbox supports (Supported) or all files on the
412 See
\reference{ref:PlaybackOptions
} for more information about these
416 \ButtonLeft & Control Shuffle mode setting. \\
417 \ButtonRight & Control Repeat mode setting. \\
418 \ButtonDown & Control Show file setting. \\
421 \ButtonFThree\ controls frequently used display options.
423 Scroll bar turns the display of the Scroll bar on the left of the screen on
426 Status bar turns the status display at the top of the screen on or off.
427 Upside down inverts the screen so that the top of the display appears nearest
428 to the buttons. This is sometimes useful when storing the
\dap\ in a pocket.
429 Key assignments swap over with the display orientation where it is logical
432 See
\reference{ref:Displayoptions
} for more information about these
436 \ButtonLeft & Control scroll bar display. \\
437 \ButtonRight & Control status bar display. \\
438 \ButtonDown & Control upside down screen setting. \\