Use nice quotation marks
[kugel-rb.git] / manual / configure_rockbox / theme_settings.tex
blob35cf7168286b90e8fd41cc7485acf96bb3cd375b
1 % $Id $ %
2 The \setting{Theme Settings} menu offers options that you can change to
3 customize the visual apperance of Rockbox.
5 \begin{description}
6 \item[Browse Theme Files.]
7 This option will display all the currently installed themes on the \dap{},
8 press \ActionTreeEnter{} to load the chosen theme and apply it.
10 A theme is a configuration file, stored in a specific directory,
11 that typically changes the WPS
12 \opt{HAVE_REMOTE_LCD}{and remote WPS}, font used and on some platforms
13 additional information such as background image and text colours.
15 There are a number of themes that ship with Rockbox. If none of
16 these suit your needs, many more can be downloaded from
17 \opt{player}{\url{http://themes.rockbox.org/index.php?target=player}}%
18 \opt{recorder}{\url{http://themes.rockbox.org/index.php?target=fmrecorder}}%
19 \opt{recorderv2fm}{\url{http://themes.rockbox.org/index.php?target=fmrecorder}}%
20 \opt{ondiofm}{\url{http://themes.rockbox.org/index.php?target=ondiofm}}%
21 \opt{ondiosp}{\url{http://themes.rockbox.org/index.php?target=ondiosp}}%
22 \opt{m5}{\url{http://themes.rockbox.org/index.php?target=m5}}%
23 \opt{x5}{\url{http://themes.rockbox.org/index.php?target=x5}}%
24 \opt{m3}{\url{http://themes.rockbox.org/index.php?target=m3}}%
25 \opt{h100}{\url{http://themes.rockbox.org/index.php?target=h100}}%
26 \opt{h300}{\url{http://themes.rockbox.org/index.php?target=h300}}%
27 \opt{h10_5gb}{\url{http://themes.rockbox.org/index.php?target=h10_5gb}}%
28 \opt{h10}{\url{http://themes.rockbox.org/index.php?target=h10}}%
29 \opt{ipod1g2g}{\url{http://themes.rockbox.org/index.php?target=ipod1g2g}}%
30 \opt{ipod3g}{\url{http://themes.rockbox.org/index.php?target=ipod3g}}%
31 \opt{ipod4g}{\url{http://themes.rockbox.org/index.php?target=ipod4g}}%
32 \opt{ipodcolor}{\url{http://themes.rockbox.org/index.php?target=ipodcolor}}%
33 \opt{ipodvideo}{\url{http://themes.rockbox.org/index.php?target=ipodvideo}}%
34 \opt{ipodmini}{\url{http://themes.rockbox.org/index.php?target=ipodmini}}%
35 \opt{ipodnano}{\url{http://themes.rockbox.org/index.php?target=ipodnano}}%
36 \opt{ipodnano2g}{\url{http://themes.rockbox.org/index.php?target=ipodnano2g}}%
37 \opt{e200}{\url{http://themes.rockbox.org/index.php?target=e200}}%
38 \opt{e200v2}{\url{http://themes.rockbox.org/index.php?target=e200v2}}%
39 \opt{c200}{\url{http://themes.rockbox.org/index.php?target=c200}}%
40 \opt{gigabeatf}{\url{http://themes.rockbox.org/index.php?target=gigabeatf}}%
41 \opt{gigabeats}{\url{http://themes.rockbox.org/index.php?target=gigabeats}}%
42 \opt{mrobe100}{\url{http://themes.rockbox.org/index.php?target=mrobe100}}%
43 \opt{vibe500}{\url{http://themes.rockbox.org/index.php?target=vibe500}}%
46 \note{Themes do not have to be purely visual. It is quite possible to create
47 a theme that switches between audio configurations for use in the car, with
48 headphones and when connected to an external amplifier. See
49 \reference{ref:CreateYourOwnWPS} for more details.}
51 \opt{lcd_bitmap}{
52 \item[Font.]
53 Browse the installed fonts on your \dap{}. Selecting one will activate it.
54 See \reference{ref:Loadingfonts} for further details about fonts.
55 } % \nopt{player}
57 \item[While Playing Screen.]
58 Opens the \setting{File Browser} in the \fname{/.rockbox/wps} directory and
59 displays all \fname{.wps} files. Selecting one will activate it,
60 \ActionStdCancel{} will exit back to the menu. For further information
61 about the WPS see \reference{ref:WPS}. For information about editing
62 a .wps file see \reference{ref:ConfiguringtheWPS}.
64 \opt{HAVE_REMOTE_LCD}{
65 \item[Remote While Playing Screen.]
66 Opens the \setting{File Browser} in the \fname{/.rockbox/wps} directory and
67 displays all \fname{.rwps} files. Selecting one will activate it, stop will
68 exit back to the menu.
69 \note{
70 A \fname{.rwps} file is a special \fname{.wps} file for the remote
71 display.
75 \item[Show Icons.]
76 Rockbox has the ability to display an icon to the left of the file
77 in the \setting{File Browser}. For details of these icons, see
78 \reference{ref:Supportedfileformats}.
79 \opt{lcd_bitmap}{
80 These icons can also be customised. See the \wikilink{IconSets}
81 and \wikilink{CustomIcons} Wiki pages for details.
84 \opt{lcd_non-mono}{%
85 \item[Clear Backdrop.]
86 Rockbox allows you to select bitmap pictures to use as backdrops,
87 see \reference{ref:LoadingBackdrops} for further information.
88 This option allows you to clear the backdrops that you set.
91 \opt{lcd_bitmap}{
92 \item[Status/Scrollbar.]
93 Settings related to on screen status display and the scrollbar.
94 \begin{description}
95 \item[Scroll Bar.] Allows you to choose where the vertical scroll bar
96 should appear.
97 \item[Scroll Bar Width.] Allows you to choose the width of the
98 scroll bar (in pixels). Default value is 6.
99 \item[Status Bar.] Allows you to choose where to display the
100 statusbar\opt{remote}{ on the main display}.
101 \opt{remote}{
102 \item[Remote Status Bar.] Allows you to choose where to display the
103 statusbar on the remote display.
105 \opt{RECORDER_PAD}{
106 \item[Button Bar.] Enables or disables the button bar prompts for the
107 ``F''-keys at the bottom of the screen.
109 \item[Volume Display.] Controls whether the volume is displayed as a
110 graphic or a numeric value on the Status Bar. If you select a numeric
111 display, volume is displayed in decibels. See \reference{ref:volume}
112 for more on the volume setting.
113 \item[Battery Display.] Controls whether the battery charge status is
114 displayed as a graphic or numerical percentage value on the Status Bar.
115 \end{description}
118 \opt{lcd_bitmap}{
119 \item[Line Selector Type.]
120 This option allows you to select which type of line selector to use.
121 \begin{description}
122 \item[Pointer.]
123 A small arrow to the left of the menu text.
124 \item[Bar (inverse).]
125 A bar with inverted foreground and background colour.
126 \opt{lcd_color}{
127 \item[Bar (Solid Colour).]
128 A bar with a solid colour, the colour is set in the \setting{Colours}
129 submenu.
130 \item[Bar (Gradient Colour).]
131 A bar with a colour gradient, the colours are set in the \setting{Colours}
132 submenu.
134 \end{description}
137 \opt{lcd_color}{
138 \item[Colours.]
139 The options in this menu sets the colours for visual elements in Rockbox.
140 \begin{description}
141 \item[Line Selector Colours.]
142 These options sets the colours for the line selector bars.
143 \begin{description}
144 \item[Primary Colour.]
145 Set the primary colour used for the gradient line selector bar and the
146 colour used for the solid color line selector bar.
147 \item[Secondary Colour.]
148 Set the secondary colour used for the gradient line selector bar.
149 \item[Text Colour.]
150 Set the colour of the selected text when using the solid colour or the
151 gradient colour line selection bars.
152 \end{description}
154 \item[Background Colour.]
155 Sets the background colour for the display.
156 \item[Foreground Colour.]
157 Sets the colour used for text and icons.
158 \item[Reset Colours.]
159 Resets the LCD display to Rockbox's default colours.
160 \end{description}
161 }% lcd_color
162 \end{description}