用途:当所选配置文件、验证报告或用户请求明确指定 FET_010_STANDARD 时,使用该技能在可渲染几何体上编写或修复 primvars:displayColor,不改动着色表面(后者属于 FET_006_STANDARD/006_MDL/006_OPENPBR 的契约)。未指定版本时默认 FET_010_STANDARD@0.1.0;报告中若为其他 FET_###_RUNTIME 特性,应先切换到对应技能。
主要能力:显示色是面向不评估材质的消费者的外观层,可独立于材质修复,甚至可用于完全无材质的资产;但它不能凭空捏造颜色——颜色来自绑定的材质,无可派生来源的几何体会被报告而非猜测。附带脚本 assets/scripts/author_display_color.py 在每个可渲染 Gprim 上写入常量 primvars:displayColor。
必要用法:python author_display_color.py <path> --verify(仅报告 DISP.001/002/003,不写入);--dry-run(显示将写入什么);python author_display_color.py <path>(写入并采样基础色贴图);--no-textures(仅用材质常量,不打开贴图);--edit-target binding(写入各 Gprim 的 material:binding 层,可覆盖实例化几何体)。脚本需 USD Python(pip install usd-core),采样还需 numpy 和 Pillow。--verify 与 --dry-run 互斥。脚本可安全重复运行,派生确定,但会重写二进制层,比较应使用展平后的 USD 而非文件哈希。退出码:0 干净,1 --verify 发现问题,2 参数错误或路径下无 USD 资产,3 至少一个资产无法读取或报错。
适用场景:清理或修复 SimReady 资产的显示颜色一致性,尤其是引用或实例化的资产。
限制:常量插值为有损,多材质网格会合并为面积加权均值;仅取基础色,不含遮蔽、金属度、顶点色与不透明度;忽略 alpha;采样为最近纹素点采样且有预算上限。在现有样例库中 --no-textures 基本无法使资产合规。权威来源为 nv_core 下的 FEAT_010_STANDARD JSON/MD 及 display_color 能力需求文档(DISP.001、DISP.002)。