ud18010andClaude Opus 4.8
0481f10b8c
根因(真机排查):QuadRemesher 引擎在激进减面下非确定性地从封闭流形 输入打出孔洞/非流形边(实测同一输入约 85% 次数破碎),即"破碎面"。 修复:QR 导回后比对输入拓扑,若比输入新增开边(孔洞)/非流形边即判破损、 弃用 QR 回退 collapse(topology_acceptable 纯策略+单测;_edge_defects 计数)。 顺带修复水密门在导入后拒绝时未恢复 obj 选中态,导致 collapse 回退时 export use_selection 选不到对象、只导出 4KB 空 FBX 的 bug。 含用户改动:--reducer 默认改为 quad(配合水密门,破碎自动回退,安全), 及其 CLI 默认值测试。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
64 lines
3.1 KiB
Python
64 lines
3.1 KiB
Python
"""FBX 减面 CLI：减到指定三角面数并重展 UV（seam 展开 + UVPM4 排布），输出 <名>_low.fbx。
|
||
用法：python model_decimate.py src/well1500.fbx --tris 5000 [-o dir]
|
||
[--unwrap seam|smart] [--reducer collapse|quad] [--max-overlap 0.15] [--blender exe]"""
|
||
import argparse
|
||
import os
|
||
|
||
from mt_run import find_blender, run_blender_script
|
||
|
||
|
||
def main():
|
||
ap = argparse.ArgumentParser(description=__doc__)
|
||
ap.add_argument("input", help="FBX 文件")
|
||
ap.add_argument("--tris", type=int, required=True, help="目标三角面数")
|
||
ap.add_argument("-o", "--out", default=None, help="输出目录（默认源文件同目录）")
|
||
ap.add_argument("--unwrap", choices=("seam", "smart"), default="seam",
|
||
help="UV 展开：seam=锐边接缝整岛展开（默认），smart=Smart UV Project")
|
||
ap.add_argument("--reducer", choices=("collapse", "quad"), default="quad",
|
||
help="减面后端：quad=Quad Remesher 四边重拓扑（默认，失败自动回退 collapse），collapse=Decimate 塌陷")
|
||
ap.add_argument("--max-overlap", type=float, default=None,
|
||
help="UV 重叠容忍上限（0-1，默认内置 0.08）；调高可让更高 seam 角度过门、减少碎岛")
|
||
ap.add_argument("--blender", default=None)
|
||
args = ap.parse_args()
|
||
if args.tris <= 0:
|
||
ap.error("--tris 必须为正整数")
|
||
if args.max_overlap is not None and not (0.0 < args.max_overlap <= 1.0):
|
||
ap.error("--max-overlap 必须在 (0, 1] 内")
|
||
|
||
blender = find_blender(args.blender)
|
||
name = os.path.splitext(os.path.basename(args.input))[0]
|
||
outdir = args.out or os.path.dirname(os.path.abspath(args.input))
|
||
out_fbx = os.path.join(outdir, name + "_low.fbx")
|
||
|
||
s = run_blender_script(blender, "bl_decimate.py",
|
||
[args.input, out_fbx, str(args.tris), args.unwrap,
|
||
"" if args.max_overlap is None else str(args.max_overlap),
|
||
args.reducer])
|
||
|
||
print("== %s: %d -> %d 面（目标 %d）-> %s" %
|
||
(s["src"], s["tris_before"], s["tris_after"], s["target"], out_fbx))
|
||
print(" 后端: %s" % s.get("reducer", "collapse"))
|
||
u = s["uv"]
|
||
overlap = "%.1f%%" % (u["overlap"] * 100) if u["overlap"] is not None else "n/a"
|
||
print(" UV: 模式=%s 岛数=%d 利用率=%.1f%% 翻转=%.1f%% 重叠=%s" %
|
||
(u["mode"], u["islands"], u["fill"] * 100, u["flipped"] * 100, overlap))
|
||
if s.get("uv_polys"):
|
||
try:
|
||
import json as _json
|
||
from uv_preview import render_uv_png
|
||
with open(s["uv_polys"], encoding="utf-8") as fp:
|
||
polys = _json.load(fp)
|
||
render_uv_png(polys, s["uv_preview"])
|
||
print(" UV 观察图: %s" % s["uv_preview"])
|
||
except Exception as e:
|
||
print(" [警告] UV 观察图渲染失败：%s" % e)
|
||
finally: # sidecar 是内部临时文件，无论渲染成败都清掉
|
||
if os.path.exists(s["uv_polys"]):
|
||
os.remove(s["uv_polys"])
|
||
for w in s["warnings"]:
|
||
print(" [警告] %s" % w)
|
||
|
||
|
||
if __name__ == "__main__":
|
||
main()
|