Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

requiresCompatibleRenderPipelineGlobalSettings

Controls whether Unity validates that a compatible RenderPipelineGlobalSettings asset is active when this Render Pipeline Asset gets assigned.
Read time 1 minuteLast updated 11 days ago

Definition

protected virtual bool requiresCompatibleRenderPipelineGlobalSettings { get; }

Remarks

URP and HDRP override this property to return 
true
by default so that Unity validates the active RenderPipelineGlobalSettings asset whenever you assign the RenderPipelineAsset at runtime. Custom render pipelines can override this property to change that behavior.
When this property returns 
true
, assigning an asset to GraphicsSettings.defaultRenderPipeline or QualitySettings.renderPipeline at runtime throws an 
InvalidOperationException
if a compatible RenderPipelineGlobalSettings asset is not currently active.
Additional Resources: GraphicsSettings.TrySetCurrentRenderPipelineGlobalSettings.