// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.
#if GT_USE_UGUI
using System.Collections.Generic;
using System.Reflection;
using UnityEngine;
#if UNITY_2021_1_OR_NEWER
using UnityEngine.Pool;
#endif
using UnityEngine.UI;
namespace Microsoft.MixedReality.GraphicsTools
{
///
/// Overrides the RectMask2D.PerformClipping method to add extra checks before doing exhaustive culling on
/// each maskable target.
///
public class RectMask2DFast : RectMask2D
{
private HashSet clipTargets = null;
private HashSet maskableTargets = null;
private int lastclipTargetsCount = 0;
private int lastmaskableTargetsCount = 0;
private bool shouldRecalculateClipRects = false;
private Canvas cachedCanvas = null;
private Vector3[] cachedCorners = new Vector3[4];
private Rect lastClipRectCanvasSpace = new Rect();
private Vector2Int lastSoftness = new Vector2Int();
private List clippers = new List();
#region MonoBehaviour Implementation
///
protected override void OnEnable()
{
base.OnEnable();
shouldRecalculateClipRects = true;
ForceClip = true;
}
#if UNITY_EDITOR
///
protected override void OnValidate()
{
base.OnValidate();
shouldRecalculateClipRects = true;
ForceClip = true;
}
#endif
///
protected override void OnDidApplyAnimationProperties()
{
base.OnDidApplyAnimationProperties();
shouldRecalculateClipRects = true;
ForceClip = true;
}
#endregion MonoBehaviour Implementation
#region RectMask2D Implementation
///
protected override void OnTransformParentChanged()
{
base.OnTransformParentChanged();
shouldRecalculateClipRects = true;
}
///
protected override void OnCanvasHierarchyChanged()
{
cachedCanvas = null;
base.OnCanvasHierarchyChanged();
shouldRecalculateClipRects = true;
}
///
/// Improves the base class method by:
/// - Checks if the canvas renderer has moved before exhaustive culling.
/// - Interleaves UpdateClipSoftness so objects are not iterated over twice.
/// - Adds a OnSetClipRect callback for derived classes to use.
///
public override void PerformClipping()
{
// Not calling the base class method intentionally to provide a more optimal version.
//base.PerformClipping();
Initialize();
if (ReferenceEquals(Canvas, null))
{
return;
}
//TODO See if an IsActive() test would work well here or whether it might cause unexpected side effects (re case 776771)
// if the parents are changed
// or something similar we
// do a recalculate here
if (shouldRecalculateClipRects || ForceClip)
{
MaskUtilities.GetRectMasksForClip(this, clippers);
shouldRecalculateClipRects = false;
}
// get the compound rects from
// the clippers that are valid
bool validRect = true;
Rect clipRect = Clipping.FindCullAndClipWorldRect(clippers, out validRect);
// If the mask is in ScreenSpaceOverlay/Camera render mode, its content is only rendered when its rect
// overlaps that of the root canvas.
RenderMode renderMode = Canvas.rootCanvas.renderMode;
bool maskIsCulled =
(renderMode == RenderMode.ScreenSpaceCamera || renderMode == RenderMode.ScreenSpaceOverlay) &&
!clipRect.Overlaps(RootCanvasRect, true);
if (maskIsCulled)
{
// Children are only displayed when inside the mask. If the mask is culled, then the children
// inside the mask are also culled. In that situation, we pass an invalid rect to allow callees
// to avoid some processing.
clipRect = Rect.zero;
validRect = false;
}
if (clipRect != lastClipRectCanvasSpace || softness != lastSoftness)
{
foreach (IClippable clipTarget in clipTargets)
{
clipTarget.SetClipRect(clipRect, validRect);
clipTarget.SetClipSoftness(softness);
}
foreach (MaskableGraphic maskableTarget in maskableTargets)
{
maskableTarget.SetClipRect(clipRect, validRect);
maskableTarget.SetClipSoftness(softness);
OnSetClipRect(maskableTarget);
maskableTarget.Cull(clipRect, validRect);
}
}
else if (ForceClip)
{
foreach (IClippable clipTarget in clipTargets)
{
clipTarget.SetClipRect(clipRect, validRect);
clipTarget.SetClipSoftness(softness);
}
foreach (MaskableGraphic maskableTarget in maskableTargets)
{
maskableTarget.SetClipRect(clipRect, validRect);
maskableTarget.SetClipSoftness(softness);
OnSetClipRect(maskableTarget);
if (maskableTarget.canvasRenderer.hasMoved)
{
maskableTarget.Cull(clipRect, validRect);
}
}
}
else
{
foreach (MaskableGraphic maskableTarget in maskableTargets)
{
// Added check back from https://github.com/Unity-Technologies/uGUI/blob/2019.1/UnityEngine.UI/UI/Core/RectMask2D.cs#L227
// even though case 1170399 says this can be an issue - hasMoved is not a valid check when animating on pivot of the object
if (!maskableTarget.canvasRenderer.hasMoved)
{
continue;
}
maskableTarget.Cull(clipRect, validRect);
}
}
ForceClip = false;
lastClipRectCanvasSpace = clipRect;
lastSoftness = softness;
}
#endregion RectMask2D Implementation
///
/// Checks if all clip/mask targets needs to be re-culled.
/// Setting this to true will force all clip/mask targets to update their culling state next frame.
///
public bool ForceClip
{
get
{
// This is an imprecise check if a clip or mask target gets added then removed on the same frame.
// But... the alternative is we reflect into m_ForceClip base member which would be a per frame allocation due to it being a value type.
// If this check is return false negatives in your scenario, then set ForceClip to true.
return clipTargets.Count != lastclipTargetsCount ||
maskableTargets.Count != lastmaskableTargetsCount;
}
set
{
if (value == true)
{
lastclipTargetsCount = 0;
lastmaskableTargetsCount = 0;
}
else
{
Initialize();
lastclipTargetsCount = clipTargets.Count;
lastmaskableTargetsCount = maskableTargets.Count;
}
}
}
///
/// Callback whenever the clip rect is mutated.
///
protected virtual void OnSetClipRect(MaskableGraphic maskableTarget) { }
private void Initialize()
{
// Check if we have already initialized.
if (clipTargets != null)
{
return;
}
// Many of the properties we need access to for clipping are not exposed. So, we have to do reflection to get access to them.
BindingFlags bindFlags = BindingFlags.Instance | BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Static;
clipTargets = (HashSet)typeof(RectMask2D).GetField("m_ClipTargets", bindFlags).GetValue(this);
maskableTargets = (HashSet)typeof(RectMask2D).GetField("m_MaskableTargets", bindFlags).GetValue(this);
}
private Canvas Canvas
{
get
{
if (cachedCanvas == null)
{
#if UNITY_2021_1_OR_NEWER
var list = ListPool