Merge pull request #8273 from Unity-Technologies/release/ppv2-3.5.4

[PPV2] Post Processing 3.5.4

Author: theo-at-unity

TestProjects/PostProcessing_Tests/Assets/CommonAssets/Scripts/PostProcessingGraphicsTests.cs

@@ -20,7 +20,7 @@ public IEnumerator Run(GraphicsTestCase testCase)
         var camera = GameObject.FindGameObjectWithTag("MainCamera").GetComponent<Camera>();
 
 #if UNITY_2020_3_OR_NEWER
-        var settings = Object.FindFirstObjectByType<PostProcessingGraphicsTestSettings>();
+        var settings = Object.FindAnyObjectByType<PostProcessingGraphicsTestSettings>();
 #else
         var settings = Object.FindObjectOfType<PostProcessingGraphicsTestSettings>();
 #endif

com.unity.postprocessing/CHANGELOG.md

@@ -4,6 +4,12 @@ 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.5.4] - 2026-03-13
+
+### Fixed
+- Fixed serialization hierarchy errors
+- Documentation updates
+
 ## [3.5.3] - 2026-02-19
 
 ### Fixed

com.unity.postprocessing/PostProcessing/Editor/BaseEditor.cs

@@ -46,11 +46,12 @@ protected T m_Target
         }
 
         /// <summary>
-        ///
+        /// Find a serialized property using an expression instead of a string. This is safer as it
+        /// helps avoiding typos and make code refactoring easier.
         /// </summary>
-        /// <typeparam name="TValue"></typeparam>
-        /// <param name="expr"></param>
-        /// <returns></returns>
+        /// <typeparam name="TValue">The serialized value type</typeparam>
+        /// <param name="expr">The expression to parse to reach the property</param>
+        /// <returns>A <see cref="SerializedProperty"/> or <c>null</c> if none was found</returns>
         protected SerializedProperty FindProperty<TValue>(Expression<Func<T, TValue>> expr)
         {
             return serializedObject.FindProperty(RuntimeUtilities.GetFieldPath(expr));

com.unity.postprocessing/PostProcessing/Editor/PostProcessEffectEditor.cs

@@ -40,7 +40,7 @@ public class PostProcessEffectEditor<T> : PostProcessEffectBaseEditor
         /// </example>
         /// <remarks>
         /// If you're trying to retrieve a <see cref="SerializedParameterOverride"/>, you should
-        /// use <seealso cref="FindParameterOverride{TValue}"/> instead.
+        /// use <see cref="FindParameterOverride{TValue}"/> instead.
         /// </remarks>
         /// <seealso cref="SerializedProperty"/>
         /// <seealso cref="FindParameterOverride{TValue}"/>

com.unity.postprocessing/PostProcessing/Runtime/Monitors/Monitor.cs

@@ -1,3 +1,5 @@
+using System;
+
 namespace UnityEngine.Rendering.PostProcessing
 {
     /// <summary>
@@ -29,6 +31,7 @@ public enum MonitorType
     /// <summary>
     /// The base class for all debug monitors.
     /// </summary>
+    [Serializable]
     public abstract class Monitor
     {
         /// <summary>

com.unity.postprocessing/PostProcessing/Runtime/ParameterOverride.cs

@@ -6,6 +6,7 @@ namespace UnityEngine.Rendering.PostProcessing
     /// The base abstract class for all parameter override types.
     /// </summary>
     /// <seealso cref="ParameterOverride{T}"/>
+    [Serializable]
     public abstract class ParameterOverride
     {
         /// <summary>
@@ -65,7 +66,7 @@ protected internal virtual void OnDisable()
     /// own by extending this class.
     /// </remarks>
     /// <example>
-    /// This sample code shows how to make a custom parameter holding a <c>float</c>.
+    /// <para>This sample code shows how to make a custom parameter holding a <c>float</c>.</para>
     /// <code>
     /// [Serializable]
     /// public sealed class FloatParameter : ParameterOverride&lt;float&gt;
@@ -143,7 +144,7 @@ public virtual void Interp(T from, T to, float t)
         /// Sets the value for this parameter to <paramref name="x"/> and mark the override state
         /// to <c>true</c>.
         /// </summary>
-        /// <param name="x"></param>
+        /// <param name="x">New value</param>
         public void Override(T x)
         {
             overrideState = true;
@@ -174,7 +175,7 @@ public override int GetHash()
         /// Implicit conversion between <see cref="ParameterOverride{T}"/> and its value type.
         /// </summary>
         /// <param name="prop">The parameter to implicitly cast</param>
-        /// <returns>A value of type <typeparam name="T">.</typeparam></returns>
+        /// <returns>A value of given type.</returns>
         public static implicit operator T(ParameterOverride<T> prop)
         {
             return prop.value;

com.unity.postprocessing/PostProcessing/Runtime/PostProcessLayer.cs

@@ -157,6 +157,7 @@ public sealed class SerializedBundleRef
             /// <summary>
             /// A reference to the bundle itself.
             /// </summary>
+            [NonSerialized]
             public PostProcessBundle bundle; // Not serialized, is set/reset when deserialization kicks in
         }
 
@@ -739,7 +740,7 @@ void OnPostRender()
         /// Grabs the bundle for the given effect type.
         /// </summary>
         /// <typeparam name="T">An effect type.</typeparam>
-        /// <returns>The bundle for the effect of type <typeparam name="T"></typeparam></returns>
+        /// <returns>The bundle for the effect of the given type.</returns>
         public PostProcessBundle GetBundle<T>()
             where T : PostProcessEffectSettings
         {
@@ -750,7 +751,7 @@ public PostProcessBundle GetBundle<T>()
         /// Grabs the bundle for the given effect type.
         /// </summary>
         /// <param name="settingsType">An effect type.</param>
-        /// <returns>The bundle for the effect of type <typeparam name="type"></typeparam></returns>
+        /// <returns>The bundle for the effect of the given type.</returns>
         public PostProcessBundle GetBundle(Type settingsType)
         {
             Assert.IsTrue(m_Bundles.ContainsKey(settingsType), "Invalid type");

com.unity.postprocessing/PostProcessing/Runtime/PostProcessManager.cs

@@ -212,7 +212,7 @@ public PostProcessVolume GetHighestPriorityVolume(LayerMask mask)
         /// <param name="layer">The unity layer to put the volume in</param>
         /// <param name="priority">The priority to set this volume to</param>
         /// <param name="settings">A list of effects to put in this volume</param>
-        /// <returns></returns>
+        /// <returns>A newly created GameObject called "Quick Volume" that contains a global volume.</returns>
         public PostProcessVolume QuickVolume(int layer, float priority, params PostProcessEffectSettings[] settings)
         {
             var gameObject = new GameObject()

com.unity.postprocessing/package.json

@@ -1,6 +1,6 @@
 {
     "name": "com.unity.postprocessing",
-    "version": "3.5.3",
+    "version": "3.5.4",
     "displayName": "Post Processing",
     "unity": "2019.4",
     "unityRelease": "19f1",