Rockwell Automation 2706-P42_P43_P44_P72_P74_P92_P94 InView Marquee Message Display User Manual - Manual (Page 134)

Publication 2706-UM016D-EN-P - March 2006
5-16 InView Control and InView Control API
DownloadBitmaps
This method is only recognized by the P9x
series of displays.
Syntax HRESULT DownloadBitmaps
(short nBitmapCount, BSTR bstrBitmaps)
Parameters nBitmapCount
The number of bitmaps that will be included
in the bstrBitmaps string. The maximum that
can be downloaded is 2048.
bstrBitmaps
A string that contains the contents of each
bitmap that will be downloaded
concatenated together. The format of a
single bitmap string is as follows:
OOOOWWWHH[bitmap definition]
OOOO = the ASCII hex offset (0 to 0x07FF)
WWW = the bitmap width (0 to 0x020)
HH = the bitmap height (0 to 0x20)
[bitmap definition] = the bitmap information,
where each row of the bitmap is
compressed into a series of bytes. For
example, a 24 x 24 bitmap will have 72
bytes of information (3 bytes for each row
and the last 4 bits of the third byte being
zeroed out because they are not used).
Return Value S_OK - Success
E_FAIL - Failure
Description This method is used to download a range of
bitmaps to a display. The range of bitmaps
to be downloaded is based on the bitmap
count passed into the method and the data
for each bitmap is based on the string
holding the concatenation of bitmap
information. The download bitmaps
command will be sent to the display address
set by the DisplayAddress property.
DisplayAddress should be set before calling
this method.
Methods
InViewCtrl Methods Properties Description