home *** CD-ROM | disk | FTP | other *** search
/ Chestnut's Multimedia Mania / MM_MANIA.ISO / graphics / povsrc20 / vax.doc < prev    next >
Text File  |  1993-09-30  |  5KB  |  108 lines
  1. This file contains the documentation specific to the VMS version of POV-Ray.
  2.  
  3. Note: PLEASE SEE POVLEGAL.DOC.  The VMS version in ZIP format is an
  4.    officially supported format and can be distributed as is.  You MAY NOT
  5.    re-package the archive file or distribute any changes to it.  If you
  6.    do post it on a BBS or network, you must provide at least the data
  7.    files and documentation files with the executables.  See POVLEGAL.DOC
  8.    for complete details.
  9.  
  10. Testing:
  11.    This version of POV-Ray for the VAX has only been tested on an Alpha AXP 500
  12.    running OpenVMS. It may need tweaking for your compiler.
  13.  
  14. Executables:
  15.    At this stage, no executables are provided.
  16.    See the note at the end of this file about this subject.
  17.  
  18. Running POV-Ray:
  19.    Assign a foreign symbol to the executable.  The syntax is:
  20.       povray :== $<your_disk>:[<directory>]povray
  21.    An example symbol might look like:
  22.       povray :== $dua100:[povray.build]povray
  23.    or
  24.       povray :== $dua100:[povray.build]povray +w320 +h200 +d +v [for example]
  25.  
  26.    You may also like to add your include file path to the symbol.
  27.    When running POV-Ray, be sure that you have a large working set.
  28.    You will need to use the '+d' option for the X version to display anything.
  29.  
  30. File Formats:
  31.    The default file format for the Vax is "targa" format (+ft).
  32.    Dump or raw may be specified on the command line or in the
  33.    povray.def file. The TGA2GIF program (not included in this archive)
  34.    may be used to convert the output to a GIF file.
  35.  
  36. Building the source:
  37.    To compile POV-Ray from the original source, follow the following instructions:
  38.    You will of course need a properly set up C compiler.
  39.  
  40.    If you want to use the X version you will need X and the X libraries.
  41.    You may need to edit the POVRAY.OPT file for your X library path.
  42.    Motif is NOT needed, as POV runs with X and Xt only.
  43.  
  44.    #define X_GETS_ARGS in vaxconf.h if you want to use X options such as 
  45.    '-display xxx:n.n'. Note that some may conflict with POV options.
  46.  
  47.      1) create a [.source] directory.
  48.  
  49.      2) copy the files from POVSRC.ZIP's SOURCE directory into this directory.
  50.  
  51.      3) copy the files from POVSRC.ZIP's MACHINE\VAX directory into [.source].
  52.  
  53.      4) rename vaxconf.h to config.h
  54.  
  55.      5) edit the file 'POVRAY.C'.
  56.         change the definition of 'main' and 'alt_main' to return 'int'
  57.         instead of 'void'. you may also like to add a return statement.
  58.  
  59.      6) edit the file 'tokenize.c'.
  60.         remove the reference to 'extern Library_Paths []'.
  61.  
  62.      7) edit the files 'csg.c' and 'objects.c'.
  63.         remove the reference to 'extern RAY VP_Ray'.
  64.  
  65.      8) execute "@vaxbuild" for a NON XWindows executable.
  66.  
  67.      9) execute "@xvaxbld" for an XWindows executable.
  68.  
  69.    Note that if you switch between X and non-X versions you MUST recompile
  70.    ALL FILES.
  71.  
  72. Post-processing Images:
  73.    POV-Ray images can be post-processed using the PBMPLUS utilities.
  74.    The program TGA2GIF (source available on Compuserve in GRAPHDEV) will run on
  75.    a VAX and does a nice job of converting Targa output files into GIF files.
  76.  
  77. Displaying Images:
  78.    There are various programs around that can display GIF files under X
  79.    windows. At a later stage I may upload one into GRAPHDEV, so have a look.
  80.    Some DECwindows systems come with a program called PICT.EXE, which will do a
  81.    good job of displaying GIF files, also.
  82.  
  83.    For those with a Postscipt printer, you can use PBMPLUS to convert POV-Ray
  84.    files to Postscript and then print them.
  85.  
  86. The VMS X Windows code was developed and tested by Christopher J. Cason under
  87. DECWindows on a DEC Alpha AXP 500.
  88.  
  89. Questions and problems in the VAX/VMS version can be directed to Chris Cason on
  90. Compuserve via mail or in the POV source section of GRAPHDEV. (currently 8).
  91.  
  92. I will continue to enhance this code and test it other machines.
  93. If you had to make any modifications to get it to compile, please let me know
  94. so that I may update this source accordingly. This particularly applies to
  95. the build files. By doing so, you will be helping others.
  96.  
  97. If you have any problems getting it to build, you may like to contact me or
  98. check the POV section of GRAPHDEV on Compuserve to see if there are updated
  99. files. Try scanning for the keyword VMS or XWINDOWS.
  100.  
  101. Expect to find a significantly enhanced X version in the near future.
  102. (Sometime in late 1993 or early 1994). This will include a Motif shell.
  103. We may also make pre-compiled executables available for VAX and Alpha.
  104. (But there is no guarantee of this).
  105.  
  106. Chris Cason.
  107. CIS:100032,1644
  108. Internet:100032.1644@compuserve.com