### 3.4 Getting hardcopy ¶

Type:

    hcp

to add the picture you see on your screen to the current hardcopy file. Yorick walks the current display list, rendering to the hardcopy file instead of to your screen. To close the hardcopy file and send it to the printer, use:

    hcp_out

Normally, hcp_out destroys the file after it has been printed; you can save the file in addition to printing it with:

    hcp_out, keep=1

If you want to close the hardcopy file without printing it, you can call hcp_finish instead of hcp_out; if you invoke hcp_finish as a function (with a nil argument), it returns the name of the file it just closed.

After you call hcp_out or hcp_finish, the next call to hcp creates a new hardcopy file. You can call hcp_file to set the name of the next hardcopy file. For example,

    hcp_file, "myfile.ps"

means that the next time Yorick creates hardcopy file, its name will be `myfile.ps`. The name of the file also implicitly determines the file type; names of the form `*.ps` will be PostScript files, while a file name of the form `*.cgm` will be a binary CGM. If you do not specify a file name, Yorick chooses a name will not clobber any existing file; if you specify a name and that file already exists, Yorick will silently overwrite the existing file.