Rendering.ScriptableRenderContext.ExecuteCommandBuffer

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

Rendering.ScriptableRenderContext.ExecuteCommandBuffer

Объявление

public void ExecuteCommandBuffer(Rendering.CommandBuffer commandBuffer);

Параметры

commandBuffer Указывает командный буфер для выполнения.

Описание

Планирует выполнение пользовательского графического командного буфера.

Во время вызова ScriptableRenderContext.ExecuteCommandBuffer ScriptableRenderContext регистрирует параметр commandBuffer в своем внутреннем список команд для выполнения. Фактическое выполнение этих команд (включая команды, хранящиеся в пользовательском командном буфере) происходит во время ScriptableRenderContext.Submit.

Убедитесь, что вы вызываете ExecuteCommandBuffer перед другими методами ScriptableRenderContext (такими как DrawRenderers, DrawShadows), если ваши вызовы отрисовки зависят от состояния конвейера, указанного вами в CommandBuffer. Пример кода ниже иллюстрирует случай, когда команды отправляются в неправильном порядке; за которым следует случай, который ведет себя так, как ожидалось:

using UnityEngine;
using UnityEngine.Rendering;

internal class ExecuteCommandBufferExample
{
    // TODO: replace with actual settings
    ScriptableRenderContext scriptableRenderContext;
    DrawingSettings drawingSettings;
    CullingResults cullingResults = new CullingResults();
    FilteringSettings filteringSettings = new FilteringSettings();

Matrix4x4 myViewMatrix = Matrix4x4.Scale(new Vector3(2f, 2f, 2f));

    public void DrawRenderersExampleIncorrect()
    {
        CommandBuffer myCommandBuffer = new CommandBuffer();

        myCommandBuffer.SetViewMatrix(myViewMatrix);

        scriptableRenderContext.DrawRenderers(cullingResults, ref drawingSettings, ref filteringSettings);
        // NO! When scriptableRenderContext submits the DrawRenderers command, it will not know about myViewMatrix :(

        scriptableRenderContext.ExecuteCommandBuffer(myCommandBuffer);
        myCommandBuffer.Clear();
    }

    public void DrawRenderersExampleBetter()
    {
        CommandBuffer myCommandBuffer = new CommandBuffer();

        myCommandBuffer.SetViewMatrix(myViewMatrix);

        scriptableRenderContext.ExecuteCommandBuffer(myCommandBuffer);
        myCommandBuffer.Clear();

        scriptableRenderContext.DrawRenderers(cullingResults, ref drawingSettings, ref filteringSettings);
        // OK! During next scriptableRenderContext.Submit() call, scriptableRenderContext will set myViewMatrix *before* drawing the renderers.
    }
}

Смотрите так же: CommandBuffer.

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