blob: 32248d275e979483afdc1d06ba157fa2cb6e7193 [file] [log] [blame]
Alex Parkerab563da2009-09-20 16:48:45 +00001\subsubsection{Viewport Declaration Syntax}
2
Alex Parker64d4ddf2010-06-20 12:58:41 +00003\config{\%V(x,y,[width],[height],[font]) \%Vf([fgshade]) \%Vb([bgshade])}%
Alex Parkerab563da2009-09-20 16:48:45 +00004
5 \begin{itemize}
Alexander Levinb57fe482009-12-23 20:05:29 +00006 \item `fgshade' and `bgshade' are numbers in the range 0 (= black) to 3
Alex Parkerab563da2009-09-20 16:48:45 +00007 (= white).
Alexander Levinb57fe482009-12-23 20:05:29 +00008 \item `font' is a number: 0 is the built-in system font, 1 is the
Alex Parker994d9552010-06-20 16:23:47 +00009 current menu font, and 2-9 are additional skin loaded fonts (see
Alex Parker1b0c77f2010-06-20 12:58:09 +000010 \reference{ref:multifont}).
Alex Parkerab563da2009-09-20 16:48:45 +000011 \item Only the coordinates \emph{have} to be specified. Leaving the other
12 definitions blank will set them to their default values.
Alex Parkerab563da2009-09-20 16:48:45 +000013 \end{itemize}
14
Alex Parker64d4ddf2010-06-20 12:58:41 +000015\note{The correct number of commas with hyphens in
Alexander Levin64bb9a02010-05-18 20:23:22 +000016 blank fields are still needed in any case.}
17
Alex Parkerab563da2009-09-20 16:48:45 +000018\begin{example}
Alex Parker64d4ddf2010-06-20 12:58:41 +000019 %V(12,20,-,-,1) %Vf(0) %Vb(3)
Alex Parkerab563da2009-09-20 16:48:45 +000020 %sThis viewport is displayed permanently. It starts 12px from the left and
21 %s20px from the top of the screen, and fills the rest of the screen from
22 %sthat point. The lines will scroll if this text does not fit in the viewport.
Alex Parker64d4ddf2010-06-20 12:58:41 +000023 %sThe user font is used, the foreground colour is set to black and the
24 %sbackground is set to white.
Alex Parkerab563da2009-09-20 16:48:45 +000025\end{example}
Alexander Levin9df56382010-05-12 22:06:18 +000026\begin{rbtabular}{.75\textwidth}{XX}{\textbf{Viewport definition} & \textbf{Default value}}{}{}
Alex Parkerab563da2009-09-20 16:48:45 +000027 width/height & remaining part of screen \\
28 font & user defined \\
29 shade & black foreground on white background \\
30\end{rbtabular}
Alexander Levinb57fe482009-12-23 20:05:29 +000031