Grandstream Networks, Inc.
XML Application Guide
Page 13 of 24
Last Updated: 3/2009
E
LEMENT
“S
HOW
S
TATUS
L
INE
”
This Boolean element decides if we will display the status bar on the top of the screen. The “Status Line”
includes the registration status icon, volume icon, time/date on the right-top corner, and the horizontal
separator line.
This element must appear exactly once in
IdleScreenType
and has a default value of “true”.
When set to false, the origin (x-0, y-0) refers to the absolute top-left corner; when set to true, the origin
refers to the reference-origin below status line (x-0,y-16). This means when
ShowStatusLine
is set to true,
all y-offsets are shift down for 16 pixels so the status line will not be corrupted or over-written.
NOTE:
Boolean variables have 2 possible values only: “true” and “false”
E
LEMENT
D
ISPLAY
B
ITMAP
This element carries the information on how a bitmap is to be rendered on screen. It has three mandatory
elements and one optional attribute:
Element Bitmap
This element contains the bitmap encoded by base64
<
xsd:element
name
=
"
Bitmap
"
type
=
"
xsd:base64Binary
"
minOccurs
=
"
1
"
maxOccurs
=
"
1
"
/>
Note
:
We only accept Windows Bitmap (file header begins with 0x424D) that is monochrome (1-bit depth)
and not exceeding 130x65 pixels (that’s our LCD resolution). Anything not bound to the above restriction is
dropped and ignored. You may use Windows Paint to change an existing BMP file to 1-bit depth.
Elements X and Y
This element contains X and Y offsets from the origin that we will use to render the bitmap.
<
xsd:element
name
=
"
X
"
type
=
"
xsd:integer
"
minOccurs
=
"
1
"
maxOccurs
=
"
1
"
default
=
"
0
"
/>
<
xsd:element
name
=
"
Y
"
type
=
"
xsd:integer
"
minOccurs
=
"
1
"
maxOccurs
=
"
1
"
default
=
"
0
"
/>
Attribute a1reg
This OPTIONAL attribute specifies the conditions when the bitmap will be displayed.
<
xsd:attribute
name
=
"
a1reg
"
type
=
"
xsd:boolean
"
/>
When this attribute is present and the value is “true” then the bitmap will be displayed ONLY when SIP
Account 1 is in REGISTERED state.
When this attribute is present and the value is “false” then the bitmap will be displayed only when SIP
Account 1 is NOT in REGISTERED state.
Note:
When this attribute is absent then this bitmap is displayed regardless to the SIP Account 1 registration
states.
NOTE:
Boolean variables have 2 possible values only: “true” and “false”; any other value such as “Yes” or
“No” will result in the bitmap displayed regardless of the SIP Account 1 registration status
E
LEMENT
D
ISPLAY
S
TRING
This element carries the information on how a string is to be rendered on screen. It has three mandatory
elements and four optional attributes:
Element DisplayStr
This element contains the string to be displayed
<
xsd:element
name
=
"
DisplayStr
"
type
=
"
xsd:string
"
minOccurs
=
"
1
"
maxOccurs
=
"
1
"
/>
