Getdisplaydata - Roku M1000 Software Manual

GetDisplayData

Syntax:
GetDisplayData
Classification:
Synchronous
Result Type:
Returns textual data when the display is in
character mode, returns binary image data when
the display is in bitmap mode
Responses:
No responses
Example (character mode display):
GetDisplayData
GetDisplayData: New software 2.6.7 is available
GetDisplayData: Perform upgrade?
Example (bitmap mode display):
GetDisplayData
GetDisplayData: data bytes: 1120
000000000000000003c0000003c0000003c0000003c00000
8383818b777f68686e6375747e66666e5956506a647b7f79
... (omitted) ...
2999c9a9896939b858189727f647274747b6c657a7c7f718
2878d859f9ba9abada0b7bab0c2cbbea7a3a9a8a7a4af9d9
e9f95a2a4a5a3a9aea0baa3a2a3aba3b8a9989f9ba
GetDisplayData returns the current contents of the RCP host-generated display.
When the RCP host is a SoundBridge unit with its own display, the data returned
is an exact copy of the current contents of the display. When the RCP host is a
WMM, the data returned is the data contained in the current virtual display.
Currently, this data represents a virtual character mode display consisting of 2
lines of 40 characters.
NOTE: The SoundBridge M500 currently does not support this command.
ISSUE:
There is no current way via RCP to determine the format of the data returned by
GetDisplayData without just calling it and dynamically sensing the data return
type. As an alternative, applications can connect to the unit's shell console (via a
telnet/TCP connection to port 4444) and call the 'displaytype' shell command.
The following table indicates the types and dimensions of each type based on the
return value of the displaytype shell command:
Copyright© 2006 Roku, LLC Page 110
Yes > No <
www.rokulabs.com