gfx/XaoS/INSTALL

   1 For Unix/X11:
   2
   3    To compile XaoS you need optimizing ansi compatible C compiler
   4    and at least one of the following libraries:
   5     o Xlib
   6     o SVGAlib
   7     o curses
   8    To compile XaoS with image saving code you also need zlib and
   9    pnglib installed. They are available at:
  10
  11    ftp://ftp.uu.net/graphics/png/src/zlib-0.95.tar.gz
  12    ftp://ftp.uu.net/graphics/png/src/libpng-0.81.tar.gz
  13
  14    XaoS now have configure script so following should work correctly:
  15
  16         CFLAGS=(your best size optimizing switches)
  17         CFLAGS1=(your best speed optimizing switches)
  18         export CFLAGS
  19
  20            #note that this two steps are not required on pc/Linux
  21            #and on all gcc compilers XaoS uses quite good switches.
  22            #but this is REQUIRED for other compilers, because XaoS
  23            #is coded to be good target for optimizer and NEEDS to
  24            #be optimized to work in reasonable speed
  25
  26         ./configure [options...usually not required]
  27         make
  28         make install
  29
  30    You may also read compilers.txt, that contain info about various
  31    compiler, best optimizing switches and common problems, since XaoS
  32    often forces compilers (including gcc) to crash/generate wrong code
  33
  34    For better results:
  35    Edit config.autoconf to reflect your system.
  36
  37    IMPORTANT NOTE:
  38    XaoS sould optionally use long double for zooming. It allows
  39    deeper zooms with no performance lost at intel platforms. Some
  40    other platforms supports long double too, but it is usually
  41    emulated so it is incredibly slow. Configure script by default
  42    enables long double just at i?86 and unknown processors.
  43
  44    If you have processor reported as unknown that is non intel and
  45    XaoS is incredibly slow, please try:
  46    ./configure -with-long-double=no
  47    make clean;
  48    make
  49    to recompile XaoS. Please let me know about this problem, so
  50    autodetection should be included into future versions of configure
  51    script.
  52
  53    If you have time to experiment and some non intel-compatible
  54    platform, please try:
  55    ./configure -with-long-double=yes
  56    make clean
  57    make
  58    And try whether XaoS still works at same speed(framerate is displayed
  59    using l key) and let me know in case that XaoS still works at same
  60    higher/bit slower(not 100times or so) speed, so I should your platform
  61    autodetect in future version of script. I did unsucesfull test at
  62    following archiotectures/processors:
  63    HP425e - Motorola MC68040
  64    HP700 - Parisc
  65    SGI
  66    SUN
  67    But it should change at various processor types, so I don't say
  68    that all SGI's or SUNs does not work with long double.
  69
  70    options available:
  71      By default XaoS will try to configure and compile following drivers
  72       X11
  73       SVGAlib
  74       Curses
  75      This may cause some problems. To reduce binary file size and/or
  76      solve such problems you may disable driver using:
  77       --with-x11-driver=no     to disable X11 driver
  78       --with-svga-driver=no    to disable SVGAlib driver
  79       --with-curses-driver=no  to disable (N)Curses driver
  80      There may be problems with configuring bit non standard curses
  81      library. You may use following options:
  82       --with-sunos-curses     Used to force SunOS 4.x curses
  83       --with-osf1-curses        Used to force OSF/1 curses
  84       --with-vcurses[=incdir] Used to force SysV curses
  85       --with-ncurses[=base-dir] Compile with ncurses/locate base dir
  86       --with-x                use the X Window System
  87      Also finding X includes should be problem.
  88       --x-includes=DIR        X include files are in DIR
  89       --x-libraries=DIR       X library files are in DIR
  90      For Linux gpm library use:
  91       --with-gpm-mouse=base-dir  Specifies the base gpm directory
  92      To enable experimental SMP support use:
  93       --with-pthread=yes
  94      note that it is really untested in version 3.0 since I don't have
  95      SMP machine :) (someone who should lend me some?)
  96
  97      Threaded version works well with aadriver, partially (w/o console
  98      switching) with SVGAlib driver and X11 driver needs patched Xlib
  99      for threads. I believe it will be normal soon (when glibc will
 100      become more popular)
 101
 102    Note that XaoS is automatically installed with sticky bit enabled when
 103    svgadriver is compiled, but it is sticky bit safe since it switches to
 104    normal privilegies after drivers are initialized.
 105
 106
 107 For DOS:
 108    You need djgpp gnu compiler, allegro graphics, zlib and pnglib
 109    Use:
 110
 111         build.bat
 112
 113 For Mac:
 114     Read README.mac for more informations
 115 For plan9:
 116     XaoS comes with mk script because I am unable to write functional
 117     mkfile on my reduced system.
 118     start mk and wait..
 119
 120
 121 You may also get binary distribution.
 122 For more information browse XaoS homepage