LanguageEnglish
  • C#

LoadStoreActionDebugModeSettings

class in UnityEngine.Rendering

/

Implemented in:UnityEngine.CoreModule

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.

Did you find this page useful? Please give it a rating: