搜索

TERRA·MESH 使用指南

欢迎使用 TERRA·MESH —— 一款轻量级的 3D 体素地形编辑与查看工具。
你可以像搭积木一样塑造山丘、挖出隧道、种上树木、放置建筑，还能标记路径、调节昼夜，并保存／加载你的作品。
本指南分为两部分：
  • 编辑页面：创造与修改你的世界。
  • 查看页面：仅展示地图。

一、快速上手（通用操作）

无论哪个版本，你都可以用鼠标或触控板自由探索 3D 场景：
  • 左键拖拽：旋转视角（查看模式）/应用工具（编辑模式）
  • 右键拖拽：平移视角（查看页面中）/旋转视角（编辑页面中）
  • 滚轮：拉近拉远
  • 中键拖拽：平移视角（编辑页面中）/拉近拉远（查看页面中）
  • 双击（折线工具下）：结束当前折线

二、编辑页面——创造你的世界

打开编辑版，你会看到一个带有大量控制面板的界面。
面板分为多个区域，按从上到下顺序说明：

1. 工具区（第一行图标）

  • 观察（1）：默认模式，可自由旋转/平移，不会修改地形。
  • 塑形（2）：堆叠地形（默认加高），配合下方的“笔刷模式”使用。
  • 挖掘（3）：削低地形或掏洞。
  • 乔木（4）：在草地上种树（自动选择树种）。
  • 棕榈（5）：种植棕榈树（适合沙地）。
  • 灌木（6）：种植灌木丛。
  • 小屋（7）：放置小房子（自动适配高度）。
  • 高楼（8）：放置塔楼。
  • 标记（9）：在地形上打点并添加文字备注。
  • 折线（0）：点击放置节点，双击结束，形成路径标记。
  • 基准（B）：参考平面工具（下面详细解释）。
键盘快捷键：工具图标上标注的数字键（1~0、B）可直接切换。

2. 笔刷直径（滑块）

控制每次涂抹影响的半径（1 = 1格大小）。直径越大，一次性塑造的范围越广。

3. 笔刷模式（塑形／挖掘的细分模式）

当选中“塑形”或“挖掘”工具时，你可以选择五种笔刷行为：
  • 加高（Q）：在现有地形上向上堆一层。
  • 平整（W）：将区域内的地表高度拉平（以第一次点击的高度为基准）。
  • 平滑（E）：平均周围高度，让地形更自然。
  • 涂色（R）：仅改变地表材质的颜色，不改变高度。
  • 体素（T）：自由堆叠或掏挖，无视地表连续性，可造悬挑、山洞等结构。
“体素”模式适合精细雕刻，其余模式适合快速地形塑形。

4. 基准面（平面涂抹）

基准面是一个虚拟平面，你可以调整它的倾斜角度（X/Z）、高度和层偏移。
启用后，“加高”和“平整”会严格沿该平面整层涂抹，非常适合修筑斜坡、梯田或平整地基。
“挖掘”则会向下削到平面下方一层。
点击地形上的“基准”工具，即可将该点设为平面的基准位置。

5. 时间与天空

  • 跟随实际时间：勾选后，天空光照自动与你的电脑时钟同步。
  • 手动时间：取消勾选后，可拖拽滑杆设定任意时刻，配合“流速”可模拟昼夜循环快进。

6. 显示模式

  • 三角网格：默认，地形显示为平滑的三角形网格，视觉效果更自然。
  • 体素方块：显示为像素风方块，适合查看体素结构。

7. 场景尺寸（自设）

你可以调整地图的宽度、高度、深度，点击“应用尺寸”后重新生成一块空白地图（注意：会清空当前内容）。
尺寸越大，体素数量越多，性能消耗也越大。

8. 塑形材质

点击色块选择当前“涂色”模式或“加高”时使用的地表材质（草、泥土、岩石、沙、雪、红壤、水）。

9. 地貌配色 & 植被与建筑配色

你可以自由调整各类地形和物体的颜色，打造独特的美术风格。

10. 场景操作

  • 重新生成：用随机种子重新生成地形（保留当前尺寸）。
  • 撤销：撤回上一次笔触操作（可多次撤销）。
  • 导出地图：将当前地形、标记、折线打包成一个 .json 文件。
  • 导入地图：加载之前导出的 .json 文件，恢复完整场景。

三、查看页面——只读查看

该页面移除了所有编辑功能，专注于展示地图，界面更加简洁。

可用的控制功能（取决于配置）

  • 显示模式切换（如果开启）：可在“三角网格”和“体素方块”间切换。
  • 标记显示开关：可隐藏/显示地图上的标记和折线，避免干扰。
  • 时间控制（如果开启）：可手动调节时刻，模拟不同光照。

如何查看自己的地图？

  1. 使用编辑版保存地图到数据库。
  2. 打开只读版。
  3. 场景即刻载入，你可以自由旋转查看。

四、常用键盘快捷键

1 ~ 0, B：切换工具
Q / W / E / R / T：切换笔刷模式（加高/平整/平滑/涂色/体素）
[</code> / <code>]：减小/增大笔刷直径
M：切换显示模式（网格/方块）
Ctrl+Z：撤销
Esc： 取消当前折线/关闭标记编辑弹窗
G：重新生成地形
查看页面仅保留 M 键切换显示模式（若该功能被开启）。

五、常见问题与提示

  • 为什么我涂色没有变化？
    确保你当前工具为“塑形”，并且笔刷模式选为“涂色”（R）。
  • 如何删除放置的树或建筑？
    切换到对应的工具（如“乔木”），点击已有的树木，它会消失（相当于橡皮擦）。
  • 基准面启用后，“加高”为何只在一个高度层操作？
    因为基准面是平面，它会强制所有柱子达到同一高度，非常适合修路或平台。
  • 地图太大导致卡顿怎么办？
    缩小地图尺寸，或降低笔刷直径，或切换到“体素方块”模式（网格模式计算量稍大）。
  • 导出的 .json 文件能分享给别人吗？
    可以，直接发送文件，对方在编辑页面中导入即可。

六、进阶提示

  • 标记与折线：可用于记录重要地点、规划路径或给其他玩家做提示。
  • 体素模式下的“堆叠”和“挖掘”可创建浮空岛、桥梁、洞穴等复杂结构，发挥你的创意！
  • 结合“基准面”的倾斜功能，可以快速制作斜坡或阶梯式梯田。