LoadStoreActionDebugModeSettings
класс в UnityEngine.Rendering
Выполнено в:UnityEngine.CoreModule
Описание
Показывать ли неопределенные области дисплея, которые могут вызвать проблемы с отображением в созданном приложении.
Если вы создаете RenderTexture, в нем могут быть неопределённые ('недействительные') пиксели. Отображение текстуры рендеринга может завершиться неудачей или вызвать артефакты, потому что неопределённые пиксели в текстура глубины вызвать неудачу испытания на глубину.
Неопределенные пиксели могут быть вызваны следующими причинами:
- Вы не загружаете предыдущий кадр в текстуру рендеринга — например, потому что вы используете RenderBufferLoadAction.DontCare
- По причинам производительности, платформа или API не загружает предыдущий кадр в текстуру рендеринга — например, на мобильных платформах или Vulkan графики API.
- Вы используете RenderBufferStoreAction.DontCare, RenderBufferStoreAction.Resolve или RenderTexture.DiscardContents для удаления содержимого буфера рендеринга после рендеринга.
- Вы не инициализируете текстуру рендеринга после того, как вы create ее.
Если вы установите LoadStoreActionDebugModeSettings.LoadStoreDebugModeEnabled до true, Unity выделяет неопределенные области с INVALIDATED. Выделения появляются только в Game представлении, и ваше созданное приложение, если вы выберете Разработка Build в Настройки сборки.

Куб справа не прошел тест глубины и может не отображаться в вашем созданном приложении, поэтому Unity выделяет область с INVALIDATED. Куб слева игнорирует проверку глубины и отображается правильно.
Вы не должны включать этот параметр, если вы профилируете свой проект, потому что это может уменьшить производительность отображения.
Вы также можете управлять этой настройкой в Настройки плеера. Этот API можно использовать во время выполнения, чтобы переопределить значение в Player Settings, но Unity сбросит его, если вы перезапустите режим Play или соберёте проект.
Неопределенные области можно исправить следующими способами:
- Проверьте правильность использования RenderBufferLoadAction и RenderBufferStoreAction.
- Проверьте инициализацию текстуры рендеринга — например, вы используете GL.Clear или CommandBuffer.ClearRenderTarget.
- Используйте ZTest Всегда используйте в шейдерах, которые вы используете в Материалах и Graphics.Blit.
Статические свойства
| Свойство | Описание |
|---|---|
| LoadStoreDebugModeEnabled | Включает или отключает Unity выделение неопределенных областей дисплея. |