rockbox/manual/configure_rockbox/theme_settings.tex
Thomas Martitz 97548f34d7 Move the "Status/Scrollbar" menu to Theme Settings, and add the F_THEMESETTING flag to the settings it was missing.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@22486 a1c6a512-1295-4272-9138-f99709370657
2009-08-24 00:22:54 +00:00

159 lines
6.9 KiB
TeX

% $Id $ %
The \setting{Theme Settings} menu offers options that you can change to
customize the visual apperance of Rockbox.
\begin{description}
\item[Browse Theme Files.]
This option will display all the currently installed themes on the \dap{},
press \ActionTreeEnter{} to load the chosen theme and apply it.
A theme is a configuration file, stored in a specific directory,
that typically changes the WPS
\opt{HAVE_REMOTE_LCD}{and remote WPS}, font used and on some platforms
additional information such as background image and text colours.
There are a number of themes that ship with Rockbox. If none of
these suit your needs, many more can be downloaded from
\opt{player}{\url{http://themes.rockbox.org/index.php?target=player}}%
\opt{recorder}{\url{http://themes.rockbox.org/index.php?target=fmrecorder}}%
\opt{recorderv2fm}{\url{http://themes.rockbox.org/index.php?target=fmrecorder}}%
\opt{ondiofm}{\url{http://themes.rockbox.org/index.php?target=ondiofm}}%
\opt{ondiosp}{\url{http://themes.rockbox.org/index.php?target=ondiosp}}%
\opt{m5}{\url{http://themes.rockbox.org/index.php?target=m5}}%
\opt{x5}{\url{http://themes.rockbox.org/index.php?target=x5}}%
\opt{m3}{\url{http://themes.rockbox.org/index.php?target=m3}}%
\opt{h100}{\url{http://themes.rockbox.org/index.php?target=h100}}%
\opt{h300}{\url{http://themes.rockbox.org/index.php?target=h300}}%
\opt{h10_5gb}{\url{http://themes.rockbox.org/index.php?target=h10_5gb}}%
\opt{h10}{\url{http://themes.rockbox.org/index.php?target=h10}}%
\opt{ipod1g2g}{\url{http://themes.rockbox.org/index.php?target=ipod1g2g}}%
\opt{ipod3g}{\url{http://themes.rockbox.org/index.php?target=ipod3g}}%
\opt{ipod4g}{\url{http://themes.rockbox.org/index.php?target=ipod4g}}%
\opt{ipodcolor}{\url{http://themes.rockbox.org/index.php?target=ipodcolor}}%
\opt{ipodvideo}{\url{http://themes.rockbox.org/index.php?target=ipodvideo}}%
\opt{ipodmini}{\url{http://themes.rockbox.org/index.php?target=ipodmini}}%
\opt{ipodnano}{\url{http://themes.rockbox.org/index.php?target=ipodnano}}%
\opt{e200}{\url{http://themes.rockbox.org/index.php?target=e200}}%
\opt{c200}{\url{http://themes.rockbox.org/index.php?target=c200}}%
\opt{gigabeatf}{\url{http://themes.rockbox.org/index.php?target=gigabeatf}}%
\opt{gigabeats}{\url{http://themes.rockbox.org/index.php?target=gigabeats}}%
\opt{mrobe100}{\url{http://themes.rockbox.org/index.php?target=mrobe100}}%
.
\note{Themes do not have to be purely visual. It is quite possible to create
a theme that switches between audio configurations for use in the car, with
headphones and when connected to an external amplifier. See
\reference{ref:CreateYourOwnWPS} for more details.}
\opt{lcd_bitmap}{
\item[Font.]
Browse the installed fonts on your \dap{}. Selecting one will activate it.
See \reference{ref:Loadingfonts} for further details about fonts.
} % \nopt{player}
\item[While Playing Screen.]
Opens the \setting{File Browser} in the \fname{/.rockbox/wps} directory and
displays all \fname{.wps} files. Selecting one will activate it, stop will
exit back to the menu. For further information about the WPS see
\reference{ref:WPS}. For information about editing a .wps file see
\reference{ref:ConfiguringtheWPS}.
\opt{HAVE_REMOTE_LCD}{
\item[Remote While Playing Screen.]
Opens the \setting{File Browser} in the \fname{/.rockbox/wps} directory and
displays all \fname{.rwps} files. Selecting one will activate it, stop will
exit back to the menu.
\note{
A \fname{.rwps} file is a special \fname{.wps} file for the remote
display.
}
}
\item[Show Icons.]
Rockbox has the ability to display an icon to the left of the file
in the \setting{File Browser}. For details of these icons, see
\reference{ref:Supportedfileformats}.
\opt{lcd_bitmap}{
These icons can also be customised. See the \wikilink{IconSets}
and \wikilink{CustomIcons} Wiki pages for details.
}
\opt{lcd_non-mono}{%
\item[Clear Backdrop:]
Rockbox allows you to select bitmap pictures to use as backdrops,
see \reference{ref:LoadingBackdrops} for further information.
This option allows you to clear the backdrops that you set.
}
%
\opt{lcd_bitmap}{
\item[Status/Scrollbar:]
Settings related to on screen status display and the scrollbar.
\begin{description}
\item[Scroll Bar:] Allows you to choose where the vertical scroll bar
should appear.
\item[Scroll Bar Width:] Allows you to choose the width of the
scroll bar (in pixels). Default value is 6.
\item[Status Bar:] Allows you to choose where to display the
statusbar\opt{remote}{ on the main display}.
\opt{remote}{
\item[Remote Status Bar:] Allows you to choose where to display the
statusbar on the remote display.
}
\opt{RECORDER_PAD}{
\item[Button Bar:] Enables or disables the button bar prompts for the
``F''-keys at the bottom of the screen.
}
\item[Volume Display:] Controls whether the volume is displayed as a
graphic or a numeric value on the Status Bar. If you select a numeric
display, volume is displayed in decibels. See \reference{ref:volume}
for more on the volume setting.
\item[Battery Display:] Controls whether the battery charge status is
displayed as a graphic or numerical percentage value on the Status Bar.
\end{description}
}
%
\opt{lcd_bitmap}{
\item[Line Selector Type.]
This option allows you to select which type of line selector to use.
\begin{description}
\item[Pointer:]
A small arrow to the left of the menu text.
\item[Bar (inverse):]
A bar with inverted foreground and background colour.
\opt{lcd_color}{
\item[Bar (Solid Colour):]
A bar with a solid colour, the colour is set in the \setting{Colours}
submenu.
\item[Bar (Gradient Colour):]
A bar with a colour gradient, the colours are set in the \setting{Colours}
submenu.
}
\end{description}
}
\opt{lcd_color}{
\item[Colours.]
The options in this menu sets the colours for visual elements in Rockbox.
\begin{description}
\item[Line Selector Colours.]
These options sets the colours for the line selector bars.
\begin{description}
\item[Primary Colour:]
Set the primary colour used for the gradient line selector bar and the
colour used for the solid color line selector bar.
\item[Secondary Colour:]
Set the secondary colour used for the gradient line selector bar.
\item[Text Colour:]
Set the colour of the selected text when using the solid colour or the
gradient colour line selection bars.
\end{description}
\item[Background Colour:]
Sets the background colour for the display.
\item[Foreground Colour:]
Sets the colour used for text and icons.
\item[Reset Colours:]
Resets the LCD display to Rockbox's default colours.
\end{description}
}% lcd_color
\end{description}