User manual

Part 6: IEEE 488.2 Command Reference
HARDCOPY Commands and Queries
HARDCOPY_SETUP, HCSU
Description
The HARDCOPY_SETUP command specifies the device type and transmission mode of the instrument's
print driver. This can be the instrument clipboard, hard drive or email, as well as a printer.
One or more individual settings can be changed by specifying the appropriate keywords, together with the
new values. If you send contradictory values within a command, the result is governed by the last one
sent.
The HARDCOPY_SETUP query returns the oscilloscope's current print settings.
Command Syntax
HARDCOPY_SETUP DEV,<device>,FORMAT,<format>,BCKG,<bckg>,
DEST,<destination>,DIR,"<directory>",AREA,<hardcopyarea>
[,FILE,"<filename>",PRINTER,"<printername>",PORT,<portname>]
<device>:= {BMP, JPEG, PNG, TIFF}
<format>:= {PORTRAIT, LANDSCAPE}
<bckg>:= {BLACK, WHITE}
<destination>:= {PRINTER, CLIPBOARD, EMAIL, FILE, REMOTE}
<area>:= {GRIDAREAONLY, DSOWINDOW, FULLSCREEN}
<directory>:= legal DOS path, for FILE mode only
<filename>:= filename string, no extension, for FILE mode only
<printername>:= valid printer name, for PRINTER mode only
<portname>:= {GPIB, NET}
Hardcopy command parameters are grouped in pairs. The first in the pair names the variable to be
modified, while the second gives the new value to be assigned. Pairs can be given in any order and can be
restricted to those variables to be changed. Omitted variables remain unaffected.
The <device> types PSD and BMPCOMP are not supported on MAUI oscilloscopes.
Strings representing the names of directories, files, or printers that may contain spaces and other non-
alphanumeric characters must be enclosed in quotes.
An autoincremented number is appended to the <filename> string with each successive capture.
The <portname> is included for backward compatibility and sets DEST, REMOTE regardless of what else is
specified in the HCSU command.
6-101