最可靠方式是用C++调用xNormal或Marmoset的CLI批量烘焙；需注意路径格式、UTF-8无BOM配置、UV完整性、DX/OpenGL法线翻转、双面AO开关及静默错误排查。
用 xNormal 或 Marmoset Toolbag 批量烘焙法线/环境光遮蔽贴图最可靠
直接在 C++ 里从头实现法线贴图或 AO 贴图的烘焙不现实——这不是算法调用问题，而是需要完整的几何采样、光线投射、UV 展开、抗锯齿重采样和 GPU 加速光栅化管线。工业级流程全部依赖成熟工具的命令行接口，C++ 最多做胶水层调度。
真正能落地的方式是：用 C++ 调用 xNormal 或 Marmoset Toolbag 的 CLI 模式，传入高模/低模路径、UV 通道、采样参数，触发烘焙并等待输出。xNormal 免费且支持完整命令行（xnormalcmd.exe），Marmoset 提供 toolbag.exe -batch 模式，二者都支持 JSON 或 XML 配置文件驱动。
- 高模必须带清晰拓扑与合理面数（>50 万面易超内存，建议分部件烘焙）
- 低模 UV 必须无重叠、有足够像素间距（xNormal 默认要求 2px padding）
- 法线烘焙需指定「源网格」（高模）和「目标网格」（低模），AO 烘焙通常只用低模自身投射
- AO 的 ray count 建议设为 512–2048；法线 baking 中
rayDistance要略大于模型局部厚度，否则出现黑边
用 C++ 调用 xNormal CLI 的关键参数和错误规避
常见失败不是代码写错，而是路径、权限或配置格式出问题。xNormal 对空格、中文路径、反斜杠极其敏感，且不报明确错误，只静默退出。
- 必须用正斜杠
/或双反斜杠\，单反斜杠会被解析为转义符 - 所有路径用绝对路径，且确保
xnormalcmd.exe所在目录已加入系统 PATH 或用完整路径调用 - 配置文件必须是 UTF-8 无 BOM，字段名大小写敏感（如
highPolyMesh不能写成highpolymesh） - 典型崩溃诱因：
lowPolyMesh的 OBJ 缺少vt行（即没 UV）、或mapSize设为奇数（xNormal 要求偶数）
最小可运行示例（JSON 配置）：
立即学习“C++免费学习笔记（深入）”；
{
"highPolyMesh": "D:/assets/hero_high.obj",
"lowPolyMesh": "D:/assets/hero_low.obj",
"outputPath": "D:/assets/hero_normal.png",
"mapSize": 2048,
"bakeType": "normal",
"rayDistance": 0.05
}法线贴图格式与 OpenGL/Vulkan 加载时的翻转陷阱
xNormal 默认输出的是 DirectX 法线贴图（Y 向上），而 OpenGL 和大多数 PBR 流程期望 OpenGL 法线贴图（Y 向下）。不处理会导致角色在光照下大面积发灰或凸凹反转。
- 最稳妥是在烘焙配置中设
"tangentSpace": true+"flipGreenChannel": true（xNormal v4+ 支持） - 若已生成 DX 格式贴图，C++ 加载后手动翻转 G 通道：对每个像素，
pixel.g = 1.0f - pixel.g - Vulkan 中若用 VK_FORMAT_R8G8B8A8_UNORM，注意 sRGB 转换：法线贴图必须禁用 sRGB 采样（
VK_FORMAT_R8G8B8A8_UNORM，非_SRGB） - 不要用 stb_image 直接读取后丢给 shader——它默认把 0–255 映射到 0.0–1.0，而法线需有符号，应改用
stbi_set_flip_vertically_on_load(1)并确认原始数据未被 gamma 矫正
AO 贴图烘焙中忽略背面导致的“内腔全黑”问题
默认 AO 烘焙只计算从表面向外发射的光线，模型内部腔体（如耳道、衣褶夹层）因无有效射线返回，会渲染成纯黑，但这不是缺陷，是预期行为。若需保留内腔细节，必须显式启用双面 AO 投射。
- xNormal 中需设置
"doubleSided": true和"rayCount": 2048（单面默认 512，双面需更高采样防噪点） - 但双面模式会显著增加烘焙时间（+300%），且对薄壁结构（如布料边缘）可能产生光渗伪影
- 更可控的做法是：烘焙两版 AO——一版常规（外表面），一版仅内表面（通过反转低模法线后重新烘焙），再在 Photoshop 或 C++ 中按深度图混合
- 注意：AO 贴图本身是灰度图，不应存为 sRGB 格式；保存时用
stbi_write_png即可，无需 gamma 处理
真正难的从来不是调哪个函数，而是判断该不该翻 G 通道、要不要开 doubleSided、以及发现 xNormal 静默失败时去翻它生成的临时 log 文件——那个文件默认藏在 %TEMP%xNormal 下，名字带时间戳，不打开根本不知道哪行 JSON 少了个逗号。
