add a mechanism to suppress eager updates

Author: al2me6

Source/DynamicProperties/MaterialPropertyManager.cs

@@ -13,6 +13,8 @@ public sealed class MaterialPropertyManager : MonoBehaviour
 
 	private readonly Dictionary<Renderer, PropsCascade> rendererCascades = [];
 
+	private readonly List<Props> propsLateUpdateQueue = [];
+
 	#endregion
 
 	#region Lifecycle
@@ -83,4 +85,34 @@ public bool Remove(Props props)
 
 		return removed;
 	}
+
+	private bool _propRefreshScheduled = false;
+	private static readonly WaitForEndOfFrame WfEoF = new();
+
+	private IEnumerator<YieldInstruction> Co_propsLateUpdate()
+	{
+		yield return WfEoF;
+
+		foreach (var props in propsLateUpdateQueue) {
+			if (props.NeedsEntriesUpdate) {
+				props.OnEntriesChanged(props);
+			} else if (props.NeedsValueUpdate) {
+				props.OnValueChanged(props);
+			}
+
+			props.SuppressEagerUpdate =
+				props.NeedsEntriesUpdate = props.NeedsValueUpdate = false;
+		}
+
+		propsLateUpdateQueue.Clear();
+		_propRefreshScheduled = false;
+	}
+
+	internal void ScheduleLateUpdate(Props props)
+	{
+		propsLateUpdateQueue.Add(props);
+		if (_propRefreshScheduled) return;
+		StartCoroutine(Co_propsLateUpdate());
+		_propRefreshScheduled = true;
+	}
 }

Source/DynamicProperties/Props.cs

@@ -111,6 +111,16 @@ public sealed class Props(int priority) : IDisposable
 	internal PropsUpdateHandler OnValueChanged = delegate { };
 	internal PropsUpdateHandler OnEntriesChanged = delegate { };
 
+	internal bool SuppressEagerUpdate = false;
+	internal bool NeedsValueUpdate = false;
+	internal bool NeedsEntriesUpdate = false;
+
+	public void SuppressEagerUpdatesThisFrame()
+	{
+		SuppressEagerUpdate = true;
+		MaterialPropertyManager.Instance.ScheduleLateUpdate(this);
+	}
+
 	[MethodImpl(MethodImplOptions.AggressiveInlining)]
 	private void _internalSet<T, TProp>(int id, T value) where TProp : Prop<T>
 	{
@@ -119,7 +129,13 @@ private void _internalSet<T, TProp>(int id, T value) where TProp : Prop<T>
 				if (EqualityComparer<T>.Default.Equals(value, typedProp.Value)) return;
 
 				typedProp.Value = value;
-				OnValueChanged(this);
+
+				if (!SuppressEagerUpdate) {
+					OnValueChanged(this);
+				} else {
+					NeedsValueUpdate = true;
+				}
+
 				return;
 			}
 
@@ -128,7 +144,12 @@ private void _internalSet<T, TProp>(int id, T value) where TProp : Prop<T>
 		}
 
 		props[id] = (TProp)Activator.CreateInstance(typeof(TProp), value);
-		OnEntriesChanged(this);
+
+		if (!SuppressEagerUpdate) {
+			OnEntriesChanged(this);
+		} else {
+			NeedsEntriesUpdate = true;
+		}
 	}
 
 	[MethodImpl(MethodImplOptions.AggressiveInlining)]