RIGOL 2 Command System
2-102 DS2000E Programming Guide
:DISPlay:DATA?
Syntax
:DISPlay:DATA?
Description
Read the bitmap data stream of the image currently displayed.
Explanation
The command is sent from the PC to the instrument through the VISA interface. The instrument responds
to the command, and directly returns the bitmap data stream of the image currently displayed to the
buffer area of the PC.
Return Format
Th format of the bitmap data stream:
Component TMC Blockheader BMP Data
Size (length) N
+2 800 x 480 x 3 + 54 = 1152054
Example #9001152054 BM...
Explanation
TMC Blockheader ::= #NX…X is used to describe
the length of the data stream. Wherein, # is the
start denoter of the data stream; N is less than or
equal to 9 and the N figures following it denotes
the length of the data stream in bytes. For
example, #9001152054; wherein, N is 9 and
001152054 denotes that the data stream contains
1152054 bytes of effective data.
Specific bitmap data.
Note
[1]
: N is the width used to describe the data length in the TMC header. For example, #9001152054.
Note
[2]
: The width is 800, the height is 480, the bit depth is 24Bit=3Byte, 54 is the size of the bitmap file header.
Example
1. Make sure that the buffer is large enough to receive the data stream; otherwise the program might
be abnormal when reading the data stream.
2. The returned data stream contains TMC data header, and you need to remove the data header to
make the data stream a standard bitmap data stream.
3. When the data size is larger than 1 M, and the communication speed of the interface is not fast
enough, you need to set an appropriate timeout time
4. The terminator '\n'(0X0A) at the end of the data should be removed.