summaryrefslogtreecommitdiff
path: root/manual/advanced_topics/main.tex
diff options
context:
space:
mode:
Diffstat (limited to 'manual/advanced_topics/main.tex')
-rwxr-xr-xmanual/advanced_topics/main.tex54
1 files changed, 25 insertions, 29 deletions
diff --git a/manual/advanced_topics/main.tex b/manual/advanced_topics/main.tex
index 786c109772..00b1688e11 100755
--- a/manual/advanced_topics/main.tex
+++ b/manual/advanced_topics/main.tex
@@ -168,32 +168,30 @@ file find the instructions on the Rockbox website:
168 the \fname{/.rockbox/backdrops} directory. 168 the \fname{/.rockbox/backdrops} directory.
169}% 169}%
170 170
171\nopt{lcd_charcell}{ 171\subsection{UI Viewport}
172 \subsection{UI Viewport} 172By default, the UI is drawn on the whole screen. This can be changed so that
173 By default, the UI is drawn on the whole screen. This can be changed so that 173the UI is confined to a specific area of the screen, by use of a UI
174 the UI is confined to a specific area of the screen, by use of a UI 174viewport. This is done by adding the following line to the
175 viewport. This is done by adding the following line to the 175\fname{.cfg} file for a theme:\\*
176 \fname{.cfg} file for a theme:\\* 176
177 177\nopt{lcd_non-mono}{\config{ui viewport: X,Y,[width],[height],[font]}}
178 \nopt{lcd_non-mono}{\config{ui viewport: X,Y,[width],[height],[font]}} 178\nopt{lcd_color}{\opt{lcd_non-mono}{
179 \config{ui viewport: X,Y,[width],[height],[font],[fgshade],[bgshade]}}}
180\opt{lcd_color}{
181 \config{ui viewport: X,Y,[width],[height],[font],[fgcolour],[bgcolour]}}
182\\*
183
184\opt{HAVE_REMOTE_LCD}{
185 The dimensions of the menu that is displayed on the remote control of your
186 \dap\ can be set in the same way. The line to be added to the theme
187 \fname{.cfg} is the following:\\*
188
189 \nopt{lcd_non-mono}{\config{remote ui viewport: X,Y,[width],[height],[font]}}
179 \nopt{lcd_color}{\opt{lcd_non-mono}{ 190 \nopt{lcd_color}{\opt{lcd_non-mono}{
180 \config{ui viewport: X,Y,[width],[height],[font],[fgshade],[bgshade]}}} 191 \config{remote ui viewport: X,Y,[width],[height],[font],[fgshade],[bgshade]}}}
181 \opt{lcd_color}{ 192 \opt{lcd_color}{
182 \config{ui viewport: X,Y,[width],[height],[font],[fgcolour],[bgcolour]}} 193 \config{remote ui viewport: X,Y,[width],[height],[font],[fgcolour],[bgcolour]}}
183 \\* 194\\*
184
185 \opt{HAVE_REMOTE_LCD}{
186 The dimensions of the menu that is displayed on the remote control of your
187 \dap\ can be set in the same way. The line to be added to the theme
188 \fname{.cfg} is the following:\\*
189
190 \nopt{lcd_non-mono}{\config{remote ui viewport: X,Y,[width],[height],[font]}}
191 \nopt{lcd_color}{\opt{lcd_non-mono}{
192 \config{remote ui viewport: X,Y,[width],[height],[font],[fgshade],[bgshade]}}}
193 \opt{lcd_color}{
194 \config{remote ui viewport: X,Y,[width],[height],[font],[fgcolour],[bgcolour]}}
195 \\*
196 }
197 195
198 Only the first two parameters \emph{have} to be specified, the others can 196 Only the first two parameters \emph{have} to be specified, the others can
199 be omitted using `$-$' as a placeholder. The syntax is very similar to WPS 197 be omitted using `$-$' as a placeholder. The syntax is very similar to WPS
@@ -202,7 +200,6 @@ file find the instructions on the Rockbox website:
202 \nopt{lcd_non-mono}{\input{advanced_topics/viewports/mono-uivp-syntax.tex}} 200 \nopt{lcd_non-mono}{\input{advanced_topics/viewports/mono-uivp-syntax.tex}}
203 \nopt{lcd_color}{\opt{lcd_non-mono}{\input{advanced_topics/viewports/grayscale-uivp-syntax.tex}}} 201 \nopt{lcd_color}{\opt{lcd_non-mono}{\input{advanced_topics/viewports/grayscale-uivp-syntax.tex}}}
204 \opt{lcd_color}{\input{advanced_topics/viewports/colour-uivp-syntax.tex}} 202 \opt{lcd_color}{\input{advanced_topics/viewports/colour-uivp-syntax.tex}}
205}
206 203
207\section{\label{ref:ConfiguringtheWPS}Configuring the Theme} 204\section{\label{ref:ConfiguringtheWPS}Configuring the Theme}
208 205
@@ -265,7 +262,6 @@ are discussed below.
265 } 262 }
266} 263}
267 264
268\nopt{lcd_charcell}{
269\subsubsection{\label{ref:Viewports}Viewports} 265\subsubsection{\label{ref:Viewports}Viewports}
270 266
271By default, a viewport filling the whole screen contains all the elements 267By default, a viewport filling the whole screen contains all the elements
@@ -279,7 +275,7 @@ be defined. A viewport is a rectangular window on the screen%
279\opt{lcd_non-mono}{ with its own foreground/background 275\opt{lcd_non-mono}{ with its own foreground/background
280\opt{lcd_color}{colours}\nopt{lcd_color}{shades}}. 276\opt{lcd_color}{colours}\nopt{lcd_color}{shades}}.
281This window also has variable dimensions. To 277This window also has variable dimensions. To
282define a viewport a line starting \config{{\%V(\dots}} has to be 278define a viewport a line starting \config{{\%V(\dots)}} has to be
283present in the theme file. The full syntax will be explained later in 279present in the theme file. The full syntax will be explained later in
284this section. All elements placed before the 280this section. All elements placed before the
285line defining a viewport are displayed in the default viewport. Elements 281line defining a viewport are displayed in the default viewport. Elements
@@ -293,6 +289,7 @@ cannot be layered \emph{transparently} over one another. Subsequent viewports
293will be drawn over any other viewports already drawn onto that 289will be drawn over any other viewports already drawn onto that
294area of the screen. 290area of the screen.
295 291
292
296\nopt{lcd_non-mono}{\input{advanced_topics/viewports/mono-vp-syntax.tex}} 293\nopt{lcd_non-mono}{\input{advanced_topics/viewports/mono-vp-syntax.tex}}
297\nopt{lcd_color}{\opt{lcd_non-mono}{\input{advanced_topics/viewports/grayscale-vp-syntax.tex}}} 294\nopt{lcd_color}{\opt{lcd_non-mono}{\input{advanced_topics/viewports/grayscale-vp-syntax.tex}}}
298\opt{lcd_color}{\input{advanced_topics/viewports/colour-vp-syntax.tex}} 295\opt{lcd_color}{\input{advanced_topics/viewports/colour-vp-syntax.tex}}
@@ -318,11 +315,10 @@ Mode can be the following:
318 the end colour\\} 315 the end colour\\}
319\end{rbtabular} 316\end{rbtabular}
320} 317}
321
322\subsubsection{Conditional Viewports} 318\subsubsection{Conditional Viewports}
323 319
324Any viewport can be displayed either permanently or conditionally. 320Any viewport can be displayed either permanently or conditionally.
325Defining a viewport as \config{{\%V(\dots}} 321Defining a viewport as \config{{\%V(\dots)}}
326will display it permanently. 322will display it permanently.
327 323
328\begin{itemize} 324\begin{itemize}