diff options
Diffstat (limited to 'manual/rockbox_interface')
-rw-r--r-- | manual/rockbox_interface/main.tex | 121 |
1 files changed, 85 insertions, 36 deletions
diff --git a/manual/rockbox_interface/main.tex b/manual/rockbox_interface/main.tex index 0804c5590c..2dea78089d 100644 --- a/manual/rockbox_interface/main.tex +++ b/manual/rockbox_interface/main.tex | |||
@@ -9,7 +9,7 @@ | |||
9 | \end{center} | 9 | \end{center} |
10 | 10 | ||
11 | Throughout this manual, the buttons on the \dap\ are labelled according to the | 11 | Throughout this manual, the buttons on the \dap\ are labelled according to the |
12 | picture above. To turn on and shutdown your \dap, the following keys are used: | 12 | picture above. To turn on and shut down your \dap, the following keys are used: |
13 | 13 | ||
14 | \begin{table} | 14 | \begin{table} |
15 | \begin{btnmap}{}{} | 15 | \begin{btnmap}{}{} |
@@ -40,15 +40,23 @@ picture above. To turn on and shutdown your \dap, the following keys are used: | |||
40 | 40 | ||
41 | \section{\label{ref:file_browser}File Browser} | 41 | \section{\label{ref:file_browser}File Browser} |
42 | \screenshot{rockbox_interface/images/ss-file-browser}{The file browser}{} | 42 | \screenshot{rockbox_interface/images/ss-file-browser}{The file browser}{} |
43 | The file browser helps you navigate through the files on your \dap, entering | 43 | Rockbox lets you browse your music in either of two ways. The ``File Browser'' |
44 | folders and executing the default action on each file. To help us differentiate | 44 | lets you navigate through the files and folders on your \dap, entering folders |
45 | files, each file format is displayed with an icon. You can select which file | 45 | and executing the default action on each file. To help differentiate files, |
46 | types are displayed (see page \pageref{ref:ShowFiles}). | 46 | each file format is displayed with an icon. |
47 | \note{When Tag Cache is enabled you will access the Tag Cache browser instead | 47 | |
48 | of the File Browser. With Tag Cache you will be able accessing your music | 48 | The ``Tag Cache Browser,'' on the other hand, allows you to navigate through |
49 | using a database but won't be able doing any file manipulations. | 49 | the music on your player using categories like album, artist, genre, etc. |
50 | Read more about Tag Cache in Section \ref{ref:tagcache}. | 50 | |
51 | } | 51 | You can select whether to browse using the File Browser or the Tag Cache Browser by |
52 | adjusting the \setting{Show Files} setting. If you choose the File Browser, the | ||
53 | \setting{Show Files} setting also lets you select what types of files you wish to | ||
54 | view. See page \pageref{ref:ShowFiles} for more information on the \setting{Show | ||
55 | Files} setting. | ||
56 | |||
57 | \note{The File Browser allows you to manipulate your files in ways that are not | ||
58 | available within the Tag Cache Browser. Read more about Tag Cache in Section | ||
59 | \ref{ref:tagcache}. The remainder of this section deals with the File Browser.} | ||
52 | 60 | ||
53 | \subsection{\label{ref:controls}Controls} | 61 | \subsection{\label{ref:controls}Controls} |
54 | \begin{table} | 62 | \begin{table} |
@@ -111,21 +119,27 @@ types are displayed (see page \pageref{ref:ShowFiles}). | |||
111 | } | 119 | } |
112 | 120 | ||
113 | \subsection{\label{ref:Filemenu}\label{ref:PartIISectionFM}File Menu} | 121 | \subsection{\label{ref:Filemenu}\label{ref:PartIISectionFM}File Menu} |
114 | \screenshot{rockbox_interface/images/ss-file-menu}{The file menu}{} | 122 | \screenshot{rockbox_interface/images/ss-file-menu}{The File Menu}{} |
115 | 123 | ||
116 | This menu operates on the file that was selected in the browser. It offers the | 124 | The File Menu allows you to perform certain operations on files or folders. |
117 | following options: | 125 | To access the File Menu, position the selector over a file or folder and |
126 | \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD} | ||
127 | {hold the \ButtonSelect\ button.} | ||
128 | \opt{RECORDER_PAD,PLAYER_PAD}{press the \ButtonPlay/\ButtonOn+\ButtonPlay\ | ||
129 | buttons.} | ||
130 | \opt{ONDIO_PAD}{hold the \ButtonRight\ button.} | ||
131 | |||
132 | \note{The File Menu is a context sensitive menu. If the File Menu is | ||
133 | invoked on a file, it will display options available for files. If the | ||
134 | File Menu is invoked on a folder or directory, it will display options | ||
135 | for directories.} | ||
136 | |||
137 | The File Menu contains the following options (unless otherwise noted, each | ||
138 | option pertains both to files and directories): | ||
118 | 139 | ||
119 | \begin{description} | 140 | \begin{description} |
120 | \item [Open with:] | ||
121 | Runs a viewer plugin on the file. Normally the filetype of a file is detected | ||
122 | and the appropriate plugin is run automatically when you press play on it. | ||
123 | Use this menu if for some reason you want to override the default action and | ||
124 | select a viewer by hand. See page \textmd{\pageref{ref:Viewersplugins}} for | ||
125 | more details on viewers. For example, this would be used to view a text file | ||
126 | with a non-standard extension, i.e. not ending with .txt. | ||
127 | \item [Playlist:] | 141 | \item [Playlist:] |
128 | Change to the Playlist submenu (see below). | 142 | Enters to the Playlist Submenu (see below). |
129 | \item [Rename:] | 143 | \item [Rename:] |
130 | This function lets the user modify a file name. | 144 | This function lets the user modify a file name. |
131 | \item [Cut:] | 145 | \item [Cut:] |
@@ -138,23 +152,38 @@ following options: | |||
138 | Only visible if a file or directory name is on the clipboard. When selected | 152 | Only visible if a file or directory name is on the clipboard. When selected |
139 | it will move or copy the clipboard to the current directory. | 153 | it will move or copy the clipboard to the current directory. |
140 | \item [Delete:] | 154 | \item [Delete:] |
141 | Only files can be deleted, not folders. Rockbox will ask for confirmation | 155 | Deletes the currently selected file. This option applies only to files, and |
142 | before deleting a file. Press PLAY to confirm deletion or any other key to | 156 | not to directories. Rockbox will ask for confirmation before deleting a file. |
143 | cancel. | 157 | Press |
158 | \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,IPOD_4G_PAD,IPOD_VIDEO_PAD} | ||
159 | {\ButtonSelect} | ||
160 | \opt{PLAYER_PAD,RECORDER_PAD}{\ButtonPlay} | ||
161 | \opt{ONDIO_PAD}{\ButtonRight} | ||
162 | to confirm deletion or any other key to cancel. | ||
144 | \item [Delete Directory:] | 163 | \item [Delete Directory:] |
145 | Deletes the folder pointed to by the cursor and all the files and folders | 164 | Deletes the currently selected directory and all of the files and folders |
146 | contained in it. Use with caution. | 165 | contained in the selected directory. Deleted directories cannot be recovered. |
166 | Use this feature with caution! | ||
167 | \item [Open with:] | ||
168 | Runs a viewer plugin on the file. Normally, when a file is selected in Rockbox, | ||
169 | Rockbox automatically detects the file type and runs the appropriate plugin. | ||
170 | The ``Open With'' function can be used to override the default action and | ||
171 | select a viewer by hand. For example, this function can be used to view a text file | ||
172 | even if the file has a non-standard extension (i.e., the file has an extension | ||
173 | of something other than ``.txt''). See page \textmd{\pageref{ref:Viewersplugins}} | ||
174 | for more details on viewers. | ||
147 | \item [Create Directory:] | 175 | \item [Create Directory:] |
148 | Makes a new folder in the current folder on the disk. | 176 | Makes a new folder in the current folder on the disk. |
149 | \end{description} | 177 | \end{description} |
150 | 178 | ||
151 | \subsection{\label{ref:Playlistsubmenu}Playlist Submenu} | 179 | \subsection{\label{ref:Playlistsubmenu}Playlist Submenu} |
152 | \screenshot{rockbox_interface/images/ss-playlist-menu}{The playlist menu}{} | 180 | \screenshot{rockbox_interface/images/ss-playlist-menu}{The Playlist Submenu}{} |
153 | If the playlist submenu is invoked on a directory, it will act on all the files | 181 | The Playlist Submenu allows you to put tracks into a ``dynamic playlist''. |
154 | within that directory. If invoked on a playlist it will act on all the files | 182 | If there is no music currently playing, Rockbox will create a new dynamic playlist |
155 | in that playlist. Otherwise it acts only on the current file. | 183 | and put the selected track(s) into the playlist. If there is music currently playing, |
156 | 184 | Rockbox will put the selected track(s) into the current playlist. The place in which | |
157 | This menu provides the following options: | 185 | the newly selected tracks are added to the playlist is determined by the following |
186 | options: | ||
158 | 187 | ||
159 | \begin{description} | 188 | \begin{description} |
160 | \item [Insert:] | 189 | \item [Insert:] |
@@ -176,10 +205,30 @@ This menu provides the following options: | |||
176 | Queue track(s) at end of playlist. | 205 | Queue track(s) at end of playlist. |
177 | \end{description} | 206 | \end{description} |
178 | 207 | ||
179 | You can insert a track, directory or playlist even if nothing is currently | 208 | The Playlist Submenu can be used to add either single tracks or entire directories |
180 | playing. In this case, a new playlist is created with only the selected tracks | 209 | to a playlist. If the Playlist Submenu is invoked on a single track, it will put |
181 | and then play is started.\\ | 210 | only that track into the playlist. On the other hand, if the Playlist Submenu |
182 | \note{The dynamic playlist is saved so resume will restore it exactly as before shutdown.} | 211 | is invoked on a directory, Rockbox adds all of the tracks in that directory to |
212 | the playlist. | ||
213 | |||
214 | \note{You can control whether or not Rockbox includes the contents of subdirectories | ||
215 | when adding an entire directory to a playlists. Set the \setting{Main Menu | ||
216 | $\rightarrow$ Playlist Options $\rightarrow$ Recusively Insert Directories} setting to | ||
217 | \setting{Yes} if you would like Rockbox to include tracks in subdirectories as well as tracks | ||
218 | in the currently-selected directory.} | ||
219 | |||
220 | If you want to have Rockbox create a playlist of a whole folder (to play an entire | ||
221 | album, for example), use the File Browser to select the song. When a single song is | ||
222 | selected from the File Browser, Rockbox will automatically create a playlist with all | ||
223 | songs in the current folder. However, if you want to play only a single song and then | ||
224 | stop, stop playback, navigate to the song you want to play, and use the \setting{Playlist | ||
225 | $\rightarrow$ Insert} function to select the song. | ||
226 | |||
227 | Dynamic playlists are saved so resume will restore them exactly as they were before | ||
228 | shutdown. | ||
229 | |||
230 | \note{To view, save or reshuffle the current dynamic playlist, use the | ||
231 | \setting{Playlist Options} setting in the WPS Context Menu.} | ||
183 | 232 | ||
184 | \subsection{Virtual Keyboard} | 233 | \subsection{Virtual Keyboard} |
185 | \screenshot{rockbox_interface/images/ss-virtual-keyboard}{The virtual keyboard}{} | 234 | \screenshot{rockbox_interface/images/ss-virtual-keyboard}{The virtual keyboard}{} |