Merge pull request #8304 from Unity-Technologies/deprecate-ppv2package

rolandk-unity · web-flow · commit a7e4c051d256 · 2026-07-08T15:54:33.000+02:00
[PPV2] Deprecating the package as Birp is being deprecated.
diff --git a/com.unity.postprocessing/CHANGELOG.md b/com.unity.postprocessing/CHANGELOG.md
@@ -4,6 +4,16 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [3.6.0] - 2026-06-01
+
+### Deprecated
+- **The entire `com.unity.postprocessing` package is now deprecated and no longer actively developed.**
+  - For URP and HDRP projects, migrate to the integrated Volume-based post-processing system.
+  - For Built-in Render Pipeline projects, consider migrating to URP.
+  - See [Post-processing Overview](https://docs.unity3d.com/Manual/urp/upgrading-from-birp.html) for migration guidance.
+- Added `[Obsolete]` attributes to `PostProcessVolume`, `PostProcessLayer`, and `PostProcessProfile` classes.
+- Added startup dialog notification that appears once per Unity session, with optional "Don't ask again on this computer" checkbox for permanent dismissal.
+
 ## [3.5.4] - 2026-03-13
 
 ### Fixed
diff --git a/com.unity.postprocessing/PostProcessing/Editor/DeprecationNotice.cs b/com.unity.postprocessing/PostProcessing/Editor/DeprecationNotice.cs
@@ -0,0 +1,49 @@
+using UnityEditor;
+using UnityEngine;
+
+namespace UnityEngine.Rendering.PostProcessing
+{
+    [InitializeOnLoad]
+    internal static class DeprecationNotice
+    {
+        const string k_DialogOptOutKey = "PPv2.DeprecationNotice";
+        const string k_SessionShownKey = "PPv2.DeprecationNotice.SessionShown";
+
+        static DeprecationNotice()
+        {
+            // Check if user has permanently opted out
+            if (EditorPrefs.GetBool(k_DialogOptOutKey, false))
+                return;
+
+            // Check if already shown this session
+            if (SessionState.GetBool(k_SessionShownKey, false))
+                return;
+
+            // Mark as shown for this session
+            SessionState.SetBool(k_SessionShownKey, true);
+
+            // Use EditorApplication.update to show dialog after editor is fully initialized
+            EditorApplication.update += ShowDeprecationDialog;
+        }
+
+        static void ShowDeprecationDialog()
+        {
+            // Remove the callback so it only runs once
+            EditorApplication.update -= ShowDeprecationDialog;
+
+            // Use Unity's built-in opt-out dialog with ForThisUser (permanent checkbox)
+            // Clicking OK without checkbox = dismiss for this session only
+            // Checking the checkbox = dismiss permanently
+            EditorUtility.DisplayDialog(
+                "Post Processing Stack v2 - Deprecated",
+                "This package is deprecated and no longer actively developed.\n\n" +
+                "For URP and HDRP projects, use the integrated post-processing via the Volume framework.\n\n" +
+                "For Built-in Render Pipeline projects, consider migrating to URP.\n\n" +
+                "See documentation for migration guidance:\n" +
+                "https://docs.unity3d.com/Manual/urp/upgrading-from-birp.html",
+                "OK",
+                DialogOptOutDecisionType.ForThisUser,
+                k_DialogOptOutKey);
+        }
+    }
+}
diff --git a/com.unity.postprocessing/PostProcessing/Editor/DeprecationNotice.cs.meta b/com.unity.postprocessing/PostProcessing/Editor/DeprecationNotice.cs.meta
diff --git a/com.unity.postprocessing/PostProcessing/Editor/EffectListEditor.cs b/com.unity.postprocessing/PostProcessing/Editor/EffectListEditor.cs
@@ -5,6 +5,8 @@
 using UnityEngine.Assertions;
 using UnityEngine.Rendering.PostProcessing;
 
+#pragma warning disable CS0618 // Type or member is obsolete
+
 namespace UnityEditor.Rendering.PostProcessing
 {
     /// <summary>
@@ -343,3 +345,5 @@ PostProcessEffectSettings CreateNewEffect(Type type)
         }
     }
 }
+
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/PostProcessing/Editor/PostProcessDebugEditor.cs b/com.unity.postprocessing/PostProcessing/Editor/PostProcessDebugEditor.cs
@@ -1,6 +1,8 @@
 using UnityEngine;
 using UnityEngine.Rendering.PostProcessing;
 
+#pragma warning disable CS0618 // Type or member is obsolete
+
 namespace UnityEditor.Rendering.PostProcessing
 {
     [CustomEditor(typeof(PostProcessDebug))]
@@ -142,3 +144,5 @@ void DoOverlayGUI(DebugOverlay overlay, params SerializedProperty[] settings)
         }
     }
 }
+
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/PostProcessing/Editor/PostProcessLayerEditor.cs b/com.unity.postprocessing/PostProcessing/Editor/PostProcessLayerEditor.cs
@@ -6,6 +6,8 @@
 using UnityEditorInternal;
 using System.IO;
 
+#pragma warning disable CS0618 // Type or member is obsolete
+
 namespace UnityEditor.Rendering.PostProcessing
 {
     using SerializedBundleRef = PostProcessLayer.SerializedBundleRef;
@@ -427,3 +429,5 @@ void ExportFrameToExr(ExportMode mode)
         }
     }
 }
+
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/PostProcessing/Editor/PostProcessProfileEditor.cs b/com.unity.postprocessing/PostProcessing/Editor/PostProcessProfileEditor.cs
@@ -1,5 +1,7 @@
 using UnityEngine.Rendering.PostProcessing;
 
+#pragma warning disable CS0618 // Type or member is obsolete
+
 namespace UnityEditor.Rendering.PostProcessing
 {
     [CustomEditor(typeof(PostProcessProfile))]
@@ -27,3 +29,5 @@ public override void OnInspectorGUI()
         }
     }
 }
+
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/PostProcessing/Editor/PostProcessVolumeEditor.cs b/com.unity.postprocessing/PostProcessing/Editor/PostProcessVolumeEditor.cs
@@ -1,6 +1,8 @@
 using UnityEngine;
 using UnityEngine.Rendering.PostProcessing;
 
+#pragma warning disable CS0618 // Type or member is obsolete
+
 namespace UnityEditor.Rendering.PostProcessing
 {
     [CanEditMultipleObjects, CustomEditor(typeof(PostProcessVolume))]
@@ -164,3 +166,5 @@ public PostProcessProfile profileRef
         }
     }
 }
+
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/PostProcessing/Editor/Tools/ProfileFactory.cs b/com.unity.postprocessing/PostProcessing/Editor/Tools/ProfileFactory.cs
@@ -4,6 +4,8 @@
 using UnityEngine.SceneManagement;
 using UnityEngine.Rendering.PostProcessing;
 
+#pragma warning disable CS0618 // Type or member is obsolete
+
 namespace UnityEditor.Rendering.PostProcessing
 {
     /// <summary>
@@ -96,3 +98,5 @@ public override void Action(int instanceId, string pathName, string resourceFile
     }
 #endif
 }
+
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/PostProcessing/Editor/Tools/VolumeFactory.cs b/com.unity.postprocessing/PostProcessing/Editor/Tools/VolumeFactory.cs
@@ -1,6 +1,8 @@
 using UnityEngine;
 using UnityEngine.Rendering.PostProcessing;
 
+#pragma warning disable CS0618 // Type or member is obsolete
+
 namespace UnityEditor.Rendering.PostProcessing
 {
     internal static class VolumeFactory
@@ -19,3 +21,5 @@ static void CreateVolume()
         }
     }
 }
+
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/PostProcessing/Runtime/PostProcessDebug.cs b/com.unity.postprocessing/PostProcessing/Runtime/PostProcessDebug.cs
@@ -1,3 +1,5 @@
+#pragma warning disable CS0618 // Type or member is obsolete
+
 namespace UnityEngine.Rendering.PostProcessing
 {
     /// <summary>
@@ -158,3 +160,5 @@ void DrawMonitor(ref Rect rect, Monitor monitor, bool enabled)
         }
     }
 }
+
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/PostProcessing/Runtime/PostProcessEffectRenderer.cs b/com.unity.postprocessing/PostProcessing/Runtime/PostProcessEffectRenderer.cs
@@ -1,3 +1,5 @@
+#pragma warning disable CS0618 // Type or member is obsolete
+
 namespace UnityEngine.Rendering.PostProcessing
 {
     /// <summary>
@@ -76,3 +78,5 @@ internal override void SetSettings(PostProcessEffectSettings settings)
         }
     }
 }
+
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/PostProcessing/Runtime/PostProcessLayer.cs b/com.unity.postprocessing/PostProcessing/Runtime/PostProcessLayer.cs
@@ -21,6 +21,7 @@ namespace UnityEngine.Rendering.PostProcessing
     [DisallowMultipleComponent, ImageEffectAllowedInSceneView]
     [AddComponentMenu("Rendering/Post-process Layer", 1000)]
     [RequireComponent(typeof(Camera))]
+    [System.Obsolete("Post Processing Stack v2 is deprecated. Use URP or HDRP's Volume-based post-processing instead.", false)]
     public sealed class PostProcessLayer : MonoBehaviour
     {
         /// <summary>
diff --git a/com.unity.postprocessing/PostProcessing/Runtime/PostProcessManager.cs b/com.unity.postprocessing/PostProcessing/Runtime/PostProcessManager.cs
@@ -3,6 +3,8 @@
 using System.Linq;
 using UnityEngine.Assertions;
 
+#pragma warning disable CS0618 // Type or member is obsolete
+
 namespace UnityEngine.Rendering.PostProcessing
 {
     /// <summary>
@@ -460,3 +462,5 @@ static bool IsVolumeRenderedByCamera(PostProcessVolume volume, Camera camera)
         }
     }
 }
+
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/PostProcessing/Runtime/PostProcessProfile.cs b/com.unity.postprocessing/PostProcessing/Runtime/PostProcessProfile.cs
@@ -7,6 +7,7 @@ namespace UnityEngine.Rendering.PostProcessing
     /// An asset holding a set of post-processing settings to use with a <see cref="PostProcessVolume"/>.
     /// </summary>
     /// <seealso cref="PostProcessVolume"/>
+    [System.Obsolete("Post Processing Stack v2 is deprecated. Use URP or HDRP's Volume-based post-processing instead.", false)]
     public sealed class PostProcessProfile : ScriptableObject
     {
         /// <summary>
diff --git a/com.unity.postprocessing/PostProcessing/Runtime/PostProcessRenderContext.cs b/com.unity.postprocessing/PostProcessing/Runtime/PostProcessRenderContext.cs
@@ -1,5 +1,7 @@
 using System.Collections.Generic;
 
+#pragma warning disable CS0618 // Type or member is obsolete
+
 namespace UnityEngine.Rendering.PostProcessing
 {
 #if (ENABLE_VR_MODULE && ENABLE_VR)
@@ -434,3 +436,5 @@ public void UpdateSinglePassStereoState(bool isTAAEnabled, bool isAOEnabled, boo
         }
     }
 }
+
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/PostProcessing/Runtime/PostProcessVolume.cs b/com.unity.postprocessing/PostProcessing/Runtime/PostProcessVolume.cs
@@ -61,6 +61,7 @@ namespace UnityEngine.Rendering.PostProcessing
     [ExecuteInEditMode]
 #endif
     [AddComponentMenu("Rendering/Post-process Volume", 1001)]
+    [System.Obsolete("Post Processing Stack v2 is deprecated. Use URP or HDRP's Volume-based post-processing instead.", false)]
     public sealed class PostProcessVolume : MonoBehaviour
     {
         /// <summary>
diff --git a/com.unity.postprocessing/PostProcessing/Runtime/Utils/RuntimeUtilities.cs b/com.unity.postprocessing/PostProcessing/Runtime/Utils/RuntimeUtilities.cs
@@ -14,6 +14,8 @@
 using UnityEngine.Assemblies;
 #endif
 
+#pragma warning disable CS0618 // Type or member is obsolete
+
 namespace UnityEngine.Rendering.PostProcessing
 {
     using SceneManagement;
@@ -1330,3 +1332,5 @@ public static string GetFieldPath<TType, TValue>(Expression<Func<TType, TValue>>
         #endregion
     }
 }
+
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/Tests/Runtime/PostProcessingRuntimeTests.cs b/com.unity.postprocessing/Tests/Runtime/PostProcessingRuntimeTests.cs
@@ -1,3 +1,4 @@
+#pragma warning disable CS0618 // Type or member is obsolete
 using System;
 using NUnit.Framework;
 using UnityEngine;
@@ -82,3 +83,4 @@ static void Destroy(PostProcessProfile profile)
         UnityEngine.Object.DestroyImmediate(profile);
     }
 }
+#pragma warning restore CS0618 // Type or member is obsolete
diff --git a/com.unity.postprocessing/package.json b/com.unity.postprocessing/package.json
@@ -1,10 +1,10 @@
 {
     "name": "com.unity.postprocessing",
-    "version": "3.5.4",
+    "version": "3.6.0",
     "displayName": "Post Processing",
-    "unity": "2019.4",
-    "unityRelease": "19f1",
-    "description": "The post-processing stack (v2) comes with a collection of effects and image filters you can apply to your cameras to improve the visuals of your games.",
+    "unity": "6000.7",
+    "unityRelease": "0a2",
+    "description": "The post-processing stack (v2) comes with a collection of effects and image filters you can apply to your cameras to improve the visuals of your games. This package is deprecated for use in URP/HDRP, please use the Volume-based post-processing instead.",
   "dependencies": {
     "com.unity.modules.physics": "1.0.0",
     "com.unity.modules.imgui": "1.0.0"

Original file line number	Diff line number	Diff line change
`@@ -5,6 +5,8 @@`
`5`	`5`	`using UnityEngine.Assertions;`
`6`	`6`	`using UnityEngine.Rendering.PostProcessing;`
`7`	`7`
	`8`	`+#pragma warning disable CS0618 // Type or member is obsolete`
	`9`	`+`
`8`	`10`	`namespace UnityEditor.Rendering.PostProcessing`
`9`	`11`	`{`
`10`	`12`	`/// <summary>`
`@@ -343,3 +345,5 @@ PostProcessEffectSettings CreateNewEffect(Type type)`
`343`	`345`	`}`
`344`	`346`	`}`
`345`	`347`	`}`
	`348`	`+`
	`349`	`+#pragma warning restore CS0618 // Type or member is obsolete`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,8 @@`
`1`	`1`	`using UnityEngine;`
`2`	`2`	`using UnityEngine.Rendering.PostProcessing;`
`3`	`3`
	`4`	`+#pragma warning disable CS0618 // Type or member is obsolete`
	`5`	`+`
`4`	`6`	`namespace UnityEditor.Rendering.PostProcessing`
`5`	`7`	`{`
`6`	`8`	`[CustomEditor(typeof(PostProcessDebug))]`
`@@ -142,3 +144,5 @@ void DoOverlayGUI(DebugOverlay overlay, params SerializedProperty[] settings)`
`142`	`144`	`}`
`143`	`145`	`}`
`144`	`146`	`}`
	`147`	`+`
	`148`	`+#pragma warning restore CS0618 // Type or member is obsolete`
Original file line number	Diff line number	Diff line change
`@@ -6,6 +6,8 @@`
`6`	`6`	`using UnityEditorInternal;`
`7`	`7`	`using System.IO;`
`8`	`8`
	`9`	`+#pragma warning disable CS0618 // Type or member is obsolete`
	`10`	`+`
`9`	`11`	`namespace UnityEditor.Rendering.PostProcessing`
`10`	`12`	`{`
`11`	`13`	`using SerializedBundleRef = PostProcessLayer.SerializedBundleRef;`
`@@ -427,3 +429,5 @@ void ExportFrameToExr(ExportMode mode)`
`427`	`429`	`}`
`428`	`430`	`}`
`429`	`431`	`}`
	`432`	`+`
	`433`	`+#pragma warning restore CS0618 // Type or member is obsolete`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,7 @@`
`1`	`1`	`using UnityEngine.Rendering.PostProcessing;`
`2`	`2`
	`3`	`+#pragma warning disable CS0618 // Type or member is obsolete`
	`4`	`+`
`3`	`5`	`namespace UnityEditor.Rendering.PostProcessing`
`4`	`6`	`{`
`5`	`7`	`[CustomEditor(typeof(PostProcessProfile))]`
`@@ -27,3 +29,5 @@ public override void OnInspectorGUI()`
`27`	`29`	`}`
`28`	`30`	`}`
`29`	`31`	`}`
	`32`	`+`
	`33`	`+#pragma warning restore CS0618 // Type or member is obsolete`
Original file line number	Diff line number	Diff line change
`@@ -4,6 +4,8 @@`
`4`	`4`	`using UnityEngine.SceneManagement;`
`5`	`5`	`using UnityEngine.Rendering.PostProcessing;`
`6`	`6`
	`7`	`+#pragma warning disable CS0618 // Type or member is obsolete`
	`8`	`+`
`7`	`9`	`namespace UnityEditor.Rendering.PostProcessing`
`8`	`10`	`{`
`9`	`11`	`/// <summary>`
`@@ -96,3 +98,5 @@ public override void Action(int instanceId, string pathName, string resourceFile`
`96`	`98`	`}`
`97`	`99`	`#endif`
`98`	`100`	`}`
	`101`	`+`
	`102`	`+#pragma warning restore CS0618 // Type or member is obsolete`