HCOPy...    Related Topics

The HCOPy system controls the output of screen information to an external device. Part of the functionality of this system is included in the File menu.

 

Command tree: HCOPy

:DESTination

:DEVice

:LANGuage

[:IMMediate]

:ITEM

:ALL

:LOGO

[:STATe]

:MLISt

[:STATe]

:TIME

[:STATe]

:PAGE

:MARGin

:BOTTom

:LEFT

:RIGHt

:TOP

:ORIentation

:WINDow

HCOPy:DESTination <string> | 'MMEM' | 'DEFPRT'

Selects a printer name or file as destination for the screen output.

<string> |

Printer name, string variable. One of the printers accessible from your PC.

 

'MMEM'

Print to file. The file name is defined via MMEMory:NAME. The command HCOPy:DEVice:LANGuage WMF | EWMF | BMP | PNG selects the file format.

'DEFPRT'

Use default printer, to be selected in the "Printers and Faxes" dialog of the Windows XP® control panel.

*RST value

n/a (*RST does not overwrite the printer destination)

 

SCPI, Command Types

Confirmed, command or query.

 

Example:

MMEM:NAME 'C:\Screenshots\PLOT1.BMP'

Define a printer file name (without creating the file), assuming that .BMP is the current file format (see HCOPy:DEVice:LANGuage).

HCOP:MIT:LOGO ON; TIME ON

Include the logo and current time and date in the printed file.

HCOP:MPAG:WIND ALL

Include all diagram areas one one page of the printed file.

HCOP:DEST 'MMEM'; :HCOP

Select 'Print to file' and create the printer file specified before.

 

 

HCOPy:DEVice:LANGuage
EMF | WMF | EWMF | BMP | JPG | PNG

Selects a file format for printer files. Selecting the format is recommended to ensure that the file defined via MMEMory:NAME can be read or imported by an external application.

EMF, WMF, EWMF

Windows enhanced metafile format (vector-based, file extension *.emf). The parameter WMF is equivalent to EMF; a query returns EMF.

BMP

Windows bitmap

JPG

JPEG bitmap

PNG

Portable network graphics format

*RST value

BMP

 

SCPI, Command Types

Confirmed, command or query.

 

Example:

HCOP:DEV:LANG BMP

Select Windows bitmap format for printer files.

MMEM:NAME 'C:\Screenshots\PLOT1.BMP'

Define a printer file name and specify an existing directory (without creating the file).

HCOP:DEST 'MMEM'; :HCOP

Select 'Print to file' and create the printer file specified before.

 

HCOPy[:IMMediate]

Initializes the print according to the current HCOPy... configuration.

*RST value

–

 

SCPI, Command Types

Confirmed, no query.

 

Example:

HCOP:DEST '<Printer_name>'

Select the printer for the output of screen data.

HCOP

Start printing.

 

HCOPy:ITEM:ALL

Selects the complete screen contents to be printed, including the logo (HCOPy:ITEM:LOGO), time (HCOPy:ITEM:TIME), and the marker list (HCOPy:ITEM:MLISt).

*RST value

After a reset, the complete information is printed; see commands for logo, time, marker list and settings.

 

SCPI, Command Types

Confirmed, no query.  

 

Example:

HCOP:ITEM:ALL

Select the complete information to be printed.

HCOP

Start printing.

 

HCOPy:ITEM:LOGO[:STATe] <Boolean>

Qualifies whether or not the printed hardcopy contains the logo. The default R&S logo (file Logo.gif) is stored in the Resources\Images subdirectory of the NWA program directory and can be replaced by another logo.

This command is valid for printed hardcopies. If you print to a file (HCOPy:DESTination 'MMEM'), use HCOPy:MITem:LOGO[:STATe].

<Boolean>

ON | OFF - Logo is included or excluded.

*RST value

n/a (*RST does not affect the printer configuration)

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:ITEM:ALL

Select the complete information to be printed.

HCOP:ITEM:LOGO ON; :HCOP

Include the logo in the printed output and start printing.

 

HCOPy:ITEM:MLISt[:STATe] <Boolean>

Qualifies whether or not the printed output contains the information in the marker info field (marker list).

<Boolean>

ON | OFF - Marker list is included or excluded.

*RST value

n/a (*RST does not affect the printer configuration)

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:ITEM:ALL

Select the complete information to be printed.

HCOP:ITEM:MLISt ON; :HCOP

Include the marker list in the printed output and start printing.

 

HCOPy:ITEM:TIME[:STATe] <Boolean>

Qualifies whether or not the printed hardcopy contains the current date and time.

This command is valid for printed hardcopies. If you print to a file (HCOPy:DESTination 'MMEM'), use HCOPy:MITem:TIME[:STATe].

<Boolean>

ON | OFF - Date and time is included or excluded.

*RST value

n/a (*RST does not affect the printer configuration)

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:ITEM:ALL

Select the complete information to be printed.

HCOP:ITEM:TIME ON; :HCOP

Include the data and time in the printed output and start printing .

 

HCOPy:MITem:LOGO[:STATe] <Boolean>

Qualifies whether or not the printed file contains the logo. The default R&S logo (file Logo.gif) is stored in the Resources\Images subdirectory of the NWA program directory and can be replaced by another logo.

This command is valid for screen content which is printed to a file (HCOPy:DESTination 'MMEM'). To configure hardcopies, use HCOPy:ITEM:LOGO[:STATe].

<Boolean>

ON | OFF - Logo is included or excluded.

*RST value

n/a (*RST does not affect the printer configuration)

 

SCPI, Command Types

Device-specific, command or query

 

Example:

See HCOPy:DESTination

 

HCOPy:MITem:TIME[:STATe] <Boolean>

Qualifies whether or not the printed file contains the current date and time.

This command is valid for screen content which is printed to a file (HCOPy:DESTination 'MMEM'). To configure hardcopies, use HCOPy:ITEM:TIME[:STATe].

<Boolean>

ON | OFF - Date and time is included or excluded.

*RST value

n/a (*RST does not affect the printer configuration)

 

SCPI, Command Types

Device-specific, command or query

 

Example:

See HCOPy:DESTination

 

HCOPy:MPAGe:WINDow
ACTive | ALL | SINGle

Defines the number of diagram areas per printed page.

This command is valid for screen content which is printed to a file (HCOPy:DESTination 'MMEM'). To configure hardcopies, use HCOPy:PAGE:WINDow.

ACTive

Print only active diagram area.

ALL |

All diagram areas are printed on one page.

SINGle

One diagram area per page.

*RST value

n/a (*RST does not affect the printer configuration)

 

SCPI, Command Types

Confirmed, command or query

 

Example:

See HCOPy:DESTination

 

 

HCOPy:PAGE:MARGin:BOTTom <numeric_value>

Defines the distance between the bottom of the page and the bottom of the printed information.  

<numeric_value>

Lower margin.

Range [def. unit]

0.01 mm to 10000 mm [mm]

*RST value

n/a (*RST does not affect the printer configuration)

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:PAGE:MARG:BOTT 10; TOP 10

Set an upper and a lower margin of 1 cm.

 

HCOPy:PAGE:MARGin:LEFT <numeric_value>

Defines the distance between the left edge of the page and the left edge of the printed information.

<numeric_value>

Left margin.

Range [def. unit]

0.01 mm to 10000 mm [mm]

*RST value

n/a (*RST does not affect the printer configuration)

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:PAGE:MARG:LEFT 10; RIGHT 10

Set an left and a right margin of 1 cm.

 

HCOPy:PAGE:MARGin:RIGHt <numeric_value>

Defines the distance between the right edge of the page and the right edge of the printed information.

<numeric_value>

Right margin.

Range [def. unit]

0.01 mm to 10000 mm [mm]

*RST value

n/a (*RST does not affect the printer configuration)

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:PAGE:MARG:LEFT 10; RIGHT 10

Set an left and a right margin of 1 cm.

 

HCOPy:PAGE:MARGin:TOP <numeric_value>

Defines the distance between the top of the page and the top of the printed information.

<numeric_value>

Upper margin.

Range [def. unit]

0.01 mm to 10000 mm [mm]

*RST value

n/a (*RST does not affect the printer configuration)

 

SCPI, Command Types

Device-specific, command or query

 

Example:

HCOP:PAGE:MARG:BOTT 10; TOP 10

Set an upper and a lower margin of 1 cm.

 

HCOPy:PAGE:ORIentation
PORTrait | LANDscape

Defines the orientation of the printed page. Switching between LANDscape and PORTrait rotates the hardcopy result by 90 degrees. No other settings are changed.

PORTrait |

Short edge of the paper is the top of the page.

LANDscape

Long edge of the paper is the top of the page.

*RST value

n/a (*RST does not affect the printer configuration)

 

SCPI, Command Types

Confirmed, command or query

 

Example:

HCOP:PAGE:ORI LAND; :HCOP

Select landscape page orientation and start printing.

 

HCOPy:PAGE:WINDow
ACTive | ALL | SINGle

Defines the number of diagram areas per printed page.

This command is valid for printed hardcopies. If you print to a file (HCOPy:DESTination 'MMEM'), use HCOPy:MPAGe:WINDow.

ACTive

Print only active diagram area.

ALL |

All diagram areas are printed on one page.

SINGle

One diagram area per page.

*RST value

n/a (*RST does not affect the printer configuration)

 

SCPI, Command Types

Confirmed, command or query

 

Example:

HCOP:PAGE:WIND SING; :HCOP

Select one diagram area per page and start printing.