多对象导入配置检查表

多对象导入配置检查表

【免费下载链接】GoB Fork of original GoB script (I just added some fixes) 项目地址: https://gitcode.com/gh_mirrors/go/GoB

前置条件

•  ZBrush版本 ≥ 2021.6.2（支持多线程文件操作）
•  Blender版本 ≥ 3.0（支持Python 3.9+特性）
•  GoB插件版本 ≥ 2.3.1（包含本文修复）

文件系统配置

•  项目路径无空格和特殊字符（如C:\GoZProjects而非C:\My Projects）
•  路径长度 < 260字符（Windows限制）
•  文件夹权限设置为"完全控制"（右键属性>安全）

ZBrush配置

•  GoZ插件已禁用（避免冲突）
•  ZScript路径正确（ZPlugins\GoB\GoB_Import.zsc）
•  临时文件清理（Edit > Preferences > Files > Clean Temp）

Blender配置

•  导入方法设为"Automatic"
•  更新间隔设为1.0秒
•  启用"Debug Output"（问题诊断用）

## 高级工作流：实现无缝协作

### 3.1 批量导入脚本

创建Blender Python脚本`batch_import_goz.py`：

```python
import bpy
import os
from gob import utils, paths

def batch_import_all():
    """导入GoZ_ObjectList.txt中的所有对象"""
    goz_list_path = os.path.join(paths.PATH_GOZ, "GoZBrush", "GoZ_ObjectList.txt")
    
    if not os.path.exists(goz_list_path):
        print(f"错误: GoZ列表文件不存在 - {goz_list_path}")
        return
        
    with open(goz_list_path, 'r') as f:
        obj_names = [line.strip() for line in f if line.strip()]
        
    if not obj_names:
        print("错误: 对象列表为空")
        return
        
    # 创建集合存放导入的对象
    coll = bpy.data.collections.new("GoZ_Imported")
    bpy.context.scene.collection.children.link(coll)
    bpy.context.view_layer.active_layer_collection = bpy.context.view_layer.layer_collection.children[coll.name]
    
    # 逐个导入对象
    for obj_name in obj_names:
        goz_path = os.path.join(paths.PATH_GOZ, "GoZProjects", "Default", f"{obj_name}.GoZ")
        if not os.path.exists(goz_path):
            print(f"警告: 对象文件不存在 - {goz_path}")
            continue
            
        # 调用GoB导入函数
        try:
            bpy.ops.scene.gob_import(action='MANUAL')
            print(f"成功导入: {obj_name}")
        except Exception as e:
            print(f"导入失败: {obj_name}, 错误: {str(e)}")

if __name__ == "__main__":
    batch_import_all()

3.2 双向同步工作流

3.3 常见问题排查流程

当多对象导入失败时，按以下步骤排查：

flowchart TD
    A[多对象导入失败] --> B{检查GoZ_ObjectList.txt}
    B -->|文件不存在| C[权限问题或路径配置错误]
    B -->|文件存在| D{对象路径是否完整}
    
    D -->|路径不完整| E[修复ZScript路径解析]
    D -->|路径完整| F{检查单个对象导入}
    
    F -->|单个也失败| G[检查文件格式和版本兼容性]
    F -->|单个成功| H[检查对象数量是否超限]
    
    H -->|超限| I[增加maxSubtools值]
    H -->|未超限| J[检查资源竞争问题]
    
    J --> K[启用文件锁定机制]

【免费下载链接】GoB Fork of original GoB script (I just added some fixes) 项目地址: https://gitcode.com/gh_mirrors/go/GoB