summaryrefslogtreecommitdiff
path: root/manual/advanced_topics/main.tex
diff options
context:
space:
mode:
Diffstat (limited to 'manual/advanced_topics/main.tex')
-rwxr-xr-xmanual/advanced_topics/main.tex85
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.
42Simply choose the option in the setting menu and choose the plugin 42Simply choose the option in the setting menu and choose the plugin
43you would like to run. 43you 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
48Rockbox supports custom fonts. A collection of fonts is available for download 47Rockbox supports custom fonts. A collection of fonts is available for download
49in the font package at \url{http://www.rockbox.org/daily.shtml}.} 48in 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} 51Rockbox 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 53be 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 55long. 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} 57in 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
286this section. All elements placed before the 281this section. All elements placed before the
287line defining a viewport are displayed in the default viewport. Elements 282line defining a viewport are displayed in the default viewport. Elements
288defined after a viewport declaration are drawn within that viewport. 283defined after a viewport declaration are drawn within that viewport.
289\opt{lcd_bitmap}{Loading images (see Appendix \reference{ref:wps_images}) 284Loading images (see Appendix \reference{ref:wps_images})
290 should be done within the default viewport.} 285should be done within the default viewport.
291A viewport ends either with the end of the file, or with the next viewport 286A viewport ends either with the end of the file, or with the next viewport
292declaration line. Viewports sharing the same 287declaration line. Viewports sharing the same
293coordinates and dimensions cannot be displayed at the same time. Viewports 288coordinates 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
526displayed if available. Could also be rendered as ``filename'' or ``tracknum -- 521displayed if available. Could also be rendered as ``filename'' or ``tracknum --
527title [artist]''. 522title [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}