Model3D pointcloud data format support (not display mode)

问题场景

用户在 gr.Model3D() 组件中加载以下文件时触发问题：

• point_cloud_without_face.ply：纯点云，只有 x/y/z + RGB 属性，无面数据。
• point_cloud_without_face.obj：只有 v 顶点行，没有 f 面行。
• point_cloud_with_face.obj：包含 f 面数据，可正常显示。

用户在测试代码中使用 display_mode="solid"，并且尝试设置为 "point_cloud" 后，纯点云文件仍然无法显示。同样的文件在 MeshLab 中可以正常渲染。

报错原文

Model3D pointcloud data format support (not display mode)

实际现象是：gr.Model3D() 渲染纯点云文件时结果为空白，无报错信息；但包含面数据的文件可正常显示。

原因分析

根据 Issue 中的排查，根因可能是：

• Gradio 内部将所有 .ply 文件路由到 Canvas3DGS（gsplat 库）组件，该组件只处理 3D Gaussian Splat 格式的 PLY（包含 scale_0、rot_0 等属性）。普通点云 PLY（只有 xyz+rgb，没有这些属性）会被当作无效数据，渲染为空白。
• 对于 .obj 文件，如果只有顶点数据（v）而没有面数据（f），同样无法在 Babylon.js 查看器中正常渲染。
• Issue 作者在评论中进一步确认：即使设置 display_mode="point_cloud"，纯点云仍不能正确显示。

环境排查

• Gradio 版本：确认你的版本是否为 4.38.1 或相近版本（Issue 中用户确认的版本）。
• PLY 文件格式：检查你的 .ply 文件头是否包含 Gaussian Splat 属性（如 scal_0、rot_0、opacity 等）。普通点云 PLY 不应包含这些属性。
• OBJ 文件内容：确认 .obj 文件中是否只有 v 行，没有 f 行。
• 依赖环境：如果你使用官方 Gradio 主分支，暂时没有已验证的环境配置可绕过此问题。

解决步骤

1. 确认问题存在：使用 MeshLab 或 Open3D 打开你的纯点云文件，确认文件本身可以正常渲染。
2. 尝试在 gr.Model3D() 中显式设置 display_mode="point_cloud"，验证是否仍然空白（Issue 作者确认不可行）。
3. 检查你的 .ply 文件头，确认是否包含 Gaussian Splat 属性；如果包含，Gradio 会将其路由到 gsplat 渲染器并尝试解析。
4. 如果你有开发能力，可以参考社区贡献者的修复方案（见参考来源中的 fork 分支），在本地修改 js/model3D/shared/Canvas3DGS.svelte，添加顶点数量检测：当 faceCount === 0 && vertexCount > 0 时切换为 PointsMaterial 渲染。
5. 或者使用第三方工具（如 MeshLab、Open3D）预览纯点云文件，等待官方发布正式修复。

验证方法

修复后，使用 Issue 中的测试文件重新加载：

• point_cloud_without_face.ply 应显示为点云（而不是空白）。
• point_cloud_without_face.obj 应显示为点云。
• point_cloud_with_face.obj 仍应正常显示（要求不引入回归）。

同时，确保 Gaussian Splat 格式的 .ply 文件仍然可以渲染，以防修复破坏原有功能。

参考来源

gradio-app/gradio #8826