OLXPLOT(1G)

NAME
olxplot - graphics filter to display plot files under Sun Open Windows

SYNOPSIS
olxplot [ file1, file2, ... ]

DESCRIPTION
olxplot is used by LNKnet and other programs to display plot files under Sun Open Windows. The same software that drives the graphics window in olxplot is also used by programs that use the xlippic(3g) subroutines to put graphics on a graphics window under Sun Open Windows. The buttons and controls under both uses work the same. When used as a plot filter this program opens up an Open Windows window to display the plots and reads modified plot(5) plotting instructions from the standard input or an optional file. All instructions are read from all plot files and stored in memory. This allows a user to move forward and backward among the plot files on the olxplot command line. Plotting instructions usually reside in a file with a '.plot' suffix created by lipgraph(1g), xlippic(3g), or LNKnet(1) graphics routines. Alternatively, lipgraph(1g) output can be piped directly to olxplot.

olxplot opens up an Open Windows window, reports the current file name, displays the first plot in the command line file list and waits for a user action to determine what to do next. The following actions are available. As indicated, they can be selected using the Sun mouse or by pressing console keys.

USER INTERACTIONS

n - DISPLAY NEXT PLOT
    1) Press the 'n' key on the keyboard.
    2) Move mouse pointer to the Next button and press the left mouse button.
    The current plot is erased and the next file in the plot list from the command line is displayed.

p - DISPLAY PREVIOUS PLOT
    1) Press the 'p' key on the keyboard.
    2) Move mouse pointer to Next on-screen button and press the left mouse button.
    The current plot is erased and the previous file in the plot list from the command line is displayed.

o - OVERLAY PLOTS
    1) Press the 'o' key on the keyboard. This alternately enables and disables the overlay mode of operation.
    2) Move mouse pointer to Overlay on-screen button and select Enable or Disable from the pull-down menu to enable or disable the overlay mode of operation.
    Overlay mode causes the next and previous commands to display new plots without erasing the current display. This allows the user to interactively combine a series of plots.

c - CLEAR SCREEN
    1) Press the 'c' key on the keyboard.
    2) Move mouse pointer to Clear on-screen button and press the left mouse button.

s - SAVE SCREEN IN PLOT FILE
    1) Press the 's' key on the keyboard, fill in the new plot file name, and press the Save button.
    2) Move mouse pointer to the File on-screen button and select Save... from the pull-down menu.
    A dialog box will appear. Fill in the new plot file name, and press the Save button or hit carriage return. Select "Cancel" with the mouse to remove the dialog box without saving a file.

q - QUIT
    1) Press the 'q' key on the keyboard.
    2) Move mouse pointer to the File on-screen button and select Quit from the pull-down menu exposed with the right mouse button.

h - PRINT SCREEN ON POSTSCRIPT PRINTER
    1) Press the 'h' key on the keyboard.
    2) Move mouse pointer to File on-screen button, drag the mouse to Print on the pull-down menu, and select the default PostScript printer from the pull-right menu attached to Print.
    A PostScript version of the plot file is generated using plot2ps. This PostScript file is then printed on the default printer using the "lpr" command or "lpr -P<printer>", if a new default printer has been selected. This only works if the printer command used at your site is "lpr". In addition, the plot2ps command must be available to convert plot files to postscript.

P - SELECT A DEFAULT POSTSCRIPT PRINTER
    1) Press the 'P' key on the keyboard.
    2) Move mouse pointer to File on-screen button, drag the mouse to Print on the pull-down menu, and select the Printer... from the pull-right menu attached to Print.
    This will display a dialog window. Type the printer name and hit carriage return or select the OK button. The default printer name on the Print pull-right menu will change to the new printer. When Print is selected in the future, the command "lpr -P<newprintername>" will be used.

? - DISPLAY THE HELP WINDOW
    1) Press the '?' key on the keyboard.
    2) Move mouse pointer to the Help on-screen button and press the left mouse button. A popup window listing the keyboard shortcuts for olxplot appears.

BUGS
The OLIT widget set used to write olxplot is not popular making the program not as portable as it should be. The xplot program can be used instead, renaming it olxplot to fool the LNKnet plots. The xplot program has reduced abilities, especially in the number of keyboard commands available.

The keyboard commands do not always work under the twm and vtwm window managers.

SEE ALSO
xplot(1g), xlippic(3g), lipgplot(1g), lipiplot(1g), lipgraph(1g), plot2ps(1g), plot(5)

HISTORY
3-Mar-91 Written by Glen Adams to support xlippic(3g) under Sun Open Windows.
2-14-95 Modified by Linda Kukolich - fixed behaviour of buttons, added setting a new lpr printer, fixed a serious memory leak in the Plot widget.