Formatting Info & Time
"Formatted Info" and "Formatted Time" are controls that can be incorporated into a player via Skin Machine. These controls incorporate similar items into a single block.
For example, a player can display the title, artist and album info in individual blocks that can be positioned independently within the skin. The Formatted Info control combines all of this info into a single block + the Formatted Info control is animated.
Likewise, a player can display current, remaining and total time in individual blocks that can be positioned independently within a skin. The Formatted Time control combines this info into a single block.
These blocks can be formatted using the infoFormat and timeFormat Player Options. These options use the integers 1, 2 and 3 to represent different kinds of data.
For example, below we have the infoFormat option set as:
<div wimpyplayer data-infoFormat="1 - 2 - 3 "></div>
Wimpy will render the Title, Artist and Album text into the block by replacing the 1, 2 and 3 characters with the appropriate information respectively -- the title, artist and album are derived from the track dataset.
The result will display info into the block similar to:
The Title - The Artist - The Album
All other characters that are not 1, 2 or 3 will appear "as is". Meaning you can incorporate words and characters as you see fit.
For example, we can include words, spaces and other characters as:
<div wimpyplayer data-infoFormat="1 by: 2 on: 3"></div>
Which would result in the player displaying as:
Some Song by: An Artist on: Greatest Hits
If a track only has a title, infoFormat will be ignored and will only display the title in the info control. This happens because otherwise, there will be too many "nothing's" displayed such as:
Title: My Title by: on:
Time formatting is conceptually identical, but rather that replacing 1, 2, 3 with track info, we replace the 1, 2, 3 with the time signatures: current, remaining, total respectively.
For example, if we format the time as:
<div wimpyplayer data-timeFormat="3 Total / 2 Remaining"></div>
Wimpy will render the time into the block similar to:
4:20 Total / -3:16 Remaining
Refer to the folowing table as a cross refrence betwen 1, 2, 3 and actual data:
1 = Title
2 = Artist
3 = Album
1 = Current Time
2 = Remaining Time
3 = Total Time