nan
076a8c90f1
- Introduced the two-times upscale specification detailing requirements for unified output, fixed model presets, arbitrary dimensions, and consistent job behavior. - Added scenarios for existing models, repeated upscale, and handling of alpha preservation. - Created the unified depth plane specification outlining geometry modes, stable interface, and asset evaluation. - Defined scenarios for mode switching, relief and camera preservation, and validation of delivered assets.
113 lines
5.3 KiB
Markdown
113 lines
5.3 KiB
Markdown
# material-view-adaptation Specification
|
||
|
||
## Purpose
|
||
TBD - created by archiving change configure-material-view-adaptation. Update Purpose after archive.
|
||
## Requirements
|
||
### Requirement: Preferences expose material view adaptation
|
||
|
||
AnyImage SHALL 在 Preferences 的 Shading 分组提供 `Adapt to Scene View Transform` 布尔选项，默认关闭。扩展设置及读取入口 SHALL 位于 `preferences.py`，并通过 `addon_preferences()` 读取。
|
||
|
||
#### Scenario: Preferences use the default
|
||
|
||
- **WHEN** 用户尚未设置该选项或读取不到扩展偏好
|
||
- **THEN** 材质颜色贴图 SHALL 使用关闭适配的行为
|
||
|
||
### Requirement: Material color space determines alpha presentation
|
||
|
||
开启适配时，AnyImage SHALL 按当前场景 View Transform 选择既有映射中的 inverse 颜色空间，并使用 STRAIGHT。关闭适配时 SHALL 使用 sRGB + PREMUL。实际回退为 sRGB 时 SHALL 使用 PREMUL，并保持 Preferences 中的适配开关原值。
|
||
|
||
#### Scenario: A supported view is adapted
|
||
|
||
- **WHEN** 适配开启，当前场景为 AgX，且 `AgX Base sRGB` 可用
|
||
- **THEN** 材质 Color Image SHALL 使用 `AgX Base sRGB` + STRAIGHT
|
||
|
||
#### Scenario: Other mapped views are adapted
|
||
|
||
- **WHEN** 适配开启，场景使用 ACES 1.3、ACES 2.0、Filmic 或 Khronos PBR Neutral，且对应空间可用
|
||
- **THEN** Color Image SHALL 分别使用 `ACES 1.3 sRGB`、`ACES 2.0 sRGB`、`Filmic sRGB` 或 `Khronos PBR Neutral sRGB`
|
||
- **AND** Alpha 模式 SHALL 为 STRAIGHT
|
||
|
||
#### Scenario: Adaptation is disabled
|
||
|
||
- **WHEN** 适配关闭，创建任意受支持入口的材质
|
||
- **THEN** Color Image SHALL 使用 sRGB + PREMUL
|
||
|
||
#### Scenario: The scene resolves to sRGB
|
||
|
||
- **WHEN** 适配开启，但场景为 Standard、视图未匹配、场景不可用或 inverse 空间不被支持
|
||
- **THEN** Color Image SHALL 使用 sRGB + PREMUL
|
||
|
||
#### Scenario: The fallback color space is unavailable
|
||
|
||
- **WHEN** 所需颜色空间及 sRGB 均无法应用
|
||
- **THEN** 配置 SHALL 明确报错并保留贴图之前的有效配置
|
||
- **AND** Preferences 中的适配开关 SHALL 保持原值
|
||
|
||
### Requirement: Material entry points apply the same policy
|
||
|
||
AnyImage SHALL 在 Plane、Depth Plane、Cutout 和剪贴板 Mesh 材质创建时统一配置 Color Image。最终模式 SHALL 在后续绑定及交付步骤中保留。Depth 与 Normal SHALL 保留各自的数据解释约定。
|
||
|
||
#### Scenario: A material is created from an edited color result
|
||
|
||
- **WHEN** 一个 PREMUL 编辑结果进入开启适配的 inverse 材质
|
||
- **THEN** 最终材质 Color Image SHALL 为 STRAIGHT
|
||
- **AND** 材质交付后 SHALL 保留该模式
|
||
|
||
#### Scenario: Shadeless material is created
|
||
|
||
- **WHEN** 用户通过支持 Shadeless 的入口创建材质
|
||
- **THEN** Color Image SHALL 应用相同颜色空间与 Alpha 配对策略
|
||
|
||
### Requirement: Configuration preserves business pixels and source ownership
|
||
|
||
材质 Color 配置 SHALL 保留原有业务 RGB、Alpha 和完全透明区域 RGB，并在 Pack、保存重载和再次编辑后保持可读取。配置 SHALL 作用于材质专用 Color Image 或独立 Color 副本。
|
||
|
||
#### Scenario: The source image has other users
|
||
|
||
- **WHEN** 源 Image 同时被其他对象引用
|
||
- **THEN** 配置 SHALL 作用于独立 Color 结果
|
||
- **AND** 原 Image 的颜色空间、Alpha 模式和业务像素 SHALL 保持原值
|
||
|
||
#### Scenario: A color result is packed and reopened
|
||
|
||
- **WHEN** byte、float、generated、dirty 或 packed 来源的 Color 完成配置并保存重载
|
||
- **THEN** 业务 RGB/Alpha SHALL 在既有编码精度内保留
|
||
- **AND** 结果 SHALL 保持所选颜色空间和 Alpha 模式
|
||
|
||
### Requirement: Preferences exclusively control material adaptation
|
||
|
||
Preferences SHALL 是适配开关的唯一控制来源。新建材质 SHALL 读取当前偏好；已创建的材质颜色贴图 SHALL 保留原配置。创建操作和颜色空间解析 SHALL 保持偏好值。
|
||
|
||
#### Scenario: The preference changes
|
||
|
||
- **WHEN** 用户在 Preferences 开启或关闭适配
|
||
- **THEN** AnyImage 已创建的材质颜色贴图 SHALL 保持原颜色空间、Alpha 模式和像素
|
||
- **AND** 后续新建材质 SHALL 使用新的偏好设置
|
||
|
||
#### Scenario: A new material shares its source with an existing material
|
||
|
||
- **WHEN** 切换偏好后，使用已被现有材质引用的源 Image 创建新材质
|
||
- **THEN** 新材质 SHALL 使用独立 Color Image 并应用当前偏好
|
||
- **AND** 已有材质的贴图及其配置 SHALL 保持原值
|
||
|
||
#### Scenario: A material is created or an inverse space is unavailable
|
||
|
||
- **WHEN** 创建材质或颜色空间解析发生回退
|
||
- **THEN** Preferences 中的适配开关 SHALL 保持操作前的值
|
||
|
||
### Requirement: Adaptation affects only material color textures
|
||
|
||
本选项 SHALL 仅配置 AnyImage 材质的 Color 贴图。Empty、普通图片编辑结果、Depth、Normal 和非目标材质 SHALL 保持原有行为与数据。
|
||
|
||
#### Scenario: A material color image is shared with an Empty
|
||
|
||
- **WHEN** 新建材质的源 Color Image 同时被 Empty 引用
|
||
- **THEN** 系统 SHALL 为材质 Color 创建独立副本并重新绑定目标节点
|
||
- **AND** Empty 引用的原 Image 的颜色空间、Alpha 模式与业务像素 SHALL 保持原值
|
||
|
||
#### Scenario: Ordinary image editing runs with adaptation enabled
|
||
|
||
- **WHEN** 开启适配后执行 Mask、Frame、Rectify 或图片编辑 Job
|
||
- **THEN** 编辑结果 SHALL 沿用各自已有颜色空间与 Alpha 规则
|
||
|