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:
@@ -0,0 +1,43 @@
|
||||
## Purpose
|
||||
|
||||
保留相同剪贴板图片的复用能力，同时核对候选 Image 当前内容与解释设置是否仍匹配首次加载状态，确保编辑后的图像和材质派生图不会被误认为原始剪贴板内容再次粘贴。
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Clipboard reuse requires an unchanged image
|
||||
|
||||
相同剪贴板输入 SHALL 仅复用当前像素、尺寸、颜色空间和 Alpha 模式均匹配缓存基线的有效 Image。缓存验证 SHALL 包括透明区域 RGB，并保持候选图像原有内容与状态。
|
||||
|
||||
#### Scenario: Repeated content remains unchanged
|
||||
|
||||
- **WHEN** 相同剪贴板内容再次粘贴，缓存图像内容和设置未改变
|
||||
- **THEN** 系统 SHALL 复用该 Image
|
||||
|
||||
#### Scenario: Mask overwrites the cached image
|
||||
|
||||
- **WHEN** Mask 修改了独占的剪贴板 Image，修改结果已打包，再次粘贴原始剪贴板内容
|
||||
- **THEN** 系统 SHALL 加载原始剪贴板内容到另一 Image，保留已编辑图像
|
||||
|
||||
#### Scenario: Shared edit leaves an intact candidate
|
||||
|
||||
- **WHEN** 编辑产生独立结果，另一个用户仍引用未修改的剪贴板原图
|
||||
- **THEN** 再次粘贴 SHALL 复用该未修改原图
|
||||
|
||||
#### Scenario: Other editing or interpretation changes invalidate a candidate
|
||||
|
||||
- **WHEN** 候选图像经过尺寸修改、原生绘制、透明 RGB 修改、颜色空间或 Alpha 模式变更
|
||||
- **THEN** 再次粘贴 SHALL 跳过已变更候选，使用原始剪贴板内容及其初始解释设置
|
||||
|
||||
#### Scenario: Legacy or unreadable cache entry is found
|
||||
|
||||
- **WHEN** 候选缺少内容校验基线或无法读取
|
||||
- **THEN** 系统 SHALL 按未命中处理，并保留已有图像
|
||||
|
||||
### Requirement: Clipboard material results stay outside the source cache
|
||||
|
||||
剪贴板 Plane SHALL 从有效剪贴板原图按整图范围生成独立材质颜色图。参考图、节点和笔刷的后续粘贴 SHALL 按原图缓存有效性选择 Image。
|
||||
|
||||
#### Scenario: Painted material is followed by another paste
|
||||
|
||||
- **WHEN** 用户粘贴为 Plane 并绘制其材质，随后把相同内容粘贴为参考图、节点或笔刷
|
||||
- **THEN** 系统 SHALL 使用原始剪贴板内容，且不复用材质颜色图
|
||||
@@ -0,0 +1,82 @@
|
||||
## Purpose
|
||||
|
||||
统一 Cutout、Convert To 与剪贴板 Plane 的材质颜色图来源和交付约定，使裁切与整图转换使用同一范围采样流程，并保障材质编辑、再次导入原文件及保存重载时图像内容与设置保持隔离。
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Material color uses the requested source bounds
|
||||
|
||||
所有材质生成入口 SHALL 按本次准备时的源图像素和范围生成颜色图。Cutout SHALL 使用裁切范围，四种 Convert To 与剪贴板 Plane SHALL 使用整图范围。AI 的参与 SHALL 保持相同颜色来源及颜色分辨率。
|
||||
|
||||
#### Scenario: Cutout uses or omits AI
|
||||
|
||||
- **WHEN** 同一源图和裁切范围分别执行普通 Cutout 和需要 AI 的 Cutout
|
||||
- **THEN** 两者的颜色图 SHALL 对应同一裁切内容、尺寸和原有 Alpha，包含透明区域 RGB
|
||||
|
||||
#### Scenario: A full image is converted
|
||||
|
||||
- **WHEN** 执行 Plane、Depth Plane、Relief Plane、Panorama 或剪贴板 Plane
|
||||
- **THEN** 颜色图 SHALL 对应完整源图片，保持原始尺寸和当前像素
|
||||
|
||||
### Requirement: Every material owns an isolated color image
|
||||
|
||||
每次生成材质 SHALL 使用独立 Color Image 和独立临时颜色文件路径，以源图基名、`_color` 及实际文件后缀命名并打包。原 Image 的内容和解释设置 SHALL 保持不变，材质 Color SHALL 不携带剪贴板原图缓存身份。
|
||||
|
||||
#### Scenario: Source users vary
|
||||
|
||||
- **WHEN** 原图没有其他用户，或被其他 Empty、材质或笔刷引用
|
||||
- **THEN** 新材质 SHALL 使用独立颜色图，原图的引用、像素、名称、路径、颜色空间及 Alpha 模式 SHALL 保持原值
|
||||
|
||||
#### Scenario: Original file is imported after material painting
|
||||
|
||||
- **WHEN** 转换后修改材质颜色图，再次按原文件路径导入图片，包括原 Image 已移除的情况
|
||||
- **THEN** 导入 SHALL 不命中材质颜色图，不带入该颜色图的材质设置和绘制像素
|
||||
|
||||
### Requirement: Encoding preserves color precision and presentation
|
||||
|
||||
颜色图 SHALL 保留对应范围的 RGB、Alpha、透明区域 RGB 及源编码精度，float / HDR SHALL 保留浮点范围。普通 byte 材质 SHALL 沿用颜色空间适配与 Alpha 配对规则，所有 float / HDR 材质 SHALL 保留源颜色空间与 Alpha 模式。
|
||||
|
||||
#### Scenario: Ordinary material is configured
|
||||
|
||||
- **WHEN** 普通 byte 材质适配关闭或回退到 sRGB，或者启用可用的 inverse 空间
|
||||
- **THEN** 颜色图 SHALL 分别采用 sRGB + PREMUL 或对应 inverse 空间 + STRAIGHT，原图设置保持不变
|
||||
|
||||
#### Scenario: HDR and unsaved pixels are serialized
|
||||
|
||||
- **WHEN** float / HDR、generated、dirty 或 packed 源图完成颜色图生成、打包和保存重载
|
||||
- **THEN** 结果 SHALL 在对应编码精度内保留业务像素、动态范围与选定的颜色解释
|
||||
- **AND** 所有 float / HDR 材质 SHALL 保留源图颜色空间与 Alpha 模式；Panorama 非 sRGB 分支沿用源解释
|
||||
|
||||
#### Scenario: Float source interpretation prevents lossless serialization
|
||||
|
||||
- **WHEN** 按源颜色空间和 Alpha 模式解码 EXR 后无法保留源浮点像素
|
||||
- **THEN** 操作 SHALL 明确拒绝转换，清理临时资源并保持源图不变
|
||||
- **AND** float / HDR 材质 SHALL 不启用场景视图适配的 Alpha Fix
|
||||
|
||||
### Requirement: Material operations release temporary resources safely
|
||||
|
||||
临时颜色文件 SHALL 在打包和相关 Job 使用结束后释放。取消或失败 SHALL 清理本次临时文件与未交付数据，保留源对象及原图。成功转换 SHALL 支持 Undo / Redo；异步源对象失效或 Image 被替换时 SHALL 取消应用。
|
||||
|
||||
#### Scenario: Packed result survives file cleanup
|
||||
|
||||
- **WHEN** 操作成功且临时目录已删除
|
||||
- **THEN** 材质颜色图 SHALL 仍能正确读取并保存重载
|
||||
|
||||
#### Scenario: An operation fails or is cancelled
|
||||
|
||||
- **WHEN** 导出、模型处理、图像加载、材质或对象创建失败，或用户取消 Job
|
||||
- **THEN** 本次临时资源 SHALL 释放，源对象、源像素和源图设置保持原值
|
||||
|
||||
#### Scenario: Conversion is undone and redone
|
||||
|
||||
- **WHEN** 用户撤销并重做转换
|
||||
- **THEN** 撤销 SHALL 恢复源对象和源图，重做 SHALL 恢复带独立颜色图的转换结果
|
||||
|
||||
### Requirement: Plane accepts static images only
|
||||
|
||||
Convert to Plane SHALL 仅接受静态图片；Movie、Sequence 和动画图像 SHALL 在创建颜色图或对象前被拒绝，并给出明确错误。
|
||||
|
||||
#### Scenario: Animated source is selected
|
||||
|
||||
- **WHEN** 源 Image 为 Movie 或 Sequence，即使其声明时长为一帧，或源图片含多帧
|
||||
- **THEN** Plane SHALL 报告仅支持静态图片，并保持源对象及图像不变
|
||||
Reference in New Issue
Block a user