mirror of
https://github.com/Shu-Ying/main_plugin_farm.git
synced 2026-10-30 06:09:59 +08:00
73 lines
3.2 KiB
Markdown
73 lines
3.2 KiB
Markdown
# 作物绘制统一定位规则
|
||
|
||
2026-10-19 经用户确认，后续普通地块作物绘制采用本文公式。
|
||
本文取代 `14-crop-position-calibration.md` 中的人工逐阶段定位方案。
|
||
不再扩展人工锚点，不按非透明包围盒裁剪图片，不保存网页作物 ID。
|
||
|
||
## 已确认的来源
|
||
|
||
网页公开 Lua 包的 `WebGLMainSceneLandController:SetCropTexture`：
|
||
先调用 `Image.SetNativeSize()`，生长阶段宽高乘 0.75，
|
||
再将 `RectTransform.anchoredPosition` 设为零。
|
||
`WebGLMainSceneLandsController:InitLands` 使用
|
||
`LandsCrops/LandN/crop` 作为普通地块作物节点。
|
||
|
||
主场景包中对应的 90 个普通作物节点（含不同预制体副本）
|
||
统一采用 `pivot = anchorMin = anchorMax = (0.5, 0)`。
|
||
这是完整画布底边中点，不是可见茎根的人工标注点。
|
||
普通土地与作物父容器中心一致；参考矩形为 153 × 79.5。
|
||
|
||
## 计算公式
|
||
|
||
输出画布左上角为原点，x 向右、y 向下。土地矩形中心为
|
||
`(Cx, Cy)`，显示高度为 `D`，作物完整画布最终显示宽高为 `w, h`：
|
||
|
||
```text
|
||
left = Cx - w / 2
|
||
top = Cy + D / 2 - h
|
||
```
|
||
|
||
原版原生像素单位一致时，PNG 完整画布为 `W, H`，场景倍率为 `s`：
|
||
|
||
```text
|
||
D = 79.5 × s
|
||
w = 0.75 × W × s
|
||
h = 0.75 × H × s
|
||
left = Cx - 0.375 × W × s
|
||
top = Cy + 39.75 × s - 0.75 × H × s
|
||
```
|
||
|
||
先确定统一场景单位，不能把 0.75 重复叠加到已有图片缩放。
|
||
以实际最终显示宽高计算位置，仅在落到输出像素时取整。
|
||
必须保留透明留白；参考土地矩形，不能使用土壤可见像素包围盒。
|
||
|
||
## 阶段边界
|
||
|
||
- 原版 step 2～6：上述生长图片公式。
|
||
- step 1：公共种子图，原生尺寸乘 0.5，localPosition=(0,0,0)。
|
||
- step 7/8：公共枯萎图，原生尺寸乘 0.5，localPosition=(0,-8,0)。
|
||
- 本地阶段编号需正确映射到原版资源阶段，不能直接混用。
|
||
- 特殊、动画和其他场景的作物须分别核验其控制器。
|
||
|
||
## 验证与接入状态
|
||
|
||
随机抽取本地数据库的茄子、油菜、黄瓜、迎春花、桂圆，
|
||
共绘制 24 个生长阶段；保留完整透明画布，不使用人工锚点。
|
||
场景倍率为 2，底边对齐的计算误差不超过 0.5 输出像素。
|
||
这验证了预览公式的执行与图片效果，不代表所有素材已逐一核对原图。
|
||
|
||
正式渲染器现使用 `crop_positions.json` schema=4 的本地可见落地机制，
|
||
不包含人工逐阶段锚点。种子和枯萎仍使用场景包原始公共精灵，
|
||
分别为 69×30 和 209×92。
|
||
|
||
此前将本地土地完整 PNG 高度除以 79.5，混用了透明画布与父矩形语义。
|
||
当前通过全部 30 块地中心计算整体尺度；作物保持直立等比缩放，以可见
|
||
底部区域的加权中心对齐本地土地中心，不再使用网页底边锚点。
|
||
虫子保留局部坐标映射；输出分辨率再乘 `width/3072`。
|
||
详见 [作物场景映射修正](22-crop-scene-mapping.md)。
|
||
原网页规则仍成立，但不能把本地 PNG 高度直接视为上文的 D。
|
||
沿用的旧土地网格存在拟合残差，不是网页场景的像素级复刻。
|
||
|
||
`scripts/preview_crop_positions.py` 已改为调用正式渲染器，生成
|
||
1024、1536、3072 三种输出档位的作物阶段及虫子预览。
|