Add new tests and functionality for image processing and geometry handling

- Introduced color_image.py for preparing standalone color images for tests.
- Added hdr_image.py to create HDR textures for testing.
- Implemented test_image_depth_panorama.py to evaluate panorama topology, UVs, and depth discontinuities.
- Created test_shadeless.py to validate the opacity and HDR color endpoints of the Shadeless group.
- Developed moge3_export.py for exporting dynamic MoGe-3 backbone and ONNX graphs.
- Added material.py to inherit material slots onto generated geometry.
- Built image_depth_panorama.py to construct a quad panorama with depth separation and sampling.
This commit is contained in:
2026-09-10 14:42:17 +08:00
parent 27ca25224a
commit 489003c2cc
136 changed files with 5758 additions and 1083 deletions

View File

@@ -0,0 +1,61 @@
## ADDED Requirements
### Requirement: Shared input format validation
AI 输入 SHALL 使用公共格式规则,在 Blender 提交前与后端处理前校验实际输入路径。支持图片为 JPG/JPEG/PNG/WEBP,视频沿用当前 MP4/MOV/AVI/MKV/WEBM/M4V/MTS/MPG/MPEG,扩展名匹配忽略大小写。
#### Scenario: Unsupported file in image edits
- **WHEN** Remove BG 与 Upscale 使用同一个存在的 `.tiff` 普通文件,且环境和模型已就绪
- **THEN** 两者在提交 Job 前取消,展示相同格式提示,包含 `.tiff` 和分类排序的支持格式
#### Scenario: Direct backend input
- **WHEN** 后端直接收到不支持格式的文件或无扩展名文件
- **THEN** 使用与前端相同的格式提示规则,无扩展名显示 `(no extension)`
#### Scenario: Supported uppercase extension
- **WHEN** 实际输入为存在的 `.PNG` 或 `.MP4` 文件
- **THEN** 通过对应图片或视频格式校验
#### Scenario: Model image validation
- **WHEN** BEN2 单帧入口收到不支持的图片扩展名
- **THEN** 使用公共格式提示的图片子集,并与公共图片支持集合一致
### Requirement: Distinct input failure reasons
系统 SHALL 区分缺失路径、不支持格式、目录无有效帧和解码失败;提示 SHALL 适用于 Image Empty 和 Image Texture,解码异常转换 SHALL 限定于读取边界。
#### Scenario: Missing source file
- **WHEN** Image Empty 或材质 Image Texture 的源图片或视频文件不存在
- **THEN** 提示缺失的 source image/video file 及路径,不将原因报告为格式不支持
#### Scenario: Invalid encoded data
- **WHEN** 支持扩展名的文件内容无法作为对应图片或视频解码
- **THEN** 报告无法读取的媒体类型及路径,并保留底层异常供诊断
### Requirement: Explicit frame selection
系统 SHALL 在复制 Blender 序列前校验图片格式;通用目录 SHALL 仅收集支持的图片,保持现有排序及帧范围规则。
#### Scenario: Unsupported Blender sequence
- **WHEN** Blender 源序列使用 `.exr` 扩展名
- **THEN** 复制前提示不支持的图片格式,不创建临时帧目录
#### Scenario: Mixed directory
- **WHEN** 通用输入目录包含 JPG、PNG、TXT 和 EXR 文件
- **THEN** 仅 JPG 与 PNG 参与处理,前后端按相同规则选择并保持原帧范围语义
#### Scenario: Empty supported frame set
- **WHEN** 通用目录为空或只有不支持的文件
- **THEN** 提示无支持的图片帧、目录路径及支持的图片格式
### Requirement: Validate prepared media
系统 SHALL 校验实际提交的文件,保持各功能自身的媒体类型、尺寸和比例约束。
#### Scenario: Packed image exported as PNG
- **WHEN** 一个名称带 `.exr` 的 packed Image 经现有流程成功导出 PNG
- **THEN** 按导出的 PNG 校验,不按源名称拒绝
#### Scenario: Feature restriction
- **WHEN** 输入通过公共格式校验但不满足 Depth Plane 的静态图限制或 Upscale 的尺寸限制
- **THEN** 仍按对应业务原因取消,不报告为格式不支持

View File

@@ -0,0 +1,33 @@
## ADDED Requirements
### Requirement: Expected operator failures are reported normally
AI 操作 SHALL 将输入准备与嵌套 Operator 调用的预期失败转换为普通错误提示和 CANCELLED,包括 Remove BG、Depth/Relief Plane、AI Environment 准备及现有 Panorama 入口。提示 SHALL 保留原因并避免重复的 Blender 错误前缀。
#### Scenario: Nested input validation failure
- **WHEN** 内部 Job Operator 报告无效输入且 bpy.ops 抛出 RuntimeError
- **THEN** 外部入口返回 CANCELLED,显示原因,不向用户展示未捕获的 Python traceback
#### Scenario: Environment setup failure
- **WHEN** AI Environment 设置入口调用安装或下载 Operator 同步失败
- **THEN** 设置入口及调用它的 AI 操作按普通错误取消
#### Scenario: Successful job startup
- **WHEN** 内部 Job Operator 返回 RUNNING_MODAL
- **THEN** 外部入口保持现有成功返回与异步处理语义,源图片及 Undo 行为保持有效
### Requirement: Temporary inputs have explicit ownership
系统 SHALL 释放本次操作创建的临时输入,在准备失败、启动失败、取消及异步结束时均有负责清理的边界;用户原文件 SHALL 保持不变。
#### Scenario: Preparation failure
- **WHEN** packed 图片导出或序列复制失败
- **THEN** 准备函数删除本次临时文件和目录,并保留源图片与源文件
#### Scenario: Synchronous nested failure
- **WHEN** 临时输入准备成功后内部 Operator 抛错或返回 CANCELLED
- **THEN** 临时输入被清理,外部操作取消,源图片引用保持不变
#### Scenario: Asynchronous completion
- **WHEN** Job 接管临时输入并在之后成功、失败或取消
- **THEN** 输入在 Job 结束时清理,运行期间保持可用,用户原文件不被删除