blob: 2bced327d87e9e757946bb853a807095b9108993 [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}
Alex Parker77a78ee2011-08-19 11:43:51 +00006 \item \%Vf and \%Vb set the foreground and background shade of grey
7 respectively.
Alexander Levinb57fe482009-12-23 20:05:29 +00008 \item `fgshade' and `bgshade' are numbers in the range 0 (= black) to 3
Alex Parkerab563da2009-09-20 16:48:45 +00009 (= white).
Alexander Levinb57fe482009-12-23 20:05:29 +000010 \item `font' is a number: 0 is the built-in system font, 1 is the
Alex Parker994d9552010-06-20 16:23:47 +000011 current menu font, and 2-9 are additional skin loaded fonts (see
Alex Parker1b0c77f2010-06-20 12:58:09 +000012 \reference{ref:multifont}).
Alex Parkerab563da2009-09-20 16:48:45 +000013 \item Only the coordinates \emph{have} to be specified. Leaving the other
14 definitions blank will set them to their default values.
Alex Parkerab563da2009-09-20 16:48:45 +000015 \end{itemize}
16
Alex Parker64d4ddf2010-06-20 12:58:41 +000017\note{The correct number of commas with hyphens in
Alex Parker77a78ee2011-08-19 11:43:51 +000018 blank fields are still needed.}
Alexander Levin64bb9a02010-05-18 20:23:22 +000019
Alex Parkerab563da2009-09-20 16:48:45 +000020\begin{example}
Alex Parker64d4ddf2010-06-20 12:58:41 +000021 %V(12,20,-,-,1) %Vf(0) %Vb(3)
Alex Parkerab563da2009-09-20 16:48:45 +000022 %sThis viewport is displayed permanently. It starts 12px from the left and
23 %s20px from the top of the screen, and fills the rest of the screen from
24 %sthat point. The lines will scroll if this text does not fit in the viewport.
Alex Parker64d4ddf2010-06-20 12:58:41 +000025 %sThe user font is used, the foreground colour is set to black and the
26 %sbackground is set to white.
Alex Parkerab563da2009-09-20 16:48:45 +000027\end{example}
Alexander Levin9df56382010-05-12 22:06:18 +000028\begin{rbtabular}{.75\textwidth}{XX}{\textbf{Viewport definition} & \textbf{Default value}}{}{}
Alex Parkerab563da2009-09-20 16:48:45 +000029 width/height & remaining part of screen \\
30 font & user defined \\
31 shade & black foreground on white background \\
32\end{rbtabular}
Alexander Levinb57fe482009-12-23 20:05:29 +000033