裁剪与变换作用域

本页规定 withScissor(rect, block) 与 withTransform(transform, block) 的行为。公共签名不变,不新增裁剪类型、能力标志或提交接口。当前实现进度见渲染接口边界,颜色与合成规则见渐变与合成。

坐标与快照

withScissor 的矩形处于当前局部坐标系。进入时读取四条边,快照完整的局部到输出变换(包括外层仿射、GUI 缩放与投影),映射四个角。

有效矩形具有有限正宽高,边与宽高均可表示为有限 Float;进入时的变换有限、可逆,四个角的齐次坐标 w 均大于零。生效区域是投影四边形与已有输出裁剪的精确交集。

  • 旋转、切变、反射与正 w 透视均按真实形状求交。轴对齐包围盒只能用于粗筛;只有真实区域轴对齐时,才可直接作为最终裁剪。
  • 裁剪进入后冻结在输出空间。块内的新变换不会移动它;嵌套裁剪使用各自进入时的变换,继续求交。
  • Rect 只在调用期间借用。后端须复制所需数值,块内改写 MutRect 不改变已生效的裁剪。

例如,先旋转 45° 再裁剪正方形,得到菱形;填充足够大的矩形后,菱形内有内容,包围盒四角保持背景。只变换左上和右下两点,或直接采用包围盒,都不满足契约。

空裁剪

宽高非正、未测量或非有限数值、边或宽高发生 Float 溢出、非有限或奇异的进入变换,以及任一角 w <= 0,均得到空裁剪。跨越视平面也属于此类。

空裁剪抑制范围内所有绘制,不能回退为无界输出。父裁剪为空时,子裁剪仍为空。无论输入是否有效,block 都恰好执行一次,保留副作用与控制流。

覆盖与合成

裁剪约束作用域内全部绘制,包括四边形、三角形、文字及装饰、控件背景、物品与平台原生绘制。不同着色器或管线不能绕过裁剪。原生文字和物品不因此新增投影几何能力,但仍须裁到同一输出区域。

裁剪只改变覆盖范围,不改变源颜色场、UV、纹理采样、绘制顺序或原生混合方式。普通图元仍按原有 source-over 规则绘制。不得把作用域变成透明隔离组;允许临时目标,但其初始内容与回写必须保证与直接绘制等价,包括已有颜色与深度。

退出与异常

两个作用域都在 finally 中恢复进入前的状态,无论正常退出还是块抛出异常。原异常须原样传播;已执行的绘制不要求回滚。录制型后端即使遇到异常,也须保留配对的 push/pop 和每笔绘制当时的状态。混合嵌套不得污染后续绘制或下一帧。

后端可在状态切换时提交排队批次,不要求逐图元提交,也不改变既有排序契约。

精度与验收

精确指几何覆盖。允许浮点、光栅化与外缘抗锯齿造成的边界差异;采样取区域内部与外部,避开边界,不要求跨平台字体抗锯齿一致。

验收须驱动生产路径,与独立投影多边形或半平面参考比较,覆盖:

  • 菱形、切变、反射、透视、仿射与透视的两种嵌套顺序,及多层真实求交;
  • 子变换下的冻结裁剪、借用矩形改写、空与无效输入、异常后的恢复;
  • 文字、纹理、三角形与原生管线,以及范围外已有颜色和深度的保留。

把最终裁剪退回包围盒或移除必要的恢复时,对应测试必须失败。完整游戏集成、其它浏览器与驱动的验收范围应由后端如实记录,不能用离屏管线测试代替。

当前验收范围

窗口生产渲染器、真实 Chrome 中的 Web 客户端、MC 生产裁剪管线的离屏 GPU 均通过独立的 40 组场景、4522 个内部/外部采样点。MC 另通过嵌套目标激活后的正常/异常恢复、跨作用域复用同一目标对象、尺寸变化、颜色与深度保留及原序/优化重放测试;原有 67 组渐变对照在三个后端也继续通过。

MC 测试使用隐藏的 OpenGL 3.2 上下文和独立原生式着色器,验证裁剪能约束不同管线;没有启动完整游戏客户端。实际字体/物品的完整游戏集成、其它浏览器与其它 GPU 驱动仍需分别验收。

圆角与软遮罩、透明隔离组、排序优化、输出尺度接口、内容来源与字体接口均不在本项范围;后续事项见渲染接口边界。


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