UI Toolkit performance debugging#

Use PanelSettings.SetPanelChangeReceiver to receive every change event. Comparing the timing of events with captures from the Profiler you can get a good picture of what change is causing hitches.

Common performance pitfalls#

• Adding or removing a class on an element with many children.
  • In this case, prefer using inline styles where possible.
• Using nested masks.
  • Apply UsageHint.MaskContainer on the root of the mask to reset batching.
• Moving an element frequently.
  • Apply UsageHint.DynamicTransform so transform calculations are performed on the GPU.
• Moving an element and its children frequently.
  • Apply UsageHint.GroupTransform and UsageHint.DynamicTransform to its children.
• Using more than 7 unique textures in one UI area.
  • Use a Sprite Atlas to group your textures as one.
  • Configure the Dynamic Atlas Settings on the Panel Settings asset to better encompass your textures.
• Abusing frequently-called events like GeometryChangedEvent.

See also#

• Getting the best performance with UI Toolkit | Unite 2024