diff options
Diffstat (limited to 'manual')
-rw-r--r-- | manual/advanced_topics/main.tex | 225 | ||||
-rw-r--r-- | manual/appendix/appendix.tex | 19 | ||||
-rw-r--r-- | manual/appendix/wps_tags.tex | 205 |
3 files changed, 225 insertions, 224 deletions
diff --git a/manual/advanced_topics/main.tex b/manual/advanced_topics/main.tex index 43bca0a1b9..91008aec7b 100644 --- a/manual/advanced_topics/main.tex +++ b/manual/advanced_topics/main.tex | |||
@@ -49,217 +49,7 @@ If your language is not yet supported and you want to write your own language fi | |||
49 | Custom WPS files may be located anywhere on the drive. The only restriction is that they must end in .wps. When you ``play'' a .wps file, it will be used for future WPS screens. If the ``played'' .wps file is located in the \fname{/.rockbox} folder, it will be remembered and used after reboot. The .wps filename must be no more than 24 characters long for it to be remembered. | 49 | Custom WPS files may be located anywhere on the drive. The only restriction is that they must end in .wps. When you ``play'' a .wps file, it will be used for future WPS screens. If the ``played'' .wps file is located in the \fname{/.rockbox} folder, it will be remembered and used after reboot. The .wps filename must be no more than 24 characters long for it to be remembered. |
50 | 50 | ||
51 | \subsection{How To Create A .wps File} | 51 | \subsection{How To Create A .wps File} |
52 | Quite simply, enter the WPS code in your favourite text editor, Notepad on Windows works fine. When you save it, instead of saving it as a .txt file, save it as a .wps file. Example: Instead of \fname{Rockbox.txt}, save the file as \fname{Rockbox.wps}. To make sure non english characters display correctly in your WPS you must save the .wps file with UTF-8 character encoding. This can be done in most editors, for example Notepad in Windows 2000 or XP (but not in 9x/ME) can do this. | 52 | Quite simply, enter the WPS code in your favourite text editor, Notepad on Windows works fine. When you save it, instead of saving it as a .txt file, save it as a .wps file. Example: Instead of \fname{Rockbox.txt}, save the file as \fname{Rockbox.wps}. To make sure non english characters display correctly in your WPS you must save the .wps file with UTF-8 character encoding. This can be done in most editors, for example Notepad in Windows 2000 or XP (but not in 9x/ME) can do this. See appendix \ref{ref:wps_tags} for all the tags that are available. |
53 | |||
54 | \subsection{Tags} | ||
55 | |||
56 | \subsubsection{Status Bar} | ||
57 | \begin{center} | ||
58 | \begin{tabular}{@{}ll@{}}\toprule | ||
59 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
60 | \%we & Status Bar Enabled\\ | ||
61 | \%wd & Status Bar Disabled\\\bottomrule | ||
62 | \end{tabular} | ||
63 | \end{center} | ||
64 | These tags override the player setting for the display of the status bar, they must be on their own line. | ||
65 | |||
66 | \subsubsection{ID3 Info} | ||
67 | |||
68 | \begin{center} | ||
69 | \begin{tabular}{@{}ll@{}}\toprule | ||
70 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
71 | \%ia & ID3 Artist\\ | ||
72 | \%ic & ID3 Composer\\ | ||
73 | \%id & ID3 Album Name\\ | ||
74 | \%ig & ID3 Genre Name\\ | ||
75 | \%in & ID3 Track Number\\ | ||
76 | \%it & ID3 Track Title\\ | ||
77 | \%iv & ID3 Version (1.0, 1.1, 2.2, 2.3, 2.4 or empty if no id3 tag)\\ | ||
78 | \%iy & ID3 Year\\\bottomrule | ||
79 | \end{tabular} | ||
80 | \end{center} | ||
81 | Remember that this information is not always available, so use the conditionals to show alternate information in preference to assuming. | ||
82 | |||
83 | \subsubsection{Battery Info} | ||
84 | |||
85 | \begin{center} | ||
86 | \begin{tabular}{@{}ll@{}}\toprule | ||
87 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
88 | \%bl & Show numeric battery level in percent.\\ | ||
89 | & Can also be used in a conditional: \%?bl{\textless}0{\textbar}1{\textbar}2{\textbar}3{\textbar}4{\textgreater}\\ | ||
90 | \%bv & Show the battery level in volts\\ | ||
91 | \%bt & Show estimated battery time left\\ | ||
92 | \%bp & "p" if the charger is connected \\ | ||
93 | & (only on targets that can charge batteries)\\ | ||
94 | \%bc & "c" if the unit is currently charging the battery\\ | ||
95 | & (only on targets that have software charge control or monitoring)\\\bottomrule | ||
96 | \end{tabular} | ||
97 | \end{center} | ||
98 | |||
99 | \subsubsection{File Info} | ||
100 | |||
101 | \begin{center} | ||
102 | \begin{tabular}{@{}ll@{}}\toprule | ||
103 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
104 | \%fb & File Bitrate (in kbps)\\ | ||
105 | \%fc & File Codec (e.g. "MP3" or "FLAC")\\ | ||
106 | & This tag can also be used in a conditional tag,\\ | ||
107 | & \%?fc{\textless}mp1{\textbar}mp2{\textbar}mp3{\textbar}wav{\textbar}vorbis{\textbar}flac{\textbar}mpc{\textbar}a52{\textbar}wavpack{\textbar}unknown{\textgreater}\\ | ||
108 | & The codec order is as follows: MP1, MP2, MP3, WAV, Ogg Vorbis (OGG),\\ | ||
109 | & FLAC, MPC, AC3, WavPack (WV), ALAC, AAC, Shorten (SHN), AIFF\\ | ||
110 | \%ff & File Frequency (in Hz)\\ | ||
111 | \%fm & File Name\\ | ||
112 | \%fn & File Name (without extension)\\ | ||
113 | \%fp & File Path\\ | ||
114 | \%fs & File Size (In Kilobytes)\\ | ||
115 | \%fv & "(avg)" if variable bit rate or "" if constant bit rate\\ | ||
116 | \%d1 & First directory from end of file path.\\ | ||
117 | \%d2 & Second directory from end of file path.\\ | ||
118 | \%d3 & Third directory from end of file path.\\\bottomrule | ||
119 | \end{tabular} | ||
120 | \end{center} | ||
121 | Example for the the \%dN commands: If the path is "/Rock/Kent/Isola/11 - 747.mp3", \%d1 is "Isola", \%d2 is "Kent"... You get the picture. | ||
122 | |||
123 | \subsubsection{Playlist/Song Info} | ||
124 | |||
125 | \begin{center} | ||
126 | \begin{tabular}{@{}ll@{}}\toprule | ||
127 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
128 | \%pb & Progress Bar\\ | ||
129 | \opt{player}{ | ||
130 | & This will display a 1 character "cup"\\ | ||
131 | & that empties as the time progresses.} | ||
132 | \opt{recorder,recorderv2fm,h1xx,h300,ipodcolor,ipodnano}{ | ||
133 | & This will replace the entire line with a progress bar. \\ | ||
134 | & You can set the height, position and width of the progressbar\\ | ||
135 | & (in pixels): \%pb{\textbar}height{\textbar}leftpos{\textbar}rightpos{\textbar}} \\ | ||
136 | \%pf & Player: Full-line progress bar + time display\\ | ||
137 | \%pc & Current Time In Song\\ | ||
138 | \%pe & Total Number of Playlist Entries\\ | ||
139 | \%pm & Peak Meter (Recorder only) The entire line is used as volume peak meter.\\ | ||
140 | \%pn & Playlist Name (Without path or extension)\\ | ||
141 | \%pp & Playlist Position\\ | ||
142 | \%pr & Remaining Time In Song\\ | ||
143 | \%ps & Shuffle. Shows 's' if shuffle mode is enabled.\\ | ||
144 | \%pt & Total Track Time\\ | ||
145 | \%pv & Current volume. Can also be used in a conditional: \\ | ||
146 | & \%?pv{\textless}0{\textbar}1{\textbar}2{\textbar}3{\textbar}4{\textbar}5{\textbar}6{\textbar}7{\textbar}8{\textbar}9{\textbar}10{\textgreater}\\\bottomrule | ||
147 | \end{tabular} | ||
148 | \end{center} | ||
149 | |||
150 | \subsubsection{Runtime Database} | ||
151 | |||
152 | \begin{center} | ||
153 | \begin{tabular}{@{}ll@{}}\toprule | ||
154 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
155 | \%rp & Song playcount\\ | ||
156 | \%rr & Song rating (0-10). This tag can also be used in a conditional tag,\\ | ||
157 | & \%?rr{\textless}0{\textbar}1{\textbar}2{\textbar}3{\textbar}4{\textbar}5{\textbar}6{\textbar}7{\textbar}8{\textbar}9{\textbar}10{\textgreater}\\\bottomrule | ||
158 | \end{tabular} | ||
159 | \end{center} | ||
160 | |||
161 | \opt{h1xx,h300}{ | ||
162 | \subsubsection{Hold Switches} | ||
163 | |||
164 | \begin{center} | ||
165 | \begin{tabular}{@{}ll@{}}\toprule | ||
166 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
167 | \%mh & "h" if the main unit hold switch is on\\ | ||
168 | \%mr & "r" if the remote hold switch is on\\\bottomrule | ||
169 | \end{tabular} | ||
170 | \end{center} | ||
171 | } | ||
172 | |||
173 | \subsubsection{Virtual LED} | ||
174 | |||
175 | \begin{center} | ||
176 | \begin{tabular}{@{}ll@{}}\toprule | ||
177 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
178 | \%lh & "h" if there is hard disk activity\\\bottomrule | ||
179 | \end{tabular} | ||
180 | \end{center} | ||
181 | |||
182 | \subsubsection{Repeat Mode} | ||
183 | |||
184 | \begin{center} | ||
185 | \begin{tabular}{@{}ll@{}}\toprule | ||
186 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
187 | \%mm & Repeat mode, 0-4, in the order: Off, All, One, Shuffle, \opt{player,recorder,recorderv2fm}{A-B}\\\bottomrule | ||
188 | \end{tabular} | ||
189 | \end{center} | ||
190 | Example: \%?mm{\textless}Off{\textbar}All{\textbar}One{\textbar}Shuffle{\textbar}A-B{\textgreater} | ||
191 | |||
192 | \subsubsection{Playback Mode Tags} | ||
193 | |||
194 | \begin{center} | ||
195 | \begin{tabular}{@{}ll@{}}\toprule | ||
196 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
197 | \%mp & Play status, 0-4, in the order: Stop, Play, Pause, Fast forward, Rewind\\\bottomrule | ||
198 | \end{tabular} | ||
199 | \end{center} | ||
200 | Example: \%?mp{\textless}Stop{\textbar}Play{\textbar}Pause{\textbar}Ffwd{\textbar}Rew{\textgreater} | ||
201 | |||
202 | \subsubsection{Images} | ||
203 | |||
204 | \begin{center} | ||
205 | \begin{tabular}{@{}ll@{}}\toprule | ||
206 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
207 | \%X{\textbar}filename.bmp{\textbar} & Load and set a backdrop image for the WPS.\\ | ||
208 | & This image must be exactly the same size as your LCD.\\ | ||
209 | \%P{\textbar}filename.bmp{\textbar} & Load a Progress bar image for the WPS.\\ | ||
210 | & Use \%pb tag to show the progress bar\\ | ||
211 | \%x{\textbar}n{\textbar}filename{\textbar}x{\textbar}y{\textbar} & Load and display an image\\ | ||
212 | & n = image ID (a-z and A-Z)\\ | ||
213 | & filename = filename (relative to /.rockbox/ and including .bmp)\\ | ||
214 | & x = x coordinate\\ | ||
215 | & y = y coordinate.\\ | ||
216 | \%xl{\textbar}n{\textbar}filename{\textbar}x{\textbar}y{\textbar} & Preload an image for later display\\ | ||
217 | & n = image ID (a-z and A-Z)\\ | ||
218 | & filename = filename (relative to /.rockbox/ and including .bmp)\\ | ||
219 | & x = x coordinate\\ | ||
220 | & y = y coordinate.\\ | ||
221 | \%xdn & Display a preloaded image\\ | ||
222 | |||
223 | & n = image ID (a-z and A-Z)\\\bottomrule | ||
224 | \end{tabular} | ||
225 | \end{center} | ||
226 | Example: image /.rockbox/bg.bmp with ID "a" at 37, 109 would be:\\ | ||
227 | \%x{\textbar}a{\textbar}bg.bmp{\textbar}37{\textbar}109{\textbar} | ||
228 | |||
229 | \begin{itemize} | ||
230 | \item \textbf{Note:} The images must be in a rockbox compatible format (1 bit per pixel BMP) | ||
231 | \item \textbf{Note:} The image tag must be on its own line | ||
232 | \item \textbf{Note:} The ID is case sensitive, giving 52 different ID's | ||
233 | \item \textbf{Note:} The size of the LCD screen for each player varies. See table below for appropriate sizes of each device. The x and y coordinates must repect each of the players' limits. | ||
234 | \end{itemize} | ||
235 | |||
236 | \subsubsection{LCD Screen Sizes} | ||
237 | |||
238 | \begin{center} | ||
239 | \begin{tabular}{@{}lll@{}}\toprule | ||
240 | \textbf{Player} & \textbf{Main LCD Size} & \textbf{Remote LCD Size}\\\midrule | ||
241 | iriver H1x0 & 160x128 & 128x64\\ | ||
242 | iriver H3x0 & 220x176 & 128x64\\ | ||
243 | Archos Recorders & 112x64 & \\ | ||
244 | Archos Ondio & 112x64 & \\ | ||
245 | iPod Nano & 176x132 & \\ | ||
246 | iPod 4G Color & 220x176 & \\ | ||
247 | iPod 5G Video & 320x240 & \\ | ||
248 | iAudio X5 & 160x128 & \\\bottomrule | ||
249 | \end{tabular} | ||
250 | \end{center} | ||
251 | |||
252 | \subsubsection{Alignment} | ||
253 | |||
254 | \begin{center} | ||
255 | \begin{tabular}{@{}lll@{}}\toprule | ||
256 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
257 | \%al & Text is left aligned\\ | ||
258 | \%ac & Text is center aligned\\ | ||
259 | \%ar & Text is right aligned\\\bottomrule | ||
260 | \end{tabular} | ||
261 | \end{center} | ||
262 | All alignment tags may be present in one line, but they need to be in the order left - center - right. If the aligned texts overlap, they are merged. | ||
263 | 53 | ||
264 | \subsubsection{Conditional Tags} | 54 | \subsubsection{Conditional Tags} |
265 | 55 | ||
@@ -352,19 +142,6 @@ Display the filename continuously.\\ | |||
352 | 142 | ||
353 | Note that by using a subline display time of 0 in one branch of a conditional, a subline can be skipped (not displayed) when that condition is met. | 143 | Note that by using a subline display time of 0 in one branch of a conditional, a subline can be skipped (not displayed) when that condition is met. |
354 | 144 | ||
355 | \subsubsection{Other Tags} | ||
356 | \begin{verbatim} | ||
357 | %% : Display a '%' | ||
358 | %< : Display a '<' | ||
359 | %| : Display a '|' | ||
360 | %> : Display a '>' | ||
361 | %; : Display a ';' | ||
362 | %s : Indicate that the line should scroll. Can occur | ||
363 | anywhere in a line (given that the text is displayed; | ||
364 | see conditionals above). You can specify up to 10 scrolling | ||
365 | lines. Scrolling lines can not contain dynamic content such | ||
366 | as timers, peak meters or progress bars. | ||
367 | \end{verbatim} | ||
368 | 145 | ||
369 | \subsubsection{Using Images} | 146 | \subsubsection{Using Images} |
370 | You can have as many as 52 images in your WPS. There are two ways of displaying images: | 147 | You can have as many as 52 images in your WPS. There are two ways of displaying images: |
diff --git a/manual/appendix/appendix.tex b/manual/appendix/appendix.tex index b0d1211587..997aef6650 100644 --- a/manual/appendix/appendix.tex +++ b/manual/appendix/appendix.tex | |||
@@ -21,6 +21,25 @@ | |||
21 | \end{tabular} | 21 | \end{tabular} |
22 | \end{center} | 22 | \end{center} |
23 | 23 | ||
24 | \chapter{\label{ref:wps_tags}WPS Tags} | ||
25 | \input{appendix/wps_tags.tex} | ||
26 | |||
27 | \chapter{LCD Screen Sizes} | ||
28 | \begin{center} | ||
29 | \begin{tabular}{@{}lll@{}}\toprule | ||
30 | \textbf{Player} & \textbf{Main LCD Size} & \textbf{Remote LCD Size}\\\midrule | ||
31 | iriver H1x0 & 160x128 & 128x64\\ | ||
32 | iriver H3x0 & 220x176 & 128x64\\ | ||
33 | Archos Recorders & 112x64 & \\ | ||
34 | Archos Ondio & 112x64 & \\ | ||
35 | iPod Nano & 176x132 & \\ | ||
36 | iPod 4G Color & 220x176 & \\ | ||
37 | iPod 5G Video & 320x240 & \\ | ||
38 | iAudio X5 & 160x128 & \\\bottomrule | ||
39 | \end{tabular} | ||
40 | \end{center} | ||
41 | |||
42 | |||
24 | \chapter{User feedback} | 43 | \chapter{User feedback} |
25 | \section{Bug reports} | 44 | \section{Bug reports} |
26 | If you experience inappropriate performance from any supported feature, | 45 | If you experience inappropriate performance from any supported feature, |
diff --git a/manual/appendix/wps_tags.tex b/manual/appendix/wps_tags.tex new file mode 100644 index 0000000000..4a812f26de --- /dev/null +++ b/manual/appendix/wps_tags.tex | |||
@@ -0,0 +1,205 @@ | |||
1 | \subsubsection{Status Bar} | ||
2 | \begin{tabular}{@{}ll@{}}\toprule | ||
3 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
4 | \%we & Status Bar Enabled\\ | ||
5 | \%wd & Status Bar Disabled\\\bottomrule | ||
6 | \end{tabular} | ||
7 | \newline | ||
8 | \newline | ||
9 | These tags override the player setting for the display of the status bar, they must be on their own line. | ||
10 | |||
11 | \subsubsection{ID3 Info} | ||
12 | |||
13 | \begin{tabular}{@{}ll@{}}\toprule | ||
14 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
15 | \%ia & ID3 Artist\\ | ||
16 | \%ic & ID3 Composer\\ | ||
17 | \%id & ID3 Album Name\\ | ||
18 | \%ig & ID3 Genre Name\\ | ||
19 | \%in & ID3 Track Number\\ | ||
20 | \%it & ID3 Track Title\\ | ||
21 | \%iv & ID3 Version (1.0, 1.1, 2.2, 2.3, 2.4 or empty if no id3 tag)\\ | ||
22 | \%iy & ID3 Year\\\bottomrule | ||
23 | \end{tabular} | ||
24 | \newline | ||
25 | \newline | ||
26 | Remember that this information is not always available, so use the conditionals to show alternate information in preference to assuming. | ||
27 | |||
28 | \subsubsection{Battery Info} | ||
29 | |||
30 | \begin{tabular}{@{}ll@{}}\toprule | ||
31 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
32 | \%bl & Show numeric battery level in percent.\\ | ||
33 | & Can also be used in a conditional: \%?bl{\textless}0{\textbar}1{\textbar}2{\textbar}3{\textbar}4{\textgreater}\\ | ||
34 | \%bv & Show the battery level in volts\\ | ||
35 | \%bt & Show estimated battery time left\\ | ||
36 | \%bp & "p" if the charger is connected \\ | ||
37 | & (only on targets that can charge batteries)\\ | ||
38 | \%bc & "c" if the unit is currently charging the battery\\ | ||
39 | & (only on targets that have software charge control or monitoring)\\\bottomrule | ||
40 | \end{tabular} | ||
41 | |||
42 | \subsubsection{File Info} | ||
43 | |||
44 | \begin{tabular}{@{}ll@{}}\toprule | ||
45 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
46 | \%fb & File Bitrate (in kbps)\\ | ||
47 | \%fc & File Codec (e.g. "MP3" or "FLAC")\\ | ||
48 | & This tag can also be used in a conditional tag,\\ | ||
49 | & \%?fc{\textless}mp1{\textbar}mp2{\textbar}mp3{\textbar}wav{\textbar}vorbis{\textbar}flac{\textbar}mpc{\textbar}a52{\textbar}wavpack{\textbar}unknown{\textgreater}\\ | ||
50 | & The codec order is as follows: MP1, MP2, MP3, WAV, Ogg Vorbis (OGG),\\ | ||
51 | & FLAC, MPC, AC3, WavPack (WV), ALAC, AAC, Shorten (SHN), AIFF\\ | ||
52 | \%ff & File Frequency (in Hz)\\ | ||
53 | \%fm & File Name\\ | ||
54 | \%fn & File Name (without extension)\\ | ||
55 | \%fp & File Path\\ | ||
56 | \%fs & File Size (In Kilobytes)\\ | ||
57 | \%fv & "(avg)" if variable bit rate or "" if constant bit rate\\ | ||
58 | \%d1 & First directory from end of file path.\\ | ||
59 | \%d2 & Second directory from end of file path.\\ | ||
60 | \%d3 & Third directory from end of file path.\\\bottomrule | ||
61 | \end{tabular} | ||
62 | \newline | ||
63 | \newline | ||
64 | Example for the the \%dN commands: If the path is "/Rock/Kent/Isola/11 - 747.mp3", \%d1 is "Isola", \%d2 is "Kent"... You get the picture. | ||
65 | |||
66 | \subsubsection{Playlist/Song Info} | ||
67 | |||
68 | \begin{tabular}{@{}ll@{}}\toprule | ||
69 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
70 | \%pb & Progress Bar\\ | ||
71 | \opt{player}{ | ||
72 | & This will display a 1 character "cup"\\ | ||
73 | & that empties as the time progresses.} | ||
74 | \opt{recorder,recorderv2fm,h1xx,h300,ipodcolor,ipodnano}{ | ||
75 | & This will replace the entire line with a progress bar. \\ | ||
76 | & You can set the height, position and width of the progressbar\\ | ||
77 | & (in pixels): \%pb{\textbar}height{\textbar}leftpos{\textbar}rightpos{\textbar}} \\ | ||
78 | \%pf & Player: Full-line progress bar + time display\\ | ||
79 | \%pc & Current Time In Song\\ | ||
80 | \%pe & Total Number of Playlist Entries\\ | ||
81 | \%pm & Peak Meter (Recorder only) The entire line is used as volume peak meter.\\ | ||
82 | \%pn & Playlist Name (Without path or extension)\\ | ||
83 | \%pp & Playlist Position\\ | ||
84 | \%pr & Remaining Time In Song\\ | ||
85 | \%ps & Shuffle. Shows 's' if shuffle mode is enabled.\\ | ||
86 | \%pt & Total Track Time\\ | ||
87 | \%pv & Current volume. Can also be used in a conditional: \\ | ||
88 | & \%?pv{\textless}0{\textbar}1{\textbar}2{\textbar}3{\textbar}4{\textbar}5{\textbar}6{\textbar}7{\textbar}8{\textbar}9{\textbar}10{\textgreater}\\\bottomrule | ||
89 | \end{tabular} | ||
90 | |||
91 | \subsubsection{Runtime Database} | ||
92 | |||
93 | \begin{tabular}{@{}ll@{}}\toprule | ||
94 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
95 | \%rp & Song playcount\\ | ||
96 | \%rr & Song rating (0-10). This tag can also be used in a conditional tag,\\ | ||
97 | & \%?rr{\textless}0{\textbar}1{\textbar}2{\textbar}3{\textbar}4{\textbar}5{\textbar}6{\textbar}7{\textbar}8{\textbar}9{\textbar}10{\textgreater}\\\bottomrule | ||
98 | \end{tabular} | ||
99 | |||
100 | \opt{h1xx,h300}{ | ||
101 | \subsubsection{Hold Switches} | ||
102 | |||
103 | \begin{tabular}{@{}ll@{}}\toprule | ||
104 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
105 | \%mh & "h" if the main unit hold switch is on\\ | ||
106 | \%mr & "r" if the remote hold switch is on\\\bottomrule | ||
107 | \end{tabular} | ||
108 | } | ||
109 | |||
110 | \subsubsection{Virtual LED} | ||
111 | |||
112 | \begin{tabular}{@{}ll@{}}\toprule | ||
113 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
114 | \%lh & "h" if there is hard disk activity\\\bottomrule | ||
115 | \end{tabular} | ||
116 | |||
117 | \subsubsection{Repeat Mode} | ||
118 | |||
119 | \begin{tabular}{@{}ll@{}}\toprule | ||
120 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
121 | \%mm & Repeat mode, 0-4, in the order: Off, All, One, Shuffle, \opt{player,recorder,recorderv2fm}{A-B}\\\bottomrule | ||
122 | \end{tabular} | ||
123 | \newline | ||
124 | \newline | ||
125 | Example: \%?mm{\textless}Off{\textbar}All{\textbar}One{\textbar}Shuffle{\textbar}A-B{\textgreater} | ||
126 | |||
127 | \subsubsection{Playback Mode Tags} | ||
128 | |||
129 | \begin{tabular}{@{}ll@{}}\toprule | ||
130 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
131 | \%mp & Play status, 0-4, in the order: Stop, Play, Pause, Fast forward, Rewind\\\bottomrule | ||
132 | \end{tabular} | ||
133 | \newline | ||
134 | \newline | ||
135 | Example: \%?mp{\textless}Stop{\textbar}Play{\textbar}Pause{\textbar}Ffwd{\textbar}Rew{\textgreater} | ||
136 | |||
137 | \subsubsection{Images} | ||
138 | |||
139 | \begin{tabular}{@{}ll@{}}\toprule | ||
140 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
141 | \%X{\textbar}filename.bmp{\textbar} & Load and set a backdrop image for the WPS.\\ | ||
142 | & This image must be exactly the same size as your LCD.\\ | ||
143 | \%P{\textbar}filename.bmp{\textbar} & Load a Progress bar image for the WPS.\\ | ||
144 | & Use \%pb tag to show the progress bar\\ | ||
145 | \%x{\textbar}n{\textbar}filename{\textbar}x{\textbar}y{\textbar} & Load and display an image\\ | ||
146 | & n = image ID (a-z and A-Z)\\ | ||
147 | & filename = filename (relative to /.rockbox/ and including .bmp)\\ | ||
148 | & x = x coordinate\\ | ||
149 | & y = y coordinate.\\ | ||
150 | \%xl{\textbar}n{\textbar}filename{\textbar}x{\textbar}y{\textbar} & Preload an image for later display\\ | ||
151 | & n = image ID (a-z and A-Z)\\ | ||
152 | & filename = filename (relative to /.rockbox/ and including .bmp)\\ | ||
153 | & x = x coordinate\\ | ||
154 | & y = y coordinate.\\ | ||
155 | \%xdn & Display a preloaded image\\ | ||
156 | |||
157 | & n = image ID (a-z and A-Z)\\\bottomrule | ||
158 | \end{tabular} | ||
159 | \newline | ||
160 | \newline | ||
161 | Example: image /.rockbox/bg.bmp with ID "a" at 37, 109 would be:\\ | ||
162 | \%x{\textbar}a{\textbar}bg.bmp{\textbar}37{\textbar}109{\textbar} | ||
163 | |||
164 | \begin{itemize} | ||
165 | \item \textbf{Note:} The images must be in a rockbox compatible format (1 bit per pixel BMP) | ||
166 | \item \textbf{Note:} The image tag must be on its own line | ||
167 | \item \textbf{Note:} The ID is case sensitive, giving 52 different ID's | ||
168 | \item \textbf{Note:} The size of the LCD screen for each player varies. See table below for appropriate sizes of each device. The x and y coordinates must repect each of the players' limits. | ||
169 | \end{itemize} | ||
170 | |||
171 | \subsubsection{Alignment} | ||
172 | |||
173 | \begin{tabular}{@{}lll@{}}\toprule | ||
174 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
175 | \%al & Text is left aligned\\ | ||
176 | \%ac & Text is center aligned\\ | ||
177 | \%ar & Text is right aligned\\\bottomrule | ||
178 | \end{tabular} | ||
179 | \newline | ||
180 | \newline | ||
181 | All alignment tags may be present in one line, but they need to be in the order left - center - right. If the aligned texts overlap, they are merged. | ||
182 | |||
183 | \subsubsection{Conditional Tags} | ||
184 | |||
185 | \textbf{If/else}\\ | ||
186 | |||
187 | Syntax: \%?xx{\textless}true{\textbar}false{\textgreater}\\ | ||
188 | |||
189 | \textbf{Enumerations}\\ | ||
190 | |||
191 | Syntax: \%?xx{\textless}alt1{\textbar}alt2{\textbar}alt3{\textbar}...{\textbar}else{\textgreater}\\ | ||
192 | |||
193 | \subsection{Other Tags} | ||
194 | \begin{tabular}{@{}ll@{}}\toprule | ||
195 | \textbf{Tag} & \textbf{Description}\\\midrule | ||
196 | \%\% & Display a '\%'\\ | ||
197 | \%{\textless} & Display a '{\textless}'\\ | ||
198 | \%{\textbar} & Display a '{\textbar}'\\ | ||
199 | \%{\textgreater} & Display a '{\textgreater}'\\ | ||
200 | \%; & Display a ';'\\ | ||
201 | \%s & Indicate that the line should scroll. Can occur anywhere in a line\\ | ||
202 | & (given that the text is displayed; see conditionals above). \\ | ||
203 | & You can specify up to 10 scrolling lines. Scrolling lines can not \\ | ||
204 | & contain dynamic content such as timers, peak meters or progress bars. | ||
205 | \end{tabular} \ No newline at end of file | ||