ComputeShader.keywordSpace

Unity · Версия 2020.3 LTS · Scripting · ComputeShader

ComputeShader.keywordSpace

public Rendering.LocalKeywordSpace keywordSpace;

Описание

Локальное пространство ключевых слов этого вычислительного шейдера.

Ключевые слова шейдера определяют, какие варианты шейдера использует Unity. Информацию о работе с ключевыми словами локального шейдера и глобальном ключевом слове шейдера и о том, как они взаимодействуют, см. в разделе Использование ключевых слов шейдера со сценариями C#.

keywordSpace представляет все ключевые слова, объявленные в исходном файле для вычислительного шейдера. Информацию об объявлении и использовании ключевых слов шейдера в исходных файлах шейдера см. в разделе Ключевые слова шейдера (откроется другой сайт).

В этом примере выполняются итерации по ключевым словам локального шейдера в локальном пространстве ключевых слов для вычислительного шейдера. Он определяет, переопределены ли они глобальным ключевым словом шейдера, и выводит их состояние.

using UnityEngine;
using UnityEngine.Rendering;

public class Example : MonoBehaviour
{
    public ComputeShader computeShader;

    void Start()
    {
        CheckShaderKeywordState();
    }

    void CheckShaderKeywordState()
    {
        // Get all the local keywords that affect the Compute Shader
        var keywordSpace = computeShader.keywordSpace;

        // Iterate over the local keywords
        foreach (var localKeyword in keywordSpace.keywords)
        {
            // If the local keyword is overridable,
            // and a global keyword with the same name exists and is enabled,
            // then Unity uses the global keyword state
            if (localKeyword.isOverridable && Shader.IsKeywordEnabled(localKeyword.name))
            {
                Debug.Log("Local keyword with name of " + localKeyword.name + " is overridden by a global keyword, and is enabled");
            }
            // Otherwise, Unity uses the local keyword state
            else
            {
                var state = computeShader.IsKeywordEnabled(localKeyword) ? "enabled" : "disabled";
                Debug.Log("Local keyword with name of " + localKeyword.name + " is " + state);
            }
        }
    }
}

Смотрите так же: Shader variants and keywords, LocalKeyword, GlobalKeyword, EnableKeyword, DisableKeyword, SetKeyword, IsKeywordEnabled, enabledKeywords, shaderKeywords.

Обновлено 17 ноября 2026 г.