PGPLOT version 5.2.2

This version is a maintenance release. It introduces no new
subroutines or functionality.


Modified configuration files

Configuration files for aix, linux, and solaris have been updated.


Windows support

The files sys_win/aaaread.me and sys_win/gidriv.f have been modified.


Modified device drivers

Minor bugs in the X-window device drivers have been corrected.


Changes to PGPLOT subroutines

pgqinf
     Returns new version number (5.2.2).

----------------------------------------------------------------------------
Tim Pearson, California Institute of Technology, tjp@astro.caltech.edu
Copyright © 1999 California Institute of Technology
PGPLOT version 5.2.1

This version is a maintenance release. It introduces no new subroutines or
functionality.

Tested Systems

Version 5.2.1 has been tested on the following systems.

   * Solaris 2.5.1 (SunOS 5.5.1), GNU Fortran (g77) and C (gcc) 2.8.1 [sol2
     g77_gcc]; tested on SPARC Ultra-1; device drivers CGDRIV GIDRIV GLDRIV
     NUDRIV PPDRIV PSDRIV TKDRIV TTDRIV WDDRIV XMDRIV XWDRIV.

Changes to configuration files and system support

New systems

sys_cygwin
sys_gnuwin32
sys_solx86

Modified systems

See the appropriate pgplot/sys_*/aaaread.me file for details of changes.
Many configuration files (not listed here) have been modified to correct
errors and add new configuration variables.

sys_aix
     Modified aaaread.me, xlf_cc.conf; added g77_gcc.conf.
sys_hp
     Added g77_gcc.conf.
sys_linux
     Added f95_gcc.conf (and directory f95_src), fort77_gcc.conf,
     g77_elf.conf, g77_gcc_aout.conf, nag_gcc.conf and directory nag_src.
sys_osf1
     Added g77_gcc.conf.
sys_win
     Added gidriv.f and pgpack.f (special versions of these routines for
     Windows).

Modified support routines

sys/grgetc.c
     Removed unused variables.
sys/grgmem.c
     Modified to work with 64-bit systems (or other systems in which a
     pointer does not fit in an int).

Changes to device drivers

New device drivers

cgdriv
     Driver for CGM (Computer Graphics Metafile).
pndriv
     Driver for PNG (Portable Network Graphics format). Note: to install
     this, you must have libpng.
xadriv
     This is a widget driver, like xmdriv, that uses the X-athena widget set
     instead of the Motif widget set. See the documentation for xmdriv for
     further information.

Modified device drivers

Many.

Changes to PGPLOT subroutines

pgqinf
     Returns new version number (5.2.1).

----------------------------------------------------------------------------
Tim Pearson, California Institute of Technology, tjp@astro.caltech.edu
Copyright © 1999 California Institute of Technology
PGPLOT version 5.2.0

This version includes bug fixes, improvements in existing routines, new
routines, and new device drivers. All changes are intended to be compatible:
existing programs should run unchanged and produce the same output (except
for a few bug fixes).

Tested Systems

Version 5.2.0 has been tested with the following operating systems and
compilers. Drivers tested include: GI, GL, NU, PG, PP, PS, TT, TK, VT, WD,
X2, XM, XW (but not all combinations of drivers and systems have been tested
exhaustively).

   * Solaris 2.5.1 (SunOS 5.5.1), Sun Fortran (f77) 3.0.1, Sun C (cc) 3.0.1
     (tested on SPARC Ultra-1) [sol2 f77_cc].
   * Solaris 2.5.1 (SunOS 5.5.1), GNU Fortran (g77) 0.5.18, GNU C (gcc)
     2.7.2.1 (tested on SPARC Ultra-1) [sol2 g77_gcc].
   * SunOS 4.1.3, Sun Fortran (f77), GNU C (gcc) (tested on Sun SPARCStation
     2) [sun4 f77_gcc].
   * OpenVMS AXP V6.1, DEC FORTRAN V6.2, DEC C V4.0, DECwindows Motif 1.1
     (tested on DEC 3000/M600).
   * OpenVMS VAX V6.1, DEC FORTRAN V6.2, DEC C V4.0, DECwindows Motif 1.2
     (tested on VAXstation 4000-90).

New PGPLOT routines

The following routines are documented in the list of subroutines, and will
be explained more fully in the manual.

pgaxis
     Draw a linear or logarithmic axis (more options will be added in later
     versions).
pgconf
     Shade area between two contours.
pgerr1
     Draw a single error bar (useful for systems which cannot pass a scalar
     to a routine that expects an array).
pgpt1
     Draw a single graph marker (useful for systems which cannot pass a
     scalar to a routine that expects an array).
pgsclp, pgqclp
     Set/query clipping status (used by PGBOX and PGAXIS to ensure that axes
     are not clipped against the viewport).
pgqdt, pgqndt
     Inquiry routines used to determine the list of device types available
     in a PGPLOT installation; useful for building menus, etc.
pgscrl
     Scroll a rectangular region of the screen; useful for making animated
     displays without redrawing the whole screen; currently only supported
     on X Window and related devices.
pgtick
     Used by pgaxis to draw single labelled tick mark; may be called
     directly, e.g., for special non-linear axes.

Modified PGPLOT routines

Internal changes that do not affect the API are not listed. Several routines
have been modified to improve their descriptions or improve speed.

pgctab
     The behavior of the arguments "brightness" and "contrast" has been
     changed slightly. The color indices set by this routine will be
     slightly changed from earlier versions of PGPLOT, except when these
     arguments have their "default" values (0.5 and 1.0). The routine is
     designed for use in an interactive environment in which the user can
     explore the effect of changing these parameters; in the new version
     they behave somewhat more as one might expect.
pgqinf
     Added ability to determine whether a device supports pgscrl.

New device drivers

pgdriv (device type /PGMF)
     Creates a disk file in a private PGPLOT Metafile format. This is a
     portable file format using only printable ASCII characters. It is
     intended to replace the old metafile (created by MFDRIV) which uses a
     binary, machine-dependent format. Subroutines are being prepared to
     allow a PGPLOT program to read and display files written in this format
     (an example program is provided in directory pgplot/pgmf). The driver
     uses only standard Fortran-77 and so should be portable to all
     operating systems on which PGPLOT is supported.
tkdriv (device type /XTK)
     For plotting in PGPLOT TCL/Tk widgets under the X Window System (UNIX
     systems only). An example program is included. Feedback on this driver
     would be appreciated: send e-mail to Martin Shepherd
     (mcs@astro.caltech.edu).

Modified device drivers

lxdriv
     LaTeX picture environment driver. Fixed bug: picture size can now be
     adjusted with PGPAP. (Note: The PostScript driver gives much better
     results than this one, if your LaTeX environmant allows PostScript
     files to be included in LaTeX documents.)
xmdriv
     Motif widget driver. Added support for scrolling; improved cursor
     handling; bug fixes.
xwdriv
     X Window driver. Added support for scrolling; bug fixes. The PGPLOT
     cursor can now be moved horizontally and vertically with the keyboard
     arrow keys, which can be more precise than using the mouse. Each
     keystroke moves the cursor by one pixel, or 10 pixels if the SHIFT key
     is depressed.

Deprecated drivers

The following drivers are probably no longer useful, and their use is
discouraged. They have been moved from pgplot/drivers to pgplot/drivers/old.
If you still need any of these drivers, please contact Tim Pearson.

imdriv, vidriv
     Imagen printers.
irdriv
     Silicon Graphics workstations: use the X-window drivers instead.
svdriv
     Sun workstations running SunView: use the X-window drivers instead.

Changes to installation procedures

The installation instructions have been rewritten. There are two changes you
should be aware of:

  1. All the UNIX configuration files (pgplot/sys_*/*.conf) have been
     modified to add new parameters that may be required for the new widget
     drivers. If you have made modifications to configuration files and
     haven't sent them back to Tim Pearson, you will need to change them
     again.
  2. If you need to modify a configuration file for your system, it is now
     recommended that you make a new configuration file called "local.conf"
     in the build directory, by editing a configuration file for a related
     system. makemake will now read this file if you do not specify a
     configuration on the makemake command line.

New and modified demonstration programs

pgdemo1
     Now uses new routine pgpt1 when a single marker is to be drawn.
pgdemo2
     Modified text-sample page.
pgdemo3
     Added demo of new routine pgconf. Demo of pgvect has been moved to
     pgdemo15.
pgdemo4
     Demo of pgimag: modified to use slightly more realistic transformation
     matrices, to show the use of pgctab, and to show how the color palette
     may be modified interactively.
pgdemo6
     Now uses new routine pgpt1 when a single marker is to be drawn.
pgdemo13
     Now uses new routine pgpt1 when a single marker is to be drawn.
pgdemo15
     New demo for routine pgvect (formerly in pgdemo3).
pgdemo16
     New demo for bar and column charts. This uses a general-purpose
     subroutine that may get included in a future version of pgplot,
     although not exactly in this form.
pgdemo17
     New demo, from Dr Martin Weisser, showing animated rotation of a
     molecular structure.

Changes to C binding

The program that creates the PGPLOT C binding (pgbind) can now generate a
binding for MS-Powerstation (Windows).

----------------------------------------------------------------------------
Tim Pearson, California Institute of Technology, tjp@astro.caltech.edu
Copyright © 1997 California Institute of Technology
PGPLOT version 5.1.1

Tested Systems

Version 5.1.1 has been tested with the following operating systems and
compilers. Drivers tested include: GI, GL, NU, PP, PS, TT, VT, WD, X2, XM,
XW (but not all combinations of drivers and systems have been tested
exhaustively).

   * SunOS 4.1.3_U1, Sun Fortran (f77) 1.3.1, GNU C (gcc) 2.7.0 (tested on
     SPARC 5).
   * Solaris 2.5 (SunOS 5.5), Sun Fortran (f77) 3.0.1, Sun C (cc) 3.0.1
     (tested on SPARC IPX).
   * Solaris 2.5 (SunOS 5.5), Sun Fortran (f77) 3.0.1, GNU C (gcc) 2.7.2
     (tested on SPARC IPX, SPARC Ultra-1).
   * OpenVMS AXP V6.1, DEC FORTRAN V6.2, DEC C V4.0, DECwindows Motif 1.1
     (tested on DEC 3000/M600).
   * OpenVMS VAX V6.1, DEC FORTRAN V6.2, DEC C V4.0, DECwindows Motif 1.2
     (tested on VAXstation 4000-90).

Changes in Version 5.1.1

All changes are bug fixes or minor improvements. The most notable bug fixes
are:

   * PGOPEN, PGBEG: a device specification like '? ' (question mark with one
     or more trailing spaces) causes PGOPEN to issue a blank prompt for
     device specification. This was an unintended change in 5.1.0, and has
     been fixed in version 5.1.1.

   * PGBEG: in version 5.1.0, the ordering of panels changed from row order
     to column order. The way the sign of the NXSUB argument was interpreted
     was precisely the opposite of the documented interpretation (NXSUB > 0
     should give row order, and < 0 should give column order). PGSUBP has
     always been wrong, but PGBEG acquired the incorrect behavior in version
     5.1.0. Both PGBEG and PGSUBP now behave as documented.

   * The PostScript driver was ignoring environment variables used to set
     the paper size. It now recognizes these variables. In addition, it will
     accept requests via routine PGPAP to change the paper size, even if the
     size requested is larger than the default size. (You can still set the
     default size with environment variables PGPLOT_PS_WIDTH and
     PGPLOT_PS_HEIGHT.) There are two side-effects of this change: (1) When
     PGPAP is used, a portrait-mode graph is placed in the lower left corner
     of the paper (offset by the amount specified by environment variables
     PGPLOT_PS_HOFFSET and PGPLOT_PS_VOFFSET; a landscape-mode graph is
     placed in the same corner of the paper, but in this case it appears to
     be the top left corner! (2) When PGPAP is used, the bounding-box cannot
     be guessed when the file is opened, so you should not use the
     PGPLOT_PS_BBOX environment variable; if you do not set this variable, a
     correct bounding box will be written in the file trailer (see the
     discussion in the note on the PostScript printer driver).

List of Changes

pgplot
     aaaread.me
          Revised for version 5.1.1.
     copyright.notice
          Version number changed.
     makemake
          It now issues a message encouraging the installer to read the
          appropriate README file.
     ver511.txt [new file]
          List of changes (this file).
pgplot/drivers
     psdriv.f
          Bug fixes: PGPLOT_PS_HOFFSET and PGPLOT_PS_VOFFSET were not
          decoded correctly (bug introduced in v5.1.0); bounding box could
          be incorrect (probably only on systems with non-static allocation
          of Fortran variables). Driver now honors all requests to change
          the paper size with PGPAP. Optimization: suppressed attempts to
          draw zero-length continuation line segments (thanks to Remko
          Scharroo).
     vtdriv-vms.f
          This is an alternative to vtdriv.f. It uses VMS-specific Fortran,
          but may work better than vtdriv.f on VMS systems.
     xwdriv.c, pgxwin_server.c
          Bug fix: images were displayed incorrectly on (some?) X-servers
          with more than 8 bits per pixel.
pgplot/examples
     pgdemo2.f
          Added example of Cyrillic text on page 3.
pgplot/src
     grdtyp.f, grpars.f
          Bug fix: improved minmatch routine for device types to allow,
          e.g., /HPGL even if /HPGL2 is also an option.
     grpocl.f
          Bug fix: (this is a support routine for polygon fill with PGPOLY,
          etc.) A polygon with one vertex exactly aligned with the edge of
          the window was not clipped correctly (thanks to Remko Scharroo for
          the bug fix).
     pgopen.f
          Bug fix and improvement in header comments. V5.1.0 introduced a
          bug: a device argument of '? ' with one or more trailing spaces
          did not issue the correct prompt.
     pgqinf.f
          Change version to 5.1.1.
     pgsave.f
          Correction in header comments.
     pgsubp.f
          This routine was interpreting a negative NXSUB argument
          incorrectly. According to the documentation, positive NXSUB should
          step through the panels in row order, while negative NXSUB should
          step through them in column order; but the routine was
          interpreting positive NXSUB as column order and negative as row
          order. The behavior has been corrected to match the documentation.
          (In version 5.1.0, pgbeg was changed to call pgsubp, thus
          introducing this bug in pgbeg as well.)
     pgtbox.f
          The positioning of labels relative to the axis has been improved;
          the displacement of labels from the axis should now be the same as
          in PGBOX. Problems were most noticeable when a large character
          size was requested. (Thanks to Neil Killeen for the fix.)
     pgvect.f
          The routine was ignoring the first row and column of the array
          when finding the scale-factor for the vector length. (Thanks to
          David Singleton for pointing this out.)
pgplot/sys_arc
     F77/ACDriver
          Revised to allow a concurrent hardcopy device (Dave Crennell).
     F77/GRexecAC
          Correct typo (Dave Crennell).
pgplot/sys_fujitsu
     This new directory replaces sys_vp2200. The files are from David
     Singleton.
     aaaread.me
          Revised.
     uxpm_frt_cc.conf
          Configuration file for Fujitsu UXP/M, frt FORTRAN compiler and
          /usr/ucb/cc compiler.
     uxpv_frt_cc.conf
          Configuration file for Fujitsu UXP/V, frt FORTRAN compiler and
          /usr/ucb/cc compiler.
pgplot/sys_hp
     *.conf
          Added support for compiling the Motif driver (xmdriv) [mcs].
pgplot/sys_linux
     aaaread.me
          Added notes on Linux variants and problems.
     g77_elf.conf [new file]
          Configuration file for Linux systems that use ELF binaries.
pgplot/sys_sol2
     aaaread.me
          Added notes about use of Sun f90 compiler and GNU g77 compiler.
          Added note about problem with the ucb version of "ld".
     f90_cc.conf [new file]
          For Solaris f90 1.1 Fortran compiler (from Ricardo Piriz).
     g77_gcc.conf [new file]
          For GNU g77 Fortran compiler (with gcc).
pgplot/sys_vp2200
     Directory removed.
pgplot/sys_vms
     aaaread.me [new file]
          Includes some notes on incompatibilities between versions of
          Motif, C compiler, and VMS.
     grlgtr.f
          This has been rewritten: it now treats logical names as
          case-insensitive, and uses $TRNLNM instead of obsolete $TRNLOG.
     makedoc.com [new file]
          A DCL command procedure to extract the documentation from the
          source code.

----------------------------------------------------------------------------
Tim Pearson, California Institute of Technology, tjp@astro.caltech.edu
Copyright © 1996 California Institute of Technology
PGPLOT version 5.1.0

Tested Systems

Version 5.1.0 has been tested with the following operating systems and
compilers. Drivers tested include: GI, GL, NU, PP, PS, TT, VT, WD, X2, XM,
XW (but not all combinations of drivers and systems have been tested
exhaustively).

   * SunOS 4.1.3_U1, Sun Fortran (f77) 1.3.1, GNU C (gcc) 2.7.0 (tested on
     SPARC 5).
   * Solaris 2.5 (SunOS 5.5), Sun Fortran (f77) 3.0.1, Sun C (cc) 3.0.1
     (tested on SPARC IPX).
   * Solaris 2.5 (SunOS 5.5), Sun Fortran (f77) 3.0.1, GNU C (gcc) 2.7.2
     (tested on SPARC IPX, SPARC Ultra-1).
   * OpenVMS AXP V6.1, DEC FORTRAN V6.2, DEC C V4.0, DECwindows Motif 1.1
     (tested on DEC 3000/M600).
   * OpenVMS VAX V6.1, DEC FORTRAN V6.2, DEC C V4.0, DECwindows Motif 1.2
     (tested on VAXstation 4000-90).

Changes in Version 5.1.0

New Features

  1. A major change in this version allows a program to have more than one
     PGPLOT device open at once. The devices can be of the same type, e.g.,
     two windows on an X-window workstation, or of different types, e.g., a
     Tektronix terminal emulator and a PostScript file. Up to 8 devices may
     be open at once. To support this new feature, four new routines have
     been added: PGOPEN, PGQID, PGSLCT, and PGCLOS, and many routines have
     been modified internally.

     At present, support for multiple devices of the same type is not
     complete. Each PGPLOT device driver needs to be modified to support
     multiple devices of the same type (i.e., served by the same driver), or
     to explicitly prohibit opening more than one device. Some of the older
     drivers have not yet been modified, and these drivers may give
     incorrect results if you attempt to use them to open two devices. There
     should never be any problem with unlike devices served by different
     drivers, e.g., /XTERM and /PS.

  2. A new driver (xmdriv) and support routines have been provided by Martin
     Shepherd to facilitate use of PGPLOT in a Motif application. Note that
     this is an experimental driver: feedback would be appreciated.

  3. The C function prototypes (cpgplot.h) and C binding are now compatible
     with C++ as well as C.

Bugs Fixed

A bug has been fixed in GRPOCL (support routine for PGPOLY). This could
cause overflow and incorrect plots if the world-coordinate values were
greater than about 1E18 (on most machines). A rounding-error has been fixed
in GRFA (support routine for PGPOLY); this could cause gaps between polygons
that should abut.

A bug has been fixed in GRPIXL (support routine for PGPIXL); this should
improve speed.

Two bugs have been fixed in the X-window driver (XWDRIV): it would sometimes
cause color maps to be set incorrectly; it allowed only 255 colors, not 256.

Drivers Removed

The following device drivers have been moved into directory
pgplot/drivers/old, and cannot be selected in a normal installation. I
believe that no-one is still using these drivers: ardriv.f (Args image
display), grdriv.f (Grinnell image display), ikdriv (Ikon pixel engine),
lidriv (Liacom display), pkdriv.f and pzdriv.f (Peritek image displays),
vedriv.f (Versatec V80 printer).

----------------------------------------------------------------------------

List of Changes

pgplot
     aaaread.me, copyright notice, makedoc, makehtml
          Updated date and version number.
     drivers.list
          Added XMDRIV (Motif driver). Do not select this unless you have
          the necessary Motif support and plan to write Motif applications
          that call PGPLOT. Removed obsolete drivers as noted above.
     makemake
          Added new subroutines. Added targets pgplot.hlp (VMS help file);
          pgplot-routines.tex (LaTeX); pgmdemo (example Motif application).
          Name changes: pgdisp is now pgdispd (directory); pgview is now
          pgview.app (NeXT).
     makehelp
          (New file.) Script to generate VMS help file.
     maketex
          (New file.) Script to generate LaTeX documentation.
     pgdispd
          Changed name of directory from pgdisp to pgdispd to avoid problems
          if you try to compile PGPLOT in the source directory.
     ver510.txt
          (New file.) List of changes since previous version.
pgplot/cpg
     cpgdemo.c
          Added a third page to exercise more routines.
     cpgplot.h
          Deleted file (note that this file needs to be created as part of
          the installation).
     pgbind.c
          Added C++ wrapper to the generated cpgplot.h file. Added support
          for const qualified declarations in the function prototypes.
pgplot/drivers
     gidriv.f, ppdriv.f, psdriv.f, ttdriv, wddriv.f, x2driv.c
          Modified to prevent concurrent access.
     gidriv.f, ppdriv.f, psdriv.f, wddriv.f
          On some systems the decoding of environment variables
          PGPLOT_xx_WIDTH, HEIGHT failed owing to a bad Fortran format.
          Rewritten to avoid this problem.
     nudriv.f
          Modified to allow concurrent access (up to 8 devices).
     xmdriv.c, pgxwin.c, pgxwin.h
          New files: PGPLOT driver for Motif applications (from Martin
          Shepherd).
     xwdriv.c
          Fix bug in handling query-color-representation.
     pgxwin_server.c
          Fix bug: 256 colors allowed, not 255.
pgplot/drivers/old
     New directory: several obsolete drivers (and associated drivers.list)
     have been moved from pgplot/drivers into this directory. These drivers
     should not be used; contact Tim Pearson if you still have a need for
     any of them.
pgplot/drivers/xmotif
     New directory: support routines and example program for Motif
     applications.
pgplot/examples
     Some of the example programs have been modified to use PGOPEN/PGCLOS
     instead of PGBEG/PGEND.
     pgdemo1.f
          Changed the pseudo-random number generator to avoid integer
          overflows.
     pgdemo6.f
          `+' key now cycles between cursor modes (rubber-band, cross-hair,
          etc.)
     pgdemo13.f
          (New program) Demonstration of two open devices.
     pgdemo14.f
          (New program) This program demonstrates a method of coding a user
          interface in PGPLOT. It requires the /XSERV device. For a more
          professional approach to graphical user interfaces, consider using
          the PGPLOT Motif driver.
pgplot/src
     (Many pg routines)
          Changed the C function prototypes to use the const qualifier where
          appropriate. This makes it easier to use the function prototypes
          with C++. Most arguments declared float * or char * are now const
          float * or const char * (except for returned values).
     grpckg1.inc
          Modified to allow up to 8 concurrent devices.
     grfa.f
          Rounding-error fix (thanks to Remko Scharroo; twice).
     grinit.f
          New routine: initializes common block (avoids BLOCK DATA).
     grpixl.f
          Minor bug fix (Remko Scharroo).
     grpocl.f
          Rewrite to avoid potential overflow (thanks to Tomasz Plewa).
     pgplot.inc
          Modified to allow up to 8 concurrent devices; many variables
          changed from scalars to arrays, with new names.
     pgask.f, pgband.f, pgbbuf.f, pgbeg.f, pgbox.f, pgcirc.f, pgebuf.f,
     pgend.f, pgerrb.f, pgerrx.f, pgerry.f, pggray.f, pghi2d.f, pgiden.f,
     pgimag.f, pglen.f, pgmtxt.f, pgncur.f, pgnoto.f, pgpage.f, pgpanl.f,
     pgpap.f, pgpoly.f, pgptxt.f, pgqah.f, pgqch.f, pgqcir.f, pgqcs.f,
     pgqfs.f, pgqhs.f, pgqinf.f, pgqitf.f, pgqtbg.f, pgqtxt.f, pgqvp.f,
     pgqvsz.f, pgqwin.f, pgrect.f, pgsah.f, pgsch.f, pgscir.f, pgsfs.f,
     pgshs.f, pgsitf.f, pgstbg.f, pgsubp.f, pgsvp.f, pgswin.f, pgvsiz.f,
     pgvstd.f, pgvw.f, pgwnad.f
          Modified to allow multiple concurrent devices.
     pgclos.f
          (New routine.) Closes the currently selected graphics device.
     pginit.f
          (New internal routine.) Initialize PGPLOT (this is to avoid an
          illegal initialization of data in COMMON).
     pgopen.f
          (New routine.) Open (and select) a graphics device; unlike PGBEG,
          this does not close any previously opened device.
     pgqid.f
          (New routine.) Returns the identifier of the currently selected
          graphics device, for use with PGSLCT.
     pgslct.f
          (New routine.) Selects one of the open devices for graphics
          output.
     pgqinf.f
          Changed version number to 5.1.0.
     pgshs.f
          Added checks on validity of arguments.
pgplot/sys_*
     Changes to configuration files to support compilation of the Motif
     driver and example programs.
pgplot/sys_arc
     Contents of directory updated for version 5.1.0 by Dave Crennell. See
     file AAAREADME.
pgplot/sys_linux
     The current version of gcc does not require system-specific variants of
     any files. The variants for f2c have been moved into a subdirectory
     pgplot/sys_linux/f77_src and the configuration files have been modified
     accordingly.
pgplot/sys_mac
     Contents of directory updated for version 5.0.3 by J. S. Salmento. See
     file aaaread.me.
pgplot/sys_msdos
     Contents of directory updated for version 5.1.0 by C. T. Dum. See file
     aaaread.me.
pgplot/sys_next
     Contents of directory updated for version 5.1.0 and NeXtStep 3.0 by
     Allyn Tennant. Configuration file for GNU Fortran (g77) added. See file
     aaaread.me.
pgplot/sys_sol2
     Added -R options to the ld commands in the configuration files; these
     help the demo programs to find the PGPLOT shared library at run time
     (assuming you haven't moved it after compilation.)
pgplot/sys_sun4
     Changed version number from 1.7 to 1.8 in all .conf files.
pgplot/sys_vms
     build.com, compile.com
          Added new routines to shared library transfer vector. Added
          instructions for linking with Motif library when needed.
     grlgtr.f
          This routine formerly converted all PGPLOT device specifications
          to uppercase for VMS. It now preserves case (VMS file and device
          names are not case-sensitive, but some PGPLOT device
          specifications can be).
     install.com
          Added new target (pgmdemo) to compile/install the Motif
          demonstration program.
     make_cpg.com
          Corrected to use the version of cpgplot.h in the current
          directory; set correct protection on generated files.
     make_pgdisp.com
          Changed name of directory from PGDISP to PGDISPD.
     make_pgmdemo.com
          (New file.) Used in compilation of the Motif example program.
pgplot/sys_win
     New directory: from Phil Seeger. Port of version 5.1.0 to MS
     PowerStation Fortran/Windows95 (or WindowsNT) environment. See file
     aaaread.me.

----------------------------------------------------------------------------
Tim Pearson, California Institute of Technology, tjp@astro.caltech.edu
Copyright © 1996 California Institute of Technology
PGPLOT version 5.0.3

Tested Systems

Version 5.0.3 has been tested with the following operating systems and
compilers. Drivers tested include: GI, GL, NU, PP, PS, TT, VT, WD, X2, XW (but
not all combinations of drivers and systems have been tested exhaustively).

   * HP-UX version A.09.01, HP Fortran/9000 (fort77), HP C (c89).
   * OpenVMS AXP V6.1, DEC FORTRAN V6.2, DEC C V4.0 (tested on DEC 3000/M600).
   * OpenVMS VAX V6.1, DEC FORTRAN V6.2, DEC C V4.0 (tested on VAXstation
     4000-90). Note: the PGDISP server cannot be compiled on this system.
   * Solaris 2.4 (SunOS 5.4), Sun Fortran 2.0.1, Sun C 2.0.1 (tested on
     SPARCstation 10).
   * SunOS 4.1.4, Sun Fortran 1.3.1, cc (tested on SPARCstation IPX). Note: the
     C-binding cannot be compiled with this non-ANSI C compiler.
   * SunOS 4.1.4, Sun Fortran 1.3.1, GNU gcc v2.7.0 (tested on SPARCstation
     IPX).

Changes in Version 5.0.3

Routine PGQCS has a new option to determine the character height in world
coordinates, and a bug that would give wrong values on devices with non-square
pixels has been corrected.

Routine PGTBOX has a new option `X' to label the HH field modulo 24. Thus, a
label such as 25h 10m would come out as 1h 10m.

Graphical output from the GIF and PPM drivers can now be directed to the
standard output by specifying a file name ``-'', e.g., ``-/gif''. This allows
output to be piped to a viewing program, e.g., ``pgprog | xv -''. This will
only work for single-page plots.

In this version I have started work to change the character coding of PGPLOT
text strings from US-ASCII to ISO Latin-1. Unfortunately I do not have
digitized versions of most of the required glyphs, so this work is not
complete. Programs which use characters with decimal codes in the range 128-255
will now display differently: in most cases, the glyph will be an approximation
to the ISO Latin-1 character (e.g., an unaccented letter instead of the
correctly accented one).

A new escape sequence, \., has been added for a centered dot (·).

A bug has been fixed that affected PostScript and possibly some other drivers:
they would ignore a change to the color-representation of the currently
selected color index.

Some changes have been made in the way PGPLOT writes BoundingBox comments in
PostScript files.

Two bugs in polygon fill have been fixed: PGPOLY would issue an error message
about a polygon with less than 3 vertices on some occasions when a polygon was
completely outside the viewport; and polygon fill was ignored completely on
some devices if the y-axis ran downwards instead of upwards.

There is one new driver (HGDRIV), for HP-GL/2 devices.

Minor corrections have been made in several other subroutines and text files.

-------------------------------------------------------------------------------

pgplot
     aaaread.me
          Changed version number to 5.0.3.
     copyright.notice
          Changed version number to 5.0.3.
     drivers.list
          Added HGDRIV.
     install.txt
          Updated.
     makehtml
          This is a perl script used for making the html documentation file.
          Some systems had trouble executing this script. I have now modified
          it to invoke perl by the #! mechanism. You may have to modify the
          first line of the script to specify the location of perl on your
          system.
     makemake
          Now includes the ``non-standard'' routines in the documentation files
          (pgplot.doc, pgplot.html). Also modified the non-standard routines to
          get cross-references to their aliases in the HTML file. The list of
          include file dependencies is now generated by searching the code.
          Special code for the Motif widget has been added. Added HGDRIV.
     ver503.txt
          (New file.) Release notes.
pgplot/drivers
     hgdriv.f
          (New file.) Driver from Colin J. Lonsdale for HP-GL/2 devices. I have
          not tested this. It is an alternative to GLDRIV: you should probably
          not include both in your PGPLOT configuration.
     lxdriv.f
          Removed a non-standard DATA initialization.
     psdriv.f
          Changed interpretation of environment variables PGPLOT_PS_BBOX and
          PGPLOT_PS_DRAW_BBOX; see the documentation.
     xwdriv.c
          Fix an error in display of large images.
     gidriv.f, ppdriv.f, wddriv.f
          Added comments to indicate what must be changed on operating systems
          like OSF/1 that use 64-bit addresses.
pgplot/examples
     pgdemo1.f
          Fixed error in scatter plot, and rewrote random number routines.
     pgdemo2.f
          Exercise a few more escape sequences.
pgplot/src
     grdtyp.f, grldev.f
          Changed to totally ignore a PGPLOT driver that reports a zero-length
          device type. This is to allow for stub drivers (more to come on
          this).
     grfa.f
          Fix bug: polygon fill was ignored on devices for which fill must be
          emulated in PGPLOT if the y-axis was reversed.
     grfa.f, grrec0.f
          Changed to avoid use of a real variable as a do-loop index (not
          allowed by some compilers).
     grscr.f
          Fix bug that affected some drivers: if you change the color
          representation of the current color, these drivers did not notice.
     grsyds.f
          Changed to allow 304 = 256+48 characters in a font rather than 128+48
          (the `48' are the greek characters). Added \. escape sequence.
     grsymk.f
          Changed to allow 304 = 256+48 characters in a font rather than
          128+48. This is in preparation for using the ISO-Latin-1 character
          set rather than US-ASCII. Unaccented glyphs have been assigned for
          most of the ISO-Latin-1 accented characters.
     pgcl.f
          Under rare circumstances could crash with both arguments to atan2
          equal to zero. [This is an internal routine used by PGCONL].
     pgpoly.f
          Fixed a bug in the clipping algorithm that affected some polygons
          that lie entirely outside the viewport.
     pgqcs.f
          Added option UNITS=4 to determine the character height in world
          coordinates, and fixed a bug that would give wrong values on devices
          with non-square pixels.
     pgqhs.f
          Corrected comments (arguments are output, not input).
     pgqinf.f
          Changed version number to 5.0.3. Changed cursor test to determine
          whether the driver reports a cursor, rather than assuming that all
          interactive devices have cursors.
     pgtbox.f
          New option `X' to label the HH field modulo 24 [Neil Killeen].
     pgimag.f
          Minor changes to header comments.
     pgswin.f, pgwnad.f
          These routines now check whether a window of zero width or zero
          height has been requested, in order to prevent a nasty divide-by-zero
          error.
     pg*.f (many files)
          Many of the top-level PG routines have been modified to issue a
          warning message (by calling PGNOTO) if no device is open. This is in
          preparation for multiple open devices.
pgplot/sys
     grfileio.c
          Recognize file name ``-'' as standard output.
pgplot/sys_dos
     msdriv.f
          Revised device driver for PCs running DOS with Microsoft Fortran 5.0,
          from Harry Lehto. This replaces msdriv.f, msdriv.koyama, and
          msdriv.lehto.
pgplot/sys_linux
     aaaread.me
          Add notes on use of Gnu g77 compiler [Brian Toby].
     g77_gcc.conf
          (New file.) Configuration file for Gnu g77 compiler [Brian Toby].
pgplot/sys_mac
     (New directory.) Macintosh OS, LS Fortran 2.1. See file aaaread.me.
pgplot/sys_msdos
     aaaread.me
          Added information about a serious bug in the Microsoft Powerstation
          Fortran compiler [from C. T. Dum].
pgplot/sys_osf1
     aaaread.me
          Added notes about the 64-bit address problem: some PGPLOT device
          drivers must be modified to be used with this operating system.
     grgmem.c
          This is a variant of pgplot/sys/grgmem.c that returns the pointer as
          an INTEGER*8 (64-bit-address).
pgplot/sys_sun4
     *.conf
          Changed shared library version number from 1.6 to 1.7.
pgplot/sys_vms
     grfileio.c
          Now recognizes file name ``-'' as standard output.

-------------------------------------------------------------------------------
Tim Pearson, California Institute of Technology, tjp@astro.caltech.edu
Copyright © 1995 California Institute of Technology
PGPLOT changes in Version 5.0.2

This version implements fill-area styles 3 and 4 (hatching and cross-hatching).
This affects polygons drawn with PGPOLY, PGCIRC, and PGRECT. Hatching is
selected by CALL PGSFS(3), and cross-hatching is selected by CALL PGSFS(4); see
also PGQFS. There is a new user-callable routine (PGSHS) to control the angle
and spacing of hatch lines, and a corresponding new inquiry routine (PGQHS).
There is also one new internal routine (PGHTCH). Drivers have been modified so
that they all interpret self-intersecting polygons the same way: a point is
inside the polygon if an infinite ray with the point as origin crosses an odd
number of polygon edges (``EvenOddRule'' in X-window terminology). Example
program PGDEMO1 has been revised to show the new fill-area styles.

Routine PGERRB has acquired new options that allow symmetric, two-sided error
bars to be drawn with one call instead of two.

There are two new drivers, LXDRIV, to create a LaTeX picture environment (this
is only useful for very simple plots), and HGDRIV, to create a plot in HPGL2
format. The PostScript driver has been updated to record a correct bounding box
for each page, and optionally include comments describing text strings. Note
that the bounding-box is now written at the end of the file, i.e., after PGPLOT
has figured out what it should be. Some programs that import PostScript require
the bounding-box in the file header. The script pgplot/pscaps.sh can be used to
move the bounding-box information into the header.

There are four bug-fixes: (1) in routine PGSUBP which was not setting the
viewport correctly; (2) in routine PGCONL (actually PGCL) which was writing
contour labels at the wrong angle; (3) in routine GRPARS which was incorrectly
attempting to overwrite the supplied device spec when doing logical-name
translation [VMS only]; (4) in routine GRFA which would sometimes incorrectly
fill a re-entrant polygon.

Support is added for the FreeBSD operating system and for PCs running MS-DOS
with Salford Software Fortran (pgplot/sys_salford) or Microsoft PowerStation
Fortran (pgplot/sys_msdos).

All the UNIX configuration files have been modified to add a CFLAGD parameter
that controls linking of C programs that call PGPLOT.
-------------------------------------------------------------------------------

pgplot
     aaaread.me
          Updated for version 5.0.2.
     ver500.txt, ver501.txt
          Earlier release notes (renamed and reformatted).
     ver502.txt
          Release notes for this release (this file).
     copyright.notice
          Updated.
     drivers.list
          Updated for new drivers.
     install.txt
          Updated.
     makemake
          Add PGHTCH, PGSHS, PGQHS to routine list; remove GRSFS. Modify to
          avoid use of shell functions that are not supported by some old
          versions of the Bourne shell.
     pscaps.sh
          (New file.) Script to modify a PostScript file by moving the
          BoundingBox comment from trailer to header. This will convert a
          single-page PGPLOT PostScript file into valid Encapsulated
          PostScript.
pgplot/cpg
     cpgplot.doc
          Added further instructions on linking C and Fortran.
     libgcc_path.sh
          A new script that tries to generate the correct linking commands for
          use with mixed Fortran and gcc.
pgplot/drivers
     ccdriv.f, ladriv.f, lndriv.f
          Remove backslashes and PDP-11 octal constants from code to improve
          portability (but these drivers are probably still specific to VMS).
     epdriv.f
          Remove some VMS dependencies; has not been tested under UNIX,
          however.
     hgdriv.f
          (New file.) Driver for HPGL2 graphics, from Colin Lonsdale.
     ljdriv.f
          (Bug fix.) Add a SAVE statement for non-static compilers.
     lxdriv.f
          (New file.) Driver for LaTeX picture environment, from Grant
          McIntosh.
     pgxwin_server.c
          Add omitted include: X11/Xos.h.
     psdriv.f
          (New feature.) If the supplied file name is '-', the driver send the
          PostScript output to standard output. (Note: this will only work when
          Fortran unit 6 is connected to standard output.) A correct
          PageBoundingBox comment is now included for each page. Plotted text
          can be included in the PostScript file as comments if environment
          variable PGPLOT_PS_VERBOSE_TEXT is set.
     tfdriv.f
          Improved optimization [David R. Chang]. Note that this driver is for
          VMS systems where the regular Tektronix driver (ttdriv.f) can send
          output to a terminal but cannot create a disk file.
     xwdriv.c
          Change polygon fill rule from ``WindingRule'' to ``EvenOddRule'' to
          match other drivers. Suppress message about starting server (when it
          starts successfully). Update comments.
pgplot/examples
     pgdemo1.f
          Revise example 6 to show all four fill-area styles, and example 7 to
          use the new options in PGERRB.
     pgdemo2.f
          Revise to exercise hatching styles.
     pgdemo3.f
          Change internal subroutine name PLOT to avoid possible conflicts with
          other libraries.
     pgdemo12.f
          Call PGBEG as a function rather than a subroutine.
pgplot/pgdisp
     initlgwin.c
          Change polygon fill rule from ``WindingRule'' to ``EvenOddRule'' to
          match other drivers.
pgplot/src
     grfa.f
          (Bug fix.) Fixed bug in filling re-entrant polygons (thanks to Andrew
          Carman).
     grlin3.f
          Prevent a possible `sqrt of negative number' error.
     gropen.f
          (Bug fix.) Avoid a zero-length string problem. Explicitly initialize
          variable to zero.
     grpars.f
          (Bug fix.) No longer overwrites supplied string with logical name
          translation; avoid a zero-length string problem.
     grpckg1.inc
          Remove unused variable GRFASL.
     grsfs.f
          (File deleted.)
     grtext.f
          Now sends text as a comment to output when requested.
     pgbeg.f
          Initialize hatching attributes. Explicitly initialize variable to
          zero.
     pgbox.f
          (Aesthetic improvement.) Move labels outwards slightly when inverted
          ticks are requested; adjust position of `MV' y labels.
     pgcl.f (support routine for pgconl)
          (Bug fix.) The contour labels were written at the wrong angle when x
          and y scales differed (thanks to Gerry Haines for discovering this);
          also labels could be drawn outside the window.
     pgerrb.f
          (Enhancement.) Add options 5 and 6 for drawing symmetric two-sided
          error-bars.
     pghtch.f
          (New file.) Routine for hatching (shading) polygon.
     pgmtxt.f
          (Bug fix.) The routine could try to use a zero-length character
          substring, which is not allowed by the Fortran-77 standard.
     pgplot.inc
          Add hatching attributes.
     pgpoly.f
          Add support for hatching.
     pgqfs.f
          Add file styles 3 and 4 (hatching).
     pgqinf.f
          Change version to 5.0.2. Avoid some zero-length string problems.
     pgqhs.f
          (New file.) Routine to inquire hatching style.
     pgrect.f
          Add support for hatching.
     pgsave.f
          Save hatching style.
     pgsfs.f
          Add file styles 3 and 4 (hatching).
     pgshs.f
          (New file.) Routine to set hatching style.
     pgsubp.f
          (Bug fix.) Rescale viewport when panel size changes.
pgplot/sys_dos
     *.f
          Split grdos.for into separate files for easier maintenance.
pgplot/sys_freebsd
     aaaread.me, f77_cc.conf, iand.c
          (New directory.) Support for FreeBSD operating system (Jean-Marc
          Zucconi).
pgplot/sys_hp
     aaaread.me
          (New file.) Add notes about optimization.
     fort77_gcc.conf
          (New file.) Configuration file for use with gcc compiler (not
          tested).
pgplot/sys_msdos
     aaaread.me, etc.
          (New directory.) Support files for MS Power Station 32-bit Fortran
          (from C. T. Dum).
pgplot/sys_osf1
     aaaread.me
          (Modified.) Add note about shareable library.
     f77_cc_shared.conf
          (New file.) For making a shareable library.
pgplot/sys_salford
     aaaread.me, *.f
          (New directory.) New system-specific files for MS-DOS with Salford
          Software Fortran (from Michael Michelson).
pgplot/sys_sun4
     *.conf
          Change -pic to -PIC (a large global offset table is needed if many
          drivers are selected).
pgplot/sys_ultrix
     f77_cc.conf
          Add "-lX11" in LIBS and "-Olimit 600" (for optimizing complex
          routines) in CFLAGC (Jaiyong Lee).
pgplot/sys_vms
     build.com
          Add PGSHS, PGQHS to transfer vector. Do not attempt to link with UIS
          on an AXP machine.

-------------------------------------------------------------------------------
Tim Pearson, California Institute of Technology, tjp@astro.caltech.edu
Copyright © 1995 California Institute of Technology
PGPLOT changes in Version 5.0.1

This version corrects several minor bugs; corrects a serious error in PGGRAY;
adds functionality to the X window driver; adds a new driver for X window dump
files.

pgplot
     aaaread.me
          Split into files aaaread.me, install.txt, whatsnew.txt, changes.txt.
     drivers.list
          Add warning that use of GIDRIV may require a license. Add /WD and
          /VWD (X-window dump files). Add comments to discourage people from
          trying to use PC drivers on UNIX systems. Revise /VERS and /VVERS.
     makehtml
          New perl script now generates syntactically correct html with
          cross-references [Diab Jerius].
     makemake
          Add instructions for SVdriv and WDdriv. Make it work with bash as
          well as sh. No longer makes pgplot.html by default. Remove VVdriv.
pgplot/drivers
     gidriv.f
          Avoid integer overflow (caused driver to crash on VAX/VMS). Add
          warning that use of this driver may require a license from Unisys.
     tfdriv.f
          Correct error in usage of GRFMEM.
     svdriv.c, svblock.c
          Restored from v4.9H (note: this driver for SunView is no longer
          supported: use XWdriv instead).
     vedriv.f
          Merge landscape and portrait modes in one driver.
     vvdriv.f
          Deleted.
     wddriv.f
          New file: generates X-window dump file [Scott Allendorf].
     xwdriv.c, pgxwin_server.c
          Fixes to datatypes of properties: corrects bugs found on Cray and
          Dec-Alpha (OSF/1). Support for all visual types, including TrueColor.
          Ability to set different attributes for each window via X resources.
          On VMS, checks that pgxwin_server has E or R access.
     x2driv.c, figdisp_comm.c
          Suppress warning messages produced by DECC compiler.
     bcdriv.f, ccdriv.f, hjdriv.f, ladriv.f, ljdriv.f, todriv.f, txdriv.f
          Eliminate use of routine gribf1.
pgplot/examples
     pgdemo2.f
          Add a test of an invisible polygon.
pgplot/fonts
     aaaread.me
          Note that pgunpack and pgdchar are unsupported.
pgplot/src
     grcurs.f
          Correct bug: start new picture if necessary.
     grldev.f
          Change ``Legal PGPLOT device types are:'' to ``Device types
          available:''.
     grmker.f
          Fix bug: viewport grew as symbols were plotted!
     pgband.f, pgcurs.f
          Issue message if device is not open.
     pggray.f, grgray.f
          PGGRAY now uses a color ramp between the colors assigned to color
          index 0 (background) and color index 1 (foreground). This should
          restore the old behavior: the ramp runs from black to white on
          devices with black background and white foreground, and from white to
          black on devices with white background and black foreground.
     pgpage.f
          If this routine detects that the size of the view surface has been
          changed (e.g., by a workstation window manager), it now rescales the
          viewport in proportion. Formerly the size of the viewport (in
          absolute units, e.g., mm) was not changed and so the viewport might
          extend outside the view surface. This only affects programs that do
          not reset the viewport for each page.
     pgpoly.f, grpocl.f
          Correct bug: an invisible polygon generated a spurious error message.
     pgqcs.f, pglen.f, pgqvsz.f
          Fix minor formatting errors in header comments.
     pgqinf.f
          Change version to 5.0.1.
     pgslw.f, pgqlw.f, grslw.f
          Correct header comments (line width unit is 0.005 inch).
pgplot/sys
     gribf1.f
          Deleted (also system-dependent variants).
     grfileio.c
          Add O_TRUNC to cause truncation when an existing file is overwritten.
pgplot/sys_convex
     fc_cc.conf
          Added -lX11.
pgplot/sys_cray
     aaaread.me
          Removed note about /XWIN: it now works.
     grfileio.c
          add O_TRUNC to cause truncation when an existing file is overwritten.
pgplot/sys_linux
     aaaread.me
          New file: note that many drivers cannot be compiled; note about
          disabling backslash interpretation.
     f77_gcc.conf
          Corrected to use ranlib, and revised list of libraries.
pgplot/sys_next
     pgview/PGView.m
          [Allyn Tennant] Correct resize bar.
     af77_src/grfileio.c
          add O_TRUNC to cause truncation when an existing file is overwritten.
pgplot/sys_sol2
     aaaread.me
          Added warning about non-ANSI C compilers.
pgplot/sys_sun
     aaaread.me
          Added note about SunView driver.
pgplot/sys_vms
     build.com
          Add PGQITF, PGSITF, PGPANL to transfer vector.
     grfileio.c
          Suppress warning messages produced by DECC compiler. Add O_TRUNC to
          cause a new version of the file to be created instead of overwriting
          (usual VMS behavior).
     grlgtr.f
          Convert supplied string to uppercase before attempting to translate
          it as a logical name.
     make_demos.com
          Correct comment.
     make_font.com
          Change protection of grfont.dat.

-------------------------------------------------------------------------------
PGPLOT Version 5.0

All changes are intended to be backwards-compatible: i.e., existing programs
should run correctly when recompiled, and recompilation should not be
necessary. Some programs may give slightly different results, owing to the bug
fixes described below.

New installation procedure

The installation procedure for UNIX systems has changed substantially, to allow
automatic generation of the makefile and the device dispatch routine
(grexec.f).

New C binding

This release of PGPLOT includes an experimental C binding for calling PGPLOT
from C programs. It consists of two files, a header file cpgplot.h that should
be included in C programs that call PGPLOT, and a system-dependent wrapper
library that encapsulates the manipulations necessary to call Fortran
subroutines from C programs (e.g, converting C null-terminated char arrays to
Fortran character strings). The wrapper library requires an ANSI-compliant C
compiler, and is not available on all systems (interlanguage calls are very
difficult or impossible on some systems).

Changes to device drivers

   *  PostScript: the PostScript device driver (device types /PS, /VPS, /CPS,
     and /VCPS) has been changed to handle the new PGIMAG routine. Use /CPS or
     /VCPS for color images. One side-effect is that the monochrome types (/PS
     and /VPS) now honor color representation changes requested by PGSCR,
     although they substitute a grey level for the requested color.
   * X-Window: the X-Window driver has had major changes to speed it up, make
     it more portable, and add new features. The window is now resizable, and
     it is possible to specify that it stay up after the PGPLOT program exits.
     The driver provides support for the new cursor features in PGBAND. The
     number of colors reserved and the default placement of the window can be
     specified in X resources.
   * GIF (Graphics Interchange Format): a new driver to create GIF files (type
     /GIF or /VGIF).
   * PPM (Portable Pixmap): a new driver to create PPM files (type /PPM or
     /VPPM).
   * Many of the other drivers have been cleaned up to make them more portable.

New routines

For details of all the PGPLOT routines, see file pgplot.doc or pgplot.html that
the installation procedures puts in the pgplot directory. The file pgplot.html
can be viewed with Mosaic (e.g., Mosaic /usr/local/pgplot/pgplot.html).

   * PGSCIR, PGQCIR: set/query the range of color indices used by routines
     PGGRAY and PGIMAG.
   * PGERAS: erase screen without advancing to new page.
   * PGCONL: for labelling contours drawn with PGCONT.
   * PGBAND: new cursor routine, with many more features than PGCURS including
     cross-hairs and rubber-bands (on devices that support this; currently only
     X-window).
   * PGIMAG: new routine (like PGGRAY) for color images.
   * PGCTAB: for generating a color table for use with PGIMAG.
   * PGSITF/PGQITF: set/query the image transfer function used by routines
     PGGRAY and PGIMAG.
   * PGPANL: to move to a different panel when the view surface has been
     divided into panels with PGBEG or PGSUBP.

The pgdem* programs in pgplot/examples have been enhanced to demonstrate the
new routines, and there are new demos programs (10--12).

Enhanced routines

   * PGBOX: new options for forcing decimal or exponential labeling.
   * PGBEG (PGBEGIN): now parses device specifications differently, so that
     file names including slash characters do not need to be quoted.
   * PGCONX: contours are now traced in a consistent direction (clockwise or
     anticlockwise).
   * PGGRAY: enhanced to allow use of linear, log, or square-root mapping of
     array value onto image brightness (see PGSITF).
   * PGPIXL: new algorithm makes smaller PS files that print faster.
   * PGPAGE: no longer beeps when prompting for next page.

Bugs fixed

   * PGNUMB: the FORM argument was ignored, but is now used as documented.
   * PGPAP (PGPAPER) was boken in 4.9H; it now works as documented, and can be
     used to change size between pages.
   * PGQCR: now works as advertised (on most devices).
   * Calling PGSCR before starting a new page (or defining PGPLOT_BACKGROUND or
     PGPLOT_FOREGROUND) no longer creates a blank page in the graphics file.
   * Filled polygons are now correctly clipped against the window on all
     devices; formerly they were not clipped on PostScript and X-Window
     devices.
   * The unit of line-width in PGSLW is now 0.005 inch on all devices.
   * Sometimes markers centered exactly on the edge of the window were not
     drawn when they should have been.

-------------------------------------------------------------------------------
Tim Pearson, California Institute of Technology, tjp@astro.caltech.edu
Copyright © 1995 California Institute of Technology
