Grandstream GXP21xx XML Application Guide - Manual (Page 22)

FIRMWARE VERSION 1.0.4.23 GXP21xx XML APPLICATION GUIDE Page 22 of 36
This element is to display a bitmap picture on the screen. Inside the tag of the XML document,
the picture must be encoded in base64 format already. There are plenty of base64 encoder online
provided for encoding the .bmp picture. Please make sure the original .bmp picture is in monochrome grey
level 8 before encoding.
ELEMENET DETAILS
Object Position Type Values Comments
DisplayBitmap Element Optional -
isfile Attribute Optional "true"/
"false"
"true": to display the picture
embedded in the firmware.
Users won't be able to directly
use it for customized pictures.
"false": to display the picture
customized in tag.
Default value is "false".
isflash Attribute Optional "true"/
"false"
Default value is "false"
X Child element Mandatory int Displays the picture from X
Y Child element Mandatory int Displays the picture from Y
Bitmap Child element Mandatory string The base-64 encoded .bmp file
To create .bmp and display it on the phone:
• Firstly, make sure the picture is in .bmp format and not exceed the LCD size of the phone.
GXP21xx support .bmp file with monochrome grey level 8 to be displayed.
• Use a base-64 encoder to encode the picture. Users shall find base64 encoders online.
• Copy and paste and encoded result inside tag.
Example:
true/false " isflash=” true/false ”>
Bitmap file encoded in base64 format
X location
Y location