
 $Id: README,v 1.3 2000/05/26 12:05:05 yamauchi Exp $

	(M\pi)^2 
				YAMAUCHI Hitoshi 
						2000-05-25


This is experimental C++ version of implementation of (M\pi)^2.

(M\pi)^2 stands for Massively Parallel Image system for Multi-Pass
Image synthesis methods. The program name is `mpi2'. Mpi2 can render
images by multi-pass rendering method. Multi-pass rendering method is
the combination of radiosity method and ray tracing method and it can
synthesize photo-realistic images.

Sorry for there is no good documentation, this version is only
experimental.


Quick Start:

    0. please install GNU make and mpich-1.2.0 or later.
	      mpich is in http://www-unix.mcs.anl.gov/mpi/mpich/.

    1. get a source tarball and expand it.
	   tar zxvf parallelMpi2.20000525.tar.gz

    2. cd parallelMpi2
	  Under this document this directory will be referred as
	  $(MPI2).  

    3. make
	This `make' runs configure and make recursively.
	1st time
		make
	When If you want to re-configure
		make distclean
		make config
		make

	If you want to specify the compiler, setenv CXX (compiler) for
        C++ compiler.  
    
    4. Test
       cd to directory which contaings sample rendering data
              cd $(MPI2)/sampledat/1PE/4tri
       run sample script
	      ./tes.sh
       view the result (This script indicates output file format is ppm.)
	      xv save.text.out
       This test takes not so much time but the created images very simple.

       another test scene:
	     cd $(MPI2)/sampledat/1PE/sphere/sphdata
	     ./tes.sh
	     xv save.text.out

       These tests run only under one processing element mode.
       Multi-processing test is under $(MPI2)/sampledat/mpi.
       Try to type ./alltest.sh under the directory. However, this is
       just a test this program is work or not.
