Keysight Technologies InfiniiVision 4000 X Series

412 Keysight InfiniiVision 4000 X-Series Oscilloscopes Programmer's Guide
16 :DISPlay Commands
:DISPlay:DATA
(see page 1610)
Query Syntax
:DISPlay:DATA? [<format>][,<palette>]
<format> ::= {BMP | BMP8bit | PNG}
<palette> ::= {COLor | GRAYscale}
The :DISPlay:DATA? query reads screen image data. You can choose 24-bit BMP,
8-bit BMP8bit, or 24-bit PNG formats in color or grayscale.
Note that the returned image is also affected by the :HARDcopy:INKSaver
command, which is ON by default and returns an inverted image. To get a
non-inverted image, send the ":HARDcopy:INKSaver OFF" command before the
DATA? query.
If no format or palette option is specified, the screen image is returned in whatever
image format is selected by the front panel's [Save/Recall] > Save > Format softkey. If
the Format softkey does not select an image format (in other words, it selects a
setup or data format), the BMP, COLor format is used.
Screen image data is returned in the IEEE-488.2 # binary block data format.
Return Format
<display data><NL>
<display data> ::= binary block data in IEEE-488.2 # format.
See Also • "Introduction to :DISPlay Commands" on page 403
• ":HARDcopy:INKSaver" on page 510
• ":HCOPY:SDUMp:DATA" on page 521
• ":HCOPY:SDUMp:FORMat" on page 522
• ":PRINt" on page 290
• "*RCL (Recall)" on page 243
• "*SAV (Save)" on page 247
• ":VIEW" on page 297
Example Code
' IMAGE_TRANSFER - In this example, we will query for the image data
' with ":DISPlay:DATA?", read the data, and then save it to a file.
Dim byteData() As Byte
myScope.IO.Timeout = 15000
myScope.WriteString ":DISPlay:DATA? BMP, COLOR"
byteData = myScope.ReadIEEEBlock(BinaryType_UI1)
' Output display data to a file:
strPath = "c:\scope\data\screen.bmp"
' Remove file if it exists.
If Len(Dir(strPath)) Then
Kill strPath
End If
Close #1 ' If #1 is open, close it.