List.xml file defines an XML object that contains a list of background images.
The List.xml file is stored in the following subdirectory on the TFTP server:
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.
information, see the documentation for your particular Cisco Unified Communications Manager release.
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:
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.
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.
<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"/>
The 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.
background image requires two PNG files:
image: Version that appears on the on the phone.
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.
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
files for background images must meet the following requirements for proper
display on the phone:
If you are using
a graphics program that supports a posterize feature for grayscale, set the
number of tonal levels per channel to 16, and the image posterizes to 16 shades