home *** CD-ROM | disk | FTP | other *** search
/ Chestnut's Multimedia Mania / MM_MANIA.ISO / graphics / povsrc20 / amiga.doc < prev    next >
Text File  |  1993-09-21  |  6KB  |  126 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
  6.    Amiga, 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
  8.    text files.  Otherwise, the Amiga distribution is identical to the
  9.    ZIP 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
  13.    NOT re-package the archive file or distribute any changes to it.  If
  14.    you do post it on a BBS or network, you must provide at least the
  15.    scene files and documentation files with the executables.  See
  16.    POVLEGAL.DOC for complete details.
  17.  
  18. Executables:
  19.    Two executables are provided:
  20.       povray881  - The version for systems with 68881 math coprocessors.
  21.       povrayieee - The version for systems without a coprocessor.
  22.  
  23. Running POV-Ray:
  24.    When running POV-Ray, be sure that you have a large stack set.  If
  25.    the stack is too small, POV-Ray could crash without warning.  Mine is
  26.    set to 50,000 bytes.
  27.  
  28. Memory Requirements:
  29.    POV-Ray can run on simple files with 1 Meg of memory.  I would highly
  30.    recommend having more memory to render more complicated scenes.
  31.    There's a known bug in this version which prevents POV-Ray from
  32.    cleaning up gracefully if it runs out of memory in some instances. 
  33.    If this occurs, the cancel requestor will not be closed.  If you
  34.    click on it, the system will probably hang or reboot.  This should be
  35.    fixed in the next release.
  36.  
  37. Display Formats:
  38.    The Amiga version of the raytracer supports three types of display
  39.    formats:
  40.       +d0     - HAM  (default)
  41.       +dE     - HAME
  42.       +dF     - Firecracker
  43.  
  44.    By default (or the +d0 switch), a display will be generated in HAM6
  45.    according to the image size.  If the image is not wider than 368
  46.    pixels, the display's horizontal mode is lo-res.  If the image is
  47.    wider than 368 pixels, the display's horizontal mode is hi-res.  If
  48.    the image is not taller than 241 pixels, the display's vertical mode
  49.    is non-interlaced.  If the image is taller than 241 pixels, the
  50.    display's vertical mode is interlaced.  Images that are smaller than
  51.    the nominal screen size are centered in the screen.  Images that are
  52.    larger than the nominal screen size are displayed in overscan.  Note
  53.    that not all machines can display a hi-res HAM6 screen.  If your
  54.    machine cannot display a particular screen, the screen-open call will
  55.    fail and an error will be displayed.
  56.  
  57.    The HAME mode is always 320 x 200 pixels.
  58.  
  59.    The firecracker mode adjusts the resolution according to the -w
  60.    (width) parameter of the raytracer.
  61.       320  <= w < 0     use 320  x 482
  62.       640  <= w < 320   use 640  x 482
  63.       768  <= w < 640   use 768  x 482
  64.       1024 <= w < 768   use 1024 x 482
  65.  
  66. File Formats:
  67.    The default file format for the Amiga is "dump" format (+fd).  Targa
  68.    or raw may be specified on the command line or in the povray.def
  69.    file.
  70.  
  71. Building The Source:
  72.    POV-Ray was compiled using Lattice (now SAS) version 5.10b.  I'm sure
  73.    that later versions will work.  If you're compiling with another
  74.    compiler, you'll have to edit the makefile to set the proper compiler
  75.    options.  As far as that goes, you're on your own.
  76.  
  77.    To compile POV-Ray from the original source, follow these
  78.    instructions:
  79.       1) copy the files in the "source" directory into a "build"
  80.          directory.
  81.       2) copy the files in the "machine/amiga" directory to the "build"
  82.          directory.
  83.       3) rename file "amigacon.h" to "config.h".
  84.       4) rename file "amiga.mak" to "makefile".
  85.       5) if you're building an IEEE executable, you must edit the
  86.          makefile, comment out the line for "CFLAGS = ..." for the '881
  87.          and uncomment the line "CFLAGS = ..." for the IEEE emulator.
  88.          Type "lmk povrayieee".
  89.       6) To compile a 68881 version of POV-Ray, leave the original
  90.          makefile unaltered and type "lmk".
  91.  
  92. Post-Processing Images:
  93.    A utility called dump2iff has been included in the executable archive
  94.    to convert the POV-Ray format output to IFF HAM format.  To run this
  95.    utility, you must provide the names of the input and output files.
  96.    eg.
  97.       dump2iff picture.dis picture.ham
  98.  
  99.    The dump2iff program can also write out a file containing the palette
  100.    it used to make the image.  It can then be told to use this palette
  101.    for when converting other images.  This is useful for making
  102.    animations for animation players that can't change color palettes
  103.    between frames.
  104.  
  105.    To output a palette, use the -p option of dump2iff:
  106.       dump2iff -ppicture.pal picture.dis picture.ham
  107.  
  108.    To use this palette for other images, simply add it to the command
  109.    line:
  110.       dump2iff pic2.dis pic2.ham picture.pal
  111.  
  112.    By default, dump2iff will perform dithering to help smooth out the
  113.    color changes.  To disable dithering, use -d on the command line.
  114.  
  115.    "The Art Department Professional" by ASDG does a fine job of post-
  116.    processing images.  ADPro can accept QRT format images (which is the
  117.    format output by POV-Ray with the +fd command-line parameter).  Al-
  118.    ternatively, you can output Targa (+ft) or raw (+fr).  To read the raw
  119.    format into ADPro, use the Scuplt reader.  You'll have to type in the
  120.    resolution you used to generate the image.
  121.  
  122. Comments and suggestions about the Amiga version can be directed to me:
  123.    Dave Park
  124.    Internet:   70004.1764@CompuServe.com
  125.    CompuServe: [70004,1764]
  126.