# 工具参考

## 画笔

**快捷键：**<kbd>P</kbd>

在 3D 模型表面或 2D 画布上绘制像素。编辑器**最核心**的工具。

- **3D 模式：** 点击 / 拖拽模型表面 → 射线检测 → UV 坐标 → 绘制
- **2D 模式：** 点击 / 拖拽像素网格
- 拖拽采用 **Bresenham 插值**，保证线条连续平滑
- 笔刷范围：**1 – 10 像素**（右侧面板调节）

## 橡皮擦

**快捷键：**<kbd>E</kbd>

擦除像素（Alpha → 0）。与画笔行为一致，只是"画"的是透明。

- 支持 3D 和 2D 模式
- 笔刷大小与画笔**共享同一设置**

## 油漆桶

**快捷键：**<kbd>G</kbd>

一键填充连续的同色区域。

**容差说明：**

<table class="align-left" id="bkmrk-%E5%AE%B9%E5%B7%AE-%E6%95%88%E6%9E%9C-0-%E2%80%93-32-%E4%B8%A5%E6%A0%BC%E5%8C%B9%E9%85%8D%EF%BC%8C%E4%BB%85%E5%A1%AB"><thead><tr><th>容差</th><th>效果</th></tr></thead><tbody><tr><td>`0 – 32`</td><td>严格匹配，仅填充精确相同的颜色</td></tr><tr><td>`64 – 128`</td><td>中等宽松，相近颜色也会被填充</td></tr><tr><td>`192 – 255`</td><td>非常宽松，大范围颜色都会被填充</td></tr></tbody></table>

## 吸管

**快捷键：**<kbd>I</kbd>

从任意位置拾取颜色，自动设为当前前景色。

- 3D 模型表面
- 2D 像素网格
- 参考图悬浮窗

> ⚠️ 无法吸取完全透明的像素，会弹出提示。

## 抓手

**快捷键：**<kbd>H</kbd>

平移视角。**默认工具**，启动时自动选中。

- **3D 视图：** 拖拽旋转模型，滚轮缩放
- **2D 面板：** 拖拽平移画布
- 不影响任何像素数据

## 噪点

**快捷键：**<kbd>N</kbd>

在笔刷区域内随机绘制彩色噪点，营造纹理质感。

- 强度范围：**0% – 100%**
- 适用场景：迷彩、星空、颗粒、粗糙表面

## 工具选项

<table class="align-left" id="bkmrk-%E9%80%89%E9%A1%B9-%E8%8C%83%E5%9B%B4-%E4%BD%9C%E7%94%A8%E4%BA%8E-%E7%AC%94%E5%88%B7%E5%A4%A7%E5%B0%8F-1-%E2%80%93-1"><thead><tr><th>选项</th><th>范围</th><th>作用于</th></tr></thead><tbody><tr><td>笔刷大小</td><td>1 – 10</td><td>画笔 · 橡皮擦 · 噪点</td></tr><tr><td>容差</td><td>0 – 255</td><td>油漆桶</td></tr><tr><td>噪点强度</td><td>0% – 100%</td><td>噪点工具</td></tr></tbody></table>

## 3D 视图操作

<table class="align-left" id="bkmrk-%E6%93%8D%E4%BD%9C-%E6%96%B9%E5%BC%8F-%F0%9F%94%83-%E6%97%8B%E8%BD%AC%E6%A8%A1%E5%9E%8B-%E6%8A%93%E6%89%8B%E6%A8%A1%E5%BC%8F%E4%B8%8B%E9%BC%A0%E6%A0%87"><thead><tr><th>操作</th><th>方式</th></tr></thead><tbody><tr><td>🔃 旋转模型</td><td>抓手模式下鼠标左键拖拽</td></tr><tr><td>🔍 缩放</td><td>鼠标滚轮</td></tr><tr><td>↔️ 平移视角</td><td>中键拖拽 或 <kbd>Shift</kbd> + 拖拽</td></tr></tbody></table>