Allied Motion Spectrum Controls 2706-P22-SC User Manual page 121

InViewCtrl Methods
ClearBitmapTable
This method is only
recognized by the P9x series of
displays.
DownloadBitmaps
This method is only
recognized by the P9x series of
displays.
Chapter 5: InView Control and InView Control API
Properties Description
Syntax HRESULT ClearBitmapTable()
Parameters None
Return Value S_OK - Success
E_FAIL - Failure
Description This method is used to clear the contents of the
display's bitmap table. The clear bitmap table
command will be sent to the display address set by
the DisplayAddress property. DisplayAddress
should be set before calling this method.
Example ClearBitmapTable()
Clears the bitmap table for the display with the
display address set through the DisplayAddress
property.
Syntax HRESULT DownloadBitmaps
(short nBitmapCount, BSTR bstrBitmaps)
Parameters 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 0×07FF)
WWW = the bitmap width (0 to 0×020)
HH = the bitmap height (0 to 0×20)
[bitmap definition] = the bitmap information,
where each row of the bitmap is compressed into a
series of bytes. For example, a 24 × 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.
User's Manual 0300277-03 Rev. A
5-17