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