From 6fa9d4d0a934376e2bc25f023f317b5dba52cd30 Mon Sep 17 00:00:00 2001 From: Nils Wallménius Date: Sun, 1 Jul 2007 11:05:01 +0000 Subject: Rename playback.text to the less confusing name browsing_and_playing.tex (as that is the name of the chapter) git-svn-id: svn://svn.rockbox.org/rockbox/trunk@13752 a1c6a512-1295-4272-9138-f99709370657 --- manual/rockbox_interface/browsing_and_playing.tex | 271 ++++++++++++++++++++++ manual/rockbox_interface/main.tex | 2 +- manual/rockbox_interface/playback.tex | 271 ---------------------- 3 files changed, 272 insertions(+), 272 deletions(-) create mode 100644 manual/rockbox_interface/browsing_and_playing.tex delete mode 100644 manual/rockbox_interface/playback.tex (limited to 'manual/rockbox_interface') diff --git a/manual/rockbox_interface/browsing_and_playing.tex b/manual/rockbox_interface/browsing_and_playing.tex new file mode 100644 index 0000000000..bf9a49b62d --- /dev/null +++ b/manual/rockbox_interface/browsing_and_playing.tex @@ -0,0 +1,271 @@ +% $Id$ % +\chapter{Browsing and playing} +\section{\label{ref:file_browser}File Browser} +\screenshot{rockbox_interface/images/ss-file-browser}{The file browser}{} +Rockbox lets you browse your music in either of two ways. The +\setting{File Browser} lets you navigate through the files and folders on +your \dap, entering folders and executing the default action on each file. +To help differentiate files, each file format is displayed with an icon. + +The \setting{Database Browser}, on the other hand, allows you to navigate +through the music on your player using categories like album, artist, genre, +etc. + +You can select whether to browse using the \setting{File Browser} or the +\setting{Database Browser} by selecting either \setting{Files} or +\setting{Database} in the \setting{Main Menu}. +If you choose the \setting{File Browser}, the \setting{Show Files} setting +lets you select what types of files you wish to view. See +\reference{ref:ShowFiles} for more information on the \setting{Show Files} +setting. + +\note{The \setting{File Browser} allows you to manipulate your files in ways +that are not available within the \setting{Database Browser}. Read more about +\setting{Database} in \reference{ref:database}. The remainder of this section +deals with the \setting{File Browser}.} + +\opt{ondio}{ +Unlike the Archos Firmware, Rockbox provides multivolume support for the +MultiMediaCard, this means the \dap{} can access both data volumes (internal +memory and the MMC), thus being able to for instance, build playlists with +files from both volumes. +In the \setting{File Browser} a new folder will appear as soon as the device +has read the content after inserting the card. This new folder's name is +generated as \fname{}, and will behave exactly as any other folder +on the \dap{}. +} + +\opt{h10,h10_5gb}{\note{ +If your \dap{} is a MTP model, the Music folder where all your music is stored +may be hidden in the \setting{File Browser}. This may be fixed by either +either changing it's properties (on a computer) to not hidden, or by changing +the \setting{Show Files} setting to all. +}} + +\subsection{\label{ref:controls}File Browser Controls} +\begin{table} + \begin{btnmap}{}{} + \ActionStdPrev{}/\ActionStdNext{} + & Go to previous/next item in list. If you are on the first/last + entry, the cursor will wrap to the last/first entry.\\ + % + \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,RECORDER_PAD} + { + \ButtonOn+\ButtonUp{}/ \ButtonDown + & Move one page up/down in the list.\\ + } + \opt{IRIVER_H10_PAD} + { + \ButtonRew{}/ \ButtonFF + & Move one page up/down in the list.\\ + } + % + \ActionTreeParentDirectory & Go to the parent directory.\\ + % + \ActionTreeEnter + & Executes the default action on the selected file or enters a + directory.\\ + % + \ActionTreeWps & If there is an audio file playing, returns to the + \setting{While Playing Screen} (WPS) without stopping playback.\\ + % + \nopt{player}% + {% + \ActionTreeStop & Stops audio playback.\\% + }% + % + \ActionStdContext{} + & Enter the \setting{File Menu}\\ + % + \ActionStdMenu{} + & Enter the \setting{Main Menu}\\ + % + \opt{RECORDER_PAD}{ + \ButtonFTwo & Switches to the Browse/Play Quick Menu \\ + % + \ButtonFThree & Switches to the Display Quick Menu \\ + % + } + \end{btnmap} +\end{table} + +\opt{RECORDER_PAD}{ + The functions of the F keys are also summarised on the button bar at the + bottom of the screen. +} + +\subsection{\label{ref:Filemenu}\label{ref:PartIISectionFM}File Menu} +\screenshot{rockbox_interface/images/ss-file-menu}{The File Menu}{} + +The \setting{File Menu} allows you to perform certain operations on files or +folders. To access the \setting{File Menu}, position the selector over a file +or folder and access the context menu with \ActionStdContext{}. + +\note{The \setting{File Menu} is a context sensitive menu. If the +\setting{File Menu} is invoked on a file, it will display options available +for files. If the \setting{File Menu} is invoked on a folder or directory, +it will display options for directories.} + +The \setting{File Menu} contains the following options (unless otherwise noted, +each option pertains both to files and directories): + +\begin{description} +\item [Playlist.] + Enters the \setting{Playlist Submenu} (see \reference{ref:playlist_submenu}). +\item [Rename.] + This function lets the user modify the name of a file or directory. +\item [Cut.] + Copies the name of the currently selected file or directory to the clipboard + and marks it to be `cut'. +\item [Copy.] + Copies the name of the currently selected file or directory to the clipboard + and marks it to be `copied'. +\item [Paste.] + Only visible if a file or directory name is on the clipboard. When selected + it will move or copy the clipboard to the current directory. +\item [Delete.] + Deletes the currently selected file. This option applies only to files, and + not to directories. Rockbox will ask for confirmation before deleting a file. + Press \ActionYesNoAccept{} + to confirm deletion or any other key to cancel. +\item [Delete Directory.] + Deletes the currently selected directory and all of the files and folders + contained in the selected directory. Deleted directories cannot be recovered. + Use this feature with caution! +\item [Open with.] + Runs a viewer plugin on the file. Normally, when a file is selected in Rockbox, + Rockbox automatically detects the file type and runs the appropriate plugin. + The \setting{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 \fname{.txt}). See \reference{ref:Viewersplugins} + for more details on viewers. +\item [Create Directory.] + Create a new folder in the current folder on the disk. +\item [Properties.] + Shows properties such as size and the time and date of the last modification + for the selected file. If used on a directory, the number of files and sub + directories in that directory will be shown, as well as the total size. +\end{description} + +\subsection{\label{sec:virtual_keyboard}Virtual Keyboard} +\screenshot{rockbox_interface/images/ss-virtual-keyboard}{The virtual keyboard}{} +This is the virtual keyboard that is used when entering text in Rockbox, for + example when renaming a file or creating a new directory. + +\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,RECORDER_PAD,GIGABEAT_PAD,SANSA_E200_PAD}{ + \begin{table} + \begin{btnmap}{}{} + \ActionKbdLeft{}/ \ActionKbdRight{}/ \ActionKbdUp{}/ \ActionKbdDown + & Move about the virtual keyboard (moves the solid cursor) \\ + % + \ActionKbdCursorLeft{} or \ActionKbdCursorRight + & Move the line cursor within the text line \\ + % + \ActionKbdSelect + & Inserts the selected keyboard letter at the current cursor position \\ + % + \ActionKbdAbort + & Exits the virtual keyboard without saving any changes \\ + % + \opt{RECORDER_PAD}{ + \ButtonFOne + & Shifts between the upper case, lower case and accented keyboards \\ + } + % + \ActionKbdDone + & Exits the virtual keyboard and saves any changes \\ + \ActionKbdBackSpace + & Deletes the character before the line cursor \\ + % + \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,GIGABEAT_PAD}{ + \ActionKbdMorseInput + & Enters Morse input mode \\ + \ActionKbdMorseSelect + & Tap to select a character in Morse input mode \\ + } + \end{btnmap} + \end{table} +} + +\opt{IPOD_4G_PAD,IPOD_3G_PAD,IRIVER_H10_PAD,IAUDIO_X5_PAD}{ + \textbf{Picker area} + \begin{table} + \begin{btnmap}{}{} + \ActionKbdUp/\ActionKbdDown & Move about the virtual keyboard. + If you move out of the picker area, you get to the \emph{Line edit mode}. \\ + \ActionKbdLeft/\ActionKbdRight & (moves the solid cursor). \\ + \ActionKbdSelect + & Inserts the currently selected keyboard letter at the current + filename cursor position \\ + \ActionKbdDone + & Exits the virtual keyboard and saves any changes \\ + \ActionKbdAbort + & Exits the virtual keyboard without saving any changes\\ + \opt{IPOD_4G_PAD,IPOD_3G_PAD,IRIVER_H10_PAD}{ + \ActionKbdMorseInput + & Enters Morse input mode \\ + \ActionKbdMorseSelect + & Tap to select a character in Morse input mode \\ + } + \end{btnmap} + \end{table} + \textbf{Line edit mode} + \begin{table} + \begin{btnmap}{}{} + \ActionKbdLeft/\ActionKbdRight & Move left and right\\ + \ActionKbdSelect & Deletes the letter to the left of the cursor\\ + \ActionKbdUp/\ActionKbdDown & Returns to the picker area\\ + \end{btnmap} + \end{table} +} +\opt{ondio}{ + \begin{table} + \begin{btnmap}{Picker area}{} + \ButtonUp/\ButtonDown/\ButtonLeft/\ButtonRight + & Move about the virtual keyboard (moves the solid cursor). + If you move out of the picker area with \ButtonUp/\ButtonDown, + you get to the line edit mode. \\ + \ButtonMenu + & Selects the letter underneath the cursor. \\ + Hold \ButtonMenu + & Accepts the change and returns to the File Browser.\\ + \ButtonOff + & Quit the virtual keyboard without saving the changes.\\ + \end{btnmap} + \end{table} + \begin{table} + \begin{btnmap}{Line edit mode}{} + \ButtonLeft/\ButtonRight & Move left and right\\ + \ButtonMenu & Deletes the letter to the left of the cursor\\ + Hold \ButtonMenu & Accepts the deletion\\ + \ButtonUp/\ButtonDown & Returns to the picker area\\ + \end{btnmap} + \end{table} +} + +\opt{player}{ + The current text line to be entered or edited is always listed on the first + line of the display. The second line of the display can contain the character + selection bar, as in the screenshot above. + \begin{table} + \begin{btnmap}{}{} + \ButtonOn & Toggle picker- and line edit mode\\ + \ButtonLeft/\ButtonRight & moves back and forth in the selected \\ + & line (picker of input line) \\ + \ButtonPlay & Picks character in character bar, or acts as backspace \\ + & in the text line.\\ + Hold \ButtonPlay & Accept\\ + \ButtonStop & Cancel\\ + \ButtonMenu & Flips picker lines\\ + \end{btnmap} + \end{table} + +} + +\input{rockbox_interface/tagcache.tex} +\input{rockbox_interface/wps.tex} + +%Include playlist section +\input{working_with_playlists/main.tex} diff --git a/manual/rockbox_interface/main.tex b/manual/rockbox_interface/main.tex index 17d48a9407..219f8c90e7 100644 --- a/manual/rockbox_interface/main.tex +++ b/manual/rockbox_interface/main.tex @@ -411,4 +411,4 @@ garbled.} \fixme{include an overview of the menu structure here} %\input{rockbox_interface/menu_structure.tex} -\input{rockbox_interface/playback.tex} +\input{rockbox_interface/browsing_and_playing.tex} diff --git a/manual/rockbox_interface/playback.tex b/manual/rockbox_interface/playback.tex deleted file mode 100644 index bf9a49b62d..0000000000 --- a/manual/rockbox_interface/playback.tex +++ /dev/null @@ -1,271 +0,0 @@ -% $Id$ % -\chapter{Browsing and playing} -\section{\label{ref:file_browser}File Browser} -\screenshot{rockbox_interface/images/ss-file-browser}{The file browser}{} -Rockbox lets you browse your music in either of two ways. The -\setting{File Browser} lets you navigate through the files and folders on -your \dap, entering folders and executing the default action on each file. -To help differentiate files, each file format is displayed with an icon. - -The \setting{Database Browser}, on the other hand, allows you to navigate -through the music on your player using categories like album, artist, genre, -etc. - -You can select whether to browse using the \setting{File Browser} or the -\setting{Database Browser} by selecting either \setting{Files} or -\setting{Database} in the \setting{Main Menu}. -If you choose the \setting{File Browser}, the \setting{Show Files} setting -lets you select what types of files you wish to view. See -\reference{ref:ShowFiles} for more information on the \setting{Show Files} -setting. - -\note{The \setting{File Browser} allows you to manipulate your files in ways -that are not available within the \setting{Database Browser}. Read more about -\setting{Database} in \reference{ref:database}. The remainder of this section -deals with the \setting{File Browser}.} - -\opt{ondio}{ -Unlike the Archos Firmware, Rockbox provides multivolume support for the -MultiMediaCard, this means the \dap{} can access both data volumes (internal -memory and the MMC), thus being able to for instance, build playlists with -files from both volumes. -In the \setting{File Browser} a new folder will appear as soon as the device -has read the content after inserting the card. This new folder's name is -generated as \fname{}, and will behave exactly as any other folder -on the \dap{}. -} - -\opt{h10,h10_5gb}{\note{ -If your \dap{} is a MTP model, the Music folder where all your music is stored -may be hidden in the \setting{File Browser}. This may be fixed by either -either changing it's properties (on a computer) to not hidden, or by changing -the \setting{Show Files} setting to all. -}} - -\subsection{\label{ref:controls}File Browser Controls} -\begin{table} - \begin{btnmap}{}{} - \ActionStdPrev{}/\ActionStdNext{} - & Go to previous/next item in list. If you are on the first/last - entry, the cursor will wrap to the last/first entry.\\ - % - \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,RECORDER_PAD} - { - \ButtonOn+\ButtonUp{}/ \ButtonDown - & Move one page up/down in the list.\\ - } - \opt{IRIVER_H10_PAD} - { - \ButtonRew{}/ \ButtonFF - & Move one page up/down in the list.\\ - } - % - \ActionTreeParentDirectory & Go to the parent directory.\\ - % - \ActionTreeEnter - & Executes the default action on the selected file or enters a - directory.\\ - % - \ActionTreeWps & If there is an audio file playing, returns to the - \setting{While Playing Screen} (WPS) without stopping playback.\\ - % - \nopt{player}% - {% - \ActionTreeStop & Stops audio playback.\\% - }% - % - \ActionStdContext{} - & Enter the \setting{File Menu}\\ - % - \ActionStdMenu{} - & Enter the \setting{Main Menu}\\ - % - \opt{RECORDER_PAD}{ - \ButtonFTwo & Switches to the Browse/Play Quick Menu \\ - % - \ButtonFThree & Switches to the Display Quick Menu \\ - % - } - \end{btnmap} -\end{table} - -\opt{RECORDER_PAD}{ - The functions of the F keys are also summarised on the button bar at the - bottom of the screen. -} - -\subsection{\label{ref:Filemenu}\label{ref:PartIISectionFM}File Menu} -\screenshot{rockbox_interface/images/ss-file-menu}{The File Menu}{} - -The \setting{File Menu} allows you to perform certain operations on files or -folders. To access the \setting{File Menu}, position the selector over a file -or folder and access the context menu with \ActionStdContext{}. - -\note{The \setting{File Menu} is a context sensitive menu. If the -\setting{File Menu} is invoked on a file, it will display options available -for files. If the \setting{File Menu} is invoked on a folder or directory, -it will display options for directories.} - -The \setting{File Menu} contains the following options (unless otherwise noted, -each option pertains both to files and directories): - -\begin{description} -\item [Playlist.] - Enters the \setting{Playlist Submenu} (see \reference{ref:playlist_submenu}). -\item [Rename.] - This function lets the user modify the name of a file or directory. -\item [Cut.] - Copies the name of the currently selected file or directory to the clipboard - and marks it to be `cut'. -\item [Copy.] - Copies the name of the currently selected file or directory to the clipboard - and marks it to be `copied'. -\item [Paste.] - Only visible if a file or directory name is on the clipboard. When selected - it will move or copy the clipboard to the current directory. -\item [Delete.] - Deletes the currently selected file. This option applies only to files, and - not to directories. Rockbox will ask for confirmation before deleting a file. - Press \ActionYesNoAccept{} - to confirm deletion or any other key to cancel. -\item [Delete Directory.] - Deletes the currently selected directory and all of the files and folders - contained in the selected directory. Deleted directories cannot be recovered. - Use this feature with caution! -\item [Open with.] - Runs a viewer plugin on the file. Normally, when a file is selected in Rockbox, - Rockbox automatically detects the file type and runs the appropriate plugin. - The \setting{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 \fname{.txt}). See \reference{ref:Viewersplugins} - for more details on viewers. -\item [Create Directory.] - Create a new folder in the current folder on the disk. -\item [Properties.] - Shows properties such as size and the time and date of the last modification - for the selected file. If used on a directory, the number of files and sub - directories in that directory will be shown, as well as the total size. -\end{description} - -\subsection{\label{sec:virtual_keyboard}Virtual Keyboard} -\screenshot{rockbox_interface/images/ss-virtual-keyboard}{The virtual keyboard}{} -This is the virtual keyboard that is used when entering text in Rockbox, for - example when renaming a file or creating a new directory. - -\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,RECORDER_PAD,GIGABEAT_PAD,SANSA_E200_PAD}{ - \begin{table} - \begin{btnmap}{}{} - \ActionKbdLeft{}/ \ActionKbdRight{}/ \ActionKbdUp{}/ \ActionKbdDown - & Move about the virtual keyboard (moves the solid cursor) \\ - % - \ActionKbdCursorLeft{} or \ActionKbdCursorRight - & Move the line cursor within the text line \\ - % - \ActionKbdSelect - & Inserts the selected keyboard letter at the current cursor position \\ - % - \ActionKbdAbort - & Exits the virtual keyboard without saving any changes \\ - % - \opt{RECORDER_PAD}{ - \ButtonFOne - & Shifts between the upper case, lower case and accented keyboards \\ - } - % - \ActionKbdDone - & Exits the virtual keyboard and saves any changes \\ - \ActionKbdBackSpace - & Deletes the character before the line cursor \\ - % - \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,GIGABEAT_PAD}{ - \ActionKbdMorseInput - & Enters Morse input mode \\ - \ActionKbdMorseSelect - & Tap to select a character in Morse input mode \\ - } - \end{btnmap} - \end{table} -} - -\opt{IPOD_4G_PAD,IPOD_3G_PAD,IRIVER_H10_PAD,IAUDIO_X5_PAD}{ - \textbf{Picker area} - \begin{table} - \begin{btnmap}{}{} - \ActionKbdUp/\ActionKbdDown & Move about the virtual keyboard. - If you move out of the picker area, you get to the \emph{Line edit mode}. \\ - \ActionKbdLeft/\ActionKbdRight & (moves the solid cursor). \\ - \ActionKbdSelect - & Inserts the currently selected keyboard letter at the current - filename cursor position \\ - \ActionKbdDone - & Exits the virtual keyboard and saves any changes \\ - \ActionKbdAbort - & Exits the virtual keyboard without saving any changes\\ - \opt{IPOD_4G_PAD,IPOD_3G_PAD,IRIVER_H10_PAD}{ - \ActionKbdMorseInput - & Enters Morse input mode \\ - \ActionKbdMorseSelect - & Tap to select a character in Morse input mode \\ - } - \end{btnmap} - \end{table} - \textbf{Line edit mode} - \begin{table} - \begin{btnmap}{}{} - \ActionKbdLeft/\ActionKbdRight & Move left and right\\ - \ActionKbdSelect & Deletes the letter to the left of the cursor\\ - \ActionKbdUp/\ActionKbdDown & Returns to the picker area\\ - \end{btnmap} - \end{table} -} -\opt{ondio}{ - \begin{table} - \begin{btnmap}{Picker area}{} - \ButtonUp/\ButtonDown/\ButtonLeft/\ButtonRight - & Move about the virtual keyboard (moves the solid cursor). - If you move out of the picker area with \ButtonUp/\ButtonDown, - you get to the line edit mode. \\ - \ButtonMenu - & Selects the letter underneath the cursor. \\ - Hold \ButtonMenu - & Accepts the change and returns to the File Browser.\\ - \ButtonOff - & Quit the virtual keyboard without saving the changes.\\ - \end{btnmap} - \end{table} - \begin{table} - \begin{btnmap}{Line edit mode}{} - \ButtonLeft/\ButtonRight & Move left and right\\ - \ButtonMenu & Deletes the letter to the left of the cursor\\ - Hold \ButtonMenu & Accepts the deletion\\ - \ButtonUp/\ButtonDown & Returns to the picker area\\ - \end{btnmap} - \end{table} -} - -\opt{player}{ - The current text line to be entered or edited is always listed on the first - line of the display. The second line of the display can contain the character - selection bar, as in the screenshot above. - \begin{table} - \begin{btnmap}{}{} - \ButtonOn & Toggle picker- and line edit mode\\ - \ButtonLeft/\ButtonRight & moves back and forth in the selected \\ - & line (picker of input line) \\ - \ButtonPlay & Picks character in character bar, or acts as backspace \\ - & in the text line.\\ - Hold \ButtonPlay & Accept\\ - \ButtonStop & Cancel\\ - \ButtonMenu & Flips picker lines\\ - \end{btnmap} - \end{table} - -} - -\input{rockbox_interface/tagcache.tex} -\input{rockbox_interface/wps.tex} - -%Include playlist section -\input{working_with_playlists/main.tex} -- cgit v1.2.3