plplot68k-5.0.1 5.0.1

Short:        PLPLOT Plotting Library
Author:       opensource/various
Uploader:     stephen ferrell gmail com (Stephen Ferrell)
Type:         gfx/show
Version:      5.0.1
Requires:     iff.library, reqtools.library
Architecture: m68k-amigaos >= 3.0
Distribution: Aminet




Requirements for building PLplot 5.0.1 on the Amiga
---------------------------------------------
The binaries are included in this archive for those who don't
want to attempt the build process.  The binaries for the demo
programs are also inlcuded.

To run the precompiled demos, extract the archive to your favorite
drive such as DH1:  Then open a shell and make the following
assign without the quotes:  "assign plplot: DH1:plplot"
Then navigate to the plplot/tmp folder and run any of the demos
such as x01c thru x19c 

I used the following utilities to build PLplot:

    make		(PD version from Fred Fish Disk #69)
    sksh		(for shell scripts)
    MakeLink		(Stefan Becker's MakeLink replacement)
    SAS/C 6.x
    reqtools.library
    iff.library

GNU make found on Aminet may also work but is untried.  



Build procedure
---------------

If you are running SKsh, the build procedure for the library is very simple.
Assuming you are in the plplot/tmp directory, type:

make [optional targets]

After building the library, you can compile the first demo program by typing:

make x01c

The process is the same for x02c thru x19c 


Notes: 

- Prior running make you can edit the configure script to change
  the math setting (default is IEEE single precision, but FFP and IEEE
  double are also supported).  
- Prior to running make you can edit the Makefile to turn on debug or optimize.


If you aren't using SKsh, you can still build PLplot using the supplied
Makefile in the tmp direcctory.

If you build the makefile with "math" set to "ieee" (default) or "ieeed"
it uses the cbm-supplied IEEE math libraries.  The nice thing about doing
it this way is that the presence of the FPU is detected at runtime and it
is used.  So the same executable can be used on machines with and without
FPU's.  

Makefile targets
----------------

Simply typing "make" builds the library and support tools.

Other targets:

	% make x01c

for the first C demo, or

	% make cdemos

for all demos.  

	% make install

copies PLplot files into plplot:bin, plplot:lib, plplot:doc, etc.  Take a
look at the "install" target in the Makefile for more info.

PLplot Amiga Release Notes
--------------------------

The screen driver uses GadTools and ReqTools, giving it a much nicer look, more
functionality, and better maintaintability than previous verions.  Also makefile.m4 now uses
SAS/C 6.x for compilation.  

The current status of the drivers is as follows:
1. The window/screen driver works great, using ReqTools for requesters
and GadTools for menus.  The only menu entries that do anything at present
are:
	Save as ILBM
	Quit
	Screen Mode
	Change Palette 0

The PLplot window is now borderless and always opens on a custom screen.
The type of screen and dimensions are the same as workbench -- eventually
you'll be able to save the configuration.  You can use any of the screen
types supported by the OS.  Screens larger than the available display
area will autoscroll.

The screen driver will ultimately support dumps to any PLplot output
device.  The printer dumps will be incorporated into this scheme.

2. The IFF driver is virtually unchanged.  I am planning to upgrade this
to support color.

3. The printer driver is unchanged, but somewhere I introduced a bug
so that plots come out extremely small.  I will fix this when I get a
chance but it'll be fixed a lot faster if someone sends me a patch..

------------------------------------------------------------------------------
Miscellaneous notes:

One can get a cheap zoom with the Amiga windows by defining, for example, 
a 2000x2000 window (in the screen mode requester).