home *** CD-ROM | disk | FTP | other *** search
/ BURKS 2 / BURKS_AUG97.ISO / SLAKWARE / XAP3 / XFRACT.TGZ / XFRACT.tar / usr / doc / xfractint / README
Text File  |  1997-04-10  |  4KB  |  94 lines
  1. Xfractint is the Unix port of fractint, which runs under X.
  2. Fractint is an IBM PC program to generate fractals, and was written by
  3. the the Stone Soup Group.  The Unix port was done by Ken Shirriff
  4. (shirriff@sprite.Berkeley.EDU).  Note: Xfractint is not as reliable as
  5. fractint and has several bugs.  Please send bug reports to Ken Shirriff.
  6.  
  7. HOW TO RUN:
  8.  
  9. If your distribution includes the directories xfmips, xfsparc, and xfalpha,
  10. you have the ready-to-run executables for the DECstation 5000, Sun Sparc,
  11. and Dec Alpha.
  12. To run, set the environment variable FRACTDIR to the appropriate directory:
  13. "setenv FRACTDIR /whatever/xfmips" (as appropriate),
  14. cd to the appropriate directory, and run "xfract".
  15. Note: you must have both the xfractint executable and the help file
  16. fractint.hlp.
  17. Note: If a filename ends in .Z, you must uncompress the file first,
  18. using the Unix "uncompress" command: "uncompress xfmips.Z".
  19.  
  20. xfrun is a shar archive file containing colormap, formula, etc. files
  21. associated with xfractint.
  22. To use these files, copy xfrun to a convenient directory and unshar
  23. it with "sh xfrun".  This will unpack a bunch of files.  Then copy the
  24. appropriate version of "fractint.hlp" and "xfract" to this directory
  25. and then setenv FRACTDIR to this directory.
  26.  
  27. HOW TO COMPILE:
  28.  
  29. The source code is in xfsrc, which is a shar archive file.  Copy this file
  30. to a convenient directory and unshar it with "sh xfsrc".
  31.  
  32. If you are compiling under SunOS, Ultrix, AIX, Linux, or HPUX, read the
  33. Makefile and uncomment the approprite lines.
  34.  
  35. Then, to compile, do:
  36. make xfractint
  37.  
  38. To find out what features are new in this version, look at the "versions" file.
  39.  
  40. GETTING MORE FRACTAL FORMULAS:
  41. Dan Goldwater (daniel_goldwater@brown.edu) has a huge collection of .map,
  42. .par, etc. files called FracXtra.  You can obtain it under the name
  43. FRACXTR5.ZIP from various sites such as
  44. The Graphics Alternative BBS, 510-524-2780 or anonymous ftp to
  45. wuarchive.wustl.edu in /mirrors/msdos/graphics.
  46.  
  47. NOTES ON POTENTIAL PROBLEMS:
  48.  
  49. Important: if you report a bug, _please_ specify what version of xfractint
  50. you are using.
  51.  
  52. Xfractint won't compile unless your compiler handles function prototypes.
  53. You have the best chance of compiling xfractint if you use gcc.  SunOS cc
  54. does not work.
  55.  
  56. To check if your compiler handles prototypes, try compiling the following
  57. two line program:
  58. int foo(int bar);
  59. main() {}
  60. If you get line 1: syntax error at or near type word "int"
  61. then your compiler doesn't handle prototypes, so you won't be able to
  62. compile xfractint.  (One person managed to use "unproto" from
  63. comp.sources.misc volume 26 to strip out the prototypes, so the standard
  64. Sun compiler would work.  You can try this, but I'm not supporting it.)
  65.  
  66. If you get "gcc: unrecognized option `-target'" when you compile, the
  67. problem is probably that you are using an old version of gcc (1.36).  You
  68. need a newer version.
  69.  
  70. If xfractint hangs in the title screen, the problem is probably that your
  71. display cannot update fast enough for the scrolling.  The solution is to
  72. use the -slowdisplay flag.
  73.  
  74. If you are using Openwindows and can't get xfractint to accept input, add
  75. to your .Xdefaults file:
  76. OpenWindows.FocusLenience:    True
  77.  
  78. To use all 256 colors, use the -private flag, discussed in the man page.
  79.  
  80. If you cannot view the GIFs that xfractint creates, the problem is that
  81. xfractint creates GIF89a format and your viewer probably only handles
  82. GIF87a format.  Run "xfractint gif87a=y" to produce GIF87a format.
  83.  
  84. The program is a straight port from the IBM PC, and it thus uses the IBM style
  85. user interface.  See the man page for more details, and a description of
  86. what to use for ctrl-pageup, etc.
  87.  
  88. DOCUMENTATION:
  89.  
  90. Running "make makedoc" will create a file fractint.doc, which contains the
  91. online documentation in ascii form.
  92.  
  93. See fractsrc.doc for copyright information on fractint.
  94.