渐变与合成

本页是图元像素语义的唯一契约:四角渐变、三角形重心插值、纹理染色、透明度、变换、裁剪与最终合成。核心与三个后端已实现,并通过下述目标像素验收。

输入格式、结构校验、资源分支与借用期限见图元输入设计;接口边界见渲染接口边界。

颜色与预乘

Color 是直通(非预乘)RGBA8888。计算前把编码 sRGB 的三个通道和 alpha 都除以 255 归一到 0..1,不做线性光、Oklab 或其它色彩空间转换。每个角或顶点先用自己的 alpha 预乘 RGB:

premultiplied = (r * a, g * a, b * a), alpha = a

预乘后的 RGB 与 alpha 都用浮点插值,不把中间结果量化回 8 位。插值完成后再进入合成;这与”先插值直通颜色、再在末尾乘一次 alpha”不同。

四边形:一个双线性场

lt、rt、lb、rb 定义未变换目标矩形上的同一个双线性场。设矩形为 left, top, width, height,对矩形内一点:

u = (x - left) / width
v = (y - top) / height

weight(lt) = (1 - u)(1 - v)
weight(rt) = u(1 - v)
weight(lb) = (1 - u)v
weight(rb) = uv

颜色 = 四个预乘角的加权和;alpha 也按同一组权重插值。把矩形拆成两个三角形只是栅格化分片:两个三角形必须评估同一个场,并让每个采样点恰好被覆盖一次。共享对角线不得出现裂缝、折痕、重复覆盖或 alpha 台阶。

翻转和转置必须对称:把四角按水平、垂直或转置关系重排,结果对应同一场的重排。四个角不能先平均成一个颜色,也不能把颜色映射到投影后的包围盒。

三角形列表:重心权重

每个三角形用自己的三个预乘顶点色做重心插值,规则与四边形相同:编码 sRGB、按顶点 alpha 预乘、浮点插值。相邻三角形的公共边同样不能重复覆盖或漏画;面积有意重叠的三角形则按列表顺序合成。无纹理与带纹理两个重载都遵守这一条。

纹理与 alpha

设渐变插值结果为 (Pg, Ag),其中 Pg 已预乘;纹理采样得到直通 RGB Cs 与 alpha As。源颜色为:

sourceP = Pg * Cs * As
sourceA = Ag * As

等价于把预乘纹理 (Cs * As, As) 与预乘渐变 (Pg, Ag) 逐分量相乘。每个 alpha 因子只乘一次:纹理 alpha 不再额外乘进 Ag,渐变 alpha 也不再额外乘进 As。

渐变域由目标矩形的局部坐标决定,与 UV 矩形、图片名义尺寸无关。同一笔绘制内,UV 平铺或裁剪只改变纹理采样,不会让渐变重复或重新开始。九宫格等多笔绘制各有自己的渐变域;需要跨分片连续时,由调用方给各分片分配对应的角颜色。

资源语义保持不变:待就绪或 ImageHolder.empty 不画;确认缺失、来源不支持或加载失败时使用缺图纹理,几何、UV 与顶点颜色不变,绝不退化成无纹理。越界与负 UV 原样交给纹理采样。纹理 alpha 为 0 或渐变 alpha 为 0 时,该采样对背景没有任何改变。

合成

每笔绘制对已有目标做一次 source-over,目标也是预乘表示:

outP = sourceP + destP * (1 - sourceA)
outA = sourceA + destA * (1 - sourceA)

颜色与目标 alpha 都要正确:

  • 目标是透明时,结果保留源 alpha;例如源 alpha 为 0.25 时有效 alpha 约为 64。
  • 目标不透明时,结果 alpha 仍为 1,不能被源的 alpha 拉低。
  • 不允许对已有 UI 目标使用 multiply、destination-in 等会改写背景的混合;需要多趟处理时,只在最终这一次 source-over 之前隔离完成。
  • 绘制顺序仍然决定覆盖关系;多层渐变叠加按调用顺序逐次 source-over。

变换与裁剪

渐变跟随仿射变换和合法的正 w 投影变换。旋转、切变、缩放后,颜色仍锚定在源矩形的局部坐标;透视四边形通过逆单应或透视正确的顶点属性恢复原始 u, v。合法投影四边形不得退化成两个仿射颜色三角形。

裁剪只限制覆盖范围,不改变渐变域:被裁掉的一侧不画,剩余部分的 u, v 仍按原矩形计算,不从裁剪后的矩形重新开始。

退化矩阵、w <= 0 或跨越视平面的变换不属于本契约;本次保留各后端的整笔回退或跳过策略,不允许输出半笔图元。跨后端统一这些无效变换的行为留待状态与坐标契约处理。

精度与验收

内部采样以浮点计算,8 位输出的内部采样容差约为 2/255。验收优先比较预乘 RGB 加 alpha,或把结果合成到黑/白背景后比较;alpha 很小时不要先反预乘再比较,否则除法会放大误差。外缘抗锯齿覆盖率单独验收,不并入内部采样容差。

代表用例:

用例 预期
不透明四角:左上白、右上红、左下黑、右下黑,取中心 约 RGB(128, 64, 64);不是两三角形对角线的 RGB(128, 0, 0)
同上,四角与四条边 场在角点等于输入值,边上按一维线性变化;边界像素的抗锯齿覆盖率另测
翻转、转置四角 与原场对应的翻转、转置一致
左侧不透明红过渡到右侧全透明蓝,取中点 预乘约 (0.5, 0, 0, 0.5);反预乘后仍是红色、alpha 约 0.5,不是紫色
四角 alpha 不等 alpha 按同一双线性权重插值,颜色按预乘插值
alpha 均为 0.5 的红色纹理与白色 tint 相乘,画在不透明蓝上 约 RGB(64, 0, 191),A = 255
同一笔画在透明目标上 预乘约 RGB(64, 0, 0),有效 A 约 64
非白 tint 与全透明 texel tint 逐分量相乘;alpha 为 0 的 texel 不改变背景
多层渐变叠在已有内容上 每层按调用顺序做一次 source-over,背景 alpha 正确
裁剪右半后观察左缘 左缘的 u 仍来自完整矩形,渐变不从裁剪边缘重启
旋转、切变与正 w 透视 源局部坐标的四角颜色位置不变,透视不塌成仿射近似
平铺或裁剪 UV 纹理重复/裁切,渐变在整个矩形上仍只有一份
两个三角形重载 都按预乘重心插值,公共边无重复覆盖

2026-10-31 验收:Java2D 实际渲染器、真实 headless Chrome 的生产客户端、MC 生产着色器与顶点发射路径的离屏 GPU 渲染,各通过同一套 67 组、328 个内部采样点;另有仓内自动测试覆盖共享边、状态恢复与资源生命周期。参考值独立按本页公式计算,比较预乘 RGB 与 alpha。

MC GPU 验收使用 NVIDIA RTX 3060 Laptop,并未启动完整 Minecraft;它不覆盖游戏内纹理管理器、原生物品与文字的完整集成。浏览器只验收 Chrome,外缘抗锯齿和整页画面不承诺逐像素一致。本次没有性能提升结论。

不变项

不新增公共 Gradient 类型、模式或能力标志;不改变通用 Color 运算、动画与 mixedWith 等函数;不把每次四角或颜色变化变成新的材质/批次键,也不强制逐四边形提交。框架侧仍不分配逐顶点对象或每次绘制整屏大小的无界缓冲区。


This site uses Just the Docs, a documentation theme for Jekyll.