Files

nan 076a8c90f1 Add specifications for two-times upscale and unified depth plane features

- 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.

2026-09-17 17:19:05 +08:00

2.8 KiB

Raw Blame History

image-layer-alpha-adjustment Specification

Purpose

TBD - created by archiving change add-image-layer-alpha-adjustment. Update Purpose after archive.

Requirements

Requirement: Image layer exposes alpha adjustment strength

O Image Layer SHALL 在默认折叠的 Options 面板中依次提供 Alpha Fix、Normal Scale、Object Space。Alpha Fix SHALL 为浮点输入，范围 0–1，subtype 为 FACTOR，默认 0，并以该值控制内部 Alpha Float Curve 的 Factor。

Scenario: Options are initially collapsed

WHEN 创建 O Image Layer 节点实例
THEN Options 面板 SHALL 默认折叠，包含 Alpha Fix、Normal Scale、Object Space
AND Color、Alpha、Normal、Bump Scale SHALL 位于面板外

Scenario: Adjustment is disabled

WHEN Alpha Fix 为 0
THEN 组输出 Alpha SHALL 等于输入 Alpha

Scenario: Adjustment is fully applied

WHEN Alpha Fix 为 1
THEN 组输出 Alpha SHALL 等于内部 Float Curve 对输入 Alpha 的求值

Scenario: Adjustment is partially applied

WHEN Alpha Fix 为 0.5
THEN 输出 SHALL 等于原始 Alpha 与完整曲线结果的平均值

Requirement: Alpha curve follows the reference profile

Alpha 曲线 SHALL 使用四个点：起点 (0, 0)、低端控制点 (0.8, 0)、靠近右上方的平滑控制点和终点 (1, 1)，形成参考图中的快速上升轮廓。对输入范围 0–1，完整调整后的输出 SHALL 保持在 0–1，保持单调不减，并保持完全透明与完全不透明端值。

Scenario: Low alpha is suppressed

WHEN 输入 Alpha 在 0–0.8 且调整强度为 1
THEN 输出 Alpha SHALL 为 0，允许浮点求值误差

Scenario: Opaque alpha is preserved

WHEN 输入 Alpha 为 1
THEN 任意调整强度下输出 Alpha SHALL 为 1

Requirement: Material creation initializes adjustment from preferences

创建使用 O Image Layer 的材质时，系统 SHALL 通过现有偏好读取入口，将 Alpha Fix 初始化为 Adapt to Scene View Transform 开启时的 1、关闭时的 0。

Scenario: Adaptation is enabled

WHEN 开启适配后创建普通着色或 Shadeless 材质
THEN O Image Layer 实例的 Alpha Fix SHALL 为 1
AND 对应着色器 SHALL 使用该组调整后的 Alpha 输出

Scenario: Adaptation is disabled

WHEN 关闭适配后创建材质
THEN O Image Layer 实例的 Alpha Fix SHALL 为 0

Scenario: Color space falls back

WHEN 适配开启且颜色空间解析回退到 sRGB
THEN 新建 O Image Layer 实例的 Alpha Fix SHALL 仍为 1

Scenario: Existing material is manually adjusted

WHEN 用户修改现有材质的 Alpha Fix 后切换偏好
THEN 已有实例的调整值 SHALL 保留
AND 后续新建材质 SHALL 使用当前偏好初始化

2.8 KiB Raw Blame History Unescape Escape