home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / developm / source / povsrc.sit / MACHINE / VAX.ZIP / VAX.DOC < prev    next >
Encoding:
Text File  |  1992-07-16  |  2.9 KB  |  70 lines
  1. This file contains the documentation specific to the VAX/VMS version of
  2. POV-Ray.
  3.  
  4. Differences from original distribution:
  5.    The original distribution of POV-Ray is in ZIP format.  For VMS,
  6.    this has been converted to a backup save set.  In addition, the VMS
  7.    distribution of POV-Ray has CR-LF pairs converted to only CR's for text
  8.    files.  Otherwise, the VAX/VMS distribution is identical to the ZIP
  9.    distribution.
  10.  
  11. Note: PLEASE SEE POVLEGAL.DOC.  The VMS version in backup 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 data
  15.    files and documentation files with the executables.  See POVLEGAL.DOC
  16.    for complete details.
  17.  
  18. Executables:
  19.  
  20.    Both object and executable files are provided.  They have been compiled
  21.    and linked under VMS 5.3-1.  The executable is called POVRAY.EXE.
  22.    
  23. Running POV-Ray:
  24.    Assign a foreign symbol to the executable.  The syntax is:
  25.       povray :== $<your_disk>:[<directory>]povray
  26.    An example symbol might look like:
  27.       povray :== $dua100:[povray.build]povray
  28.  
  29.    When running POV-Ray, be sure that you have a large working set.
  30.  
  31. File Formats:
  32.    The default file format for the Amiga is "dump" format (+fd).  Targa or
  33.    raw may be specified on the command line or in the povray.def file.
  34.  
  35. Building the source:
  36.    POV-Ray was compiled using VAX C version 3.1.  I'm sure that later
  37.    versions will also work fine.  If you're compiling with another compiler,
  38.    you may have to edit the build procedure to set the proper compiler
  39.    options.  As far as that goes, you're on your own.
  40.  
  41.    To compile POV-Ray from the original source, follow the following
  42.    instructions:
  43.  
  44.       1) copy the files in the "source" directory into a "build" directory
  45.       2) copy the files in [.source.machine.vms] to the build directory
  46.       3) rename vaxconf.h to config.h
  47.       4) execute "@vaxbuild"
  48.  
  49. Post-processing Images:
  50.    POV-Ray images can be post-processed using the PBMPLUS utilities.
  51.  
  52. Diplaying Images:
  53.    There are many utilities available for displaying POV-Ray files.  For 
  54.    myself, I usually convert them to PBMPLUS format and use the xloadimage
  55.    utility.  I have heard that the xv utility may be able to display 
  56.    QRT/DKBtrace files (which is what these are) directly.  Both xv and 
  57.    xloadimage are available via FTP from Black.Cerritos.Edu and 
  58.    White.Cerritos.Edu.  There is also a mail server available via 
  59.    MAILSERV@Cerritos.edu.  Place the one line command 'help' in the body of
  60.    the message for more information.
  61.  
  62.    For those with a Postscipt printer, you can use PBMPLUS to convert POV-Ray
  63.    files to Postscript and then print them.
  64.  
  65. Questions and problems in the VAX/VMS version can be directed to the Usenet 
  66. group COMP.GRAPHICS.
  67.  
  68. Dean Nedelman
  69. Internet:   sysmgt007@spacm1.spac.spc.com
  70.