LayerTreeHost Core Lifecycle and Commit Methods
Blink28618 Marras 2025

LayerTreeHost Core Lifecycle and Commit Methods

The provided text comprises extensive documentation of the LayerTreeHost class, a foundational component in a compositing system (likely Chromium's cc layer). It thoroughly details the object's lifecycle, beginning with LayerTreeHost::CreateThreaded and LayerTreeHost::CreateSingleThreaded static factory methods, which establish the host in multi-threaded or single-threaded operating modes. The documentation explains the purpose of various member functions, focusing heavily on thread management via the TaskRunnerProvider and ensuring main-thread affinity for most operations, such as accessing state and the UIResourceManager. Key mechanisms for controlling the frame production pipeline are covered, including methods for toggling visibility, managing the LayerTreeFrameSink (output surface), and various methods like SetNeedsCommit and SetNeedsAnimate that trigger frame updates and scheduling through a proxy object, along with systems for pausing rendering or deferring commits.

Jaksot(466)

cc::LayerImpl / PictureLayerImpl

cc::LayerImpl / PictureLayerImpl

Impl‑side layer objects that reference property‑tree nodes and emit draw quads from recorded paint (tiles).

22 Syys 202550min

cc::PropertyTrees

cc::PropertyTrees

(TransformTree / ClipTree / EffectTree / ScrollTree) with nodes cc::TransformNode / ClipNode / EffectNode / ScrollNode — The impl‑side property‑tree state that positions, clips, blends, and scrolls co...

22 Syys 202534min

cc::LayerTreeHostImpl

cc::LayerTreeHostImpl

The compositor‑thread twin that owns the active/pending trees, runs impl‑side animations/scroll, and prepares draw. Implements cc::InputHandler for threaded scrolling/pinch.

22 Syys 202546min

main —> impl cc::LayerTreeHost

main —> impl cc::LayerTreeHost

Packages updated layers/property trees; kicks a commit to the compositor thread (via the proxy).

22 Syys 202536min

blink::PropertyTreeManager

blink::PropertyTreeManager

Bridges Blink’s paint property trees into cc property trees: creates/updates cc TransformNode, ClipNode, EffectNode, and ScrollNode (including inner/outer viewport scroll nodes).

22 Syys 202539min

blink::PaintArtifactCompositor

blink::PaintArtifactCompositor

Decides what needs to be composited and prepares the main‑thread representation to feed cc (layers if needed, scrollbar compositing, etc.).

22 Syys 202542min

blink::PaintArtifact

blink::PaintArtifact

The immutable package of paint chunks + display items for this frame, used to drive compositing without re‑painting.

21 Syys 202536min

blink::TransformPaintPropertyNode / ClipPaintPropertyNode / EffectPaintPropertyNode / ScrollPaintPropertyNode

blink::TransformPaintPropertyNode / ClipPaintPropertyNode / EffectPaintPropertyNode / ScrollPaintPropertyNode

The paint property trees captured during painting (transform, clip, effect/opacity, scroll offset) that define visual & coordinate‑space state.

21 Syys 202541min