feat(contour-map): 重写为可交互 3D 等高线模型,新增五大地貌专题 #30

Merged
Morris merged 1 commits from feat/contour-map-rewrite into main 2026-11-19 20:46:00 +08:00
Owner

概述

把 model/contour-map 从「图片式示意图 + 标注层」重写为可交互 3D 等高线教学模型,并补齐五大典型地貌专题。

主要改动

1. 五大地貌高度场(TerrainField.cs)
新增 LandformKind 与五套生成器:穹状山峰、宽脊山脊、V 形山谷、双峰鞍部、台地陡崖。地形按真实比例做得较宽阔,半径过小会退化成"尖锥 / 薄墙",等高线铺不开。

2. 可交互 3D 视图(ContourView.cs,重写)

  • 鼠标拖动旋转、滚轮缩放,按地形包围盒八点投影自动取景铺满画布
  • 法线光照 + 四周裙边侧壁,山体有厚度不再悬空
  • 四步实验动画:等高切割 → 形成交线 → 垂直投影 → 疏密判坡
  • 切割步骤不再叠加半透明板,而是把高度压到切面 min(h, lv) 得到真实截面,并用 ExtractContour(lv) 精确求交线
  • 3D 用 ColorForHeightSmooth 渐变设色,俯视仍保留教材式硬分档 + 图例、指北针、比例尺、剖面图

3. 界面(ContourPage.cs,重写)
地貌标签移到画布上方(WrapPanel,窄屏自动换行并隐藏侧栏);右侧栏放实验流程 / 观察面板 / 判读要点;底部播放、重置、视图切换、上色、实时读数;空格与 1–5 快捷键;全屏。

4. 文案(DefaultTexts.cs / i18n)
90 个键中英各一套。顺带修复 LoadTexts 从不读 i18n 文件、语言包形同虚设的缺陷,改为「内置默认 + 语言包覆盖」。

修复的渲染缺陷

问题 根因 修复
3D 里等高线呈断续虚线 Chain() 只向尾部延伸,一条曲线被切成十几段短链 端点索引 + 双向延伸,每层恢复为 300+ 点完整曲线
"疏密判坡"整片红 SlopeAt 固定除以 450,坡度全部饱和到 1 按地形起伏 span*2.6 自适应归一化
切割是假切割 只叠加半透明板,山尖仍在 高度压到切面得到真实截面;被削掉的山峰不再标高

验证

  • dotnet build model/contour-map/src/ContourMapModel.csproj -c Release:0 警告 0 错误
  • dotnet run --project model/_engine/PreviewGen:全模型离屏渲染通过,封面已重新生成
  • 另建全尺寸离屏渲染器逐状态出图核对(默认 / 俯视 / 五地貌 / 四步动画 / 中间帧)
  • 性能:62×62 面片 + 画刷颜色缓存,1440×900 单帧约 35 ms(≈28 fps)

备注

清单版本 1.1 → 1.2,help.json 与新交互同步;ContourMapModel.dll 已按仓库既有约定部署到 contour-map.model/。

## 概述 把 `model/contour-map` 从「图片式示意图 + 标注层」重写为**可交互 3D 等高线教学模型**,并补齐五大典型地貌专题。 ## 主要改动 **1. 五大地貌高度场(`TerrainField.cs`)** 新增 `LandformKind` 与五套生成器:穹状山峰、宽脊山脊、V 形山谷、双峰鞍部、台地陡崖。地形按真实比例做得较宽阔,半径过小会退化成"尖锥 / 薄墙",等高线铺不开。 **2. 可交互 3D 视图(`ContourView.cs`,重写)** - 鼠标拖动旋转、滚轮缩放,按地形包围盒八点投影自动取景铺满画布 - 法线光照 + 四周裙边侧壁,山体有厚度不再悬空 - 四步实验动画:等高切割 → 形成交线 → 垂直投影 → 疏密判坡 - 切割步骤不再叠加半透明板,而是把高度压到切面 `min(h, lv)` 得到真实截面,并用 `ExtractContour(lv)` 精确求交线 - 3D 用 `ColorForHeightSmooth` 渐变设色,俯视仍保留教材式硬分档 + 图例、指北针、比例尺、剖面图 **3. 界面(`ContourPage.cs`,重写)** 地貌标签移到画布上方(WrapPanel,窄屏自动换行并隐藏侧栏);右侧栏放实验流程 / 观察面板 / 判读要点;底部播放、重置、视图切换、上色、实时读数;空格与 1–5 快捷键;全屏。 **4. 文案(`DefaultTexts.cs` / i18n)** 90 个键中英各一套。顺带修复 `LoadTexts` 从不读 i18n 文件、语言包形同虚设的缺陷,改为「内置默认 + 语言包覆盖」。 ## 修复的渲染缺陷 | 问题 | 根因 | 修复 | | --- | --- | --- | | 3D 里等高线呈断续虚线 | `Chain()` 只向尾部延伸,一条曲线被切成十几段短链 | 端点索引 + 双向延伸,每层恢复为 300+ 点完整曲线 | | "疏密判坡"整片红 | `SlopeAt` 固定除以 450,坡度全部饱和到 1 | 按地形起伏 `span*2.6` 自适应归一化 | | 切割是假切割 | 只叠加半透明板,山尖仍在 | 高度压到切面得到真实截面;被削掉的山峰不再标高 | ## 验证 - `dotnet build model/contour-map/src/ContourMapModel.csproj -c Release`:**0 警告 0 错误** - `dotnet run --project model/_engine/PreviewGen`:全模型离屏渲染通过,封面已重新生成 - 另建全尺寸离屏渲染器逐状态出图核对(默认 / 俯视 / 五地貌 / 四步动画 / 中间帧) - 性能:62×62 面片 + 画刷颜色缓存,1440×900 单帧约 35 ms(≈28 fps) ## 备注 清单版本 1.1 → 1.2,`help.json` 与新交互同步;`ContourMapModel.dll` 已按仓库既有约定部署到 `contour-map.model/`。
Morris added 1 commit 2026-11-19 20:45:19 +08:00
feat(contour-map): 重写为可交互 3D 等高线模型,新增五大地貌专题
PR 审核 / 后端编译 (pull_request) Canceled after 0s
PR 审核 / 后端自检 (pull_request) Canceled after 0s
PR 审核 / 前端检查(Flutter) (pull_request) Canceled after 0s
PR 审核 / 安全扫描 (pull_request) Canceled after 0s
PR 审核 / 审核汇总 (pull_request) Canceled after 0s
5b628971a9
- 新增 LandformKind 与五套高度场生成器:穹状山峰、宽脊山脊、V 形山谷、双峰鞍部、台地陡崖
- 3D 视图重写:拖动旋转 / 滚轮缩放、按包围盒自动取景、法线光照、四周裙边侧壁、
  切割步骤改为把高度压到切面得到真实截面并用求交线精确出线
- 四步实验动画(等高切割 → 形成交线 → 垂直投影 → 疏密判坡),俯视 / 立体切换
- 界面重排:地貌标签移到画布上方(WrapPanel,窄屏自动换行并隐藏侧栏),
  右侧栏放实验流程 / 观察面板 / 判读要点;播放、重置、视图、上色、实时读数,空格与 1–5 快捷键、全屏
- 文案 90 个键中英双语;LoadTexts 改为「内置默认 + i18n 文件覆盖」,此前完全忽略语言包
- 修复三处渲染缺陷:Chain() 只向尾部延伸把等高线切成虚线;坡度归一化写死导致判坡整片红;
  切割只是叠加半透明板而山尖仍在
- 清单版本 1.1 → 1.2,描述与 help.json 同步;62×62 面片 + 画刷缓存,1440×900 单帧约 35ms
Morris merged commit 4ef291568a into main 2026-11-19 20:46:00 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Morris/GC#30