SUNPLOT

Section: User Commands (1)
Index Return to Main Contents

NAME

sunplot - plotter backend for Sun workstation

SYNOPSIS

sunplot [ -c canvas_size ] [ -h horizontal_size ] [ -v vertical_size ] [ -f font_name ] [ -r ] [ -x ] [ -y ] [ -l ] [ -s ] [ -R ]

DESCRIPTION

Sunplot reads UNIX plotter code (see plot(5)) from standard input and displays it in a Sun window. The window consists of two subwindows. At the top is a control panel with a number of buttons and below it is a window with a canvas on which sunplot draws and a horizontal and a vertical scrollbar with which you can select which part of the canvas you want to see in the window. The buttons in the control panel have the following functions:

Next Page: Draw the next page. Pages are separated by an e (the erase function in the plot(3X) library). This button is not displayed while sunplot is still reading a page or when the end of the input has been reached.
Redraw: Redraw the current page.
Zoom: Zoom the current page. Sunplot finds the most extreme x- and y-coordinates in the current page and uses those values in stead of the values given by the s command (the space function) for scaling.
Options: Sunplot displays a window where you can set certain options. See the description below.
Dump: Sunplot displays a window with four items. You should type a file name after the string Dump to file: and then press the Dump button. Sunplot will then dump the plot into the named file in the format chosen with the Dump format item. The dump can be in rasterfile(5), icon, or UNIX plot(5) format. If the file name is empty, sunplot will do nothing. The dump subwindow will continue to be displayed until the Done button is selected.
Fit Screen: Resize the window so that the canvas fits.
Quit: Exit sunplot without asking for user confirmation.

OPTIONS

When the Options button is pressed sunplot will display a window with the following items.

Done: Done setting options. The window disappears and the page is redrawn with the new settings.
Apply: Apply the selected options. Sunplot will automatically do a redraw of the page with the new settings.
Rotate: Rotate the plot by 90 degrees counter-clockwise.
X Mirror: Mirror the plot in the x-axis.
Y Mirror: Mirror the plot in the y-axis.
Label: If on, display labels.
Square: If on, the canvas is square, otherwise you can set the horizontal and vertical sizes of the canvas separately.
Reverse: Display the canvas in reverse video.
Font name: The name of the font to be used for the labels. If the name is not absolute it is taken to be relative to the system's fonts directory /usr/lib/fonts/fixedwidthfonts. If no name is given or the named file does not contain a font, the default font is used.
Canvas size: The size of the canvas. The size of the canvas is measured in pixels. This is only displayed when the Square toggle is on.
Horizontal size: The horizontal size of the canvas. This is only displayed when the Square toggle is off.
Vertical size: The vertical size of the canvas. This is only displayed when the Square toggle is off.

The following command line options are recognized.

-c canvas_size: Set the canvas size. Canvas_size must be between 64 and 2048. This also switches on the Square toggle.
-h horizontal_size: Set the horizontal size. Horizontal_size must be between 64 and 2048. This also switches off the Square toggle.
-v vertical_size: Set the vertical size. Vertical_size must be between 64 and 2048. This also switches off the Square toggle.
-f font_name: Set the font to be used for labels. This is independent from the font that is used for the text in the control panel and the options and dump windows. A name not starting with ``/'' is taken to be relative to the system's font directory /usr/lib/fonts/fixedwidthfonts.
-r: Rotate the plot by 90 degrees counter-clockwise.
-x: Mirror the plot in the x-axis.
-y: Mirror the plot in the y-axis.
-l: Toggle labeling.
-s: Toggle square mode.
-R: Display in reverse video (white on black).

The -r, -x and -y options are evaluated left to right and can be repeated to get cumulative effect. Sunplot also recognizes the generic tool arguments; see suntools(1) for a list of these arguments.

The defaults are: labels printed, square canvas, canvas size is 512 by 512 pixels, the point (0, 0) is in the lower left-hand corner.

BUGS

The linemod function is not implemented.

The zoom command doesn't take the height and width of labels into account.

AUTHOR

Sjoerd Mullender, Free University, Amsterdam <sjoerd@cs.vu.nl>

This document was created by man2html, using the manual pages.
Time: 06:44:58 GMT, December 12, 2024