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.

Formatting

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

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:

infoFormat
1 = Title
2 = Artist
3 = Album

timeFormat
1 = Current Time
2 = Remaining Time
3 = Total Time