Maya Python脚本：如何检测UV Shell坐标及UDIM边界交叉情况

完全可以通过Maya Python脚本实现这个需求，核心思路是获取每个UV Shell的UV坐标范围，判断其是否跨越UDIM的整数边界（U或V方向的整数坐标线）。以下是具体实现方案：

实现逻辑 #

• 遍历目标模型的所有UV Shell
• 对每个Shell，获取其包含的所有UV点的U/V坐标
• 计算该Shell的U/V坐标极值（最小/最大值）
• 判断U方向的最小值和最大值的整数部分是否不同，或V方向的最小值和最大值的整数部分是否不同——如果满足其中一项，说明该Shell跨UDIM边界

代码示例 #

import maya.cmds as cmds
import math

def check_uv_shell_cross_udim(mesh_name, uv_set="map1"):
    # 验证模型是否存在
    if not cmds.objExists(mesh_name):
        print(f"错误：模型 {mesh_name} 不存在")
        return
    
    # 获取所有UV Shell的ID
    shell_ids = cmds.polyUVShell(mesh_name, query=True, allShells=True, uvSet=uv_set)
    if not shell_ids:
        print("该模型未检测到UV Shell")
        return
    
    violating_shells = []
    
    for shell_id in shell_ids:
        # 获取当前Shell对应的所有UV点
        uv_list = cmds.polyUVShell(f"{mesh_name}.map[{shell_id}]", query=True, uvList=True, uvSet=uv_set)
        if not uv_list:
            continue
        
        # 获取UV点的U、V坐标
        u_coords = cmds.polyEditUV(uv_list, query=True, u=True, uvSet=uv_set)
        v_coords = cmds.polyEditUV(uv_list, query=True, v=True, uvSet=uv_set)
        
        # 计算坐标极值
        u_min, u_max = min(u_coords), max(u_coords)
        v_min, v_max = min(v_coords), max(v_coords)
        
        # 判断是否跨UDIM边界
        u_cross = math.floor(u_min) != math.floor(u_max)
        v_cross = math.floor(v_min) != math.floor(v_max)
        
        if u_cross or v_cross:
            violating_shells.append(shell_id)
            print(f"UV Shell {shell_id} 存在跨UDIM边界情况：")
            if u_cross:
                tile_u1 = 1001 + math.floor(u_min)
                tile_u2 = 1001 + math.floor(u_max)
                print(f"  U方向范围：{u_min:.4f} 到 {u_max:.4f}，跨越UDIM {tile_u1} 和 {tile_u2}")
            if v_cross:
                # UDIM的V方向向下递增，所以用-floor(v)计算tile编号
                tile_v1 = 1001 + math.floor(-v_max)
                tile_v2 = 1001 + math.floor(-v_min)
                print(f"  V方向范围：{v_min:.4f} 到 {v_max:.4f}，跨越UDIM {tile_v1} 和 {tile_v2}")
    
    if violating_shells:
        print(f"\n总计 {len(violating_shells)} 个UV Shell跨UDIM边界")
    else:
        print("所有UV Shell均未跨UDIM边界，合规")

# 使用示例：替换为你的模型名称
check_uv_shell_cross_udim("pCube1")

关键说明 #

• 支持指定UV集：默认使用map1，如果模型有自定义UV集，可以修改uv_set参数
• UDIM编号计算：UDIM的规则是1001 + 整数U坐标 + 10 * 整数V坐标（向下为正），所以V方向需要用math.floor(-v)来转换
• 仅检测边界跨越：如果一个Shell的UV被拆分到多个UDIM但每部分都完全在各自UDIM内（无边界跨越），会被判定为合规，符合你的需求

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