diff options
Diffstat (limited to 'manual/advanced_topics')
-rwxr-xr-x | manual/advanced_topics/main.tex | 54 |
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} | 172 | By 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 | 173 | the 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 | 174 | viewport. 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 | ||
271 | By default, a viewport filling the whole screen contains all the elements | 267 | By 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}}. |
281 | This window also has variable dimensions. To | 277 | This window also has variable dimensions. To |
282 | define a viewport a line starting \config{{\%V(\dots}} has to be | 278 | define a viewport a line starting \config{{\%V(\dots)}} has to be |
283 | present in the theme file. The full syntax will be explained later in | 279 | present in the theme file. The full syntax will be explained later in |
284 | this section. All elements placed before the | 280 | this section. All elements placed before the |
285 | line defining a viewport are displayed in the default viewport. Elements | 281 | line defining a viewport are displayed in the default viewport. Elements |
@@ -293,6 +289,7 @@ cannot be layered \emph{transparently} over one another. Subsequent viewports | |||
293 | will be drawn over any other viewports already drawn onto that | 289 | will be drawn over any other viewports already drawn onto that |
294 | area of the screen. | 290 | area 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 | ||
324 | Any viewport can be displayed either permanently or conditionally. | 320 | Any viewport can be displayed either permanently or conditionally. |
325 | Defining a viewport as \config{{\%V(\dots}} | 321 | Defining a viewport as \config{{\%V(\dots)}} |
326 | will display it permanently. | 322 | will display it permanently. |
327 | 323 | ||
328 | \begin{itemize} | 324 | \begin{itemize} |