summaryrefslogtreecommitdiffstats
path: root/manual/configure_rockbox/theme_settings.tex
blob: d87a2014882816b56fb10574175c42a9cbeee2cc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
% $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[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}