# 屋顶清晰度试点与两处精模样例

## 本次新验收要求

维护者提供正面案例(110.40957689672715,28.4430329383677)和反面小区(110.40570023361066,28.434788752462875)，要求提高屋顶清晰度、精模外观至少达到正面案例的细节标准，并补全规则小区真实楼体。维护者已明确肯定卡顿基本解决、渐进加载很好；后续须保留现有加载策略/预算。此反馈是用户硬件体验接受，不是代理采集的GPU时间/FPS测量。

## 屋顶清晰度实现

检查本地影像meta.json，最高zoom19。问题主要是精片把屋顶atlas最长边统一降为64px：若覆盖224m，约3.49m/px；某些覆盖435–449m的精片约6.8–7.0m/px。直接锐化这类64px不能恢复源图细节。

实现了可选纹理密度/限幅锐化参数，默认参数不变。独立试点使用z19源图采样密度、最长边≤512，RGB轻微unsharp amount0.25，单通道变化≤8，JPEG92；不生成虚构图像、不声称新增测绘信息。保留源TMS瓦片哈希、原RGBA/处理RGBA哈希和最终JPEG哈希。

| 精片 | 当前atlas | 试点atlas | 当前有效m/px | 试点有效m/px |
|---|---|---|---|---|
| region25 fine27 |64×64|205×203|0.838/0.830|约0.262/0.262|
| region25 fine0 |64×60|512×475|3.494/3.451|约0.437/0.436|

已实际打开[旧fine0图](<roof-quality-pilot/region-25-fine-0-current.jpg>)、[新源密度图](<roof-quality-pilot/region-25-fine-0-source-density.jpg>)、[处理后图](<roof-quality-pilot/region-25-fine-0-processed.jpg>)及fine27对应图。清晰度提升主要来自保留源像素，轻微锐化变化很小。Atlas矩形中的道路/地面可见于对照图，但UV仍只应用已有屋顶几何；该图片不是模型渲染截图，不证明3D中投影完全自然。

[试点报告](<roof-quality-pilot/report.json>)记录两块独立GLB，不在运行配置中。合计解码纹理估算增加1,474,740字节；region25从30,546,032增加到32,020,772字节，单区仍低于96MiB。实际GPU/渲染/整城替换仍未验证；不能将这两个试点结论推广为全城512纹理成本通过。

## 回归与依赖情况

- [投影回归](<../../../../../tools/city-massing/verify-roof-geodesy.mjs>)27个已知WGS84正算点反解通过，最大高度误差1.86e-9m；ENU变换矩阵和原点检查通过。该回归覆盖县城附近/0–450m，不是全球极区地理库。
- [像素处理回归](<../../../../../tools/city-massing/verify-roof-raster-quality.mjs>)512上限、无源数据修改、alpha保留、均匀色不变、限幅锐化通过。
- [可重现试点回归](<../../../../../tools/city-massing/verify-roof-quality-pilot.mjs>)当前生成器默认64px能逐字节复现两块旧JPEG；处理后JPEG与已保存试点逐字节一致；完整解码几何/法线/index、UV、非屋顶材质和源哈希通过。
- 本地node_modules/@cesium/engine当前缺失，Cesium模块导入失败。为离线纹理采样抽出局部WGS84换算，未安装依赖、未修改应用的Cesium版本。原依赖Cesium的整城验证当前不能自动宣称再次通过。

## 正反坐标质量对账

[190m范围当前报告](<user-samples/report-v2.json>)使用原七个roofed2源manifest的ID，属于30159源集元数据，不是逐精片几何和真实render证明；新增13栋pilot不在该旧源集定义里。此次修复座落excluded记录重复添加cad前缀的映射错误。

- 正面：282 active源ID；0已座落未active；21 planned未座落；103无plan。已打开[正面图](<user-samples/positive-fine-coverage.jpg>)。附近asset/massing混合，不能仅靠archetype把所有楼体认定达标。
- 反面：171 active源ID；82已座落未active；68 planned未座落；175无plan。已打开[反面图](<user-samples/negative-estate-coverage.jpg>)。绿=active，青=已座落未active，红=planned未座落，黄=无plan，紫十字=用户坐标。
- 四个已座落未active的4–5层估算候选：cad-25612(494.5m²/5层/高差0.81m)、cad-25467(514m²/5层/1.86m)、cad-25968(288.4m²/4层/3.03m)、cad-25957(283.8m²/4层/2.68m)。源rural标签是mask选择分类；需要逐屋顶+重复轮廓复核后决定局部纳入，不全面恢复rural。
- 更靠近用户位置的cad-25627/25641/25632仍因高差20.56/6.85/3.30m排除，面积/估层分别约960m²8层、714m²6层、520m²6层。这些更大轮廓不能由上述四个小候选替代成“整个小区已补全”。

## 后续实施

先审核反面小区大楼栋的重复/复合测绘轮廓与原DEM适用性，提出按小区整体基础但逐栋外观的方案；保留道路和楼间隙，明确楼高/立面是估算。普通massing近景需补窗、层线/入口等细节并保持闭合屋顶，不能仅把GE0名称称为精模。屋顶需由小试点推广到有资源门限的独立新版本后才考虑接入。

本轮仅离线生成/复验，不运行Web build/debug、服务器或浏览器。维护者性能体验接受已记录，但精模质量统一、反面小区恢复、高清屋顶运行接入和最终外观仍未完成，目标active/票open。