Specifications

3-11
Cisco Unified IP Phone Services Application Development Notes
OL-22505-01
Chapter 3 CiscoIPPhone XML Objects
XML Object Definitions
Figure 3-6 CiscoIPPhoneImage Object with WindowMode Wide
CiscoIPPhoneImageFile
The latest generation of Cisco Unified IP Phones have higher-resolution displays with more color depth.
The Cisco
Unified IP Phone 7970G, for example, has a display area of 298x168 pixels available to the
Services pane and renders images in 12-bit color.
To support these more advanced displays, a new XML object allows the use of color PNG images in
addition to the grayscale
CiscoIPPhoneImage objects. The CiscoIPPhoneImageFile object behaves like
the
CiscoIPPhoneImage object, except for the image data. Instead of using the <Data> tag to embed the
image data, the
<URL> tag points to the PNG image file.
Definition
<CiscoIPPhoneImageFile WindowMode="Width Mode of XSI window">
<Title>Image Title goes here</Title>
<Prompt>Prompt text goes here</Prompt>
<LocationX>Horizontal position of graphic</LocationX>
<LocationY>Vertical position of graphic</LocationY>
<URL>Points to the PNG image</URL>
</CiscoIPPhoneImageFile>
For the description on WindowMode attribute see CiscoIPPhoneImage, page 3-7.
For examples on the use of the WindowMode attribute, see Example, page 3-12.
The web server must deliver the PNG image to the phone with an appropriate MIME Content-Type
header, such as image/png, so the phone recognizes the content as a compressed, binary PNG image. The
PNG image can be either palettized or RGB, and the maximum image size and color depth are model
dependent (see
Table 3-2).
Table 3-2 Cisco Unified IP Phones Display Image Sizes and Color Depths
Model
Resolution
1
(width x height)
Resolution in
Wide Mode
(width x height)
Color/Grayscale
/Monochrome
Color Depth (bits)
Cisco Unified IP Phones 7905G, 7906G,
7911G, 7912G
2
, 7931G
N/A N/A Grayscale 1
Cisco Unified IP Phone [phone] x 59 N/A Grayscale 1
Cisco Unified IP Phone 7921G, 7925G,
7926G, 7925G-EX
176 x 140 N/A Color 16