From d7cb3b13fbb0f6ccec0bfabd3b618b2b9b8a870d Mon Sep 17 00:00:00 2001 From: Alex Parker Date: Sat, 31 Jul 2010 12:47:12 +0000 Subject: Manual: add some missing theme tags, and close FS#11472. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@27637 a1c6a512-1295-4272-9138-f99709370657 --- manual/appendix/wps_tags.tex | 45 ++++++++++++++++++++++++++++++++++++-------- 1 file changed, 37 insertions(+), 8 deletions(-) diff --git a/manual/appendix/wps_tags.tex b/manual/appendix/wps_tags.tex index 9fd5e42e20..bc71956584 100644 --- a/manual/appendix/wps_tags.tex +++ b/manual/appendix/wps_tags.tex @@ -161,6 +161,29 @@ or \config{\%D(2)}), produce the information for the next file to be played. the rest of the track>}\\ \config{\%Sp} & Current playback pitch\\ \end{tagmap} + +\section{Playlist Viewer} + \begin{tagmap} + \config{\%Vp(start,if tag present,other)} & Display the playlist viewer in + the current viewport.\\ + \end{tagmap} + + \begin{itemize} + \item `start' is the offset relative to the currently playing track for the + playlist to display from (0 the current track, 1 is the next track, etc.). + \item `if tag present' is the skin code to display if the track has been buffered. + \item `other' is the skin code to display if the track hasnt been buffered, + essentially only the filename is know at this point. + \end{itemize} + + The entire viewport will be used, so don't expect other tags in the same + viewport to work well. Supported tags are \%pp, all tags starting with \%i, + most tags starting with \%f, \%pt and \%s.\\ + + Example: \config{\%Vp(1,\%pp - \%it,\%pp - \%fn)} -- Display the playlist + position, then either the track title (from the tags) or + the filename. The viewer will display as many tracks as will fit in the + viewport. \section{Runtime Database} \begin{tagmap} @@ -202,8 +225,7 @@ or \config{\%D(2)}), produce the information for the next file to be played. \begin{tagmap} \config{\%mm} & Repeat mode, 0-4, in the order: Off, All, One, Shuffle, A-B\\ \end{tagmap} -Example: \config{\%?mm} +Example: \config{\%?mm} \section{Playback Mode} \begin{tagmap} @@ -211,9 +233,7 @@ Example: \config{\%?mm} +Example: \config{\%?mp} \section{Current Screen} \begin{tagmap} @@ -223,8 +243,7 @@ FM pause>} The tag can also be used as the switch in a conditional tag. For players without some capabilities (e.g. having no FM radio) some values will be never yielded. -Example: \config{You are in the \%?cs
} +Example: \config{You are in the \%?cs
} \section{List Title (\fname{.sbs} only)} \begin{tagmap} @@ -435,17 +454,27 @@ and must have the same name as the preset. They need to be in either and tuned to a preset (and not recording) in order for them to be shown. } -\section{Alignment} +\section{Alignment and language direction} \begin{tagmap} \config{\%al} & Align the text left\\ \config{\%aL} & Align the text left, or to the right if RTL language is in use\\ \config{\%ac} & Centre the text\\ \config{\%ar} & Align the text right\\ \config{\%aR} & Align the text right, or to the left if RTL language is in use\\ + \config{\%ax} & The next tag should follow the set language direction. When + prepended to a viewport declaration, the viewport will + be horizontally mirrored if the user language is set to + a RTL language. Currently the \%Cl, \%V and \%Vl tags + support this.\\ + \config{\%Sr} & Use as a conditional to define options for left to right, or + right to left languages. \%?Sr\\ \end{tagmap} + All alignment tags may be present in one line, but they need to be in the order left -- centre -- right. If the aligned texts overlap, they are merged. +Example: \config{\%ax\%V(\dots)} + \section{Conditional Tags} \begin{tagmap} -- cgit v1.2.3