CullingResults

Структура с результатами операции отсечения.

В Scriptable Render Pipeline, когда Unity выполняет операцию удаления, он сохраняет результаты в CullingResults структура. В эти данные входят сведения о видимых объектах, источниках света и зондах отражений. Unity использует их для отрисовки объектов и обработки источников света. CullingResults структура предоставляет также несколько функций, помогающих при отрисовке теней.

Чтобы получить CullingResults структуру, вызовите ScriptableRenderContext.Cull.

A CullingResults структура действительна в пределах области видимости RenderPipeline.Render функции; ее данные выходят за рамки, когда Render возвращает функция. Вы можете использовать те же CullingResults структуру несколько раз в пределах одного цикла рендеринга, и вы можете использовать общую CullingResults структуру между несколькими Cameras если вы знаете, что они могут видеть одни и те же объекты. Это может сэкономить на потерянных операциях CPU и, следовательно, повысить производительность.

После того, как Unity выполняет операции рисования с CullingResults, вы не можете вызвать ScriptableRenderContext.Cull Список рендереров должен оставаться последовательным на протяжении всего процесса рендирования, чтобы избежать непредсказуемых результатов или сбоев. Чтобы убедиться, что список рендереров не изменяется случайно, обведите код между ScriptableRenderContext.PushDisableApiRenderers и ScriptableRenderContext.PopDisableApiRenderers.

Этот пример показывает, как получить CullingResults структуру, а затем передайте её в ScriptableRenderContext.DrawRenderers.

using UnityEngine;
using UnityEngine.Rendering;

public class ExampleRenderPipeline : RenderPipeline
{
    public ExampleRenderPipeline()
    {
    }

    protected override void Render(ScriptableRenderContext context, Camera[] cameras)
    {
        foreach (Camera camera in cameras)
        {
            // Get the culling parameters from the current camera
            camera.TryGetCullingParameters(out var cullingParameters);

            // Schedule the cull operation that populates the CullingResults struct
            CullingResults cullingResults = context.Cull(ref cullingParameters);

            // Place code that schedules drawing operations using the CullingResults struct here
            // See ScriptableRenderContext.DrawRenderers for details and examples
            // …

            // Execute all of the scheduled operations, in order
            context.Submit();
        }
    }
}