summaryrefslogtreecommitdiff
path: root/manual/advanced_topics/main.tex
diff options
context:
space:
mode:
Diffstat (limited to 'manual/advanced_topics/main.tex')
-rw-r--r--manual/advanced_topics/main.tex33
1 files changed, 20 insertions, 13 deletions
diff --git a/manual/advanced_topics/main.tex b/manual/advanced_topics/main.tex
index d66bdf5a0a..57dc6d6762 100644
--- a/manual/advanced_topics/main.tex
+++ b/manual/advanced_topics/main.tex
@@ -1,7 +1,7 @@
1% $Id$ % 1% $Id$ %
2\chapter{Advanced Topics} 2\chapter{Advanced Topics}
3 3
4\section{\label{ref:CustomisingUI}Customising the userinterface} 4\section{\label{ref:CustomisingUI}Customising the User Interface}
5\subsection{\label{ref:GettingExtras}Getting Extras} 5\subsection{\label{ref:GettingExtras}Getting Extras}
6\opt{lcd_bitmap}{ 6\opt{lcd_bitmap}{
7Rockbox supports custom fonts. A collection of fonts is available for download 7Rockbox supports custom fonts. A collection of fonts is available for download
@@ -45,6 +45,10 @@ file find the instructions on the Rockbox website:
45 and select \setting{Background Colour} or \setting{Foreground Colour}. 45 and select \setting{Background Colour} or \setting{Foreground Colour}.
46 The colours set here are used in all menus, browsers and in the 46 The colours set here are used in all menus, browsers and in the
47 \setting{While Playing Screen}. 47 \setting{While Playing Screen}.
48 \subsection{Changing Filetype Colours}
49 Rockbox has the capability to modify the File Browser to show different
50 filetypes in different colours depending upon the file extension.
51 See the \wikilink{CustomFiletypeColours} Wiki page for details.
48} 52}
49 53
50\nopt{archos,mrobe100}{% 54\nopt{archos,mrobe100}{%
@@ -142,7 +146,7 @@ The WPS parser will always display the last part if the tag has no value, or if
142the list of alternatives is too short. 146the list of alternatives is too short.
143\end{description} 147\end{description}
144 148
145\subsubsection{Next Song info} 149\subsubsection{Next Song Info}
146You can display information about the next song -- the song that is 150You can display information about the next song -- the song that is
147about to play after the one currently playing (unless you change the 151about to play after the one currently playing (unless you change the
148plan). 152plan).
@@ -157,7 +161,7 @@ name used in the next song and \config{\%Ff} is the mp3 frequency.
157 suggest you use the conditional display tag a lot when displaying 161 suggest you use the conditional display tag a lot when displaying
158 information about the next song!} 162 information about the next song!}
159 163
160\subsubsection{Alternating sublines} 164\subsubsection{Alternating Sublines}
161 165
162It is possible to group items on each line into 2 or more groups or 166It is possible to group items on each line into 2 or more groups or
163``sublines''. Each subline will be displayed in succession on the line for a 167``sublines''. Each subline will be displayed in succession on the line for a
@@ -268,9 +272,9 @@ title [artist]''.
268% % \end{verbatim} 272% % \end{verbatim}
269%} 273%}
270 274
271\section{\label{ref:manage_settings}Managing Rockbox settings} 275\section{\label{ref:manage_settings}Managing Rockbox Settings}
272 276
273\subsection{Introduction to \fname{.cfg} files.} 277\subsection{Introduction to \fname{.cfg} Files.}
274Rockbox allows users to store and load multiple settings through the use of 278Rockbox allows users to store and load multiple settings through the use of
275configuration files. A configuration file is simply a text file with the 279configuration files. A configuration file is simply a text file with the
276extension \fname{.cfg}. 280extension \fname{.cfg}.
@@ -286,7 +290,7 @@ for configuration files. See \reference{ref:manage_settings_menu} for an
286explanation of how to create, edit and load configuration files. 290explanation of how to create, edit and load configuration files.
287 291
288\subsection{\label{ref:cfg_specs}Specifications for \fname{.cfg} 292\subsection{\label{ref:cfg_specs}Specifications for \fname{.cfg}
289 files.} 293 Files.}
290 294
291The Rockbox configuration file is a plain text file, so once you use the 295The Rockbox configuration file is a plain text file, so once you use the
292\setting{Save .cfg file} option to create the file, you can edit the file on 296\setting{Save .cfg file} option to create the file, you can edit the file on
@@ -328,6 +332,9 @@ Example of a configuration file:
328 each file a different name (such as \fname{car.cfg}, 332 each file a different name (such as \fname{car.cfg},
329 \fname{headphones.cfg}, etc.), and you can then use the \setting{Browse .cfg 333 \fname{headphones.cfg}, etc.), and you can then use the \setting{Browse .cfg
330 files} option to quickly change settings.} 334 files} option to quickly change settings.}
335
336 A special case configuration file can be used to force a particular setting or settings every time Rockbox starts up (e.g. to set the volume to a safe level).
337Format a new configuration file as above with the required setting(s) and save it into the \fname{/.rockbox} directory with the filename \fname{fixed.cfg}.
331 338
332\subsection{\label{ref:manage_settings_menu}The \setting{Manage Settings} 339\subsection{\label{ref:manage_settings_menu}The \setting{Manage Settings}
333 menu} The \setting{Manage Settings} menu can be found in the \setting{Main 340 menu} The \setting{Manage Settings} menu can be found in the \setting{Main
@@ -337,7 +344,7 @@ Example of a configuration file:
337 344
338\begin{description} 345\begin{description}
339 346
340\item [Browse .cfg Files.]Opens the file browser in the \fname{/.rockbox} 347\item [Browse .cfg Files]Opens the file browser in the \fname{/.rockbox}
341 directory and displays all \fname{.cfg} (configuration) files. Selecting a 348 directory and displays all \fname{.cfg} (configuration) files. Selecting a
342 \fname{.cfg} file will cause Rockbox to load the settings contained in that 349 \fname{.cfg} file will cause Rockbox to load the settings contained in that
343 file. Pressing \ButtonLeft\ will exit back to the \setting{Manage Settings} 350 file. Pressing \ButtonLeft\ will exit back to the \setting{Manage Settings}
@@ -345,7 +352,7 @@ Example of a configuration file:
345 \setting{Manage Settings} menu for details of how to save and edit a 352 \setting{Manage Settings} menu for details of how to save and edit a
346 configuration file. 353 configuration file.
347 354
348\item [Reset Settings.]This wipes the saved settings in the \dap\ and 355\item [Reset Settings]This wipes the saved settings in the \dap\ and
349 resets all settings to their default values. 356 resets all settings to their default values.
350 357
351 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{ 358 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{
@@ -362,22 +369,22 @@ Example of a configuration file:
362 \ButtonA\ button immediately after the \dap\ turns on.} 369 \ButtonA\ button immediately after the \dap\ turns on.}
363 } 370 }
364 371
365\item [Save .cfg file.]This option writes a \fname{.cfg} file to 372\item [Save .cfg File]This option writes a \fname{.cfg} file to
366 your \daps{} disk. The configuration file has the \fname{.cfg} 373 your \daps{} disk. The configuration file has the \fname{.cfg}
367 extension and is used to store all of the user settings that are described 374 extension and is used to store all of the user settings that are described
368 throughout this manual. 375 throughout this manual.
369 376
370 Hint: Use the \setting{Save .cfg file} feature (\setting{Main Menu 377 Hint: Use the \setting{Save .cfg File} feature (\setting{Main Menu
371 $\rightarrow$ General Settings}) to save the current settings, then 378 $\rightarrow$ General Settings}) to save the current settings, then
372 use a text editor to customize the settings file. See Appendix 379 use a text editor to customize the settings file. See Appendix
373 \reference{ref:config_file_options} for the full reference of available 380 \reference{ref:config_file_options} for the full reference of available
374 options. 381 options.
375 382
376\item [Save Sound Settings.]This option writes a \fname{.cfg} file to 383\item [Save Sound Settings]This option writes a \fname{.cfg} file to
377 your \daps\ disk. The configuration file has the \fname{.cfg} 384 your \daps\ disk. The configuration file has the \fname{.cfg}
378 extension and is used to store all of the sound related settings. 385 extension and is used to store all of the sound related settings.
379 386
380\item [Save Theme Settings.]This option writes a \fname{.cfg} file to 387\item [Save Theme Settings]This option writes a \fname{.cfg} file to
381 your \daps\ disk. The configuration file has the \fname{.cfg} 388 your \daps\ disk. The configuration file has the \fname{.cfg}
382 extension and is used to store all of the theme related settings. 389 extension and is used to store all of the theme related settings.
383 390
@@ -394,7 +401,7 @@ Example of a configuration file:
394 you intended. 401 you intended.
395} 402}
396 403
397\subsection{\label{ref:using_rolo}Using ROLO (Rockbox loader)} 404\subsection{\label{ref:using_rolo}Using ROLO (Rockbox Loader)}
398Rockbox is able to load and start another firmware file without rebooting. 405Rockbox is able to load and start another firmware file without rebooting.
399You just ``play'' a file with the extension % 406You just ``play'' a file with the extension %
400\opt{recorder,recorderv2fm,ondio}{\fname{.ajz}.} % 407\opt{recorder,recorderv2fm,ondio}{\fname{.ajz}.} %