home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / developm / source / povsrc.sit / MACHINE / UNIX.ZIP / UNIX.DOC < prev    next >
Encoding:
Text File  |  1992-06-21  |  3.4 KB  |  81 lines
  1. This file contains the documentation specific to UNIX systems.  Due to the
  2. wide variety of UNIX systems available, POV-Ray may not compile directly
  3. as is.  Every effort has been made to make it compile on as many systems as
  4. we have access to.  If you have problems compiling, try checking with a
  5. local UNIX guru first.  If you still have problems, contact the POV-Ray team.
  6.  
  7. If you are trying to compile POV-Ray on an unsupported platform, the UNIX
  8. version is the best one to use as a base.
  9.  
  10.  
  11. Differences from original distribution:
  12.    The original distribution of POV-Ray is in ZIP format.  For UNIX,
  13.    this has been converted to compressed TAR format.  In addition, the UNIX
  14.    distribution of POV-Ray has CR-LF pairs converted to only LF's for text
  15.    files.  Otherwise, this distribution is identical to the ZIP
  16.    distribution.
  17.  
  18. Note: PLEASE SEE POVLEGAL.DOC.  The UNIX version in tar-compress format is an
  19.    officially supported format and can be distributed as is.  You MAY NOT
  20.    re-package the archive file or distribute any changes to it.  If you
  21.    do post it on a BBS or network, you must provide at least the scene
  22.    files and documentation files with the executables.  See POVLEGAL.DOC
  23.    for complete details.
  24.  
  25. Executables:
  26.    No executables are provided for the UNIX version of POV-Ray since there
  27.    are so many possible executable formats.  In general, however, UNIX
  28.    systems come bundled with a C compiler, so recompiling the source for
  29.    your target system shouldn't cause a problem. You may not distribute
  30.    an executable that you have compiled. It is for your personal use only.
  31.    
  32. Display Formats:
  33.    There are two different ways to create a UNIX system.  The first way has
  34.    no display options (i.e., it cannot display the image as it's rendering it).
  35.  
  36.    Alternatively, if you have X-Windows, you can compile in the X-Windows
  37.    drivers.  See the section on building the source.
  38.  
  39. File Formats:
  40.    The default file format for UNIX is "dump" format (+fd).  Targa or
  41.    raw may be specified on the command line or in the povray.def file.
  42.  
  43. Building the source:
  44.    POV-Ray should compile as is with most ANSI or non-ANSI UNIX compilers.
  45.    No changes should be needed in the core of the raytracer.
  46.  
  47.    To compile POV-Ray from the original source, follow the following
  48.    instructions:
  49.  
  50.       1) copy the files in the "source" directory into a "build" directory
  51.       2) copy the files in machine/unix to the build directory
  52.           (note, if your archive is in ZIP format, you probably have CR-LF
  53.            pairs in the source code.  These should be translated to LF's
  54.            only before you compile)
  55.       3) rename config.h to config.h
  56.           (This file may need to be editted on a system by system basis)
  57.  
  58.       For the non-X-Windows version:
  59.       4) rename unix.mak to makefile
  60.  
  61.       For the X-Windows version,
  62.       4) rename xwindows.mak to makefile
  63.  
  64.       5) Type "make"
  65.  
  66.  
  67.    Your executable will be called povray.
  68.  
  69. Post-processing Images:
  70.    POV-Ray images can be post-processed using the same utilities as DKBTrace
  71.    used.  For UNIX systems, the PBM utilities are an excellent choice for
  72.    post-processing utilities.  The 'dump' format of POV-Ray is the same as
  73.    QRT format, so the QRTTOPPM utility can be used to convert these files
  74.    to PPM format.
  75.  
  76. Questions and problems in the UNIX version can be directed to David Buck.
  77.  
  78. David Buck
  79. Internet:   dbuck@ccs.carleton.ca
  80. CompuServe: 70521,1371
  81.