Region Files

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Region files are required if you use any type of hit button (2PushHit, PushHit, or ToggleHit).

Region files are used to define areas that will respond to a tap, also known as a hit, on a specific button. For each hit button, an area in the Region bitmap is given a specific Web color (such as #FF0000, which is the value for solid red). The color number is specified in the region button definition. When the user displays the skin, the button image is superimposed onto the background using the coordinates of the area in the Region bitmap.

For example, you could draw a red circle in a location corresponding to the location of the Next button and color it solid red (#FF0000). Then in the button definition, you could assign a hit RGB value of 255,0,0 (which is the RGB equivalent of #FF0000). In this case, the Next button would only respond to taps (hits) inside the red circle.

Hit buttons are used when you want to define shapes other than rectangles. You must still define the coordinates for each button so that secondary images such as Pushed and Disabled can be located correctly. In practice, each button is bounded by a rectangle, and these imaginary boundary rectangles must not overlap.

Note

Region art files are not needed in Windows Media Player 10 Mobile skins because button types are not supported in Windows Media Player 10 Mobile or later.

 

The following image is a typical Region file.

This file defines the parts of the skin for each hit-type button. Each color will be identified by its color number in the Buttons section of the skin definition file.

Related topics

Art Files