Display:data - Rigol DS1000Z Series Programming Manual

RIGOL

: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 Th format of the bitmap data stream is as follows.
Format
Component
TMC
Blockheader
TMC
Blockheader
Note
#90000.
Note
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.
2-30
Size
(length)
[1]
N +2
800*480*3+
54=1152054
[2]
[1]
: N is the width used to describe the data length in the TMC header. For example,
[2]
: The width is 800, the height is 480, the bit depth is 24 bit = 3 byte, 54 is the size
Example Explanation
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
#9001152054 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
effective data.
BM... Specific bitmap data.
Chapter 2 Command System
DS1000Z Programming Guide