Version: 2023.2
LanguageEnglish
  • C#

LoadStoreActionDebugModeSettings

class in UnityEngine.Rendering

/

Implemented in:UnityEngine.CoreModule

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Description

Whether to show undefined areas of the display that might cause rendering problems in your built application.

If you create a RenderTexture, it might have undefined ('invalidated') pixels. Rendering to the render texture might fail or produce artefacts, because undefined pixels in the depth texture cause depth testing to fail.

Undefined pixels can be caused by the following:

If you set LoadStoreActionDebugModeSettings.LoadStoreDebugModeEnabled to true, Unity highlights undefined areas with INVALIDATED. The highlights appear only in the Game view, and your built application if you select Development Build in Build settings.



In the image above, the cube on the right has failed depth testing and might not render in your built application, so Unity highlights the area with INVALIDATED. The cube on the left ignores depth testing and renders correctly.

You shouldn't enable this parameter if you're profiling your project, because it might reduce rendering performance.

You can also control this setting in Player settings. You can use the API at runtime to override the value in Player settings, but Unity resets the value if you restart Play Mode or build your project.

You can fix undefined areas in the following ways:

Static Properties

LoadStoreDebugModeEnabledEnables or disables Unity highlighting undefined areas of the display.