Search Results for

    Show / Hide Table of Contents

    在 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)"
          }
        }
      ]
    }
    
    1. 将自己的遮罩贴图导入 Unity,关闭 sRGB (Color Texture)。用遮罩合并教程核对通道。
    2. 复制要预览的材质,选择 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"
        }
      }
    ]
    
    1. 在带灯光的场景观察金属度、遮蔽和平滑度。检查项目运行时材质组件的覆盖配置。材质组件教程
    In this article
    Back to top Panzer War Document