view release on metacpan or  search on metacpan

GnuplotTerminals.pod  view on Meta::CPAN

=head1 pbm

Several options may be set in the C<pbm> terminal---the driver for PBMplus.

Syntax:

      set terminal pbm {<fontsize>} {<mode>}

where <fontsize> is C<small>, C<medium>, or C<large> and <mode> is C<monochrome>,
C<gray> or C<color>.  The default plot size is 640 pixels wide and 480 pixels
high; this may be changed by C<set size>.

The output of the C<pbm> driver depends upon <mode>: C<monochrome> produces a
portable bitmap (one bit per pixel), C<gray> a portable graymap (three bits
per pixel) and C<color> a portable pixmap (color, four bits per pixel).

The output of this driver can be used with Jef Poskanzer's excellent PBMPLUS
package, which provides programs to convert the above PBMPLUS formats to GIF,
TIFF, MacPaint, Macintosh PICT, PCX, X11 bitmap and many others.  PBMPLUS may
be obtained from ftp.x.org.  The relevant files have names that begin with
"netpbm-1mar1994.p1"; they reside in /contrib/utilities.  The package can
probably also be obtained from one of the many sites that mirrors ftp.x.org.

Examples:

      set terminal pbm small monochrome             # defaults
      set size 2,2; set terminal pbm color medium



=head1 dospc

The C<dospc> terminal driver supports PCs with arbitrary graphics boards,
which will be automatically detected.  It should be used only if you are
not using the gcc or Zortec C/C++ compilers.



=head1 pdf

This terminal produces files in the Adobe Portable Document Format
(PDF), useable for printing or display with tools like Acrobat Reader

Syntax:

      set terminal pdf {fname "<font>"} {fsize <fontsize>}

where <font> is the name of the default font to use (default Helvetica)
and <fontsize> is the font size (in points, default 12)



=head1 pm

The C<pm> terminal driver provides an OS/2 Presentation Manager window in
which the graph is plotted.  The window is opened when the first graph is
plotted.  This window has its own online help as well as facilities for
printing, copying to the clipboard and some line type and color adjustments.
The C<multiplot> option is supported.

Syntax:

      set terminal pm {server {n}} {persist} {widelines} {enhanced} {"title"}

If C<persist> is specified, each graph appears in its own window and all
windows remain open after C<gnuplot> exits.  If C<server> is specified, all
graphs appear in the same window, which remains open when C<gnuplot> exits.
This option takes an optional numerical argument which specifies an instance
of the server process.  Thus multiple server windows can be in use at the
same time.

If C<widelines> is specified, all plots will be drawn with wide lines.  If
C<enhanced> is specified, sub- and superscripts and multiple fonts are
enabled using the same syntax as the C<enhanced postscript> option (see
C<set terminal postscript enhanced> for details).  Font names for the basic
PostScript fonts may be abbreviated to single letters.

If C<title> is specified, it will be used as the title of the plot window.
It will also be used as the name of the server instance, and will override
the optional numerical argument.

Linewidths may be changed with C<set linestyle>.



=head1 png (OLD)

The C<png> terminal driver supports Portable Network Graphics.  This old 
version of the png driver requires the third-party libraries "libpng" 
and "zlib".  There is a newer png driver, with many more features, that
is preferred if you have libgd version 1.8 or newer.

Syntax:

      set terminal png {small | medium | large}
                       {transparent|notransparent}
                       {picsize <xsize> <ysize>}
                       {monochrome | gray | color}
                       {<color0> <color1> <color2> ...}

C<transparent> instructs the driver to generate transparent PNGs.  The first
color will be the transparent one.

The defaults are C<small> (fontsize) and C<color>.  Default size of the output
is 640*480 pixel. This can be changed by the option C<picsize>.

Each <color> must be of the form 'xrrggbb', where x is the literal character
'x' and 'rrggbb' are the red, green and blue components in hex.  For example,
'x00ff00' is green.  The background color is set first, then the border
color, then the X & Y axis color, then the plotting colors.  The maximum
number of colors that can be set is currently 99.



=head1 postscript

Several options may be set in the C<postscript> driver.

GnuplotTerminals.pod  view on Meta::CPAN

=head2 graph-menu

The C<gnuplot graph> window has the following options on a pop-up menu
accessed by pressing the right mouse button or selecting C<Options> from the
system menu:

C<Bring to Top> when checked brings the graph window to the top after every
plot.

C<Color> when checked enables color linestyles.  When unchecked it forces
monochrome linestyles.

C<Copy to Clipboard> copies a bitmap and a Metafile picture.

C<Background...> sets the window background color.

C<Choose Font...> selects the font used in the graphics window.

C<Line Styles...> allows customization of the line colors and styles.

C<Print...> prints the graphics windows using a Windows printer driver and
allows selection of the printer and scaling of the output.  The output
produced by C<Print> is not as good as that from C<gnuplot>'s own printer
drivers.

C<Update wgnuplot.ini> saves the current window locations, window sizes, text
window font, text window font size, graph window font, graph window font
size, background color and linestyles to the initialization file
C<WGNUPLOT.INI>.



=head2 printing

In order of preference, graphs may be be printed in the following ways.

C<1.> Use the C<gnuplot> command C<set terminal> to select a printer and C<set
output> to redirect output to a file.

C<2.> Select the C<Print...> command from the C<gnuplot graph> window.  An extra
command C<screendump> does this from the text window.

C<3.> If C<set output "PRN"> is used, output will go to a temporary file.  When
you exit from C<gnuplot> or when you change the output with another C<set
output> command, a dialog box will appear for you to select a printer port.
If you choose OK, the output will be printed on the selected port, passing
unmodified through the print manager.  It is possible to accidentally (or
deliberately) send printer output meant for one printer to an incompatible
printer.



=head2 text-menu

The C<gnuplot text> window has the following options on a pop-up menu accessed
by pressing the right mouse button or selecting C<Options> from the system
menu:

C<Copy to Clipboard> copies marked text to the clipboard.

C<Paste> copies text from the clipboard as if typed by the user.

C<Choose Font...> selects the font used in the text window.

C<System Colors> when selected makes the text window honor the System Colors
set using the Control Panel.  When unselected, text is black or blue on a
white background.

C<Update wgnuplot.ini> saves the current text window location, text window
size, text window font and text window font size to the initialisation file
C<WGNUPLOT.INI>.

C<MENU BAR>

If the menu file C<WGNUPLOT.MNU> is found in the same directory as
WGNUPLOT.EXE, then the menu specified in C<WGNUPLOT.MNU> will be loaded.
Menu commands:

[Menu] starts a new menu with the name on the following line.

[EndMenu] ends the current menu.

[--] inserts a horizontal menu separator.

[|] inserts a vertical menu separator.

[Button] puts the next macro on a push button instead of a menu.

Macros take two lines with the macro name (menu entry) on the first line and
the macro on the second line.  Leading spaces are ignored.  Macro commands:

[INPUT] --- Input string with prompt terminated by [EOS] or {ENTER}

[EOS] --- End Of String terminator.  Generates no output.

[OPEN] --- Get name of file to open from list box, with title of list box
terminated by [EOS], followed by default filename terminated by [EOS] or
{ENTER}.  This uses COMMDLG.DLL from Windows 3.1.

[SAVE] --- Get name of file to save.  Similar to [OPEN]

Macro character substitutions:

{ENTER} --- Carriage Return '\r'

{TAB} --- Tab '\011'

{ESC} --- Escape '\033'

{^A} --- '\001'

...

{^_} --- '\031'

Macros are limited to 256 characters after expansion.



=head2 wgnuplot.ini