home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / developm / source / povsrc.sit / MACHINE / AMIGA.ZIP / AMIGA.DOC < prev    next >
Encoding:
Text File  |  1992-07-09  |  4.8 KB  |  116 lines
  1. This file contains the documentation specific to the Amiga version of
  2. POV-Ray.
  3.  
  4. Differences from original distribution:
  5.    The original distribution of POV-Ray is in ZIP format.  For the Amiga,
  6.    this has been converted to LZH format.  In addition, the Amiga
  7.    distribution of POV-Ray has CR-LF pairs converted to only LF's for text
  8.    files.  Otherwise, the Amiga distribution is identical to the ZIP
  9.    distribution.
  10.  
  11. Note: PLEASE SEE POVLEGAL.DOC.  The Amiga version in LZH format is an
  12.    officially supported format and can be distributed as is.  You MAY NOT
  13.    re-package the archive file or distribute any changes to it.  If you
  14.    do post it on a BBS or network, you must provide at least the scene
  15.    files and documentation files with the executables.  See POVLEGAL.DOC
  16.    for complete details.
  17.  
  18. Executables:
  19.    Two executables are provided:
  20.  
  21.    povray881  - The version for systems with 68881 math coprocessors
  22.    povrayieee - The version for systems without a coprocessor
  23.  
  24.    
  25. Running POV-Ray:
  26.    When running POV-Ray, be sure that you have a large stack set.  If the
  27.    stack is too small, POV-Ray could crash without warning.  I usually use
  28.    80,000 bytes, but then again, I have a lot of memory to spare.
  29.  
  30. Memory Requirements:
  31.    POV-Ray can run on simple files with 1 Meg of memory.  I would highly
  32.    recommend having more memory to render more complicated scenes.
  33.    There's a known bug in this version which prevents POV-Ray from cleaning
  34.    up gracefully if it runs out of memory in some instances.  If this occurs,
  35.    the cancel requestor will not be closed.  If you click on it, the system
  36.    will probably hang or reboot.  This should be fixed in the next release.
  37.  
  38. Display Formats:
  39.    The Amiga version of the raytracer supports three types of display
  40.    formats:
  41.  
  42.    +d0     - HAM  (default)
  43.    +dE     - HAME
  44.    +dF     - Firecracker
  45.  
  46.    The firecracker mode adjusts the resolution according to the -w (width)
  47.    parameter of the raytracer.
  48.  
  49.     320  <= w < 0     use 320 x 482
  50.     640  <= w < 320   use 640 x 482
  51.     768  <= w < 640   use 768 x 482
  52.     1024 <= w < 768   use 1024 x 482
  53.  
  54. File Formats:
  55.    The default file format for the Amiga is "dump" format (+fd).  Targa or
  56.    raw may be specified on the command line or in the povray.def file.
  57.  
  58. Building the source:
  59.    POV-Ray was compiled using Lattice (now SAS) version 5.05.  I'm sure that
  60.    later versions will also work fine.  If you're compiling with another
  61.    compiler, you'll have to edit the makefile to set the proper compiler
  62.    options.  As far as that goes, you're on your own.
  63.  
  64.    To compile POV-Ray from the original source, follow the following
  65.    instructions:
  66.  
  67.       1) copy the files in the "source" directory into a "build" directory
  68.       2) copy the files in machine/amiga to the build directory
  69.       3) rename amigacon.h to config.h
  70.       4) rename amiga.mak to makefile
  71.       5) if you're building an IEEE executable, you must edit the makefile,
  72.          comment out the line for "CFLAGS = ..." for the '881 and uncomment
  73.          the line "CFLAGS = ..." for the IEEE emulator.
  74.  
  75.          Type "lmk povrayieee"
  76.  
  77.       6) To compile a 68881 version of POV-Ray, leave the original makefile
  78.          unaltered and type "lmk".
  79.  
  80. Post-processing Images:
  81.    A utility called dump2iff has been included in the executable archive to
  82.    convert the POV-Ray format output to IFF HAM format.  To run this utility,
  83.    you must provide the names of the input and output files.
  84.  
  85.    eg.
  86.       dump2iff picture.dis picture.ham
  87.  
  88.    The dump2iff program can also write out a file containing the palette
  89.    it used to make the image.  It can then be told to use this palette for
  90.    when converting other images.  This is useful for making animations for
  91.    animation players that can't change color palettes between frames.
  92.  
  93.    To output a palette, use the -p option of dump2iff:
  94.       dump2iff -ppicture.pal picture.dis picture.ham
  95.  
  96.    To use this palette for other images, simply add it to the command line:
  97.       dump2iff pic2.dis pic2.ham picture.pal
  98.  
  99.    By default, dump2iff will perform dithering to help smooth out the color
  100.    changes.  To disable dithering, use -d on the command line.
  101.  
  102.    Personally, I've started using "The Art Department" by ASDG to
  103.    post-process my images.  The Art Department Professional can accept QRT
  104.    format images (which is the format output by POV-Ray with the +fd
  105.    command-line parameter). Alternatively, you can output Targa (+ft) or
  106.    raw (+fr).  To read the raw format into The Art Department, use the Scuplt
  107.    reader.  You'll have to type in the resolution you used to generate the
  108.    image.
  109.  
  110.  
  111. Questions and problems in the Amiga version can be directed to David Buck.
  112.  
  113. David Buck
  114. Internet:   dbuck@ccs.carleton.ca
  115. CompuServe: 70521,1371
  116.