docs/15-crop-position-formula.md

# 作物绘制统一定位规则

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=2 保存统一规则，
不再包含人工逐阶段锚点；导出 metadata 也不再写入人工标注。
种子和枯萎使用场景包原始公共精灵，分别为 69×30 和 209×92。

现有 3072 基准场景沿用旧土地布局；以其土地显示高度 `D` 除以 79.5
得到原版单位到当前布局的统一倍率，再换算作物与虫子尺寸和坐标。
跨输出分辨率只追加 `width/3072`，不重复应用 0.75。
旧土地的宽高比例仍沿用本地布局，因此本次是定位规则移植，
不是对整个网页场景像素级复刻。

`scripts/preview_crop_positions.py` 已改为调用正式渲染器，生成
1024、1536、3072 三种输出档位的作物阶段及虫子预览。