如何在 Cympha Studio 中用笔刷工具清理网格

Cympha Studio 的三种清理笔刷只修复扫描上的一块区域，例如残留的附件凸起或伪影，牙科病例中网格的其余部分保持原样.

适用对象: 需要做定点局部清理的临床医生和技工所设计师 —— 比如去除残留的附件凸起、扫描仪伪影、龈缘过延伸,或某一块区域的散斑噪声 —— 而无需重建整张网格. 经典用例是脱位后扫描:附件已临床去除,但扫描中仍能看到凸起.

你将了解到: 如何从网格右键菜单启动笔刷会话;共享笔刷控制(尺寸、悬停预览、笔触)如何工作;三种笔刷模式(Smart cleanup…、Delete region…、Local smoothing…)各做什么、何时选用哪一种;以及典型的附件凸起去除工作流.

所需时间: 处理一个附件凸起两到五分钟. 整颌附件耗时更久 —— 每一个都是单独一笔.

开始之前

你需要:

已通过 Add model (+)、☰ Open optical scan file… 或拖放添加到场景中的网格. 支持格式:.stl、.ply、.obj.
未加载 GuideMia 病例 —— 笔刷清理命令仅在没有完整 .gvw 病例打开时才会出现在用户添加网格的右键菜单中. 如已打开,请用 ☰ → Clear scene.
**带鼠标和滚轮的桌面浏览器. ** 笔刷由 3D 画布上的左键拖拽笔触驱动,并用滚轮调整大小;没有滚轮的触控板也能用,但用真正的鼠标做基于滚轮的笔刷调节要快得多.
原文件备份. 笔触一旦完成就会立即应用. <kbd>Ctrl</kbd>+<kbd>Z</kbd> 可恢复上一版几何,但撤销只有一步 —— 如果失误发生在两次编辑之前,恢复方式是重新导入源网格.

笔刷 vs 整张表面. ** 整张表面命令如 Fix model、Fill holes 与 Smooth 无法区分尖刺是噪声还是解剖结构,所以它们对整张网格一视同仁. 当你能看到**缺陷确切位置且想保持其它表面不变时,笔刷就是为此而生.

何时该用哪种笔刷模式

用户添加网格的右键菜单中提供三种笔刷模式. 共享行为相同(笔刷一致、笔触模型一致、松开即应用的时机一致 —— 详见第 2 步). 差别在于对你涂抹到的三角形如何处理:

| 模式 | 每笔行为 | 删除后是否封孔? | 最适合 | |---|---|---|---| | Smart cleanup… | 自动:删除涂抹三角形或对其光顺 —— Studio 按每一笔根据涂抹区域中位于开放边界上的比例自动决定 | 是 —— 自动封闭由此产生的孔 | 你不想纠结删除还是光顺的混合缺陷 | | Delete region… | 始终删除所涂三角形并跑填洞 —— 每一笔都是切除并封闭,绝不光顺 | 是 | 你已确定这块材料必须去掉、想强制切除时 | | Local smoothing… | 始终只对涂抹区域做光顺 —— 从不删除三角形 | 不适用 | 松弛你不想去除的解剖结构上的噪声 |

日常使用选 Smart cleanup… —— 大多数缺陷要么明显是孔洞边缘(删除+填洞)要么明显是噪声斑(光顺),Smart cleanup 能正确分类而你无需选择.

当你已确定涂抹的材料必须去掉、不想要每笔自动分类时,选 Delete region… —— 每一笔都会删除你涂到的部分并封闭留下的开口.

当缺陷是噪声,且你想确保无论如何都不会有任何三角形被删除时,选 Local smoothing… —— 例如在不让牙冠边缘被刮的前提下光顺牙齿表面.

第 1 步 —— 启动笔刷会话

在主 3D 视图中右键单击网格.
在右键菜单中选择 Smart cleanup…、Delete region… 或 Local smoothing…,取决于你想做什么.
视图进入笔刷模式. 定位手柄与测距工具会被自动关闭,以确保点击交给笔刷而非这些工具.
当指针位于 3D 画布上时,会出现一个青色圆环环绕指针 —— 这就是笔刷的覆盖范围.
状态行显示就绪;对于 Smart cleanup,笔触间通常显示 "Ready".

**笔刷只对你启动时所在的网格生效. ** 如果场景中有两个牙弓,本次笔刷会话中只能编辑你右键的那一个. 要清理另一个牙弓,先退出(在 3D 视图上右键取消),然后从那个网格的右键菜单重新启动笔刷.

第 2 步 —— 掌握共享的笔刷控制

下列控制在三种模式中行为一致.

笔刷环跟随指针

青色圆环的覆盖大小是按屏幕像素计的,而非牙面上的毫米. 这意味着:

把相机拉近后,同样的笔刷在 mm 上覆盖更少的解剖结构.
拉远相机后,覆盖更多的解剖结构.

要做精细处理,涂抹前先把相机移近;要做大面积扫掠,拉远相机.

用鼠标滚轮调整笔刷大小

笔刷激活且指针位于 3D 画布(WebGL 区域,非侧边面板)上时:

滚动滚轮改变圆环大小 —— 一个方向放大、另一个方向缩小,每一格一个小步长.
如果你的鼠标或触控板使用反向滚动,先两个方向各试一次,确认哪个方向是放大笔刷.
半径限制在一个较小的最小值(用于精细)和一个较大的最大值(用于大面积扫掠)之间.
画布内的滚轮事件由笔刷捕获,因此当指针在视口内时,调节笔刷优先于场景缩放. 如果你想用滚轮缩放页面,把指针移到画布外.

涂抹一笔

在网格表面按住鼠标左键.
沿你想编辑的区域拖拽. 沿路径会盖印多个笔刷盘,因此即便光标跳跃也能留下连续的涂抹区域.
按住左键期间,淡青色色调显示本笔触中所有盘的并集 —— 这是即将编辑区域的预览.
松开左键. 仅在松开时,Studio 才会收集受影响的三角形,运行当前模式的清理逻辑,更新几何并持久化结果.

笔触之间你可以继续涂抹 —— 无需重新打开菜单 —— 直到退出笔刷模式.

退出笔刷模式

在主 3D 视图任意处右键单击. 笔刷取消,状态行显示 "Clean up cancelled." 这次点击时正常的网格右键菜单被抑制,以便笔刷干净退出 —— 之后想重新看到菜单,再次右键即可.

几何说明. ** 每一笔涂抹完成后,Studio 只保留被笔刷遮罩命中三角形中最大连通的那一组**. 这能避免对背面薄片或第二个壳上的意外拾取被同时编辑 —— 因此你即便涂穿一面薄壁,也只会处理前侧.

第 3 步 —— 各模式的具体行为

Smart cleanup…

每完成一笔,Studio 会检查你涂抹区域中有多少处于网格开放边界(与孔洞相邻的边)上:

如果涂抹区域大量落在开放边界上,该笔被视为删除:这些三角形被移除,然后跑填洞过滤器封闭开口.
否则该笔仅对涂抹区域光顺.

如果一笔未产生有用结果,你可能在状态行看到 "Smart cleanup: nothing to apply for this stroke …",并附上自动选择了哪条路径(删除还是光顺)的说明,以便你调整下一笔. 如果不喜欢自动选择,可再涂一笔,或改用 Delete region… / Local smoothing… 强制指定行为.

Delete region…

每一笔都会删除所涂三角形并跑填洞 —— 与 Smart cleanup 的删除路径相同,但无条件执行. 当你希望每一笔都是切除并封闭、绝不光顺时使用. 退出该工具时,如果有部分变得不连通,只保留最大的连通块.

Local smoothing…

每一笔仅对涂抹区域光顺(与 Smart cleanup 中光顺路径相同的处理). 无论你涂到什么,绝不删除三角形. 这是只想松弛噪声时最安全的模式 —— 没有任何途径会意外切入解剖结构.

典型的附件凸起去除工作流

这是设计师使用笔刷最常见的原因:脱位后扫描仍显示临床附件的凸起,你想去除它们,使模型读起来像一份干净的治疗后牙弓.

Add model 添加治疗后扫描.
如果扫描在其它地方还有小孔,可选先跑 Fix model —— 参见如何用 Fix model 修复网格. 如果唯一缺陷是附件凸起,跳过此步.
把相机拉近到第一个附件,让凸起在视图中占据合适比例.
右键网格 → Smart cleanup….
用滚轮把笔刷大小调整到刚好能一笔覆盖凸起,边缘略微进入健康釉质.
在凸起上按下并连续拖拽一笔;松开.
Smart cleanup 通常会把这一笔分类为"删除"(凸起是一个凸起区域,删除后边缘会让局部变为开放),并自动封闭由此产生的孔. 凸起应被光滑的釉质替换.
如果第一笔没把它全部清掉,再涂一次 —— 渐进的笔触比一大笔更安全.
移到下一颗牙的附件并重复.
当所有凸起都被清掉后,在 3D 视图上右键单击 退出笔刷模式.
可选:最后跑一次 Fix model 或 Smooth,对整张网格做最终抛光.

如果某一笔留下了可见的坑或锐边:

切换到 Local smoothing… 模式轻轻光顺该处.
或切换到 Delete region… 进一步修剪边缘.

如果某一笔删除了过多材料,停止涂抹. 继续删除会让损失加重. 立即按 <kbd>Ctrl</kbd>+<kbd>Z</kbd> 恢复该笔之前的几何 —— 撤销只有一步,所以要马上用 —— 或重新导入原文件,从头开始,这次用更小的笔刷.

成功的样子

你打算去除的缺陷已经消失;周围表面未被触及.
状态行在 "Ready" 与每笔的确认消息之间循环.
Models 中该网格条目仍在且可见.
笔触之间你可以旋转相机(在笔刷模式下,右键拖拽和中键拖拽仍可用;仅左键被捕获用于涂抹)以从其它角度检查,然后继续.

故障排查

**右键菜单不显示笔刷选项. ** 加载了 GuideMia 病例 —— 用 ☰ → Clear scene 清场;或你在病例几何而非用户添加网格上右键.

状态行显示 "Clean up: empty stroke — drag on the model with the brush." 你只是点击但没有拖得足够远到让笔刷盖印盘. 请按下并拖拽,不要只点击.

状态行显示 "Clean up: no mesh triangles under the painted mask — paint on the surface." 你的笔触没有落在网格上 —— 例如涂在背景或洞上. 要瞄准表面;青色色调预览会告诉你实际涂到了哪里.

**Smart cleanup 在我想要删除时选择了光顺(或反之). ** 自动规则看的是涂抹区域内的边界三角形. 要强制删除+填洞,使用 Delete region…;要强制只光顺,使用 Local smoothing…. 模式内没有手动覆盖选项.

**某一笔删除了我想保留的材料. ** 停止涂抹并立即按 <kbd>Ctrl</kbd>+<kbd>Z</kbd> —— 几何编辑保留恰好一步撤销,可恢复该笔之前的网格. 如果之后又涂过,则重新导入原网格,改用更小的笔刷重来.

**笔刷环跳到了背面并编辑了错误的一侧. ** "保留最大连通组"规则通常能防止这种情况,但在非常薄的壁上可能拾取背面. 先旋转视图让前面显然最近,再涂抹.

**滚轮缩放了场景而不是调节笔刷大小. ** 滚动时指针不在 3D 画布上. 把指针移入 WebGL 视口再滚动.

**笔刷模式激活时,在 3D 视图右键不能关闭菜单. ** 这是设计如此 —— 在笔刷模式中右键是取消笔刷而非打开菜单. 看到 "Clean up cancelled." 后再右键即可恢复正常的右键菜单.

**启动笔刷时,测距或定位手柄消失了. ** 两者在笔刷模式启动时都会被关闭,以确保点击交给笔刷. 退出笔刷模式(在 3D 视图上右键)后它们会回来.