[cisco-voip] background image

Tue Oct 9 18:26:05 EDT 2007

You'll need to configure List.xml. Here's the info I
gleaned from the Googlemaster.

Creating Custom Background Images
You can provide users with a choice of background
images for the LCD screen on
their phones. Users can select a background image by
choosing Settings > User 
Preferences > Background Images on the phone.
The image choices that users see come from PNG images
and an XML file (called 
List.xml) that are stored on the TFTP server used by
the phone. By storing your 
own PNG files and editing the XML file on the TFTP
server, you can designate 
the background images from which users can choose. In
this way, you can provide 
custom images, such as your company logo.Page 5

6-5
Cisco Unified IP Phone Administration Guide for Cisco
Unified CallManager 4.2, Cisco Unified IP Phones
OL-8611-01
Chapter 6 Customizing the Cisco Unified IP Phone
Creating Custom Background Images
The following sections describe how you can customize
the background images 
that are available at your site by creating your own
PNG files and editing the 
List.xml file:
•
List.xml File Format Requirements, page 6-5.
•
PNG File Requirements for Custom Background Images,
page 6-6.
•
Configuring a Custom Background Image, page 6-7
List.xml File Format Requirements
The List.xml file defines an XML object that contains
a list of background images. 
The List.xml file is stored in the following folder on
the TFTP server:
C:\Program Files\Cisco\TFTPPath\Desktops\320x212x12
Tip
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.
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 will appear 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.Page 6

Chapter 6
Customizing the Cisco Unified IP Phone
Creating Custom Background Images
6-6
Cisco Unified IP Phone Administration Guide for Cisco
Unified CallManager 4.2, Cisco Unified IP Phones 
OL-8611-01
List.xml Example
<CiscoIPPhoneImageList>
<ImageItem
Image=”TFTP:Desktops/320x212x12/TN-Fountain.png” 
URL=”TFTP:Desktops/320x212x12/Fountain.png”/> 
<ImageItem
Image=”TFTP:Desktops/320x212x12/TN-FullMoon.png” 
URL=”TFTP:Desktops/320x212x12/FullMoon.png”/> 
</CiscoIPPhoneImageList>
The Cisco Unified IP Phone firmware includes a default
background image. This 
image is not defined in the List.xml file. 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 appears on the Background
Images screen 
from which users can select an image. Must be 25% of
the size of the full size 
image.
Tip
Many graphics programs provide a feature that will
resize 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
using a different name.
The PNG files for background images must meet the
following requirements for
proper display on the Cisco Unified IP Phone:
•
Full size image—320 pixels (width) X 212 pixels
(height). 
•
Thumbnail image—80 pixels (width) X 53 pixels
(height).
•
Color palette—Includes up to 12-bit color (4096
colors). You can use more 
than 12-bit color, but the phone will reduce the color
palette to12-bit before 
displaying the image. For best results, reduce the
color palette of an image to
12-bit when you create a PNG file.Page 7

6-7
Cisco Unified IP Phone Administration Guide for Cisco
Unified CallManager 4.2, Cisco Unified IP Phones
OL-8611-01
Chapter 6 Customizing the Cisco Unified IP Phone
Creating Custom Background Images
Tip
If you are using a graphics program that supports a
posterize feature for 
specifying the number of tonal levels per color
channel, set the number of
tonal levels per channel to 16 (16 red X 16 green X 16
blue = 4096 colors).
Configuring a Custom Background Image
To create custom background images for the Cisco
Unified IP Phone, follow these 
steps:
Procedure
Step 1
Create two PNG files for each image (a full size
version and a thumbnail version). 
Ensure the PNG files comply with the format guidelines
that are listed in the 
“PNG File Requirements for Custom Background Images”
section on page 6-6.
Step 2
Place the new PNG files that you created in the
following folder on the TFTP 
server for each Cisco Unified CallManager in the
cluster:
C:\Program Files\Cisco\TFTPPath\Desktops\320x212x12
Note
Cisco recommends that you also store backup copies of
custom image 
files in another location. You can use these backup
copies if the 
customized files are overwritten when you upgrade 
Cisco Unified CallManager.
Step 3
Use a text editor to edit the List.xml file. See the
“List.xml File Format
Requirements” section on page 6-5 for the location of
this file, formatting 
requirements, and a sample file.
Step 4
Save your modifications and close the List.xml file.
Note
When you upgrade Cisco Unified CallManager, a default
List.xml file
will replace your customized List.xml file. After your
customize the 
List.xml file, make a copy of the file and store it in
another location. After 
upgrading Cisco Unified CallManager, replace the
default List.xml file
with your stored copy.Page 8

Chapter 6
Customizing the Cisco Unified IP Phone
Configuring the Idle Display
6-8
Cisco Unified IP Phone Administration Guide for Cisco
Unified CallManager 4.2, Cisco Unified IP Phones 
OL-8611-01
Step 5
To cache the new List.xml file, stop and start the
TFTP service by using 
Cisco Unified CallManager Serviceability or disable
and re-enable the Enable 
Caching of Constant and Bin Files at Startup TFTP
service parameter (located in
the Advanced Service Parameters

HTH,
Paul

--- Michael Sy <mjdsy9 at gmail.com> wrote:

> Thanks for your reply but this is for a 7941 and
> 7970. In the SDk it seems
> its only for the 7912 . pls advise.
> 
> On 10/9/07, Vince Loschiavo
> <VLoschiavo at data-corporation.com> wrote:
> >
> > -----Original Message-----
> > From: cisco-voip-bounces at puck.nether.net
> > [mailto:cisco-voip-bounces at puck.nether.net] On
> Behalf Of Paul Choi
> > Sent: Tuesday, October 09, 2007 3:47 PM
> > To: Michael Sy; cisco-voip at puck.nether.net
> > Subject: Re: [cisco-voip] background image
> >
> > Background images aren't supported on
> 40s/60s...must
> > have 41s/61s
> >
> > --- Michael Sy <mjdsy9 at gmail.com> wrote:
> >
> > > assistance needed pls in creating and uploading
> the
> > > background image for
> > > 7940 and 7970 phones..ccm 4.2..thanks in advance
> > >
> > > --
> > > Mike
> > > >
> _______________________________________________
> > > cisco-voip mailing list
> > > cisco-voip at puck.nether.net
> > >
> https://puck.nether.net/mailman/listinfo/cisco-voip
> >
> >
> >
> >     That is correct.
> >
> > You need a 7941, 7942, 7945, 7961, 7962, 7965,
> 7970, or 7971  (aka an
> > XML capable phone).
> >
> > However,
> > For the 7940's and 7960's it is possible to use
> the IDLE URL feature to
> > display a low quality image.
> >
> > Check the IP Phone Services SDK from Crisco for
> the application to
> > convert the images to XML format.
> >
> > Or check out
> > http://www.ccmstuff.net/
> > or more how-to's and examples.
> >
> > -Vince
> >
> >
> >
> 
> 
> -- 
> Mike Sy
> 

____________________________________________________________________________________
Take the Internet to Go: Yahoo!Go puts the Internet in your pocket: mail, news, photos & more. 
http://mobile.yahoo.com/go?refer=1GNXIC