Update app.py

app.py

@@ -216,6 +216,31 @@ def step4_track(session_id):
 # New: run all steps sequentially
 @spaces.GPU()
 def generate_results_and_mesh(image, session_id):
+
+    """
+    Process an input image through a 3D reconstruction pipeline and return the intermediate outputs and mesh file.
+
+    This function runs a multi‐step workflow to go from a raw input image to a reconstructed 3D mesh:
+      1. **Preprocessing**: crops and masks the image for object isolation.
+      2. **Normals Estimation**: computes surface normal maps.
+      3. **UV Mapping**: generates UV coordinate maps for texturing.
+      4. **Tracking**: performs final alignment/tracking to prepare for mesh export.
+      5. **Mesh Discovery**: locates the resulting `.ply` file in the tracking output directory.
+
+    Args:
+        image (PIL.Image.Image or ndarray): Input image to reconstruct.
+        session_id (str): Unique identifier for this session’s output directories.
+
+    Returns:
+        tuple:
+            - final_status (str): Newline‐separated status messages from each pipeline step.
+            - crop_img (Image or None): Cropped and preprocessed image.
+            - normals_img (Image or None): Estimated surface normals visualization.
+            - uv_img (Image or None): UV‐map visualization.
+            - track_img (Image or None): Tracking/registration result.
+            - mesh_file (str or None): Path to the generated 3D mesh (`.ply`), if found.
+    """
+    
     # Step 1
     status1, crop_img, _, _ = preprocess_image(image_array)
     if "❌" in status1: