diff options
author | Marc Guay <marcguay@rockbox.org> | 2008-06-24 05:16:23 +0000 |
---|---|---|
committer | Marc Guay <marcguay@rockbox.org> | 2008-06-24 05:16:23 +0000 |
commit | 85eec85a172b4580b653446b221a1704fc9212a1 (patch) | |
tree | 488bda3696fdd2bfd3ea694b979a3a4effe1d24b /manual/advanced_topics/main.tex | |
parent | e7a31c16dc818f835c7aef2cc0183e0f6075e81d (diff) | |
download | rockbox-85eec85a172b4580b653446b221a1704fc9212a1.tar.gz rockbox-85eec85a172b4580b653446b221a1704fc9212a1.zip |
Commit part of Eddy's changes to the Advanced Topics section of the manual.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@17775 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'manual/advanced_topics/main.tex')
-rw-r--r-- | manual/advanced_topics/main.tex | 33 |
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}{ |
7 | Rockbox supports custom fonts. A collection of fonts is available for download | 7 | Rockbox 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 | |||
142 | the list of alternatives is too short. | 146 | the list of alternatives is too short. |
143 | \end{description} | 147 | \end{description} |
144 | 148 | ||
145 | \subsubsection{Next Song info} | 149 | \subsubsection{Next Song Info} |
146 | You can display information about the next song -- the song that is | 150 | You can display information about the next song -- the song that is |
147 | about to play after the one currently playing (unless you change the | 151 | about to play after the one currently playing (unless you change the |
148 | plan). | 152 | plan). |
@@ -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 | ||
162 | It is possible to group items on each line into 2 or more groups or | 166 | It 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.} |
274 | Rockbox allows users to store and load multiple settings through the use of | 278 | Rockbox allows users to store and load multiple settings through the use of |
275 | configuration files. A configuration file is simply a text file with the | 279 | configuration files. A configuration file is simply a text file with the |
276 | extension \fname{.cfg}. | 280 | extension \fname{.cfg}. |
@@ -286,7 +290,7 @@ for configuration files. See \reference{ref:manage_settings_menu} for an | |||
286 | explanation of how to create, edit and load configuration files. | 290 | explanation 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 | ||
291 | The Rockbox configuration file is a plain text file, so once you use the | 295 | The 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). | ||
337 | Format 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)} |
398 | Rockbox is able to load and start another firmware file without rebooting. | 405 | Rockbox is able to load and start another firmware file without rebooting. |
399 | You just ``play'' a file with the extension % | 406 | You just ``play'' a file with the extension % |
400 | \opt{recorder,recorderv2fm,ondio}{\fname{.ajz}.} % | 407 | \opt{recorder,recorderv2fm,ondio}{\fname{.ajz}.} % |