summaryrefslogtreecommitdiff
path: root/support/gplot
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /support/gplot
Initial commit
Diffstat (limited to 'support/gplot')
-rw-r--r--support/gplot/README.DRAWCGM56
-rw-r--r--support/gplot/README.GPLOT45
-rw-r--r--support/gplot/README.HDF76
-rw-r--r--support/gplot/history5
4 files changed, 182 insertions, 0 deletions
diff --git a/support/gplot/README.DRAWCGM b/support/gplot/README.DRAWCGM
new file mode 100644
index 0000000000..78c3b31f1b
--- /dev/null
+++ b/support/gplot/README.DRAWCGM
@@ -0,0 +1,56 @@
+ RELEASE DESCRIPTION
+
+This release (3.4) of the CGMGen and DrawCGM software contains several
+minor bug fixes and a couple of new routines. Color handling under
+Sun X11/NeWS has been fixed, preventing a lot of miscoloring and some
+crashes on that platform. A bug which resulted in crashes with long
+lists of circular polymarkers under the 'xws' device driver has been
+fixed. (Both of these fixes are in the 'xws' driver, and not DrawCGM
+proper). The CGRID and CIRCLE routines have been added to draw
+circles and coordinate grids respectively, and the OUTFIL routine
+has been added to allow setting of the output file name.
+
+ INTALLATION INSTRUCTIONS
+
+This software is designed to run on VMS systems, and Unix systems
+including UNICOS and Ultrix. To install the software under VMS,
+copy the GPlot directory tree to the VMS machine and edit the
+descrip.mms file in the main (gplot) directory to include the device
+drivers and GPlot controllers you want. Use the following command
+to cause VAX MMS to create the DrawCGM library and the four test
+routines cgmgen_test.exe, drawcgm_test.exe, drawcgm_tst2.exe, and
+clip_test.exe:
+
+ $ mms drawcgm.olb tests
+
+On Unix systems, untar or copy the GPlot directory tree and edit the
+Makefile in the main (gplot) directory to accomodate your machine and
+include the device drivers and controllers you want. The following
+command will cause make to create the DrawCGM library and the four test
+programs listed above:
+
+ $ make drawcgm tests
+
+If you are using the Vax C compiler, you may need to compile and include
+the .jbl files included in the distribution to properly resolve entry points
+referenced from FORTRAN but resolved from C. If you have this problem,
+simply compile the .jbl files and merge them into the DrawCGM object library.
+
+The descrip.mms and Makefile files can also be used to make GPlot, of
+course.
+
+ HINTS
+
+The most trouble-prone part of the current implementation is the
+system used to cause pauses at the end of frames when DrawCGM is
+used interactively. In general, if STPAUS has been called, at the
+end of each frame (in response to NEWFRM or GRFCLS) the terminal
+bell will ring and the program will wait for the user to hit return
+before continuing. This works fine in most cases, but on the Cray
+under UNICOS, a carriage return is not sufficient to continue at
+the end of a frame. Use a space followed by a carriage return
+instead. This is a consequence of the behavior of Cray CFT77
+Fortran.
+
+
+
diff --git a/support/gplot/README.GPLOT b/support/gplot/README.GPLOT
new file mode 100644
index 0000000000..8ec94777ef
--- /dev/null
+++ b/support/gplot/README.GPLOT
@@ -0,0 +1,45 @@
+ Pittsburgh Supercomputing Center
+ Release of GPLOT (4.3b2) -- Oct. 30, 1991
+
+This is the official release of GPLOT 4.3b2 available through anonymous
+ftp from ftp.psc.edu:/pub/gplot. This is a small bug fix version, and
+differs slightly from gplot 4.3b1.
+
+This release also includes the 3.3 release of CGMGen and DrawCGM software.
+To get the release information for DRAWCGM, please take a look at the file
+README.DRAWCGM.
+
+If you are interested in getting the HDF driver for GPLOT, please get
+the file README.HDF and hdfdev.tar.Z.
+
+The files necessary to create GPLOT are available in two forms.
+
+(1) If you are on a Unix system, FTP the file gplot.tar (using binary
+ format), move it into its own directory (gplot), and un-tar it
+ using the command 'tar xf gplot.tar'.
+
+ The Makefile contains a complete Unix makefile. You will need to modify
+ the Makefile to include a workstation driver of your choice according to
+ the included directions and use it to make gplot and drawcgm. Please
+ read the instructions before making any changes to the Makefile.
+
+ A note about the two X window drivers : xl and xws
+ ---------------------------------------------------
+ xl works great with simple cgm files, and is fast, but does not have
+ colormaps installed.
+ xws has colormaps and good dithering techniques. So it can be used for
+ cell array cgm files, but the rendering process can be slow.
+
+ The interfaces "gplotdw", "gplotaw" and "gplotm" use xl by default.
+ If you wish to change that to use xws, you will need to edit the
+ Makefile appropriately.
+
+
+(2) If you are on a VMS system, copy all the files in the 'src' directory,
+ and use the descrip.mms file (if you are running MMS) or use the file
+ MAKEGPLOT.COM to construct GPLOT.
+
+
+When you take a copy of GPLOT, please send mail to Anjana Kar (kar@a.psc.edu)
+so we can add you to our mailing list. Bug reports should be sent to Anjana
+at that address.
diff --git a/support/gplot/README.HDF b/support/gplot/README.HDF
new file mode 100644
index 0000000000..9c78be3306
--- /dev/null
+++ b/support/gplot/README.HDF
@@ -0,0 +1,76 @@
+What this is:
+
+ The six files in this package (available as hdfdev.tar.Z) are the
+ necessary additions to Gplot 4.3b1 in order to add a new device
+ which produces output in HDF format.
+
+ Gplot 4.3b1 (available from PSC as ftp.psc.edu:pub/gplot/gplot.tar)
+ and HDF 3.10r4 (available from NCSA as ftp.ncsa.uiuc.edu:HDF/tar3.1/*)
+ are needed to make this driver operational. The files included here are:
+
+ Makefile.cdif \ Context diffs of the files "Makefile" and
+ devices.cdif / "devices.c" from the Gplot 4.3b1 package.
+
+ hdf.h \
+ hdf.c \ New files that make up the hdf Gplot driver.
+ rline.c /
+ rpoly.c /
+
+
+Setup:
+
+ All that you need to do is extract these files into your main Gplot
+ source directory, then type the following lines to update your
+ Makefile and devices.c files:
+
+ patch < Makefile.cdif
+ patch < devices.cdif
+
+ If patch does not exist on your machine, then you will have to patch
+ these files by hand.
+
+ The Makefile expects the HDF library to be installed as libdf.a in a
+ standard library search location; if this file is located someplace
+ else or called something else, then modify the HLIBS line in the
+ Makefile. The files df.h and dfi.h (both from the HDF distribution)
+ are also expected to be found in a standard header search location;
+ if they are located someplace else, then add an appropriate -I<dir>
+ flag to the CFLAGS line in the Makefile.
+
+ NOTE: You must be sure to set the MACHINE line in the Gplot
+ Makefile to be the same as it was set in the HDF Makefile; any
+ errors while processing dfi.h are usually a result of MACHINE not
+ being set correctly.
+
+ Once these changes have been made and the Makefile configured for
+ your site, all you need to do is type "make" and you will get a new
+ Gplot executable with a "hdf" device that produces HDF raster images
+ from CGM files. Each image from the CGM file is placed into its own
+ HDF file; the first image is placed in the file "cgm0000.hdf", the
+ second in "cgm0001.hdf", etc. The device "hdf2" will place all the
+ images from the cgm file into a single "cgm.hdf" HDF file.
+
+
+Limitations:
+
+ Currently, the following functions are unavailable:
+
+ - Conversion of direct color CGM images into HDF raster images.
+ - Pattern and hatch fill of polygons.
+
+
+Support:
+
+ This Gplot device driver was written by Michael Mull of the San
+ Diego Supercomputing Center. He is providing support for this
+ device driver and any questions or problems should be directed
+ towards him. His InterNET mailing address is:
+
+ mullm@sdsc.edu
+
+ Problems with this patch kit should be directed toward Brian Kircher
+ and Anjana Kar of the Pittsburgh Supercomputing Center at the
+ following InterNET mailing addresses:
+
+ kircher@a.psc.edu
+ kar@a.psc.edu
diff --git a/support/gplot/history b/support/gplot/history
new file mode 100644
index 0000000000..f61b082d53
--- /dev/null
+++ b/support/gplot/history
@@ -0,0 +1,5 @@
+August 4, 1994: Updated file xws_color.c,and made a new tar file.
+April 27, 1995: Installed new lvr_io.c (for 9600 BR on LVR) and made
+ a new tar file.
+May 1, 1995: Fixed a bug in lvr.c (flip_unix)
+May 10, 1995: Fixed End Frame reporting error in lvr.c (lvr_end)