Image Element (WMP SDK)
[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.]
Note
This section describes functionality designed for use by online stores. Use of this functionality outside the context of an online store is not supported.
The Image element specifies the images that Windows Media Player displays to the user to represent the online store.
<Image
EulaURL = "URL"
MenuURL = "URL"
ServiceLargeURL = "URL"
ServiceSmallURL = "URL"
/>
Attributes
-
EulaURL (required for type 1 stores, ignored for type 2)
-
URL for the logo that Windows Media Player displays in the end user license agreement (EULA) dialog box. This must be a PNG image that is 80 x 80 pixels.
-
MenuURL (optional)
-
URL for the image that Windows Media Player displays on the services menu. This image must be 15 x 15 pixels.
-
ServiceLargeURL (optional)
-
For a type 1 online store, this is the URL for the image that Windows Media Player displays on the Online Stores tab. For Windows Media Player 11, this image must be 45 pixels wide by 13 pixels high. For Windows Media Player 12, this image must be 45 pixels wide by 30 pixels high. To support both versions 11 and 12 of Windows Media Player, you must provide two separate ServiceInfo.xml documents, each of which points to the appropriately sized image for ServiceLargeURL.
For a type 2 online store, this is the URL for the image that Windows Media Player displays beside the Online Stores tab or beside the task pane buttons. This image must be 30 x 30 pixels.
-
ServiceSmallURL (optional)
-
URL for the logo that is displayed along with the marketing description specified in the Description element. If it is not supplied, it will be blank. (All types, optional) This must be a PNG image that is 45 pixels wide and 13 pixels high.
Parent/Child Elements
| Hierarchy | Element |
|---|---|
| Parent elements | ServiceInfo |
| Child elements | None |
Remarks
The supported image formats are .gif, .jpg, .bmp, and .png (which is the recommended format). Using Web transparency is both supported and recommended. Animated GIF files are not supported.
If you do not supply a value for MenuURL, Windows Media Player displays no graphic on the menu for your online store.
You can provide an animated image for ServiceLargeURL. In Windows Media Player 10 or 11, the image is animated. In Windows Media Player 12, only the first frame of the image is displayed. To provide an animated image, create a single image file that contains successive frames of your animation. For example, for an image that is 30 pixels wide and 30 pixels high, you could supply 20 successive images side by side in an image that is 600 pixels wide and 30 pixels high. Windows Media Player would automatically animate such an image by showing the 20 individual images one after another. This animation occurs only once when the online store opens; it does not repeat.
Requirements
| Requirement | Value |
|---|---|
| Version |
Windows Media Player 10 or later |