diff options
Diffstat (limited to 'manual/advanced_topics')
-rwxr-xr-x | manual/advanced_topics/main.tex | 85 |
1 files changed, 34 insertions, 51 deletions
diff --git a/manual/advanced_topics/main.tex b/manual/advanced_topics/main.tex index 66793a8d24..f669dd5211 100755 --- a/manual/advanced_topics/main.tex +++ b/manual/advanced_topics/main.tex | |||
@@ -42,29 +42,26 @@ Rockbox allows you to choose a plugin to run for select menu options. | |||
42 | Simply choose the option in the setting menu and choose the plugin | 42 | Simply choose the option in the setting menu and choose the plugin |
43 | you would like to run. | 43 | you would like to run. |
44 | 44 | ||
45 | \opt{lcd_bitmap}{ | ||
46 | \subsection{\label{ref:GettingExtras}Getting Extras} | 45 | \subsection{\label{ref:GettingExtras}Getting Extras} |
47 | 46 | ||
48 | Rockbox supports custom fonts. A collection of fonts is available for download | 47 | Rockbox supports custom fonts. A collection of fonts is available for download |
49 | in the font package at \url{http://www.rockbox.org/daily.shtml}.} | 48 | in the font package at \url{http://www.rockbox.org/daily.shtml}. |
50 | 49 | ||
51 | \opt{lcd_bitmap}{ | 50 | \subsection{\label{ref:Loadingfonts}Loading Fonts}\index{Fonts} |
52 | \subsection{\label{ref:Loadingfonts}Loading Fonts}\index{Fonts} | 51 | Rockbox can load fonts dynamically. Simply copy the \fname{.fnt} file to the |
53 | Rockbox can load fonts dynamically. Simply copy the \fname{.fnt} file to the | 52 | \dap{} and ``play'' it in the \setting{File Browser}. If you want a font to |
54 | \dap{} and ``play'' it in the \setting{File Browser}. If you want a font to | 53 | be loaded automatically every time you start up, it must be located in the |
55 | be loaded automatically every time you start up, it must be located in the | 54 | \fname{/.rockbox/fonts} directory and the filename must be at most 24 characters |
56 | \fname{/.rockbox/fonts} directory and the filename must be at most 24 characters | 55 | long. You can browse the fonts in \fname{/.rockbox/fonts} under |
57 | long. You can browse the fonts in \fname{/.rockbox/fonts} under | 56 | \setting{Settings $\rightarrow$ Theme Settings $\rightarrow$ Font} |
58 | \setting{Settings $\rightarrow$ Theme Settings $\rightarrow$ Font} | 57 | in the \setting{Main Menu}.\\ |
59 | in the \setting{Main Menu}.\\ | 58 | |
60 | 59 | \note{Advanced Users Only: Any BDF font should | |
61 | \note{Advanced Users Only: Any BDF font should | 60 | be usable with Rockbox. To convert from \fname{.bdf} to \fname{.fnt}, use |
62 | be usable with Rockbox. To convert from \fname{.bdf} to \fname{.fnt}, use | 61 | the \fname{convbdf} tool. This tool can be found in the \fname{tools} |
63 | the \fname{convbdf} tool. This tool can be found in the \fname{tools} | 62 | directory of the Rockbox source code. See \wikilink{CreateFonts\#ConvBdf} |
64 | directory of the Rockbox source code. See \wikilink{CreateFonts\#ConvBdf} | 63 | for more details. Or just run \fname{convbdf} without any parameters to |
65 | for more details. Or just run \fname{convbdf} without any parameters to | 64 | see the possible options.} |
66 | see the possible options.} | ||
67 | } | ||
68 | 65 | ||
69 | \subsection{\label{ref:Loadinglanguages}Loading Languages} | 66 | \subsection{\label{ref:Loadinglanguages}Loading Languages} |
70 | \index{Language files}% | 67 | \index{Language files}% |
@@ -109,15 +106,13 @@ file find the instructions on the Rockbox website: | |||
109 | \\ | 106 | \\ |
110 | \config{folder, m3u, m3u8, cfg, wps, lng, rock, bmark, cue, colours, mpa, | 107 | \config{folder, m3u, m3u8, cfg, wps, lng, rock, bmark, cue, colours, mpa, |
111 | \firmwareextension{}, % | 108 | \firmwareextension{}, % |
112 | \opt{swcodec}{mp1, }mp2, mp3% | 109 | mp1, mp2, mp3, ogg, oga, wma, wmv, asf, wav, flac, ac3, a52, mpc, wv, |
113 | \opt{swcodec}{, ogg, oga, wma, wmv, asf, wav, flac, ac3, a52, mpc, | 110 | m4a, m4b, mp4, mod, shn, aif, aiff, spx, sid, adx, nsf, nsfe, spc, ape, |
114 | wv, m4a, m4b, mp4, mod, shn, aif, aiff, spx, sid, adx, nsf, nsfe, | 111 | mac, sap, mpg, mpeg% |
115 | spc, ape, mac, sap}% | ||
116 | \opt{lcd_bitmap}{\opt{swcodec}{, mpg, mpeg}}% | ||
117 | \opt{HAVE_REMOTE_LCD}{, rwps}% | 112 | \opt{HAVE_REMOTE_LCD}{, rwps}% |
118 | \opt{lcd_non-mono}{, bmp}% | 113 | \opt{lcd_non-mono}{, bmp}% |
119 | \opt{radio}{, fmr}% | 114 | \opt{radio}{, fmr}% |
120 | \opt{lcd_bitmap}{, fnt, kbd}}\\* | 115 | , fnt, kbd}\\* |
121 | %It'd be ideal to get these from filetypes.c | 116 | %It'd be ideal to get these from filetypes.c |
122 | 117 | ||
123 | All file extensions that are not either specifically listed in the | 118 | All file extensions that are not either specifically listed in the |
@@ -286,8 +281,8 @@ present in the theme file. The full syntax will be explained later in | |||
286 | this section. All elements placed before the | 281 | this section. All elements placed before the |
287 | line defining a viewport are displayed in the default viewport. Elements | 282 | line defining a viewport are displayed in the default viewport. Elements |
288 | defined after a viewport declaration are drawn within that viewport. | 283 | defined after a viewport declaration are drawn within that viewport. |
289 | \opt{lcd_bitmap}{Loading images (see Appendix \reference{ref:wps_images}) | 284 | Loading images (see Appendix \reference{ref:wps_images}) |
290 | should be done within the default viewport.} | 285 | should be done within the default viewport. |
291 | A viewport ends either with the end of the file, or with the next viewport | 286 | A viewport ends either with the end of the file, or with the next viewport |
292 | declaration line. Viewports sharing the same | 287 | declaration line. Viewports sharing the same |
293 | coordinates and dimensions cannot be displayed at the same time. Viewports | 288 | coordinates and dimensions cannot be displayed at the same time. Viewports |
@@ -526,18 +521,17 @@ That is, ``tracknum -- title [artist, album]'', where most fields are only | |||
526 | displayed if available. Could also be rendered as ``filename'' or ``tracknum -- | 521 | displayed if available. Could also be rendered as ``filename'' or ``tracknum -- |
527 | title [artist]''. | 522 | title [artist]''. |
528 | 523 | ||
529 | %\opt{lcd_bitmap}{ | 524 | %\begin{verbatim} |
530 | % \begin{verbatim} | 525 | % %s%?it<%?in<%in. |>%it|%fn> |
531 | % %s%?it<%?in<%in. |>%it|%fn> | 526 | % %s%?ia<%ia|%?d2<%d(2)|(root)>> |
532 | % %s%?ia<%ia|%?d2<%d(2)|(root)>> | 527 | % %s%?id<%id|%?d1<%d(1)|(root)>> %?iy<(%iy)|> |
533 | % %s%?id<%id|%?d1<%d(1)|(root)>> %?iy<(%iy)|> | ||
534 | % | 528 | % |
535 | % %al%pc/%pt%ar[%pp:%pe] | 529 | % %al%pc/%pt%ar[%pp:%pe] |
536 | % %fbkBit %?fv<avg|> %?iv<(id3v%iv)|(no id3)> | 530 | % %fbkBit %?fv<avg|> %?iv<(id3v%iv)|(no id3)> |
537 | % %pb | 531 | % %pb |
538 | % %pm | 532 | % %pm |
539 | % % \end{verbatim} | 533 | % |
540 | %} | 534 | %\end{verbatim} |
541 | 535 | ||
542 | \section{\label{ref:manage_settings}Managing Rockbox Settings} | 536 | \section{\label{ref:manage_settings}Managing Rockbox Settings} |
543 | 537 | ||
@@ -713,11 +707,10 @@ current version. | |||
713 | available. | 707 | available. |
714 | 708 | ||
715 | 709 | ||
716 | \opt{swcodec}{ | ||
717 | Another area of savings is avoiding or reducing CPU boosting | 710 | Another area of savings is avoiding or reducing CPU boosting |
718 | through disabling computing intense features (e.g. sound processing) or | 711 | through disabling computing intense features (e.g. sound processing) or |
719 | using effective audio codecs. | 712 | using effective audio codecs. |
720 | } The following provides a short overview of the most relevant settings and | 713 | The following provides a short overview of the most relevant settings and |
721 | rules of thumb. | 714 | rules of thumb. |
722 | 715 | ||
723 | \subsection{Display backlight} | 716 | \subsection{Display backlight} |
@@ -765,16 +758,13 @@ current version. | |||
765 | that allows correct and continuous playback (see \reference{ref:AntiSkipBuf}). | 758 | that allows correct and continuous playback (see \reference{ref:AntiSkipBuf}). |
766 | } | 759 | } |
767 | 760 | ||
768 | \opt{swcodec}{ | ||
769 | \subsection{Replaygain} | 761 | \subsection{Replaygain} |
770 | Replaygain is a post processing that equalises the playback volume of audio | 762 | Replaygain is a post processing that equalises the playback volume of audio |
771 | files to the same perceived loudness. This post processing applies a factor | 763 | files to the same perceived loudness. This post processing applies a factor |
772 | to each single PCM sample and is therefore consuming additional CPU time. If | 764 | to each single PCM sample and is therefore consuming additional CPU time. If |
773 | you want to achieve some (minor) savings in runtime, switch this feature off | 765 | you want to achieve some (minor) savings in runtime, switch this feature off |
774 | (see \reference{ref:ReplayGain}). | 766 | (see \reference{ref:ReplayGain}). |
775 | } | ||
776 | 767 | ||
777 | \opt{lcd_bitmap}{ | ||
778 | \subsection{Peak Meter} | 768 | \subsection{Peak Meter} |
779 | The peak meter is a feature of the While Playing Screen and will be updated with a | 769 | The peak meter is a feature of the While Playing Screen and will be updated with a |
780 | high framerate. Depending on your \dap{} this might result in a high CPU load. To | 770 | high framerate. Depending on your \dap{} this might result in a high CPU load. To |
@@ -782,15 +772,11 @@ current version. | |||
782 | \opt{ipodvideo}{ | 772 | \opt{ipodvideo}{ |
783 | \note{Especially the \playerman{} \playertype{} suffers from an enabled peak meter.} | 773 | \note{Especially the \playerman{} \playertype{} suffers from an enabled peak meter.} |
784 | } | 774 | } |
785 | } | ||
786 | 775 | ||
787 | \opt{swcodec,disk_storage,flash_storage}{ | ||
788 | \subsection{Audio format and bitrate} | 776 | \subsection{Audio format and bitrate} |
789 | \opt{swcodec}{ | ||
790 | In general the fastest decoding audio format will be the best in terms of | 777 | In general the fastest decoding audio format will be the best in terms of |
791 | battery runtime on your \dap{}. An overview of different codec's performance | 778 | battery runtime on your \dap{}. An overview of different codec's performance |
792 | on different \dap{}s can be found at \wikilink{CodecPerformanceComparison}. | 779 | on different \dap{}s can be found at \wikilink{CodecPerformanceComparison}. |
793 | } | ||
794 | 780 | ||
795 | \opt{flash_storage}{ | 781 | \opt{flash_storage}{ |
796 | Your target uses flash that consumes a certain amount of power during access. | 782 | Your target uses flash that consumes a certain amount of power during access. |
@@ -813,11 +799,8 @@ current version. | |||
813 | another based upon the above mentioned. This will reduce the audio quality. | 799 | another based upon the above mentioned. This will reduce the audio quality. |
814 | If you have the choice, select the best suiting codec when encoding the | 800 | If you have the choice, select the best suiting codec when encoding the |
815 | original source material. | 801 | original source material. |
816 | } | ||
817 | 802 | ||
818 | \opt{swcodec}{ | ||
819 | \subsection{Sound settings} | 803 | \subsection{Sound settings} |
820 | In general all kinds of sound processing will need more CPU time and therefore | 804 | In general all kinds of sound processing will need more CPU time and therefore |
821 | consume more power. The less sound processing you use, the better it is for | 805 | consume more power. The less sound processing you use, the better it is for |
822 | the battery runtime (for options see \reference{ref:configure_rockbox_sound}). | 806 | the battery runtime (for options see \reference{ref:configure_rockbox_sound}). |
823 | } | ||