
XML Based Customizable Screen
www.grandstream.com
Root Element “Screen”
The XML document has root element called Screen; it contains exactly 1 sub-element
called
IdleScreen.
<xsd:element name="Screen">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="IdleScreen" type="IdleScreenType"
minOccurs="1" maxOccurs="1"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
Element “IdleScreenType”
This element defines three components that are makes up the idle screen. These
components are defined as elements.
<xsd:complexType name="IdleScreenType">
<xsd:sequence>
<xsd:element name="ShowStatusLine" type="xsd:boolean"
minOccurs="1" maxOccurs="1" default="true"/>
<xsd:element name="DisplayBitmap" type="DisplayBitmapType"
minOccurs="0" nillable="true"/>
<xsd:element name="DisplayString" type="DisplayStringType"
minOccurs="0" nillable="true"/>
</
xsd:sequence>
</xsd:complexType>
Note: By the above grammar,
ShowStatusLine must appear exactly once and any
number of
DisplayBitmap and DisplayString instances.
Display Rules
When both DisplayBitmap and DisplayString elements are present, all bitmaps will
be rendered before the strings are displayed. When multiple instances of the same
type (bitmap/string) are present, they are displayed in the order they appear in the
XML and later objects (bitmap/string) may overwrite/corrupt previous objects.
Element “ShowStatusLine”
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.