class in UnityEngine.Rendering
/
Implemented in:UnityEngine.CoreModule
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:
LoadStoreDebugModeEnabled | Enables or disables Unity highlighting undefined areas of the display. |