在 Unity 预览遮罩贴图
中文 | English
在仓库根目录运行以下命令,用本机 Unity MCP 回放本页示例。
python Docs/Manual/manual/tools/tutorials.py run mask-texture-preview
点击展开 MCP 操作点击收起 MCP 操作
准备教学样例。${变量} 由配方提供。
{
"variables": {
"material": "${fixture}/Tutorial_Prop.mat",
"settings": "${fixture}/Tutorial_MaterialSettings.asset",
"model": "${fixture}/Tutorial_Material.prefab",
"texture": "${fixture}/TutorialMask.png"
},
"calls": [
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CreateFolder",
"args": [
"${fixtureParent}",
"${folder}"
]
},
"expect": {
"contains": "(String)"
}
}
]
}
- 将自己的遮罩贴图导入 Unity,关闭 sRGB (Color Texture)。用遮罩合并教程核对通道。
- 复制要预览的材质,选择 WindyVerse/Vehicle/FullPBR。将贴图赋给遮罩字段 _MaskMap,把预览材质拖到独立模型上。
点击展开 MCP 操作点击收起 MCP 操作
[
{
"tool": "invoke",
"arguments": {
"path": "static:ShanghaiWindy.Core.AssetBundleManager/LuaEnv/DoString",
"args": [
"local U = CS.UnityEngine\nlocal source = U.Texture2D(2, 2, U.TextureFormat.RGBA32, false, true)\nlocal color = U.Color(0.24, 0.76, 0, 0.5)\nfor x = 0, 1 do\n for y = 0, 1 do source:SetPixel(x, y, color) end\nend\nsource:Apply()\nlocal png = U.ImageConversion.EncodeToPNG(source)\nCS.System.IO.File.WriteAllBytes('${texture}', png)\nlocal copy = U.Texture2D(2, 2, U.TextureFormat.RGBA32, false, true)\nassert(U.ImageConversion.LoadImage(copy, png, false))\nlocal pixel = copy:GetPixel(0, 0)\nassert(math.abs(color.r - pixel.r) < .005 and math.abs(color.g - pixel.g) < .005)\nassert(math.abs(color.b - pixel.b) < .005 and math.abs(color.a - pixel.a) < .005)\nU.Object.DestroyImmediate(source)\nU.Object.DestroyImmediate(copy)\nreturn \"PNG channel sample verified\"\n",
"tutorial-pbr-mask",
"null"
]
},
"expect": {
"contains": "PNG channel sample verified"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/ImportAsset",
"args": [
"${texture}",
"ForceSynchronousImport"
]
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect_set",
"arguments": {
"path": "importer:${texture}/sRGBTexture",
"value": "false"
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect",
"arguments": {
"path": "importer:${texture}/sRGBTexture"
},
"expect": {
"contains": "(Boolean) False"
}
},
{
"tool": "invoke",
"arguments": {
"path": "static:UnityEditor.AssetDatabase/CopyAsset",
"args": [
"Packages/com.shanghaiwindy.coreresources/BuiltInVehicles/Altius-U/Art/Default-FastProp.mat",
"${material}"
]
},
"expect": {
"contains": "(Boolean) True"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${material}/shader/name"
},
"expect": {
"contains": "WindyVerse/Vehicle/FullPBR"
}
},
{
"tool": "invoke",
"arguments": {
"path": "asset:${material}/HasProperty",
"args": [
"_MaskMap"
]
},
"expect": {
"contains": "(Boolean) True"
}
},
{
"tool": "invoke",
"arguments": {
"path": "asset:${material}/SetTexture",
"args": [
"_MaskMap",
"@asset:${texture}"
]
},
"expect": {
"contains": "OK:"
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${material}/GetTexture(_MaskMap)/name"
},
"expect": {
"contains": "(String) TutorialMask"
}
},
{
"tool": "prefab_edit",
"arguments": {
"json": {
"path": "${model}",
"mode": "create",
"component": "UnityEngine.MeshRenderer",
"values": {
"m_Materials": [
{}
]
},
"references": [
{
"property": "m_Materials.Array.data[0]",
"asset": "${material}",
"type": "UnityEngine.Material"
}
]
}
},
"expect": {
"equals": {
"ok": true
}
}
},
{
"tool": "inspect",
"arguments": {
"path": "asset:${model}/MeshRenderer/sharedMaterial/GetTexture(_MaskMap)/name"
},
"expect": {
"contains": "(String) TutorialMask"
}
}
]
- 在带灯光的场景观察金属度、遮蔽和平滑度。检查项目运行时材质组件的覆盖配置。材质组件教程