3AS · 3D Annotation System

从服务器打开项目

已保存到服务器

诊断日志

设置 · 附加信息

测量基点 · 说明

测量基点决定「模型上的哪一点算原点、朝向哪个方向」，节点的「相对基点坐标」都是从它算出来的。

基点是怎么来的（按优先级，GLB 原生约定）：

① 模型里如果有一个叫 Origin（或 _origin/origin，大小写不敏感）的节点，模型第一次加载会自动拿它的世界坐标+朝向当默认基点。

② 没有这种命名节点时，退一步用模型整体包围盒的中心当基点，朝向默认 0°。

③ 以上都不满足、或想要另一个基点（比如多层建筑每层各一个），可以在下面手动新增或编辑。

「朝向°」是绕本场景竖直轴（Y 轴）的方位角，不是完整三轴旋转。

哪个基点是「默认」：没有显式关联具体基点的节点，相对测量数值按「默认基点」计算。默认基点本来按上面①②优先级自动选，但你可以在任意一行的下拉菜单里选「设为默认基点」手动指定——手动指定之后就不再跟着自动规则走，直到你把它改回「非默认基点」为止（哪怕模型里确实有 Origin 节点，手动指定的也会盖过它，你有最终决定权）。下拉当前显示的文字会告诉你这一行是靠哪条规则生效成默认的。这几类操作（新增/编辑/删除/设为默认）都会记进撤销栈和操作脚本，导出的注释 JSON 里每个基点也会带一个 resolvedReason 字段说明它当时是不是默认、为什么。

材质编辑 · 说明

材质用 PBR 金属度/粗糙度 工作流（glTF 标准）：漫反射决定基础颜色，金属度/粗糙度决定表面质感，自发光让材质自己发光（不受灯光影响）。

上方详情区编辑当前选中的材质，改了立即在视口生效，「另存为 GLB」时一并写回。

下方画廊点击色块可以切换正在编辑的材质；把色块卡片拖到视口的网格上，能把这个材质重新指派给那个网格。

画廊右上角「◎ 取色」反过来用——点它再点视口里的网格，自动定位到那个网格当前用的材质。「🧹 清理」批量处理 fallback 占位名/纯黑材质/节点缩放归一化，详见 Doc/EDITOR-SPEC.md §5。

贴图 · 说明

这里列出 GLB 文件里全部内嵌贴图（raw.images[]），支持格式：PNG/JPEG（标准）· WebP（EXT_texture_webp）· KTX2（KHR_texture_basisu）。

上方详情区显示当前选中贴图的大图预览、格式/尺寸/体积，以及被哪些材质的哪些槽位引用——「替换」「删除」两个操作都基于这份引用关系。

下方列表点一行即可选中并在上方展开详情；点缩略图直接打开大图预览。

替换复用材质编辑器的贴图上传逻辑，替换的是第一处引用它的材质槽位；删除会弹二次确认，列出全部受影响材质，确认后清空这些材质槽位的引用（贴图数据本身不会被物理删除，符合项目一贯不做索引位移垃圾回收的既有做法）；改名只改 raw.images[i].name 这个显示用的名字。

列表上方「⇓ 批量导出全部贴图」把当前模型 raw.images[] 全部贴图逐个下载到本地——用原始文件名，重名自动加 (1)/(2) 序号后缀防覆盖；浏览器可能会对连续多次下载弹出确认提示，这是浏览器自身的安全机制，允许一次即可。

模型块 · 说明

节点树跟 glTF 原生层级一致，只包一个子节点的分组会自动合并显示成一行（合并规则/注释挂载点见 Doc/EDITOR-SPEC.md §6.2），glTF 数据本身没有变，纯粹是显示层折叠。

点一行在上方展开详情——顶点/三角、通道、属于、材质、世界空间 T/R/S（可直接编辑）、相对基点坐标都在这里；样例复制/包围盒两个操作入口也在详情区，导出已经挪到视口右侧工具条（选中节点后可用）。

拖动一行的名称到另一行上，可以把它重新挂靠成那一行的子节点（保持世界空间位置不变，见 Doc/TODO.md #29）。

「关联基点」下拉选这个节点相对哪个基点计算测量数值，留空＝用场景第一个基点兜底；橙色标记的基点新增/编辑在「场景」Tab（见 Doc/EDITOR-SPEC.md §8）。

删除贴图 · 二次确认

材质清理

a. Fallback 材质自动重命名

把「fallback Material」「material_N」这类占位名，按引用它的节点名批量改成能看懂的名字（已有正常名字的材质不动）

黑色材质替色（b / c 二选一）

不处理黑色材质 b. 随机浅色（RGB 各通道独立在 200-254 随机取值） c. 指定统一色

只对 baseColor 接近纯黑（RGB 三通道均 < 0.05）的材质生效

d. 缩放归一化

把节点缩放烘焙进网格顶点数据，节点 scale 写回 (1,1,1)，世界空间外观不变

包围盒

默认按节点世界空间旋转角生成定向包围盒（OBB，不是简单轴对齐盒子）；下面旋转角可手动改，改完自动按新角度重新计算尺寸/中心并重画线框（青色虚线，区别于节点选中的黄色实线框）。

X° Y° Z°

尺寸

—

中心

—

中心点

① 关联到一个已有基点；② 或者以当前节点的世界坐标新建一个基点（新建后自动关联当前节点）。下面显示这个基点当前的位置，改了直接保存，视口橙色标记同步刷新。

关联基点

当前基点位置

X Y Z 朝向°

对齐到已加载模型

已加载模型

该模型的基点

新模型自己的基点

重放操作脚本

预览滚轮缩放

就绪