Time Format
timeFormat -- Establishes the way the time is displayed while the track is playing in the info display area.
Description
There are three types of time signatures available:
1 = Current Time
2 = Remaining Time
3 = Total Time
We use numbers to designate the data-types because you may want to include letters amongst the time signatures. This will make sense in a minute.
NOTE: If the skin does not have enough space to display all the time information you need, or if you want to right or left justify the time, open the skin with Skin Machine and make the adjustments as needed.
Example 1:
If we set timeFormat as follows:
timeFormat = "1 / 2 / 3 "
... then Wimpy will render the time as:
0:30 / 1:45 / 2:15
... because the number "1" refers to the Current Time, the number "2" refers to the Remaining Time and Number 3 refers to Total Time. You'll notice that there is a space, then a dash, then another space between the numbers. Wimpy will include any characters "as is" between the numbers. Wimpy will only replace a number with the corresponding data type.
Example 2:
A more advanced example would be:
timeFormat = "Current: 1 / Remaining: 2 / Total: 3"
... this would render the info display area as:
Current: 0:30/ Remaining: 1:45/ Total: 2:15
... where ever the numbers show up, they get replaced by the actual data. Any character between the numbers will not be replaced. Now it should make sense why we use numbers to represent data -- this allows you to use letters amongst timeFormat :)
NOTE: We recommend URL encoding special characters that may interfere with HTML or XML, such as a space " " & ' ? \ etc.
So in the examples above, they should actually appear as:
timeFormat=1%20-%202
and
timeFormat=Current%3A%201%20%2F%20Remaining%3A%202%20%2F%20Total%3A%203
The Customizer Tool will automatically URL encode this option for you, we only mention this for advanced users.
Options
1 -- Current Time
2 -- Remaining Time
3 -- Total Time
Usage
As HTML option:
wimpy.swf?timeFormat=1%20/%203
As Wimpy Configs Option:
<timeFormat>1 - 3 </timeFormat>
As Javascript Option:
wimpyConfigs.timeFormat="1 - 3 ";
.
|
