Share via


Windows Media Player 11 SDK Bitmap Type 

Windows Media Player SDK banner art

Previous Next

Bitmap Type

The following table shows the values that are valid for the bitmap type. Only the Background type is required; others are optional and relate to different possible uses of images.

Value Description
Background Required. The image upon which all button images are superimposed. The base background image dimensions include the full width and height of the screen. This is also the file where images for the natural states of buttons and trackbars are displayed. (Pushed and disabled buttons are not part of this image.)
Disabled Required. Indicates that pushing the button will have no effect. Defines an image that is displayed when specific player functionality is unavailable to the user. You must supply a Coordinates value to indicate the top-left corner position of this image relative to the Background image.
Pushed Required. Defines an image that is displayed when the user pushes a button. Use Pushed to give visual feedback to the user when he taps on a button. You must supply a Coordinates value to indicate the top-left corner position of this image relative to the Background image.
Region Defines images that use colored regions to represent the tap-response area for the hit-type buttons: PushHit, ToggleHit, 2PushHit. If you are using the hit-type buttons, you must supply a Region image. This image file uses specific Windows Palette colors for each control. The colors are defined by numbers representing the value of red, green, and blue for the region. This image is never seen by the user. You must also supply a Coordinates value to indicate the top-left corner position of this image relative to the Background image.
SeekThumb Defines an image that you will use in conjunction with a trackbar to indicate the current position in the media item. For example, if a song is half finished playing, the SeekThumb image is displayed in the middle of the trackbar. By tapping and dragging the SeekThumb image, the user can restart the media item at any position, which is called seeking. The image of the trackbar itself is defined in the Background image. The SeekThumb image is not included in the Bitmaps section of the skin definition file, but is specified as part of the trackbar definition in the TrackBars section.
Super Defines the Disabled image for a trackbar. It can also contain alternate images for the mute button.
VolumeThumb Defines an image to use in conjunction with a trackbar to indicate the volume position. By tapping and dragging the VolumeThumb image, the user can change the volume level. The image of the trackbar itself is defined in the Background image. The VolumeThumb image is not included in the Bitmaps section of the skin definition file, but is specified as part of the trackbar definition in the TrackBars section.

Note Region and Super bitmap types are deprecated in skins for Windows Media Player 10 Mobile or later.

Note that the file name and the file type are not necessarily the same. You can call the Pushed file anything you like, but it is still referred to in other places as Pushed. For example, in the Buttons section, you will have an item such as:

  

This refers to the type of the file, not the file name.

See Also

Previous Next