home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / source / machine / amiga / amiga.doc < prev    next >
Encoding:
Text File  |  1994-01-11  |  6.9 KB  |  161 lines
  1. This file contains the documentation specific to the Amiga version of
  2. POVRay v2.1.
  3.  
  4. Differences From Original Distribution:
  5.  
  6.    The original distribution of POVRay is in ZIP format and contains
  7.    files in MS-DOS format.  The filenames are restricted to 8.3 characters
  8.    and the text files contain CRLF line terminators.  A script and a
  9.    utility to strip CRs, restore the long Amiga filenames, and create
  10.    icons is provided in the POVRAY/MACHINE/AMIGA directory.  Note that
  11.    none of the POVRay data files need be stripped of CRs as POVRay
  12.    accepts data files both with and without CRs.
  13.  
  14.    There are custom Amiga executable, documentation, and scene archives
  15.    that have been converted to LZH format and have been stripped of all CR
  16.    characters and include long Amiga filenames and Amiga icons.  The Amiga
  17.    executable archive contains two executable versions of POVRay, a
  18.    68881 and an IEEE version, two executable programs that perform image
  19.    postprocessing, one to HAM6 and one to IFF24, and two programs that
  20.    convert TGA files, one to GIF and one to DUMP.  Otherwise, the Amiga
  21.    distribution is identical to the ZIP distribution.
  22.  
  23. SEE POVLEGAL.DOC FOR USE AND DISTRIBUTION TERMS.
  24.  
  25.    The Amiga archive in LZH format is an officially supported and
  26.    distributed format.
  27.  
  28. Executables:
  29.  
  30.    Six executables are provided:
  31.       povray881  - The version for systems with 68881 math coprocessors.
  32.       povrayieee - The version for systems without a coprocessor.
  33.       dump2iff   - Converts POV output files to Amiga HAM6.
  34.       dump2i24   - Converts POV output files to Amiga IFF24
  35.       tga2dump   - Converts TARGA format to dump format.
  36.       tga2gif    - Converts TARGA files to GIF.
  37.  
  38. Running POVRay:
  39.  
  40.    When running POVRay, be sure that you have a large stack set.  If
  41.    the stack is too small, POVRay could crash without warning.  Mine
  42.    is set to 80,000 bytes.
  43.  
  44. Memory Requirements:
  45.  
  46.    POVRay can run on simple files with 1 Meg of memory.  I would
  47.    highly recommend having more memory to render more complicated
  48.    scenes.  There is a known bug in this version which prevents POVRay
  49.    from cleaning up gracefully if it runs out of memory in some instan-
  50.    ces.  If this occurs, the cancel requestor will not be closed.  If you
  51.    click on it, the system will probably hang or reboot.
  52.  
  53. Display Formats:
  54.  
  55.    The Amiga version of the raytracer supports four types of display
  56.    formats:
  57.       +d, +d0 - default
  58.       +d1     - HAM6
  59.       +d2     - HAM8
  60.       +dE     - HAME
  61.       +dF     - Firecracker
  62.  
  63.    By default, a display will be generated in HAM6 according to the image
  64.    size.  If the image is wider than 368 pixels, the display's horizontal
  65.    mode is hi-res, otherwise it is lo-res.  If the image is taller than
  66.    241 pixels, the display's vertical mode is interlaced, otherwise it is
  67.    non-interlaced.  Images that are smaller than the nominal screen size
  68.    are centered in the display screen.  Images that are larger than the
  69.    nominal screen size are displayed in overscan.  Note that not all
  70.    machines can display a hi-res HAM6 screen or an AGA screen.  If your
  71.    machine cannot display a particular screen, the screen-open call will
  72.    fail and an error will be displayed.
  73.  
  74.    The HAME mode is always 320 x 200 pixels.
  75.  
  76.    The firecracker mode adjusts the resolution according to the -w
  77.    (width) parameter of the raytracer.
  78.  
  79.       320  <= w < 0     use 320  x 482
  80.       640  <= w < 320   use 640  x 482
  81.       768  <= w < 640   use 768  x 482
  82.       1024 <= w < 768   use 1024 x 482
  83.  
  84. File Formats:
  85.  
  86.    The default file format for the Amiga is "dump" format (+fd).  Targa
  87.    or raw may be specified on the command line or in the povray.def file.
  88.  
  89. Building The Source:
  90.  
  91.    POVRay was compiled using SAS C version 5.10b.  I'm sure that later
  92.    versions will work.  If you're compiling with another compiler, you'll
  93.    have to edit the makefile to set the proper compiler options.  As far
  94.    as that goes, you're on your own.
  95.  
  96.    To compile POVRay from the original source, follow these instructions:
  97.       1) From a shell, CD to the POVRAY/MACHINE/AMIGA directory and
  98.          "execute dos2ami",  which is a script that will strip CRs from
  99.          the text files, restore long filenames, and install some icons.
  100.       2) Copy the files in the POVRAY/SOURCE directory into a POVRAY/
  101.          BUILD directory.
  102.       3) Copy from the POVRAY/MACHINE/AMIGA directory files 'amiga.c',
  103.          'config.h', and 'makefile' to the POVRAY/BUILD directory.
  104.       4) If you're building an IEEE executable, you must edit the
  105.          makefile and comment out the line for "CFLAGS = ..." for the
  106.          '881, uncomment the line "CFLAGS = ..." for the IEEE emulator,
  107.          and type "lmk povrayieee".
  108.       5) To compile a 68881 version of POVRay, leave the original
  109.          makefile unaltered and type "lmk".
  110.  
  111. Post-Processing Images:
  112.  
  113.    Two utilities called dump2iff and dump2i24 have been included in the
  114.    executable archive to convert the POVRay format output to HAM6 and
  115.    IFF24 format.  To run these utilities, you must provide the names of
  116.    the input and output files.
  117.    eg.
  118.       dump2i24 picture.dis picture.i24
  119.    or
  120.       dump2iff picture.dis picture.iff
  121.  
  122.    The dump2iff program can also write out a file containing the palette
  123.    it used to make the image.  It can then be told to use this palette
  124.    when converting other images.  This is useful for making animations for
  125.    animation players that can't change color palettes between frames.
  126.  
  127.    To output a palette, use the -p option of dump2iff:
  128.       dump2iff -ppicture.pal picture.dis picture.iff
  129.  
  130.    To use this palette for other images, simply add it to the command
  131.    line:
  132.       dump2iff picture.dis picture.iff picture.pal
  133.  
  134.    By default, dump2iff will perform dithering to help smooth out the
  135.    color changes.  To disable dithering, use -d on the command line.
  136.  
  137.    The dump2i24 program does not generate a palette.  The 24-bit pixel
  138.    data is stored directly into 24 bit-planes.
  139.  
  140.    Two other utilities called tga2dump and tga2iff are also included in
  141.    the executable archive to convert TARGA format files.  To run these
  142.    utilities you must provide the names of the input and output files.
  143.    eg.
  144.       tga2gif -d -m picture.tga picture.gif
  145.    or
  146.       tga2dump picture.tga picture.dis
  147.  
  148.    "The Art Department Professional" by ASDG does a fine job of post-
  149.    processing images.  ADPro can accept QRT format images (which is the
  150.    format output by POVRay with the +fd command-line parameter).  Al-
  151.    ternatively, you can output Targa (+ft) or raw (+fr).  To read the raw
  152.    format into ADPro, use the Scuplt reader.  You'll have to type in the
  153.    resolution you used to generate the image.
  154.  
  155.    This document is based on text originally by David K. Buck.
  156.  
  157. Comments and suggestions about the Amiga version can be directed to me:
  158.    Dave Park
  159.    Internet:   70004.1764@compuserve.com
  160.    CompuServe: [70004,1764]
  161.