RIGOL Chapter 2 Command System
2-30 DS1000Z Programming Guide
:DISPlay:DATA?
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 is as follows.
Component
Size
Example Explanation
TMC
Blockheader
N
[1]
+2 #9001152054
TMC Blockheader ::= #NXXXXXX 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 denote 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
TMC
Blockheader
800*480*3+
54=1152054
[2]
BM… Specific bitmap data.
Note
[1]
: N is the width used to describe the data length in the TMC header. For example,
#90000.
Note
[2]
: The width is 800, the height is 480, the bit depth is 24 bit = 3 byte, 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 the TMC data header which should be removed 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.