Controls printing of the analyzer screen and optional data to a printer or a file.
HCOPy: ITEM | AWINdow | CTABle | GPFail | LOGO | MKRData | PNUMber | SEGData | SWINdow | TIME | TTABle | WINDows PAGE | DIMension | LLEFt | URIGht | SIZE SDUMP | DATA? | FORMat |
Click on a keyword to view the command details.
Blue commands are superseded or obsolete.
See Also
Example Programs
Applicable Models: All (Read-Write) Sets the default printer and selects as the current printer. Use HCOPy:PRINters? to return a list of locally installed printers. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<string> |
Name of the printer to become the default. |
Examples |
HCOP:DPR "MyPrinter" hcopy:dprinter "YourPrinter" |
Query Syntax |
HCOPy:DPRinter? |
Return Type |
String |
Not Applicable |
Applicable Models: All (Write-only) Saves the screen image to a file. The image does NOT include the optional print data invoked by many HCOPy commands. |
|
Parameters |
|
<filename> |
Name of the file to save the screen to. The file is saved to the current working directory unless a valid full path name is specified. Use one of the following suffixes: .bmp - not recommended due to large file size .jpg - not recommended due to poor quality .png - recommended |
Examples |
HCOPY:FILE "myFile.png" hcopy:file "c:/data/myfile.png" |
Query Syntax |
Not Applicable |
Not Applicable |
Applicable Models: All (Write-only) Prints the screen to the default printer. |
|
Examples |
HCOP |
Query Syntax |
Not applicable |
Not Applicable |
Applicable Models: All (Read-Write) When ON, prints only the Active window. When OFF, prints all windows. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<bool> |
Active window state. Chose from: OFF or (0) - Print ALL windows. ON or (1) - Print Active window only. |
Examples |
HCOP:ITEM:AWIN 1 hcopy:item:awindow:state off |
Query Syntax |
HCOPy:ITEM:AWINdow[:STATe]? |
Return Type |
Boolean |
OFF (0) |
Applicable Models: All (Read-Write) When ON, prints the channel settings table. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<bool> |
Channel table print state. Chose from: OFF or (0) - Does NOT print the channel settings table. ON or (1) - Prints channel settings table. |
Examples |
HCOP:ITEM:CTAB 1 hcopy:item:ctable:state off |
Query Syntax |
HCOPy:ITEM:CTABle[:STATe]? |
Return Type |
Boolean |
OFF (0) |
Applicable Models: All (Read-Write) When ON, prints the Global Pass/Fail status in the page header. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<bool> |
Pass / Fail print state. Chose from: OFF or (0) - Does NOT print Pass / Fail status. ON or (1) - Print Pass / Fail status |
Examples |
HCOP:ITEM:GPF 1 hcopy:item:gpfail:state off |
Query Syntax |
HCOPy:ITEM:GPFail[:STATe]? |
Return Type |
Boolean |
OFF (0) |
Applicable Models: All (Read-Write) When ON, prints the Keysight Technologies logo in the page header. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<bool> |
Keysight logo print state. Chose from: OFF or (0) - Prints the Keysight logo. ON or (1) - Does NOT print the Keysight logo. |
Examples |
HCOP:ITEM:LOGO 1 hcopy:item:logo:state off |
Query Syntax |
HCOPy:ITEM:LOGO[:STATe]? |
Return Type |
Boolean |
OFF (0) |
Applicable Models: All (Read-Write) When ON, includes marker data as part of the trace attributes table. To print marker data, HCOP:ITEM:TTABle must also be set to ON. This setting does not affect the limited marker readout data that can be displayed in the measurement window. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<bool> |
Marker data print state. Chose from: OFF or (0) - Does NOT print Marker data. ON or (1) - Print Marker data. |
Examples |
HCOP:ITEM:MKRD 1 hcopy:item:mkrdata:state off |
Query Syntax |
HCOPy:ITEM:MKRData[:STATe]? |
Return Type |
Boolean |
OFF (0) |
Applicable Models: All (Read-Write) When ON, prints page numbers (1 of n) in the header at the top of each page. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<bool> |
Page number print state. Chose from: OFF or (0) - Does NOT print page numbers. ON or (1) - Print page numbers. |
Examples |
HCOP:ITEM:PNUM 1 hcopy:item:pnumber:state off |
Query Syntax |
HCOPy:ITEM:PNUMber[:STATe]? |
Return Type |
Boolean |
OFF (0) |
Applicable Models: All (Read-Write) When ON, prints a single measurement window per page. When OFF, prints up to four measurement windows per page. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<bool> |
Single window print state. Chose from: OFF or (0) - Print up to four windows per page. ON or (1) - Print only one window per page. |
Examples |
HCOP:ITEM:SWIN 1 hcopy:item:swindow:state off |
Query Syntax |
HCOPy:ITEM:SWINdow[:STATe]? |
Return Type |
Boolean |
OFF (0) |
Applicable Models: All (Read-Write) When ON, prints the VNA computer date and time in the header. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<bool> |
Time stamp print state. Chose from: OFF or (0) - Does NOT print time stamp. ON or (1) - Print time stamp. |
Examples |
HCOP:ITEM:TIME 1 hcopy:item:time:state off |
Query Syntax |
HCOPy:ITEM:TIME:[STATe]? |
Return Type |
Boolean |
OFF (0) |
Applicable Models: All (Read-Write) When ON, prints the trace attributes table. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<bool> |
Trace attributes table print state. Chose from: OFF or (0) - Does NOT print the trace attributes table. ON or (1) - Print the trace attributes table. |
Examples |
HCOP:ITEM:TTABle 1 hcopy:item:ttable:state off |
Query Syntax |
HCOPy:ITEM:TTABle[:STATe]? |
Return Type |
Boolean |
OFF (0) |
Applicable Models: All (Read-Write) Sets the vertical amount of a page that is filled by the measurement windows. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<value> |
Window size as a fraction of the page. Chose a value from .4 (40%) to 1.0 (100%) |
Examples |
HCOP:ITEM:WFR .8 hcopy:item:wfraction .5 |
Query Syntax |
HCOPy:ITEM:WFRaction? |
Return Type |
Numeric |
.4 |
Applicable Models: All (Read-Write) When ON, prints measurement windows. Use HCOPy:ITEM:AWINdow to specify all windows or only the active window. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<bool> |
Windows print state. Chose from: OFF or (0) - Does not print measurement windows. ON or (1) - Print measurement windows. |
Examples |
HCOP:ITEM:WIND 1 hcopy:item:windows:state off |
Query Syntax |
HCOPy:ITEM:WINDows[:STATe]? |
Return Type |
Boolean |
OFF (0) |
Applicable Models: All (Read-Write) Sets the left and lower page margins. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<left> |
Left page margin as a percentage of entire page width. Value must be between 0 and 1. |
<lower> |
Lower page margin as a percentage of entire page length. Value must be between 0 and 1. |
Examples |
HCOP:PAGE:DIM:LLEF .10,.10 hcopy:page:dimensions:lleft .5,.7 |
Query Syntax |
HCOPy:PAGE:DIMensions:LLEFt? |
Return Type |
Numeric, Numeric |
Depends on selected page size |
Applicable Models: All (Read-Write) Sets the right and upper page margins. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<right> |
Right page margin as a percentage of entire page width. Value must be between 0 and 1. |
<upper> |
Upper page margin as a percentage of entire page length. Value must be between 0 and 1. |
Examples |
HCOP:PAGE:DIM:URIG .10,.10 hcopy:page:dimensions:uright .5,.7 |
Query Syntax |
HCOPy:PAGE:DIMensions:URIGht? |
Return Type |
Numeric, Numeric |
Depends on selected page size |
Applicable Models: All (Read-Write) Sets the page orientation. This setting survives instrument preset and analyzer application restart. |
|
Parameters |
|
<char> |
Choose from:
|
Examples |
HCOP:PAGE:ORI PORT hcopy:page:orientation landscape |
Query Syntax |
HCOPy:PAGE:ORIentation? |
Return Type |
Character |
PORTrait |
Applicable Models: (Read-Write) Sets the paper type, which implies the page size. This setting survives instrument preset and analyzer application restart. |
|||||||||||||||||||||||||||||
Parameters |
|
||||||||||||||||||||||||||||
<int> |
Choose from:I
For more paper type choices, see Microsoft's "wingdi.h" file, which can be downloaded as part of the Platform SDK. |
||||||||||||||||||||||||||||
Examples |
HCOP:PAGE:SIZE 2 hcopy:page:size 5 |
||||||||||||||||||||||||||||
Query Syntax |
HCOPy:PAGE:SIZE? |
||||||||||||||||||||||||||||
Return Type |
Integer |
||||||||||||||||||||||||||||
1 |
Applicable Models: All (Read-only) Returns the display image in a definite-length arbitrary binary block. The format of the data is PNG by default. Use HCOP:SDUMp:DATA:FORMat to change the format. This command is equivalent to saving an image to the analyzer (HCOPy:FILE) and then using MMEM:TRAN to transfer the file to the computer. |
|
Examples |
HCOP:SDUM? hcopy:sdump? |
Return Type |
A definite-length arbitrary binary block |
Not Applicable |
Applicable Models: All (Read-Write) Sets the graphic format for HCOPy:SDUMp:DATA? |
|
Parameters |
|
<char> |
Choose from: JPG | BMP | PNG |
Examples |
HCOP:SDUMp:DATA:FORMat BMP |
Query Syntax |
HCOPy:SDUMp:DATA:FORMat? |
Return Type |
Character |
PNG |
Applicable Models: All (Read-only) Returns a comma-separated list of printers installed on the VNA. Select a printer using HCOPy:DPRinter. This setting survives instrument preset and analyzer application restart. |
|
Examples |
HCOP:PRIN? hcopy:printers? |
Query Syntax |
HCOPy:PRINters? |
Return Type |
String |
Not Applicable |