Agilent Technologies InfiniiVision 3000 X-Series Programmer's Manual page 304

13
:DISPlay Commands
:DISPlay:DATA
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.
If no format or palette option is specified, the screen image is returned in
BMP, COLor format.
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
•
•
•
•
•
•
Example Code
or output.
See complete example programs at:
starting on page 1147
304
(see page 1138)
"Introduction to :DISPlay Commands"
":HARDcopy:INKSaver"
":PRINt" on page 215
"*RCL (Recall)" on page 175
"*SAV (Save)" on page 179
":VIEW" on page 225
' 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.
Open strPath For Binary Access Write Lock Write As #1
Put #1, , byteData
Close #1 ' Close file.
myScope.IO.Timeout = 5000
Agilent InfiniiVision 3000 X-Series Oscilloscopes Programmer's Guide
on page 298
on page 363
' Write data.
Chapter 40, "Programming Examples,"
' Open file f