manual/configure_rockbox/theme_settings.tex

   1 % $Id $ %
   2 The \setting{Theme Settings} menu offers options that you can change to
   3 customize the visual appearance of Rockbox.
   4
   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.
   9
  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.
  14
  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{iaudiom5}{\url{http://themes.rockbox.org/index.php?target=m5}}%
  23   \opt{iaudiox5}{\url{http://themes.rockbox.org/index.php?target=x5}}%
  24   \opt{iaudiom3}{\url{http://themes.rockbox.org/index.php?target=m3}}%
  25   \opt{iriverh100}{\url{http://themes.rockbox.org/index.php?target=h100}}%
  26   \opt{iriverh300}{\url{http://themes.rockbox.org/index.php?target=h300}}%
  27   \opt{iriverh10_5gb}{\url{http://themes.rockbox.org/index.php?target=h10_5gb}}%
  28   \opt{iriverh10}{\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}}%
  44   \opt{fuzeplus}{\url{http://themes.rockbox.org/index.php?target=sansafuzeplus}}%
  45   .
  46
  47   \note{Themes do not have to be purely visual. It is quite possible to create
  48     a theme that switches between audio configurations for use in the car, with
  49     headphones and when connected to an external amplifier. See
  50     \reference{ref:CreateYourOwnWPS} for more details.}
  51
  52 \opt{lcd_bitmap}{
  53   \item[Font.]
  54     Browse the installed fonts on your \dap{}. Selecting one will activate it.
  55     See \reference{ref:Loadingfonts} for further details about fonts.
  56 } % \nopt{player}
  57
  58 \item[While Playing Screen.]
  59   Opens the \setting{File Browser} in the \fname{/.rockbox/wps} directory and
  60   displays all \fname{.wps} files. Selecting one will activate it,
  61   \ActionStdCancel{} will exit back to the menu. For further information
  62   about the WPS see \reference{ref:WPS}. For information about editing
  63   a .wps file see \reference{ref:ConfiguringtheWPS}.
  64
  65 \opt{HAVE_REMOTE_LCD}{
  66   \item[Remote While Playing Screen.]
  67     Opens the \setting{File Browser} in the \fname{/.rockbox/wps} directory and
  68     displays all \fname{.rwps} files. Selecting one will activate it, stop will
  69     exit back to the menu.
  70     \note{
  71       A \fname{.rwps} file is a special \fname{.wps} file for the remote
  72       display.
  73     }
  74 }
  75
  76 \item[Show Icons.]
  77   Rockbox has the ability to display an icon to the left of the file
  78   in the \setting{File Browser}. For details of these icons, see
  79   \reference{ref:Supportedfileformats}.
  80   \opt{lcd_bitmap}{
  81     These icons can also be customised. See the \wikilink{IconSets}
  82     and \wikilink{CustomIcons} Wiki pages for details.
  83   }
  84
  85 \opt{lcd_non-mono}{%
  86   \item[Clear Backdrop.]
  87     Rockbox allows you to select bitmap pictures to use as backdrops,
  88     see \reference{ref:LoadingBackdrops} for further information.
  89     This option allows you to clear the backdrops that you set.
  90 }
  91 %
  92   \opt{lcd_bitmap}{
  93     \item[Status/Scrollbar.]
  94       Settings related to on screen status display and the scrollbar.
  95       \begin{description}
  96       \item[Scroll Bar.] Allows you to choose where the vertical scroll bar
  97         should appear.
  98       \item[Scroll Bar Width.] Allows you to choose the width of the
  99         scroll bar (in pixels).  Default value is 6.
 100       \item[Status Bar.] Allows you to choose where to display the
 101         statusbar\opt{remote}{ on the main display}.
 102       \opt{remote}{
 103         \item[Remote Status Bar.] Allows you to choose where to display the
 104         statusbar on the remote display.
 105       }
 106       \opt{RECORDER_PAD}{
 107        \item[Button Bar.] Enables or disables the button bar prompts for the
 108          ``F''-keys at the bottom of the screen.
 109       }
 110       \item[Volume Display.] Controls whether the volume is displayed as a
 111         graphic or a numeric value on the Status Bar. If you select a numeric
 112         display, volume is displayed in decibels.  See \reference{ref:volume}
 113         for more on the volume setting.
 114       \item[Battery Display.] Controls whether the battery charge status is
 115         displayed as a graphic or numerical percentage value on the Status Bar.
 116       \end{description}
 117     }
 118 %
 119 \opt{lcd_bitmap}{
 120 \item[Line Selector Type.]
 121   This option allows you to select which type of line selector to use.
 122   \begin{description}
 123     \item[Pointer.]
 124       A small arrow to the left of the menu text.
 125     \item[Bar (inverse).]
 126       A bar with inverted foreground and background colour.
 127 \opt{lcd_color}{
 128     \item[Bar (Solid Colour).]
 129       A bar with a solid colour, the colour is set in the \setting{Colours}
 130       submenu.
 131     \item[Bar (Gradient Colour).]
 132       A bar with a colour gradient, the colours are set in the \setting{Colours}
 133       submenu.
 134 }
 135   \end{description}
 136 }
 137
 138 \opt{lcd_color}{
 139   \item[Colours.]
 140     The options in this menu sets the colours for visual elements in Rockbox.
 141     \begin{description}
 142     \item[Line Selector Colours.]
 143       These options sets the colours for the line selector bars.
 144       \begin{description}
 145         \item[Primary Colour.]
 146           Set the primary colour used for the gradient line selector bar and the
 147           colour used for the solid color line selector bar.
 148         \item[Secondary Colour.]
 149           Set the secondary colour used for the gradient line selector bar.
 150         \item[Text Colour.]
 151           Set the colour of the selected text when using the solid colour or the
 152           gradient colour line selection bars.
 153       \end{description}
 154
 155     \item[Background Colour.]
 156       Sets the background colour for the display.
 157     \item[Foreground Colour.]
 158       Sets the colour used for text and icons.
 159     \item[Reset Colours.]
 160       Resets the LCD display to Rockbox's default colours.
 161     \end{description}
 162 }% lcd_color
 163 \end{description}