If you are manually creating the directory structure and the List.xml file, you must ensure that the directories
and files can be accessed by the user\CCMService, which is used by the TFTP service.
Tip
For more information, see the
“
Software Upgrades
”
chapter in
Cisco Unified Communications Operating
System Administration Guide
.
The List.xml file can include up to 50 background images. The images are in the order that they appear in the
Background Images menu on the phone. For each image, the List.xml file contains one element type, called
ImageItem. The ImageItem element includes these two attributes:
•
Image: Uniform resource identifier (URI) that specifies where the phone obtains the thumbnail image
that appears on the Background Images menu on a phone.
•
URL: URI that specifies where the phone obtains the full-size image.
The following example shows a List.xml file that defines two images. The required Image and URL attributes
must be included for each image. The TFTP URI that is shown in the example is the only supported method
for linking to full-size and thumbnail images. HTTP URL support is not provided.
List.xml Example
<CiscoIPPhoneImageList>
<ImageItem Image="TFTP:Desktops/640x480x24/TN-Fountain.png"
URL="TFTP:Desktops/640x480x24/Fountain.png"/>
<ImageItem Image="TFTP:Desktops/640x480x24/TN-FullMoon.png"
URL="TFTP:Desktops/640x480x24/FullMoon.png"/>
</CiscoIPPhoneImageList>
The Cisco Unified IP Phone firmware includes a default background image. The List.xml file does not define
this image. The default image is always the first image that appears in the Background Images menu on the
phone.
PNG File Requirements for Custom Background Images
Each background image requires two PNG files:
•
Full size image - Version that appears on the on the phone.
•
Thumbnail image - Version that displays on the Background Images screen from which users can select
an image. Must be 25% of the size of the full-size image.
Many graphics programs provide a feature that resizes a graphic. An easy way to create a thumbnail image
is to first create and save the full-size image, then use the sizing feature in the graphics program to create
a version of that image that is 25% of the original size. Save the thumbnail version by using a different
name.
Tip
The PNG files for background images must meet the following requirements for proper display on the Cisco
Unified IP Phone:
•
Full size image - 640 pixels (width) X 480 pixels (height).
•
Thumbnail image - 123 pixels (width) X 111 pixels (height).
Cisco Unified IP Phone 8961, 9951, and 9971 Administration Guide for Cisco Unified Communications Manager 10.0
(SIP)
215
Cisco Unified IP Phone Customization
PNG File Requirements for Custom Background Images
REVIEW DRAFT - CISCO CONFIDENTIAL
