基础用法

本节介绍如何使用组合样条工具（Assembly Spline Tool）在样条路径上创建模块化网格装配的核心流程。

快速入门

打开工具

1. 在世界编辑器（World Editor）顶部找到模式栏。
2. 点击 组合样条 模式按钮。
3. 工具窗口会打开，顶部有一排按钮。
4. 第一个按钮是 “添加新组合样条”。

创建新的组合样条

1. 在工具窗口中点击 “添加新样条”。
2. 地图上的鼠标指示球会从红色变为紫色。
3. 在地图上左键单击，即可依次放置节点并绘制样条路径。
4. 继续点击添加更多节点，随着用户绘制样条会动态显示出来。

基础编辑

移动节点

• 鼠标方式：直接在地图上点击并拖动节点。
• Gizmo方式：按下 ALT 键以切换gizmo模式，然后用gizmo的移动手柄拖动。

调整样条宽度

1. 选中组合样条上的某个节点。
2. 查看该节点左右两侧的 “肋部手柄”（rib handles）。
3. 向内或向外拖动肋部手柄，以调整样条宽度。
4. 这会影响组件在样条上的间距和排布。

节点编辑

• 选择节点：点击任意节点（被选中时会高亮）。
• 拖动节点：点击并拖动节点在地图上移动。
• 添加新节点：在地图空白区域悬停，可在样条任意一端（距离近的一端）添加节点。
• 插入节点：在样条上悬停，可见高亮球体和提示文字，点击即可插入新节点。
• 删除节点：选中节点后按下 DEL 键。

样条操作

• 闭合样条：将起点或终点节点拖动到另一端附近，会出现提示线和文本说明。按住 SHIFT 并松开可将样条闭合成环。
• 合并样条：将一条样条的起点或终点节点拖动到另一条同工具类型样条的起点或终点节点，会出现提示线。按住 SHIFT 并松开，可将它们合并为一条样条。
• 分割样条：选中某个节点，然后点击样条列表下方的 “分割” 按钮，即可在该点将样条分割为两条。
• 简化样条：使用 “简化” 按钮可在保留主要形状的同时，减少节点数量。
• 翻转样条：使用 “翻转” 按钮可颠倒样条节点顺序，实现方向反转，组件排列方向也会相应切换。

使用默认套件

1. 创建样条后，工具会自动加载默认组件套件。
2. 套件组件会在工具窗口的 组件 区域中显示。
3. 用户会看到主要的立柱组件和桥接线组件。
4. 随着用户绘制样条，套件会自动沿样条进行装配排列。

组件套件结构解析

1. 分子组件（Molecule Components）：装配中刚性的部分，沿着样条线放置（如电线杆、围栏柱等）。

2. 桥接组件（Bridge Components）：可拉伸的网格，用于连接各个分子组件（如电话线、电线、围栏板等）。

3. 别名（Alias）：当桥接组件在多个地方出现时，会创建别名条目以便区分。

4. 变体（Variation）：组件可能有不同的变体（如红色、白色、干净、脏污等）。

5. 根节点（Root）：所有装配套件都必须包含一个根分子网格，并且该网格总是最先被放置。

创建组合样条线

调整分子间距

1. 在样条属性区域找到 分子间距（Molecule Spacing） 滑块

2. 拖动滑块可以增加或减少分子之间的距离

3. 数值越小 = 分子间距越近

4. 数值越大 = 分子间距越远

5. 距离变化时，桥接组件会自动拉伸，始终与每个分子组件的正确位置连接

6. 用户调整时，可以实时看到网格的变化

调整桥接下垂度

1. 在样条属性区域找到 桥接下垂度（Bridge Sag） 滑块

2. 拖动滑块可以调整桥接组件的下垂程度（如组件支持）

3. 数值越小 = 下垂度较小

4. 数值越大 = 下垂度较大

分布方式选项

1. 轮流分布（Round Robin）：按顺序轮流遍历所有已启用组件

2. 随机分布（Random）：利用权重和随机种子来分配组件

切换不同的组件套件

加载围栏套件

1. 在 套件管理（Kit Management） 区域，点击 “加载套件（Load Kit）”

2. 浏览或选择围栏套件（包含木柱和木板）

3. 围栏组件会替换电线杆组件

套件对比

1. 电线杆套件：电线杆 + 电线桥接件，适用于基础设施

2. 围栏套件：木柱 + 木板，适用于边界

3. 组件列表：每个套件包含不同的分子组件与桥接组件

4. 间距需求：不同的套件可能需要不同的间距设置

朝向与放置

法线模式的使用

1. 法线模式（Normal Mode） 按钮有三种状态循环切换：

   • 地形（Terrain）：使用每个节点本地的地形法线
   • 本地（Local）：使用样条线的方向和朝向
   • 全局（Global）：使用世界“上”方向（0, 0, 1）

2. 建议从地形模式开始，实现自然放置效果

3. 点击按钮切换为本地模式，可以让组件按照样条线的方向放置

4. 再次点击切换为全局模式，可以让组件按照世界坐标对齐

预旋转控制

1. 使用 预旋转（Prerotation） 按钮（0°、90°、180°、270°）

2. 0°：默认朝向

3. 90°：顺时针旋转90度

4. 180°：绕Z轴旋转180度

5. 270°：逆时针旋转90度

拟合地形

1. 在样条线列表下，勾选 “拟合地形（Conform to Terrain）”

2. 组合样条线将投射到地形表面

3. 可选：设置样条线的法线继承自地形法线

样条线管理

启用/禁用样条线

1. 在工具窗口中找到样条线列表

2. 使用每条样条线的启用/禁用开关

3. 禁用的样条线：不会显示节点，但内容仍然可见

4. 启用的样条线：可以完全与节点交互并编辑

恢复系统

1. 多边形选择：使用工具中的多边形选择按钮，在网格周围绘制一个选择区域。

2. 场景树选择：在场景树中多选兼容的对象，然后右键选择“转换为组合样条线”。

3. 对象选择：使用对象选择工具，在场景树中右键选择“转换为组合样条线”。

4. 工具会自动添加一条新的样条线，并估算所有属性（包括预旋转、分布方式、间距等）。

配置文件管理

1. 保存配置文件：点击样条线列表下的**“保存配置文件”**按钮，将当前样条线的属性保存为JSON文件。

2. 加载配置文件：点击**“加载配置文件”**按钮，从磁盘加载之前保存的配置文件。

3. 配置文件内容：配置文件包含样条线的属性（间距、套件选择、桥件下垂、预旋转等），但不包含几何体本身。

4. 复制配置文件：使用CTRL+C可将选中样条线的配置文件复制到剪贴板。

5. 粘贴配置文件：使用CTRL+V可将复制的配置文件粘贴到其他样条线上，继承全部属性并保留目标样条线的几何信息。

导出到PNG遮罩

工具顶部按钮区提供了“导出为PNG遮罩”按钮。可将整个工具会话导出为灰度16位PNG遮罩，便于第三方软件导入导出使用。

后续操作建议

熟悉这些基础流程后，用户可以进一步探索：

• 高级套件管理与配置
• 定制套件的创建与验证
• 复杂的组装流程
• 与主样条工具的集成
• 进阶的地形塑形操作