Hardcopy Command
Controls printing of the PNA 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
HCOPy:DPRinter <string>
|
(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 PNA 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 |
|
HCOPy:FILE <filename>
|
(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 |
|
HCOPy[:IMMediate]
|
(Write-only) Prints the screen to the default printer. |
|
|
Examples |
HCOP |
|
Query Syntax |
Not applicable |
|
Not Applicable |
|
HCOPy:ITEM:AWINdow[:STATe] <bool>
|
(Read-Write) When ON, prints only the Active window. When OFF, prints all windows. This setting survives instrument preset and PNA 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) |
|
HCOPy:ITEM:CTABle[:STATe] <bool>
|
(Read-Write) When ON, prints the channel settings table. This setting survives instrument preset and PNA 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) |
|
HCOPy:ITEM:GPFail[:STATe] <bool>
|
(Read-Write) When ON, prints the Global Pass/Fail status in the page header. This setting survives instrument preset and PNA 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) |
|
HCOPy:ITEM:LOGO[:STATe] <bool>
|
(Read-Write) When ON, prints the Keysight Technologies logo in the page header. This setting survives instrument preset and PNA 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) |
|
HCOPy:ITEM:MKRData[:STATe] <bool>
|
(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 PNA 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) |
|
HCOPy:ITEM:PNUMber[:STATe] <bool>
|
(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 PNA 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) |
|
HCOPy:ITEM:SEGData[:STATe] <bool> - Obsolete
|
Note: This command no longer works beginning with A.09.40 (Read-Write) When ON, includes ALL segment data as part of the channel settings table. To print ALL segment data, HCOP:ITEM:CTAB must also be set to ON. This setting survives instrument preset and PNA application restart. |
|
|
Parameters |
|
|
<bool> |
Expanded segment data print state. Chose from: OFF or (0) - Does NOT print expanded segment data, but summary data is printed. ON or (1) - Print expanded segment data. |
|
Examples |
HCOP:ITEM:SEGD 1 hcopy:item:segdata:state off |
|
Query Syntax |
HCOPy:ITEM:SEGData[:STATe]? |
|
Return Type |
Boolean |
|
OFF (0) |
|
HCOPy:ITEM:SWINdow[:STATe] <bool>
|
(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 PNA 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) |
|
HCOPy:ITEM:TIME[:STATe] <bool>
|
(Read-Write) When ON, prints the PNA computer date and time in the header. This setting survives instrument preset and PNA 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) |
|
HCOPy:ITEM:TTABle[:STATe] <bool>
|
(Read-Write) When ON, prints the trace attributes table. This setting survives instrument preset and PNA 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) |
|
HCOPy:ITEM:WFRaction <value>
|
(Read-Write) Sets the vertical amount of a page that is filled by the measurement windows. This setting survives instrument preset and PNA 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 |
|
HCOPy:ITEM:WINDows[:STATe] <bool>
|
(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 PNA 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) |
|
HCOPy:PAGE:DIMensions:LLEFt <left, lower>
|
(Read-Write) Sets the left and lower page margins. This setting survives instrument preset and PNA 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 |
|
HCOPy:PAGE:DIMensions:URIGht <right, upper>
|
(Read-Write) Sets the right and upper page margins. This setting survives instrument preset and PNA 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 |
|
HCOPy:PAGE:ORIentation <char>
|
(Read-Write) Sets the page orientation. This setting survives instrument preset and PNA application restart. |
|
|
Parameters |
|
|
<char> |
Choose from:
|
|
Examples |
HCOP:PAGE:ORI PORT hcopy:page:orientation landscape |
|
Query Syntax |
HCOPy:PAGE:ORIentation? |
|
Return Type |
Character |
|
PORTrait |
|
HCOPy:PAGE:SIZE <int>
|
(Read-Write) Sets the paper type, which implies the page size. This setting survives instrument preset and PNA 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 |
|||||||||||||||||||||||||||||
HCOPy:SDUMp:DATA?
|
(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 PNA (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 |
|
HCOPy:SDUMp:DATA:FORMat <char>
|
(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 |
|
HCOPy:PRINters?
|
(Read-only) Returns a comma-separated list of printers installed on the PNA. Select a printer using HCOPy:DPRinter. This setting survives instrument preset and PNA application restart. |
|
|
Examples |
HCOP:PRIN? hcopy:printers? |
|
Query Syntax |
HCOPy:PRINters? |
|
Return Type |
String |
|
Not Applicable |
|
Last modified:
|
13-Apr-2011 |
Obsolete seg data |
|
15-Mar-2010 |
Added SDUMP commands (A.09.20) |
|
Nov. 1, 2006 |
Added new commands |