Rigol DS1104Z-S Plus Programming Guide

Chapter 2 Command System RIGOL
MSO1000Z/DS1000Z Programming Guide 2-63
:DISPlay:DATA?
Syntax
:DISPlay:DATA? [<color>,<invert>,<format>]
Description
Read the data stream of the image currently displayed on the screen and set the color,
invert display, and format of the image acquired.
Parameter
Name
Type
Range
Default
<color>
Bool
{ON|OFF}
ON
<invert>
Bool
{{1|ON}|{0|OFF}}
0|OFF
<format>
Discrete
{BMP24|BMP8|PNG|JPEG|TIFF}
BMP24
Explanation
 <color>: color of the image; ON denotes color and OFF denotes intensity graded
color.
<invert>: the invert function; 1|ON denotes turning on the invert function and 0|OFF
denotes turning off the invert function.
 When [<color>,<invert>,<format>] is omitted, by default, the image color
(:STORage:IMAGe:COLor) and the status of the invert function
(:STORage:IMAGe:INVERT) currently selected are used and the image format is set
to BMP24.
 The command is sent from the PC to the instrument through the VISA interface. The
instrument responds to the command and directly returns the data stream of the
image currently displayed to the buffer area of the PC.
Return
Format
The format of the data stream is as follows.
Component
Size (length)
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
effective data.
Image Data
(take BMP24
as an
example)
800x480x3+54
=1152054
[2]
BM…
Specific image data.
Note
[1]
: N is the width of the data length in the TMC header. For example, the number "9" behind
"#" in #9001152054.
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 image 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.

Rigol DS1104Z-S Plus Specifications

General

Brand	Rigol
Model	DS1104Z-S Plus
Category	Test Equipment
Language	English