模型/3D（施工中）¶

本目录按文档主题整理施工中的模型与 3D 节点；软件添加菜单中，这些节点直接位于 Shift+A → 施工中。这些页面只记录当前可见端口和预期方向，不承诺格式兼容、运行能力或跨版本稳定性。

模型读取与检索¶

• 读取模型：计划从文件路径读取模型，并提供模型对象、格式和基础统计信息。
• 导入模型：计划导入 GLB 模型，并拆分输出场景、Mesh、材质与贴图等可继续处理的数据。
• 查找Mesh：计划在 3D 场景中按查询条件查找 Mesh，并返回首个结果和结果集合。
• 查找材质：计划在 3D 场景中按查询条件查找材质，并返回首个结果和结果集合。
• 查找贴图：计划在 3D 场景中按查询条件查找贴图，并返回单个或多个候选结果。

材质图与批处理¶

• 创建材质图：计划从场景、材质或查询条件创建一份可编辑的材质图。
• 赋值材质槽：计划把动态数据源写入材质图的指定槽位。
• 指定Mesh材质：计划为场景中的指定 Mesh 关联材质，并输出更新后的场景。
• 读取PBR槽位：计划读取材质图中的 PBR 槽位，并以图像、图层、向量或数值形式返回内容。
• 设置PBR槽位：计划使用动态数据源、向量或数值设置材质图中的 PBR 槽位。
• 材质运算：计划对材质图槽位或输入数据执行材质运算，并输出运算结果。
• 烘焙材质图：计划按指定分辨率烘焙材质图，并输出图像或贴图结果。
• 系列资产批处理：计划根据批量描述和输出目录，对一组系列资产执行材质处理。

几何创建与优化¶

• 创建平面：计划在场景中创建具有指定尺寸、位置和名称的平面 Mesh。
• 创建立方体：计划在场景中创建具有指定尺寸、位置和名称的立方体 Mesh。
• 创建圆柱：计划在场景中创建具有指定半径、高度、分段和位置的圆柱 Mesh。
• 创建球：计划在场景中创建具有指定半径、分段、环数和位置的球体 Mesh。
• 精简Mesh：计划按比例、目标三角面数或误差条件精简 Mesh。
• 写回GLB：计划把场景与可选贴图写回 GLB 文件，并返回输出路径。

贴图处理¶

• 烘焙贴图：计划在低模、高模与材质之间烘焙指定类型的贴图。
• UV贴图边缘扩展：计划依据模型 UV 信息扩展贴图边缘，降低采样接缝风险。
• 贴图色差调整：计划调整贴图的亮度、对比度、饱和度、伽马、色温、色相与色彩空间模式。

合规检查与修复¶

• 检测3D合规：计划按合规规则检查 3D 场景，并生成结构化报告。
• 修复3D合规：计划依据合规规则修复 3D 场景，并返回修复后的场景与报告。
• 一键检测修复3D合规：计划串联检测、修复和复检，输出修复前后报告与结果场景。