# MoonEXR 增量功能：2026-11-06

本页接口自 MoonEXR 0.2.0 提供。

## 原始位级区域粘贴与有限样本经验分位数
`Image::paste_region(patch, limits~)` 将 patch 的绝对坐标窗口写入原图。
窗口必须完全位于目标 data window 内；patch 可只含部分现有通道，但 Channel 的名称、像素类型和 linear 标志必须一致。
按字节复制 HALF/FLOAT/UINT，保留未选通道、窗口外样本、原 display window、元数据和 screen 参数。
patch 自身元数据不覆盖目标；不裁剪、不重采样、不进行颜色混合。源图不变，操作重新校验调用预算。

`Plane::quantiles(probabilities, limits~)` 对有限样本按最近秩定义求经验分位数：
升序样本 x，p>0 返回 x[ceil(p*n)-1]，p=0 返回最小值；保持请求顺序及重复请求。
NaN/正负无穷不参与排序，报告 finite_samples/nonfinite_samples，无有限样本返回 None。
概率必须有限且在 [0,1]；请求数最多 max_attributes，样本数最多 max_pixels，
样本与结果的 Double 槽位估算总量受 max_decoded_bytes 限制。

用于渲染通道局部修订、对象 ID 修复、科学成像区域更新、批量资产质量阈值估计。
统计结果不自动修改曝光，也不代表完整色彩管理或统计推断。

粘贴 K 个目标通道、J 个 patch 通道，时间 O(KJ+B+P)，空间 O(B+K)，B 为被复制的目标通道字节、P 为 patch 字节。
分位数时间 O(N log N+Q)、空间 O(N+Q)，N 为样本数、Q 为请求数。
测试含负坐标、UINT32 最大值、非目标通道和元数据保留、文件往返、越界/类型/预算拒绝及非有限样本。

## 运行

```sh
moon run examples/expansion --target native --deny-warn
moon test --target all --deny-warn
```

Windows 使用 README 中对应的 Moon 包装脚本替代 `moon`。
CI 已添加该示例；无需网络服务、私钥或真实设备。