From 4aa3b68f11312e3590d219cece0bae8d94edd900 Mon Sep 17 00:00:00 2001
From: Peter Hachenberger <hachenberger@mpi-inf.mpg.de>
Date: Thu, 16 Mar 2006 19:56:00 +0000
Subject: [PATCH] explained visual_hull.C plus file format .vsh

---
 Nef_3/demo/Nef_3/README | 39 +++++++++++++++++++++++++++++++++++++--
 1 file changed, 37 insertions(+), 2 deletions(-)

diff --git a/Nef_3/demo/Nef_3/README b/Nef_3/demo/Nef_3/README
index d4fe194eb7b..638b69cf13b 100644
--- a/Nef_3/demo/Nef_3/README
+++ b/Nef_3/demo/Nef_3/README
@@ -16,12 +16,47 @@ visualization_SM: This program shows how to display the sphere map of
 
 
 visualization_SNC: This program shows how to display Nef_polyhedron_3. 
-                   The program expects a 3D Nef polyhedron from
+-----------------  The program expects a 3D Nef polyhedron from
 		   standard in. For example call
 		   ./visualization_SNC < visualization_SNC.cin
------------------
+
+visual_hull: This program computes the visual hull of a 3D Object
+-----------  photographed by several cameras. Each camera returns
+             one polygon that resembles the shape of the 3D Object
+             from the camperas point of view. The visual hull is
+             an approximation of the original 3D Object. From a
+             camara photos, we compute a cone that tightly covers
+             all 3D Objects that could have caused the photographed
+             shape. The intersection of all cones is the visual hull.
+
+             File format .vsh (no comments allowed):
+             ---------------------------------------
+	     <point>         \\ minimum and maximum coordinates of 
+             <point>         \\ some box enclosing the 3D object.
+             int             \\ number of cameras.
+	     <camera>*       \\ position and photo of cameras
+
+	     camera
+             ------
+             <point>         \\ position of camera.
+	     int             \\ number of facet cycles of photo shape
+	     <facet cycle>*  \\ cycle data of facet cycles
+
+             facet cycle (first one is outer cycle, others bound holes)
+             -----------
+             int             \\ number of points in the cycle.
+             <point>         \\ points of facet cycle 
+                             \\ (must lie in common plane)
+
+             point
+             -----
+             double double double  \\ coordinates of point
+
 
 cube.off, 
 visualization_SNC.cin,
 visualization_SM.cin:   example input file
 --------
+
+mpi.vsh: example input file for visual_hull. 
+------   Call:  visual_hull mpi.vsh