Update app.py

app.py

@@ -1,76 +1,77 @@
 import gradio as gr
 import os
 
-# 1. 定义文件夹路径
-IMG_DIR = "example_image"  # 你的图片文件夹名
-MODEL_DIR = "f3c"          # 你的模型文件夹名
+# 1. Define directory paths
+IMG_DIR = "example_image"  # Directory for images
+MODEL_DIR = "f3c"          # Directory for 3D models
 
-# 2. 自动扫描并匹配文件
+# 2. Automatically scan and match files
 examples = []
 
-# 检查文件夹是否存在，避免报错
+# Check if directories exist to avoid errors
 if os.path.exists(IMG_DIR) and os.path.exists(MODEL_DIR):
-    # 获取所有 png 图片
+    # Get all png images, sorted
     image_files = sorted([f for f in os.listdir(IMG_DIR) if f.endswith('.png')])
     
     for img_file in image_files:
-        # 获取不带后缀的文件名 (例如 "6" 或 "typical_creature_dragon")
+        # Get filename without extension (e.g., "6" or "typical_creature_dragon")
         base_name = os.path.splitext(img_file)[0]
         
-        # 构造对应的 GLB 文件名：规则是 "文件名_demo_trellis.glb"
+        # Construct the expected GLB filename: rule is "filename_demo_trellis.glb"
         expected_glb_name = f"{base_name}_demo_trellis.glb"
         
-        # 拼接完整路径
+        # Construct full paths
         img_path = os.path.join(IMG_DIR, img_file)
         glb_path = os.path.join(MODEL_DIR, expected_glb_name)
         
-        # 关键步骤：只有当对应的 3D 文件确实存在时，才添加到展示列表
+        # Critical step: Only add to the list if the corresponding 3D file actually exists
         if os.path.exists(glb_path):
             examples.append({
                 "image": img_path,
                 "model": glb_path,
-                "label": base_name  # 图片下方的文字标签
+                "label": base_name  # Label displayed below the image
             })
         else:
-            # 如果没找到对应的模型，可以在后台打印一下，方便排查
-            print(f"⚠️ 未找到匹配模型: 图片 {img_file} -> 缺少 {expected_glb_name}")
+            # Print to logs if a matching model is missing (for debugging)
+            print(f"⚠️ Matching model not found: Image {img_file} -> Missing {expected_glb_name}")
 
-print(f"✅ 成功加载了 {len(examples)} 组数据")
+print(f"✅ Successfully loaded {len(examples)} pairs of data")
 
-# 3. 定义点击事件：返回对应的模型路径
+# 3. Define click event: Return the corresponding model path
 def display_model(evt: gr.SelectData):
     if evt.index < len(examples):
         return examples[evt.index]["model"]
     return None
 
-# 4. 构建界面
+# 4. Build the interface
 with gr.Blocks(title="3D Model Viewer") as demo:
     gr.Markdown("## 3D Accelerated Instances Showcase")
-    gr.Markdown(f"点击左侧图片，右侧查看 3D 效果。共加载 {len(examples)} 个实例。")
+    gr.Markdown(f"Click on an image on the left to view the 3D effect on the right. Loaded {len(examples)} instances in total.")
     
     with gr.Row():
-        # 左侧：图片画廊
+        # Left column: Image Gallery
         with gr.Column(scale=1):
             gallery = gr.Gallery(
                 value=[item["image"] for item in examples],
                 label="Instance Gallery",
-                columns=3,         # 一行显示3张图
-                height=800,        # 设置高度，图片多时会出现滚动条
+                columns=3,         # Number of images per row
+                height=800,        # Set height (scrollable if many images)
                 object_fit="contain",
-                allow_preview=False # 禁止点击放大图片
+                allow_preview=False # Disable click-to-zoom
             )
         
-        # 右侧：3D 展示区
+        # Right column: 3D Viewer
         with gr.Column(scale=2):
             model_3d = gr.Model3D(
-                clear_color=[0.2, 0.2, 0.2, 1.0], # 深灰色背景，看模型更清晰
+                clear_color=[0.2, 0.2, 0.2, 1.0], # Dark gray background for better contrast
                 label="3D Interactive View",
-                camera_position=(0, 0, 2.5)       # 调整相机距离
+                camera_position=(0, 0, 2.5)       # Adjust initial camera distance
             )
 
-    # 绑定交互
+    # Bind interaction: Gallery click -> Update Model3D
     gallery.select(fn=display_model, outputs=model_3d)
 
-# 启动
+# Launch the app
 if __name__ == "__main__":
+    # ssr_mode=False is crucial to prevent "bool is not iterable" errors in some environments
     demo.launch()