Display

Topics...

Purpose

Provide a simple, generic schema for display of notification messages. Note that this schema should be rarely used; the preferred method for display of notification messages is for displays to listen for, and extract notifications from passing messages rather than rely on applications specifically targeting a given display. This approach facilitates loose coupling of displays with other devices.

TiVo On-Screen Display

xap-header
{
v=12
hop=1
uid=FF123400
class=osd.notification
source=acme.my.controller
target=*.osd.*
}
display
{
text=Hello from xAP
}

Generic Display

xap-header
{
v=12
hop=1
uid=FF123400
class=lcd.display
source=acme.my.controller
target=*.display.*
}
display
{
text=Now is the time!
attribute={flash,ss|bold|scroll}
duration=ss
region=x,y,x,y
}

Where attribute specifies the styling of the text - flash for n seconds, and then resume normal display, use bold face or scroll the text.
duration specifies how long the text is displayed for in seconds. 0 (or omitted duration) indicates indefinitely.
region indicates where on the screen the text is displayed using cartesian co-ordinates for top left and bottom right hand corners of the display rectangle region. Text should be wrapped to fit the region. By convention the top left corner of the screen has co-ordinates (1,1)

Related...