Available Controls
Wimpy contains a large number of built-in controls you can incorporate into the player via the Controls Panel in Skin Machine. Below is a diagram of a generic skin that is displaying all available controls.
Reference Table
Human Name | Description | Internal Name |
Screen | Displays cover art images or video content. See "Cover Art" for details on how and when cover art can be used and/or displayed. | cmp_cover |
Screen Play / Pause | Icon that displays the play / pause state fo the player. This object disolves after a few seconds of changing. Appears when user rolls over the screen. | cmp_coverPlayPause |
Formatted Info | Scrolls artist, title, album within a block. At startup, this block displays a message to user that can be defined with the "starUpText" option. Formatting is controlled via the "infoFormat" option. See "Formatting Info & Time" reference for more info on formatting. | cmp_info |
Artist Block | Displays the artist info. | cmp_info_artist |
Title Block | Displays the title info. | cmp_info_title |
Album Block | Displays the album info. | cmp_info_album |
Formatted Time | Offers a single block to display multiple time signatures. Formatting is controlled via the "timeFormat" option. See "Formatting Info & Time" reference for more info on formatting. | cmp_time |
Current Time | du | cmp_time_current |
Remaining Time | du | cmp_time_remain |
Total Time | du | cmp_time_total |
Play | If Pause and/or Stop controls do not exist, this control will assume the "play pause" functionality. Meaning that it will display a "play" icon when playing, and a "pause" icon when the player is paused. When either Pause or Stop controls exist, this control maintains it's appearance with only the "play" icon. |
cmp_play |
Pause | du | cmp_pause |
Stop | Stops playback and rewinds track to beginning | cmp_stop |
Rewind / Previous | Rewinds track to beginning if > 2 seconds of track have elapsed. Otherwise goes to previous track. | cmp_rewind |
Next | Advances to next track in playlist | cmp_next |
Playlist | Icon displays type of media (media or playlist). Link and download icons only appear when playlist items contain info or download data. | cmp_playlist |
Back | Returns to previously loaded playlist. | cmp_plBack |
Scroll Up | Scrolls playlist one item up. | cmp_plScrollUp |
Scroll Bar | Scroll bar for playlist. | cmp_plScroll |
Scroll Down | Scrolls playlist one item down. | cmp_plScrollDown |
Fake EQ | Animates when a track is playing to mimic traditional graphical EQ movement. Does not match actual sample data, animations are randomly generated. | cmp_fakeEQ |
Thinker | Displays when an item has been requested to load, but has not started loading fully. Items thinker reacts to include: Media files, playlists. | cmp_thinker |
Mute | Click to mute / unmute track. NOTE: Some devices do not allow volume to be controlled programmatically -- therefore this control may confuse users. Use with caution. | cmp_mute |
Volume Slider | NOTE: Some devices do not allow volume to be controlled programmatically -- therefore this control may confuse users. Use with caution. | cmp_volume |
Fullscreen | Pushes the Screen control into fullscreen mode. | cmp_fullscreen |
Random | Causes player to select tracks randomly, rather than use the order as layed out by the playlist. | cmp_random |
Loop | Loop has three modes: Off, Loop Track, Loop Playlist. Modes advance to the next mode by clicking the icon one time. | cmp_loop |
Help | Displays info about the player and link to wimpyplayer.com | cmp_help |
Each control is identified within a player with a specific internal name. You can access individual controls via Javascript.
See Also
- Skin Machine - Conrols Panel
- API - getSkinElement