Files
Black-Cyan 60cce66993
Tests / test (push) Has been cancelled
初始化 VRMify 增强版(VRMify Enhanced)
导入上游源码,为所有面向用户的品牌显示处添加「增强版 / Enhanced」标识;包含 unitypackage→VRM 的纯色 Toon 材质、兽耳 SpringBone、Unity 描边、UV 接缝白边补偿修复,以及默认不强制 T-pose。146 个单元测试通过。
2026-11-15 23:21:59 +08:00

271 lines
11 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# -*- coding: utf-8 -*-
"""Unity 工程 / 解开的 unitypackage 里的材质 → 底色贴图。
Unity 导出的 FBX 常常不带贴图文件名(Texture 节点的 FileName 是空的),贴图是在 Unity 的
材质(.mat,YAML 文本)里按 GUID 指定的:
m_Name: mat_Body
m_TexEnvs: _MainTex / _Main_Texture / _BaseMap … → m_Texture: {fileID: 2800000, guid: 1db2…}
而 GUID 写在贴图旁边的 .meta 里(`guid: 1db2…`)。这里把两边对起来:材质名 → 贴图路径。
FBX 里的材质名和 .mat 的 m_Name 一致(Unity 导入 FBX 时按材质名找 / 建 .mat)。
新旧两种 .mat 序列化格式都认:
* Unity 5+: m_TexEnvs:\\n - _MainTex:\\n m_Texture: {…}
* Unity 4.x: m_TexEnvs:\\n data:\\n first:\\n name: _MainTex\\n second:\\n m_Texture: {…}
二进制序列化的 .mat 读不了,跳过。
"""
import os
import re
IMAGE_EXT = (".png", ".tga", ".jpg", ".jpeg", ".bmp", ".dds", ".psd", ".tif", ".tiff")
# 当底色用的槽位,按优先级
MAIN_SLOTS = ("_maintex", "_main_texture", "_basemap", "_basecolormap", "_basetexture", "_albedo",
"_albedomap", "_diffuse", "_diffusemap", "_colortex", "_tex")
# 当主色用的槽位,按优先级(_ShadeColor / _OutlineColor 这些不能当底色)
COLOR_SLOTS = ("_color", "_basecolor", "_maincolor", "_tintcolor", "_diffusecolor",
"_maintexcolor", "_color0", "_basecolour", "_maincolour", "_colour")
NOT_MAIN = ("normal", "bump", "spec", "metal", "rough", "occlusion", "emission", "emissive", "mask",
"matcap", "sphere", "ramp", "shade", "outline", "rim", "detail", "parallax", "height", "noise")
_GUID = re.compile(r"guid:\s*([0-9a-fA-F]{32})")
_NAME = re.compile(r"^\s*m_Name:\s*(.*?)\s*$", re.M)
_COLOR = re.compile(r"\{\s*r:\s*([-+0-9.eE]+)\s*,\s*g:\s*([-+0-9.eE]+)\s*,"
r"\s*b:\s*([-+0-9.eE]+)\s*,\s*a:\s*([-+0-9.eE]+)\s*\}")
# Toon shader 的描边在 shader 的 Outline pass 里,参数只写在 .mat(FBX 没有对应信息)
OUTLINE_WIDTH_SLOTS = ("_outline_width", "_outlinewidth", "_outline_size", "_outlinesize")
OUTLINE_COLOR_SLOTS = ("_outline_color", "_outlinecolor")
def find_root(start, max_up=8):
"""Unity 资源的根:往上找 Assets 文件夹;没有(解开的 unitypackage 去掉了 Assets/)时,
只要上一层还像 Unity 资源文件夹(有 .meta 文件)就继续往上,最后至少往上两层。"""
d = os.path.abspath(start)
for _ in range(max_up):
if os.path.basename(d).lower() == "assets":
return d
parent = os.path.dirname(d)
if parent == d:
break
d = parent
d = os.path.abspath(start)
for k in range(max_up):
parent = os.path.dirname(d)
if parent == d:
break
try:
unityish = any(n.lower().endswith(".meta") for n in os.listdir(parent))
except OSError:
unityish = False
if not unityish and k >= 2:
break
d = parent
return d
def _walk(root, limit):
n = 0
for d, dirs, files in os.walk(root):
dirs[:] = [x for x in dirs if x.lower() not in ("library", "temp", "obj", ".git", "node_modules")]
for f in files:
n += 1
if n > limit:
return
yield d, f
def _slots(text):
"""→ [(槽位名, guid)],按文件里的顺序。"""
out = []
i = text.find("m_TexEnvs:")
if i < 0:
return out
end = len(text)
for key in ("m_Floats:", "m_Ints:", "m_Colors:"):
j = text.find(key, i)
if j > 0:
end = min(end, j)
block = text[i:end]
# Unity 5+: - _MainTex: Unity 4: name: _MainTex
marks = [(m.start(), m.group(1)) for m in re.finditer(r"^\s*-\s*([A-Za-z_][\w]*):\s*$", block, re.M)]
marks += [(m.start(), m.group(1)) for m in re.finditer(r"^\s*name:\s*([A-Za-z_][\w]*)\s*$", block, re.M)]
marks.sort()
for k, (pos, name) in enumerate(marks):
seg = block[pos:marks[k + 1][0] if k + 1 < len(marks) else len(block)]
m = re.search(r"m_Texture:\s*\{[^}]*\}", seg)
if not m:
continue
g = _GUID.search(m.group(0)) # 空槽位是 {fileID: 0},没有 guid
if g:
out.append((name, g.group(1).lower()))
return out
def _main_guid(slots):
if not slots:
return None
by = {n.lower(): g for n, g in slots}
for s in MAIN_SLOTS:
if s in by:
return by[s]
for n, g in slots:
if not any(k in n.lower() for k in NOT_MAIN):
return g
return None
def _colors(text):
"""→ {颜色槽位名(小写): [r, g, b, a]}。
Unity 5+ 写 `- _Color: {r: 0, g: 0, b: 0, a: 1}`,Unity 4.x 写
`name: _Color` 再在 second 段里给 `{r: …, a: …}`(字段名可能是 val / m_Color);
m_Colors 也可能套在 m_SavedProperties 里。两种都按块扫描。
"""
i = text.find("m_Colors:")
if i < 0:
return {}
end = len(text)
for key in ("m_TexEnvs:", "m_Floats:", "m_Ints:", "m_SavedProperties:", "---"):
j = text.find(key, i + len("m_Colors:"))
if j > 0:
end = min(end, j)
block = text[i:end]
out = {}
for m in re.finditer(r"^\s*-\s*([A-Za-z_][\w]*):\s*(\{[^}]*\})", block, re.M):
v = _COLOR.search(m.group(2))
if v:
out[m.group(1).lower()] = [float(x) for x in v.groups()]
marks = [(m.start(), m.group(1)) for m in
re.finditer(r"^\s*name:\s*([A-Za-z_][\w]*)\s*$", block, re.M)]
for k, (pos, name) in enumerate(marks):
seg = block[pos:marks[k + 1][0] if k + 1 < len(marks) else len(block)]
v = _COLOR.search(seg)
if v:
out[name.lower()] = [float(x) for x in v.groups()]
return out
def _main_color(colors):
"""→ 底色 [r, g, b, a];只认主色槽位,阴影色 / 描边色不算。"""
if not colors:
return None
for s in COLOR_SLOTS:
if s in colors:
return colors[s]
for n, c in colors.items():
if not any(k in n for k in NOT_MAIN):
return c
return None
def _floats(text):
"""→ {属性名(小写): float},m_Floats 段里的 `- _Key: 1.0`。"""
i = text.find("m_Floats:")
if i < 0:
return {}
end = len(text)
for key in ("m_Colors:", "m_TexEnvs:", "m_Ints:", "m_BuildTextureStacks:", "---"):
j = text.find(key, i + len("m_Floats:"))
if j > 0:
end = min(end, j)
out = {}
for m in re.finditer(r"^\s*-\s*([A-Za-z_][\w]*):\s*([-+0-9.eE]+)\s*$", text[i:end], re.M):
try:
out[m.group(1).lower()] = float(m.group(2))
except ValueError:
pass
return out
def _outline(text):
"""→ {"width", "color": [r,g,b], "mode"} 或 None。
UCTS / Toon_DoubleShadeWithFeather 这类 shader 的描边是一个额外的 Outline pass:
`m_ShaderKeywords` 里有 `_OUTLINE_NML` / `_OUTLINE_POS`,宽度在 `m_Floats._Outline_Width`、
颜色在 `m_Colors._Outline_Color`。FBX 里完全没有对应信息,必须在这里读出来。
注意 `_OUTLINE` 只是 NML/POS 模式枚举(0 = NML),不是开关;宽度 > 0 才算开了描边。
"""
fl = _floats(text)
width = next((fl[k] for k in OUTLINE_WIDTH_SLOTS if fl.get(k, 0) > 0), 0.0)
if width <= 0:
return None
col = _colors(text)
rgb = next((col[k][:3] for k in OUTLINE_COLOR_SLOTS if k in col), [0.0, 0.0, 0.0])
return {"width": width, "color": [float(x) for x in rgb],
"mode": "POS" if "_OUTLINE_POS" in text else "NML"}
def material_properties(start, limit=50000):
"""→ {材质名: {"tex": 底色贴图绝对路径或 None, "color": [r,g,b,a] 或 None}}。
start 是 FBX 所在文件夹。没有贴图、只有 m_Colors 的材质(Toon shader 的纯黑 /
纯白)也在这里返回,颜色交给 fbx2pmx 烘焙成一张纯色贴图;找不到 Unity 资源返回 {}。
"""
root = find_root(start)
guid_path = {}
mats = []
for d, f in _walk(root, limit):
low = f.lower()
if low.endswith(".meta"):
asset = f[:-5]
if asset.lower().endswith(IMAGE_EXT):
try:
with open(os.path.join(d, f), encoding="utf-8", errors="replace") as fh:
m = _GUID.search(fh.read(2000))
except OSError:
continue
if m and os.path.isfile(os.path.join(d, asset)):
guid_path[m.group(1).lower()] = os.path.join(d, asset)
elif low.endswith(".mat"):
mats.append(os.path.join(d, f))
# 注意不能因为「一张图片 .meta 都没有」就提前返回:纯色材质的 .mat 里本来就没有
# 贴图 GUID,以前的 `not mats or not guid_path` 会把它们全部丢掉。
if not mats:
return {}
# 同名材质可能有好几份(每套衣服一个文件夹,各有一个 mat_Hair)。按 Unity 导入 FBX 时的
# 查找顺序(Recursive-Up)挑:FBX 所在文件夹及其 Materials/,再往上一层……直到 Assets;
# 都不在这条链上的(别的角色 / 别的衣服的材质)排最后
chain = []
d = os.path.normcase(os.path.abspath(start))
while True:
chain.append(d)
if os.path.basename(d).lower() == "assets" or os.path.dirname(d) == d:
break
d = os.path.dirname(d)
def rank(mat_path):
md = os.path.normcase(os.path.dirname(os.path.abspath(mat_path)))
for k, a in enumerate(chain):
if md.lower() == a.lower() or md.lower() == os.path.join(a, "materials").lower():
return k
return 1000
best = {}
for p in mats:
try:
with open(p, "rb") as fh:
raw = fh.read(200000)
except OSError:
continue
if not raw.startswith(b"%YAML"):
continue # 二进制序列化的材质
text = raw.decode("utf-8", "replace")
nm = _NAME.search(text)
name = nm.group(1).strip().strip('"') if nm else os.path.splitext(os.path.basename(p))[0]
tex = guid_path.get(_main_guid(_slots(text)) or "")
color = _main_color(_colors(text))
outline = _outline(text)
if tex is None and color is None and outline is None:
continue
r = rank(p)
prop = {"tex": tex, "color": color, "outline": outline}
for key in {name, os.path.splitext(os.path.basename(p))[0]}:
if key not in best or r < best[key][0]:
best[key] = (r, prop)
return {k: v[1] for k, v in best.items()}
def material_textures(start, limit=50000):
"""→ {材质名: 底色贴图的绝对路径}。兼容旧调用,只返回有贴图的材质。"""
return {k: v["tex"] for k, v in material_properties(start, limit).items() if v["tex"]}