我的notion笔记

• Graphic 和Layout 组件都依赖于CanvasUpdateRegistry 类，它不在Unity编辑器的界面中公开。此类跟踪必须更新的Layout 组件和Graphic 组件集，并在其关联的Canvas 调用willRenderCanvases事件时根据需要触发更新。[引用自官方文档]

单例

申明了一个CanvasUpdateRegistry类型的instance单例类

/// <summary>
/// Get the singleton registry instance.
/// </summary>
public static CanvasUpdateRegistry instance
{
    get
    {
        if (s_Instance == null)
            s_Instance = new CanvasUpdateRegistry();
        return s_Instance;
    }
}

跟踪

m_LayoutRebuildQueue

private readonly IndexedSet<ICanvasElement> m_LayoutRebuildQueue = new IndexedSet<ICanvasElement>();

1. 通过 InternalRegisterCanvasElementForLayoutRebuild接口将 ICanvasElement 加入m_LayoutRebuildQueue，不会重复添加，外界通过调用静态函数RegisterCanvasElementForLayoutRebuild将ICanvasElement加入队列

2. 关于 IndexedSet

3. 外部添加途径

   1. Scrollbar的OnValidate接口， ScrollRect的OnEnable、SetDirtyCaching接口，Slider的OnValidate接口，Toggle的OnValidate接口：调用RegisterCanvasElementForLayoutRebuild注册
   2. LayoutRebuild的MarkLayoutRootForRebuild静态方法调用TryRegisterCanvasElementForLayoutRebuild注册，MarkLayoutRootForRebuild又只在其MarkLayoutForRebuild接口中调用。而

   LayoutRebuilder.MarkLayoutForRebuild(rectTransform);
   

   在需要更新位置、大小的组件里被调用（通常在onenable、setdirty中）

m_GraphicRebuildQueue

private readonly IndexedSet<ICanvasElement> m_GraphicRebuildQueue = new IndexedSet<ICanvasElement>();

1. 同1，不同的是：不会根据是否添加过返回false
2. 同上2
3. 增加了m_PerformingGraphicUpdate参数，控制添加元素，正在执行m_GraphicRebuildQueue中元素的rebuild时，不允许添加/移除新的元素
4. 外部添加途径：只有Graphic中几个设置dirty的地方主动调用了:SetVerticesDirty、SetMaterialDirty、OnCullingChanged、MarkGeometryAsDirty

CanvasUpdateRegistry.RegisterCanvasElementForGraphicRebuild(this);

调用

PerformUpdate

注册进委托

在构造函数中，将PerformUpdate添加进Canvas.willRenderCanvases

protected CanvasUpdateRegistry()
{
    Canvas.willRenderCanvases += PerformUpdate;
}

• *Canvas.SendWillRenderCanvases* 包含对订阅到Canvas组件的willRenderCanvases事件的C脚本的调用。Unity UI的CanvasUpdateRegistry类接收此事件，并使用它运行前面描述的重建过程。预计任何脏UI组件都会在此时更新其画布呈现器。

执行

1. 调用CleanInvalidItems，从上面2个数组中移除null或者IsDestroyed的对象，IsDestroyed的对象会调用一次其LayoutComplete接口
2. 设置m_PerformingLayoutUpdate = true，表示在执行layout的update，避免在执行时有layout被从数组中移除
3. m_LayoutRebuildQueue.Sort(s_SortLayoutFunction);排序，按照父节点数量从少到多排序。官方文档也解释了排序原因：
   • 在GameObject层次结构中靠近根的布局可能会改变嵌套在其中的任何布局的位置和大小，因此必须首先计算。
4. 遍历3次（Prelayout、Layout、PostLayout）m_LayoutRebuildQueue，调用其rebuild接口
5. 再次遍历m_LayoutRebuildQueue，调用LayoutComplete接口
6. 清空m_LayoutRebuildQueue
7. m_PerformingLayoutUpdate = false
8. ClipperRegistry.instance.Cull();执行裁剪
9. m_PerformingGraphicUpdate = true;防止在执行过程中对数组添加和删除
10. 遍历2次（PreRender、LatePreRender）m_GraphicRebuildQueue，调用Rebuild接口
11. 再次遍历m_GraphicRebuildQueue，调用GraphicUpdateComplete接口
12. 清空m_GraphicRebuildQueue
13. m_PerformingGraphicUpdate = false;

ClipperRegistry

Registry class to keep track of all IClippers that exist in the scene

This is used during the CanvasUpdate loop to cull clippable elements. The clipping is called after layout, but before Graphic update.

实现和CanvasUpdateRegistry类似，一个m_Clippers的IndexedSet<IClipper>，保存可裁剪对象，不同的是，m_Clippers不会主动清空。目前专门给RectMask2D用的，在OnEnable将自身添加进数组，OnDisable时反注册

执行时机是上文的步骤8，在layout更新后，Graphic更新前执行