home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / maths / plplot / plplot_2 / sys / amiga / README.ami < prev   
Encoding:
Text File  |  1994-08-23  |  4.9 KB  |  130 lines
  1.  
  2. Requirements for building PLplot on the Amiga
  3. ---------------------------------------------
  4.  
  5. I use the following utilities to build PLplot:
  6.  
  7.     make        (PD version, ported from mod.sources posting)
  8.     sksh        (for shell scripts)
  9.     MakeLink        (Stefan Becker's MakeLink replacement)
  10.     SAS/C 6.x
  11.     reqtools.library
  12.     iff.library
  13.  
  14. I may eventually switch to GNU make, I just haven't had the time to look
  15. into it.  
  16.  
  17. Beginning with PLplot 4.99h, precompiled versions of plplotf.lib,
  18. plrender, and some of the demo programs are available by anonymous ftp
  19. from dino.ph.utexas.edu as plplot/amiga/plamiga.lha.
  20.  
  21. Build procedure
  22. ---------------
  23.  
  24. If you are running SKsh, the build procedure is very simple.  Assuming
  25. you are in the distribution directory, type:
  26.  
  27. 1. cd tmp
  28. 2. chmod +s ../sys/amiga/configure
  29. 3. ../sys/amiga/configure
  30. 4. make [optional targets]
  31.  
  32. Notes: 
  33. - Step 2 fixes the script bit which may have been lost during transit.  
  34. - Prior to step 3 you can edit the configure script to change
  35.   the math setting (default is IEEE single precision, but FFP and IEEE
  36.   double are also supported).  
  37. - Prior to step 4 you can edit the Makefile to turn on debug or optimize.
  38.  
  39. The configure script (a) creates the Makefile, (b) creates "Makedemo", a
  40. standalone makefile for the demo programs, (c) creates links to all the
  41. necessary source files.  Soft links are best for this purpose, as you can
  42. edit the original file and the link is automatically updated, forcing make
  43. to do a rebuild.  This nice behavior does not occur for hard links -- once
  44. the hard link is made the contents are always preserved, even if you
  45. modify the original file.  
  46.  
  47. If you are running 2.0, you can in fact use soft links (except on the ram
  48. disk), with Stefan Becker's MakeLink replacement.  Unfortunately, most
  49. utilities don't deal with them correctly.  Also, the syntax for MakeLink
  50. is rather cumbersome (compared to the Unix ln), and currently there is no
  51. easy way to use it except with the provided 'lnsoft' script for use under
  52. SKsh.  One caveat: if you delete or move a file pointed to by a soft link,
  53. most filesystem utilities no longer can delete the soft link!  About the
  54. only way I've been able to delete the soft link in this case is to go into
  55. workbench and remove the entire directory containing the links.
  56.  
  57. If you aren't using SKsh, you can still build PLplot using the supplied
  58. Makefile and Makedemo files in the sys/amiga/cf directory.  These may not
  59. always be up-to-date, however.  In place of links you can always use file
  60. copies.
  61.  
  62. If you build the makefile with "math" set to "ieeef" (default) or "ieeed"
  63. it uses the cbm-supplied IEEE math libraries.  The nice thing about doing
  64. it this way is that the presence of the FPU is detected at runtime and it
  65. is used.  So the same executable can be used on machines with and without
  66. FPU's.  There is a small speed penalty with doing it this way, but nothing
  67. I felt uncomfortable with when I tested it last (on the order of a few
  68. percent).
  69.  
  70. Makefile targets
  71. ----------------
  72.  
  73. Simply typing "make" builds the library and support tools.
  74.  
  75. Other targets:
  76.  
  77.     % make x01c
  78.  
  79. for the first C demo, or
  80.  
  81.     % make cdemos
  82.  
  83. for all demos.  
  84.  
  85.     % make install
  86.  
  87. copies PLplot files into plplot:bin, plplot:lib, plplot:doc, etc.  Take a
  88. look at the "install" target in the Makefile for more info.
  89.  
  90. PLplot Amiga Release Notes
  91. --------------------------
  92.  
  93. The Amiga drivers are still under development.  The new screen driver now
  94. uses GadTools and ReqTools, giving it a much nicer look, more
  95. functionality, and better maintaintability.  Also makefile.m4 now uses
  96. SAS/C 6.x for compilation.  I plan eventually to make available
  97. precompiled, optimized libraries to reduce some of the difficulty in
  98. building PLplot (and perhaps non-optimized versions as well).
  99.  
  100. The current status of the drivers is as follows:
  101. 1. The window/screen driver works great, using ReqTools for requesters
  102. and GadTools for menus.  The only menu entries that do anything at present
  103. are:
  104.     Save as ILBM
  105.     Quit
  106.     Screen Mode
  107.     Change Palette 0
  108.  
  109. The PLplot window is now borderless and always opens on a custom screen.
  110. The type of screen and dimensions are the same as workbench -- eventually
  111. you'll be able to save the configuration.  You can use any of the screen
  112. types supported by the OS.  Screens larger than the available display
  113. area will autoscroll.
  114.  
  115. The screen driver will ultimately support dumps to any PLplot output
  116. device.  The printer dumps will be incorporated into this scheme.
  117.  
  118. 2. The IFF driver is virtually unchanged.  I am planning to upgrade this
  119. to support color.
  120.  
  121. 3. The printer driver is unchanged, but somewhere I introduced a bug
  122. so that plots come out extremely small.  I will fix this when I get a
  123. chance but it'll be fixed a lot faster if someone sends me a patch..
  124.  
  125. ------------------------------------------------------------------------------
  126. Miscellaneous notes:
  127.  
  128. One can get a cheap zoom with the Amiga windows by defining, for example, 
  129. a 2000x2000 window (in the screen mode requester).  
  130.