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 apperance of Rockbox.
   4
   5 \begin{description}
   6 \item[Browse Themes.]
   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{RECORDER_PAD}{\wikilink{WpsArchos}}%
  18   \opt{h1xx}{\wikilink{WpsIriverH100}}%
  19   \opt{h300,ipodcolor}{\wikilink{WpsIriverH300}}%
  20   \opt{ipodvideo}{\wikilink{WpsIpod5g}}%
  21   \opt{ipodnano}{\wikilink{WpsIpodNano}}%
  22   \opt{ipodmini}{\wikilink{WpsIpodMini}}%
  23   \opt{x5}{\wikilink{WpsIaudioX5}}%
  24   .
  25   Some of the downloads from this website will actually be standalone WPS files,
  26   others will be full-blown themes.
  27
  28   \note{Themes do not have to be purely visual. It is quite possible to create
  29     a theme that switches between audio configurations for use in the car, with
  30     headphones and when connected to an external amplifier. See
  31     \reference{ref:CreateYourOwnWPS} for more details.}
  32
  33 \nopt{player}{
  34   \item[Browse fonts.]
  35     Browse the installed fonts on your \dap{}. Selecting one will activate it.
  36     See \reference{ref:Loadingfonts} for further details about fonts.
  37 } % \nopt{player}
  38
  39 \item[Browse WPS files.]
  40   Opens the \setting{File Browser} in the \fname{/.rockbox/wps} directory and
  41   displays all \fname{.wps} files. Selecting one will activate it, stop will
  42   exit back to the menu. For further information about the WPS see
  43   \reference{ref:WPS}. For information about editing a .wps file see
  44   \reference{ref:ConfiguringtheWPS}.
  45
  46 \opt{HAVE_REMOTE_LCD}{
  47   \item[Browse RWPS files.]
  48     Opens the \setting{File Browser} in the \fname{/.rockbox/wps} directory and
  49     displays all \fname{.rwps} files. Selecting one will activate it, stop will
  50     exit back to the menu.
  51     \note{
  52       A \fname{.rwps} file is a special \fname{.wps} file for the remote
  53       display.
  54     }
  55 }
  56
  57 \item[Show Icons.]
  58   Rockbox has the ability to display an icon to the left of the file
  59   in the \setting{File Browser}. For details of these icons, see
  60   \reference{ref:Supportedfileformats}.
  61
  62 \nopt{archos}{%
  63   \item[Clear Backdrop:]
  64     Rockbox allows you to select bitmap pictures to use as backdrops,
  65     see \reference{ref:LoadingBackdrops} for further information.
  66     This option allows you to clear the backdrops that you set.
  67 }%
  68
  69 \opt{lcd_bitmap}{
  70 \item[Line Selector Type.]
  71   This option allows you to select which type of line selector to use.
  72   \begin{description}
  73     \item[Pointer:]
  74       A small arrow to the left of the menu text.
  75     \item[Bar (inverse):]
  76       A bar with inverted foreground and background colour.
  77 \opt{lcd_color}{
  78     \item[Bar (Solid Colour):]
  79       A bar with a solid colour, the colour is set in the \setting{Colours}
  80       submenu.
  81     \item[Bar (Gradient Colour):]
  82       A bar with a colour gradient, the colours are set in the \setting{Colours}
  83       submenu.
  84 }
  85   \end{description}
  86 }
  87
  88 \opt{lcd_color}{
  89   \item[Colours.]
  90     The options in this menu sets the colours for visual elements in Rockbox.
  91     \begin{description}
  92     \item[Line Selector Colours.]
  93       These options sets the colours for the line selector bars.
  94       \begin{description}
  95         \item[Primary Colour:]
  96           Set the primary colour used for the gradient line selector bar and the
  97           colour used for the solid color line selector bar.
  98         \item[Secondary Colour:]
  99           Set the secondary colour used for the gradient line selector bar.
 100         \item[Text Colour:]
 101           Set the colour of the selected text when using the solid colour or the
 102           gradient colour line selection bars.
 103       \end{description}
 104
 105     \item[Background Colour:]
 106       Sets the background colour for the display.
 107     \item[Foreground Colour:]
 108       Sets the colour used for text and icons.
 109     \item[Reset Colours:]
 110       Resets the LCD display to Rockbox's default colours.
 111     \end{description}
 112 }% lcd_color
 113 \end{description}