Maya中给选中网格批量应用UDIM模式PNG纹理及代码报错排查

报错原因 #

原代码核心错误是创建file纹理节点时传入了错误的类型参数：cmds.shadingNode('file9', asTexture=True) 里的'file9'是节点名称而非节点类型，正确的节点类型是'file'。Maya无法识别file9类型，因此创建了无效的unknown节点，导致后续设置属性失败。

完整解决方案代码 #

import maya.cmds as cmds

def assign_udim_texture(texture_dir, texture_prefix="", material_type="lambert"):
    # 获取选中对象，确保后续操作有目标
    selected = cmds.ls(sl=True, long=True)
    if not selected:
        cmds.error("请先选中需要赋予纹理的网格对象")
    
    # 处理选中对象，转换为shape节点（材质需赋予shape节点）
    shape_nodes = []
    for obj in selected:
        if cmds.objectType(obj) == "transform":
            shapes = cmds.listRelatives(obj, shapes=True, fullPath=True) or []
            shape_nodes.extend(shapes)
        else:
            shape_nodes.append(obj)
    # 去重避免重复操作
    shape_nodes = list(set(shape_nodes))

    # 创建材质与对应的材质组
    material_name = cmds.shadingNode(material_type, asShader=True)
    shading_group = cmds.sets(renderable=True, noSurfaceShader=True, empty=True, name=f"{material_name}SG")
    cmds.connectAttr(f"{material_name}.outColor", f"{shading_group}.surfaceShader", force=True)

    # 创建file纹理节点并配置UDIM参数
    file_node = cmds.shadingNode('file', asTexture=True, name="UDIM_File_Texture")
    cmds.setAttr(f"{file_node}.uvTilingMode", 3)  # 3对应Maya的UDIM模式
    cmds.setAttr(f"{file_node}.useFrameExtension", True)
    # 拼接带UDIM占位符的纹理路径（需匹配你的纹理命名规则）
    texture_path = f"{texture_dir}/{texture_prefix}<UDIM>.png"
    cmds.setAttr(f"{file_node}.fileTextureName", texture_path, type='string')

    # 连接纹理到材质
    cmds.connectAttr(f"{file_node}.outColor", f"{material_name}.color", force=True)

    # 批量将材质赋予所有目标shape节点
    for shape in shape_nodes:
        cmds.sets(shape, forceElement=shading_group)

# 调用示例
if __name__ == "__main__":
    # 替换为你的纹理目录路径
    texture_directory = r"Q:/public/kartikey/textureSwatcherTest/selected_tex/"
    # 替换为纹理文件名前缀（比如纹理是tex_1001.png，前缀填"tex_"；若直接是1001.png则留空）
    assign_udim_texture(texture_directory)

关键细节说明 #

• UDIM配置：
  • uvTilingMode=3是Maya中启用UDIM模式的固定枚举值。
  • 开启useFrameExtension才能让Maya识别路径中的<UDIM>占位符，自动匹配对应编号的纹理文件。
• 材质组：Maya中材质必须通过材质组（shading group）才能赋予对象，原代码缺少这一步会导致材质无法正确生效。
• 批量处理：自动将选中的转换节点（transform）转为shape节点，确保材质赋予到正确的渲染节点，同时去重避免重复操作。

使用注意事项 #

1. 纹理文件命名必须符合UDIM规范：比如1001.png、tex_1002.png，编号为4位数字且从1001开始。
2. 路径使用正斜杠/或原始字符串r""避免转义问题。
3. 若需使用其他材质（如standardSurface、blinn），修改material_type参数即可。

内容的提问来源于stack exchange，提问作者Kartikey Sinha