This file contains the documentation specific to the SINIX version of
POV-Ray.  This archive contains both an X (x-povray) and a non-graphical
(povray) version of POV-Ray 3.00a. The non-graphical version is about
twice as fast as the X version due to the special math library.

/******************************************************************************
 * Note that this port is not supported by the POV-Ray Team(tm).
 * Use at your own risk.
 *****************************************************************************/

The port was based on the source code available from www.povray.org.

I used the CDS 1.1 compiler with the following flags:
	-O -Wb,-r4000 -Wb,-mips3 -Kr4000

The non-graphical version was linked with the additional flags
	-dn -lm_r4000

Using -lm_r4000 instead of -lm_s seemed to fix the problems I had
with some pov files. 

I tested this program on an RM400 running SINIX-N 5.42B0032.

The package itself is based on the linux distribution with the binaries
and the README replaced.

For a default installation, go to /usr/local/lib and do a

   mkdir -p /usr/local/lib
   mkdir -p /usr/local/bin
   cd /usr/local/lib
   gzip -cd < INSERT_PATH/povray.3.00a.tgz | tar xvf -
   mv povray3/povray /usr/local/bin
   mv povray3/x-povray /usr/local/bin
   mv povray3/povray1 /usr/share/man/man1
   cp povray3/povray.ini $HOME/.povrayrc

The preferred location for installing POV-Ray for SINIX is under
/usr/local/lib/povray3 for all of the INI, scene, and include files,
and /usr/local/bin for povray and x-povray.  Each user will also
need to have an INI file to tell POV-Ray where to look for these files.

The POV-Ray man page, povray.1, should be placed in a similarly accessible
location, such as /usr/share/man/man1.  If it is expected that many people
will be using one version of POV-Ray, it would be a good idea to edit
povray.1, under the section 'FILES' to specify where all of the
documentation, scenes, and include files are actually stored, if they
aren't installed as suggested above.


INI files:
   POV-Ray allows the use of files to store common configuration
   settings, such as the output format, image size, and library paths.
   If the environment variable POVINI is set, then POV-Ray will look at
   the file that POVINI is pointing to to read configuration
   information.  If POVINI is not set, then POV-Ray will try to read
   the file ".povrayrc" in your home directory, or failing this, it will
   try to read the file "povray.ini", in the current directory.  The
   POVRAYOPT environment variable is no longer used by POV-Ray.
    
   The default povray.ini file that is shipped with the SINIX archive
   assumes that POV-Ray will be installed under /usr/local/lib/povray3.
   If you are not installing POV-Ray there, you should edit the Library_Path 
   specifications in this file to point to the location where POV-Ray is
   installed.  Each user should copy this file to ".povrayrc" in their home
   directory. 

   The other INI files, like zipfli.ini and tgaflc.ini are of limited use
   under UNIX, but are included as examples of how to automate operations
   from within POV-Ray, and can be customized to use whatever programs
   you have installed.

X Window System display:
   During rendering, the window will be updated after every scanline has
   been rendered, or sooner if the rendering is taking a long time.  To
   update it sooner you can click any mouse button in the window or press
   (almost) any key.  Pressing <CTRL-R> or <CTRL-L> during rendering will
   refresh the whole screen.  The rendering will pause when complete if
   the Pause_When_Done (or +P) flag is set.  To exit at this point, press
   the 'q' or 'Q' key or click any mouse button in the rendering window.
 
   The xpovicon.xpm is a color icon for use with fvwm or other window manager
   which can use external icons.  To have fvwm use the icon, move it to the
   directory pointed to by your PixmapPath, often /usr/include/X11/pixmaps/,
   add the following line to your .fvwmrc:
 
       Style "Povray" Icon xpovray.xpm
 
   and re-start X Windows.  Re-starting fvwm will not be enough.  If you
   don't restart, or choose not to do this this, POV-Ray will use a
   similar built-in monochrome icon.
 
   The X-windows version also supports these standard command-line options
   in addition to those given in the generic POV-Ray documentation:
 
   -display <display name>           Preview on the specified display
   -geometry <WIDTHxHEIGHT+XXX+YYY>  Start with the given size and position
   -visual <visual type>             Use specified visual if available
   -title <title>                    Use the given title for the window
   -icon                             Start iconified
   -borderwidth <width>              Use a border of the given width in pixels
   -help                             Output these X Windows options
 
File Formats:
   The default file format for SINIX is "TGA" format (+ft).  Optionally,
   the "PPM" format, popular on UNIX platforms, or the new "PNG" format
   can be set as the default output format by setting "Output_File_Type = p"
   or "Output_File_Type = n" in your .povrayrc file or by using +fp or +fn
   on the command-line.

   If you are generating histogram files in the CSV format (comma
   separated values), then the units of time are in tens of microseconds
   (10 x 10^-6 s), and each grid block can store times up to 12 hours.
 
Interrupting POV-Ray:
   To interrupt a rendering in progress, you can use CTRL-C (SIGINT),
   which will allow POV-Ray to finish writing out any rendered data
   before it quits.  You can also press the 'q' or 'Q' keys in the
   rendering preview window to interrupt the trace if the Test_Abort
   (or +X) flag is set.
 
Post-processing Images:
   For UNIX systems, the PBM utilities are an excellent choice for
   post-processing utilities, especially if you are running on a console.
   They are included in the switls package shipped with SINIX/windows
   (this package is not installed by default).

   Not that the xv delivered with SINIX/windows is not able to display 
   TGA images. You have to convert them to a different file format.

   In order to convert an image in TGA format to GIF format, you
   may issue the following commands:

	   tgatoppm <file.tga | ppmquant 256 | ppmtogif >file.gif


--
Siegfried Hempfer  | Tel: +49/(0)89/636-41553      | Experience: Something 
SNI AG, OEC ES DX2 | Fax: +49/(0)89/636-41215      | you don't get until 
Otto-Hahn-Ring 6   | eMail: hempfer.muc@sni.de     | just after you need it.
D-81730 Muenchen   | Priv:  GSAHempfer@t-online.de | 
