NAME

SYNOPSIS

DESCRIPTION

When you type zi with no parameters, the filters available in the directory $CPLOTHOME/filters are listed, with the name of the last-used filter, or if there is none, the default filter, displayed in parenthesis. You may enter <return> to use that filter, or you may enter the name of the desired filter program and options and then <return>.

Giving the file or device name file as the first argument after filter switches the standard output of the filter to file. (Note that file can't begin with a - or @ character.) You might use this option to redirect video displays to another terminal or to put output destined for a printer into a file to be sent to the printer at a later time. For example,

zi epsfilter plot.eps


Although filters that have output destined to be printed (or spooled) are usually already configured to send that output to a particular printer, you may override the default spooling commands by using the @spool_opts feature. For example,

zi psfilter @lp @-dlaser @-s


If you enter any of the z commands before initializing a filter with zi, you will be prompted for a filter, as if you had typed zi.

Before a new filter process is begun, the program waits for the previous filter process (if any) to terminate. If you enter zi and the plot program is waiting for the previous filter process to terminate, typing a ^C will return the program to the PLOT-> prompt. Entering another zi will kill the previous filter process without waiting for it to terminate normally. You may want to terminate a filter to kill a misbehaving filter program or to abort a plot when you don't want to wait for it to be completed.

The filter process also is killed when C- PLOT exits, as C-PLOT is designed to clean up all subprocesses and temporary files it has created. To make sure a filter associated with a printer has finished processing its input, type zi before exiting the program. The program will wait until the current filter has finished and then prompt for a new filter name. You can just hit <return> and then exit the plot program. Alternatively, use the zs command to synchronize filter termination with the plot program.

Some filters, such as those that generate PostScript or HPGL-2, recognize command line options. For example,

zi psfilter plot.eps -eps -color


If filter contains a / character, the name is taken as an absolute or relative path name. The names of the filters are arbitrary, and each site is free to rename the installed filters.

For general information on graphics filters, see the filters help file.

SEE ALSO