diff options
author | Justin Heiner <jheiner@rockbox.org> | 2002-08-27 01:05:19 +0000 |
---|---|---|
committer | Justin Heiner <jheiner@rockbox.org> | 2002-08-27 01:05:19 +0000 |
commit | a7a46c70ddec4930945b7ebb484b379952962a0b (patch) | |
tree | e2b8074e75f7dd99f45c376e4d386a0f129816d5 /docs | |
parent | 0dbcb43620ca106b2d6ec44c798208653acf38dc (diff) | |
download | rockbox-a7a46c70ddec4930945b7ebb484b379952962a0b.tar.gz rockbox-a7a46c70ddec4930945b7ebb484b379952962a0b.zip |
Update to CUSTOM_WPS. Now has an If/Else ability. Also updated the docs
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@1990 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'docs')
-rw-r--r-- | docs/CUSTOM_WPS_FORMAT | 101 |
1 files changed, 68 insertions, 33 deletions
diff --git a/docs/CUSTOM_WPS_FORMAT b/docs/CUSTOM_WPS_FORMAT index d9461f969e..916c9887b1 100644 --- a/docs/CUSTOM_WPS_FORMAT +++ b/docs/CUSTOM_WPS_FORMAT | |||
@@ -1,46 +1,78 @@ | |||
1 | Custom WPS Display | 1 | Custom WPS Display |
2 | wps.config File Format Specifications | 2 | wps.config File Format Specifications |
3 | 3 | ||
4 | Description | 4 | |
5 | ----------- | 5 | Description / General Info |
6 | The Custom WPS Display is used on the Rockbox Player ONLY as a means | 6 | -------------------------- |
7 | to customize the WPS to the user's likings. | 7 | * The Custom WPS Display is used on the Rockbox Player ONLY, as a means |
8 | The first line of the 2 line display is the customized line (scrolling). | 8 | to customize the WPS to the user's likings. |
9 | The second line is always the time display. (Elapsed & Total Time). | 9 | * Plans to implement this feature into the recorder are in progress. |
10 | The second line is not able to be customized. | 10 | * The first line of the 2 line display is the customized line (scrolling). |
11 | All characters not preceded by % are displayed as typed. | 11 | * The second line is always the time display. (Elapsed & Total Time). |
12 | * The second line is not able to be customized. | ||
13 | * Any CR's, LF's, or CR/LF's (Commonly known as Newline/Return/Enter) in | ||
14 | the wps.config file will be treated as spaces. IE: Don't use them. | ||
15 | * After editing the wps.config file, you may need to reboot your Rockbox. | ||
16 | * All tags except for %%, %?, and %: contain 3 characters (%xx). Remember | ||
17 | to type the tags correctly, or you will get unexpected output, or even | ||
18 | possibly no output at all. | ||
19 | * All characters not preceded by % are displayed as typed. | ||
20 | |||
12 | 21 | ||
13 | File Location | 22 | File Location |
14 | ------------- | 23 | ------------- |
15 | The configuration file must be located in the root folder of the | 24 | The configuration file must be located in the root folder of the |
16 | device and must be named wps.config (lowercase) | 25 | device and must be named wps.config (lowercase) |
17 | 26 | ||
27 | |||
18 | Tags | 28 | Tags |
19 | ---- | 29 | ---- |
20 | %t : ID3 Title | 30 | ID3 Info Tags: |
21 | %a : ID3 Artist | 31 | %it : ID3 Title |
22 | %n : ID3 Track Number | 32 | %ia : ID3 Artist |
23 | %u : ID3 Album | 33 | %in : ID3 Track Number |
24 | %c : Conditional Title/Filename | 34 | %id : ID3 Album |
25 | Displays "Artist - Title" *or* | 35 | File Info Tags: |
26 | Displays Filename if no ID3 Artist/Title | 36 | %fc : Conditional Title/Filename |
27 | %h : Conditional Title/Filename | 37 | Displays "Artist - Title" *or* |
28 | Displays "Title - Artist" *or* | 38 | Displays Filename if no ID3 Artist/Title |
29 | Displays Filename if no ID3 Artist/Title | 39 | %fd : Conditional Title/Filename |
30 | %b : File Bitrate | 40 | Displays "Title - Artist" *or* |
31 | %f : File Frequency | 41 | Displays Filename if no ID3 Artist/Title |
32 | %p : File Path | 42 | %fb : File Bitrate |
33 | %m : File Name | 43 | %ff : File Frequency |
34 | %s : File Size (In Kilobytes) | 44 | %fp : File Path |
35 | %i : Playlist Position | 45 | %fn : File Name |
36 | %l : Playlist Total Entries | 46 | %fs : File Size (In Kilobytes) |
37 | %e : Elapsed Track Time | 47 | Playlist/Song Info Tags: |
38 | %o : Total Track Time | 48 | %pp : Playlist Position |
39 | %% : Displays a % | 49 | %pe : Playlist Total Entries |
40 | 50 | %pc : Current Time In Song | |
41 | Example wps.config File | 51 | %pt : Total Track Time |
52 | Other Tags: | ||
53 | %% : Displays a % | ||
54 | Conditional ID3/File Tags (If/Else block): | ||
55 | The following two tags are completely optional, and meant only for those | ||
56 | that wish to go crazy with customization. It lets you specify what to | ||
57 | do when it finds an ID3 tag, and also when it doesn't find one. It can | ||
58 | be placed anywhere within the wps.config file. | ||
59 | The first condition of the If/Else block is what to do when it DOES find | ||
60 | valid ID3 tags. The second condition is what to do when there are no | ||
61 | valid ID3 tags available. | ||
62 | %? : Start/End an If/Else block | ||
63 | %: : Seperator between If and Else | ||
64 | Example: | ||
65 | To display "Title - Artist" if there is ID3 available, or "Filename" | ||
66 | if there is no ID3, the following string would be used: | ||
67 | %?%it - %ia%:%fn%? | ||
68 | Yes, you are not going crazy (although I may be)... This *IS* more | ||
69 | confusing then Perl :-) | ||
70 | |||
71 | |||
72 | Example wps.config File (Without If/Else) | ||
42 | ----------------------- | 73 | ----------------------- |
43 | %i/%l: %c * %sKB | 74 | %pp/%pe: %fc * %fsKB |
75 | |||
44 | 76 | ||
45 | Example Output | 77 | Example Output |
46 | -------------- | 78 | -------------- |
@@ -53,5 +85,8 @@ File Size: 3500 | |||
53 | Elapsed Track Time: 2:23 | 85 | Elapsed Track Time: 2:23 |
54 | Total Track Time: 3:01 | 86 | Total Track Time: 3:01 |
55 | The output of this on the player would be: | 87 | The output of this on the player would be: |
56 | 5/10: My Song.mp3 * 3500KB | 88 | --------------------------- |
57 | 2:23/3:01 | 89 | | 5/10: My Song.mp3 * 3500KB| |
90 | | 2:23/3:01 | | ||
91 | --------------------------- | ||
92 | Of course, the whole first line wouldn't fit, so it scrolls it. | ||