语言英语
  • C#

ComputeShader.EnableKeyword

留下反馈
切换到手册

声明

public void EnableKeyword(ref Rendering.LocalKeyword keyword);

声明

public void EnableKeyword(string keyword);

参数

keyword 要启用的 LocalKeyword。
keyword 要启用的 LocalKeyword 的名称。

描述

为该计算着色器启用局部着色器关键字。

着色器关键字决定 Unity 使用哪些着色器变体。有关使用 局部着色器关键字 和 全局着色器关键字 以及它们如何交互的信息，请参阅 使用 C# 脚本的着色器关键字。

如果您传入一个 LocalKeyword，并且它在 keywordSpace 中不存在，则此函数无效。如果您传入一个字符串，并且具有该 name 的 LocalKeyword 在 keywordSpace 中不存在，则此函数无效。

采用字符串作为参数的此函数版本比采用 LocalKeyword 作为参数的版本慢。如果您多次调用此函数，最佳实践是创建一个 LocalKeyword 结构体，将其缓存并使用它。

注意：LocalKeyword 特定于单个 Shader 或 ComputeShader 实例。您不能将其与其他 Shader 或 ComputeShader 实例一起使用，即使它们声明了名称相同的关键字。

以下示例创建一个名为 EXAMPLE_FEATURE_ON 的 LocalKeyword 结构体，并将其缓存。它提供了启用和禁用它的函数。

using UnityEngine;
using UnityEngine.Rendering;

public class ComputeKeywordExample : MonoBehaviour
{
    public ComputeShader computeShader;
    private LocalKeyword exampleFeatureKeyword;

    void Start()
    {
        // Create and cache the LocalKeyword
        exampleFeatureKeyword = new LocalKeyword(computeShader, "EXAMPLE_FEATURE_ON");
    }

    public void EnableExampleFeature()
    {
        computeShader.EnableKeyword(exampleFeatureKeyword);
    }

    public void DisableExampleFeature()
    {
        computeShader.DisableKeyword(exampleFeatureKeyword);
    }
}

其他资源：着色器变体和关键字、LocalKeyword、GlobalKeyword、DisableKeyword、SetKeyword、keywordSpace、IsKeywordEnabled、enabledKeywords、shaderKeywords。

Did you find this page useful? Please give it a rating:

  • 此处描述的内容是否未按预期工作？它可能是已知问题。请在以下位置查看问题跟踪器： issuetracker.unity3d.com.

    版权所有 ©2005-2024 Unity Technologies。保留所有权利。版本：6000.0.25f1 (91cbff7fd174)。构建于：2024-10-19。
    教程 社区解答 知识库 论坛 资源商店 使用条款 法律 隐私政策 Cookie 不要出售或共享我的个人信息