diff options
author | Martin Arver <martin.arver@gmail.com> | 2006-03-23 14:11:52 +0000 |
---|---|---|
committer | Martin Arver <martin.arver@gmail.com> | 2006-03-23 14:11:52 +0000 |
commit | 94c1289da7daf480850241b3081a8863b17733e9 (patch) | |
tree | 9af365bcffc639272e33a4ad41f952781196a0e3 /manual/advanced_topics | |
parent | e7463a45baba2da0498e4aec619f72e7a74fced3 (diff) | |
download | rockbox-94c1289da7daf480850241b3081a8863b17733e9.tar.gz rockbox-94c1289da7daf480850241b3081a8863b17733e9.zip |
Move WPS tag definitions to the appendix
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@9206 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'manual/advanced_topics')
-rw-r--r-- | manual/advanced_topics/main.tex | 225 |
1 files changed, 1 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: |