在 Maya 2023 中使用 Python 3 编写一个**批量导入 `.ass` 文件并创建 `aiStandIn` 节点**的工具，是非常常见的需求，特别是在制作资产代理、场景管理或资产替换时。 下面是一个完整的工具脚本，包括： - GUI 界面（使用 `PySide2`） - 文件夹选择对话框 - 自动识别 `.ass` 文件 - 批量创建 `aiStandIn` 节点 - 支持自动命名、位置偏移防止重叠 --- ### ✅ 示例：批量导入 `.ass` 文件的工具 ```python import os import maya.cmds as cmds from PySide2 import QtWidgets, QtCore def create_ass_importer_gui(): """创建 GUI 界面""" window_name = "AssBatchImporterWindow" # 如果窗口已存在则删除 if cmds.window(window_name, exists=True): cmds.deleteUI(window_name) # 创建主窗口 main_window = cmds.window(window_name, title="批量导入 .ass 文件", widthHeight=(400, 200)) cmds.columnLayout(adjustableColumn=True) # 输入路径字段 path_label = cmds.text(label="选择 .ass 文件夹：") path_field = cmds.textField(editable=True, width=380) # 选择路径按钮 def select_folder(): dialog = QtWidgets.QFileDialog() folder = dialog.getExistingDirectory(None, "选择文件夹") if folder: cmds.textField(path_field, edit=True, text=folder) cmds.button(label="选择文件夹...", command=lambda x: select_folder(), width=380) # 导入按钮 def do_import(*args): folder_path = cmds.textField(path_field, query=True, text=True) import_ass_files_to_aiStandIn(folder_path) cmds.button(label="批量导入 .ass 文件", command=do_import, width=380, backgroundColor=[0.3, 0.6, 0.3]) # 显示窗口 cmds.showWindow(main_window) def import_ass_files_to_aiStandIn(import_dir): """ 从指定目录中导入所有 .ass 文件并创建 aiStandIn 节点 """ import_dir = os.path.normpath(import_dir.strip()) print(f"📁 正在导入路径: {import_dir}") if not os.path.exists(import_dir): cmds.warning(f"❌ 路径不存在: {import_dir}") return # 获取所有文件 try: all_items = os.listdir(import_dir) except Exception as e: cmds.warning(f"❌ 无法读取路径: {import_dir}, 错误: {str(e)}") return # 过滤出 .ass 文件 ass_files = [] for item in all_items: full_path = os.path.join(import_dir, item) if os.path.isfile(full_path) and item.lower().endswith(".ass"): ass_files.append(item) if not ass_files: cmds.warning(f"❌ 没有找到 .ass 文件: {import_dir}") return print(f"📁 共找到 {len(ass_files)} 个 .ass 文件") spacing = 2.0 # 每个代理之间的偏移量 for i, filename in enumerate(ass_files): base_name = os.path.splitext(filename)[0] full_path = os.path.join(import_dir, filename).replace("\\", "/") try: standin = cmds.createNode("aiStandIn", name=f"{base_name}_proxy") cmds.setAttr(f"{standin}.dso", full_path, type="string") # 设置位置偏移 x = (i % 5) * spacing z = (i // 5) * spacing cmds.move(x, 0, z, standin) print(f"✅ 已导入: {full_path} 为 {standin}") except Exception as e: print(f"❌ 导入失败: {filename}, 错误: {str(e)}") print("✅ 所有 .ass 文件导入完成") # 启动工具 create_ass_importer_gui() ``` --- ## 🧩 功能说明 | 功能 | 描述 | |------|------| | GUI 界面 | 使用 `PySide2` 创建图形界面，支持文件夹选择 | | 文件识别 | 自动识别 `.ass` 文件（不区分大小写） | | 批量导入 | 为每个 `.ass` 文件创建 `aiStandIn` 节点 | | 命名规则 | 使用文件名作为节点名，如 `geo_cube.ass` → `geo_cube_proxy` | | 位置偏移 | 每个代理节点在视图中偏移一定距离，避免重叠 | --- ## ✅ 使用方式 1. 将脚本保存为 `.py` 文件，例如 `ass_importer.py`。 2. 在 Maya 脚本编辑器中运行： ```python import ass_importer ass_importer.create_ass_importer_gui() ``` 3. 点击 "选择文件夹..." 按钮，选择包含 `.ass` 文件的目录。 4. 点击 "批量导入 .ass 文件" 按钮，开始导入。 --- ## 📌 注意事项 - 确保你使用的是 Maya 2023 的 Python 3 环境。 - 需要安装 `PySide2`，Maya 2023 默认自带。 - 确保 Arnold 插件已加载（菜单：**Window > Settings/Preferences > Plug-in Manager**，启用 `mtoa.mll`）。 ---