Blink’s BoxFragmentPainter: The Orchestrator of Physical Fragment Painting

Chromium Animation Keyframe Snapshotting and Native Paint Worklets

The provided sources describe the specialized native paint worklet architecture used by Chromium to animate properties like background-color on the compositor thread. Unlike traditional properties that use keyframe snapshots to cache resolved values, this system generates a PaintWorkletInput during the paint phase to store color data and timing functions. The compositor then drives a simplified progress animation from 0 to 1, allowing a native C++ definition to interpolate colors and perform rasterization independently of the main thread. This approach bypasses the standard Blink style resolution for every frame, significantly improving performance for paint-heavy properties. If an animation’s parameters change, the system triggers a repaint to refresh the input data rather than updating ordinary compositor keyframes. Ultimately, this framework provides a robust handoff mechanism that enables complex painting tasks to behave like hardware-accelerated animations.

Web Animations Level 2

The provided sources detail the evolution and implementation of the Web Animations Level 2 (WA2) specification within the Chromium Blink rendering engine. Web Animations Level 2 is framed as a supplemental update rather than a full replacement, introducing a shift from simple time-based animations to a hierarchical tree model and progress-based timelines. The documentation distinguishes between stable features already integrated for scroll-driven animations, such as overallProgress and range-based offsets, and unstable components like grouping, sequencing, and exploratory custom effects. For Blink engineers, this transition necessitates a major architectural expansion to handle complex timing inheritances, non-monotonic timelines, and new compositor-thread synchronization challenges. The sources ultimately emphasize a staged implementation strategy that prioritizes finalized timing standards while deferring more speculative and high-risk elements of the draft.

Web Animations Level 1

The provided sources describe the Web Animations Level 1 specification and its technical implementation within the Blink rendering engine. This standard establishes a unified timing and animation model that synchronizes CSS transitions, CSS animations, and JavaScript-driven effects into a single coherent framework. Architecturally, Blink separates this process into two distinct stages: a timing model that calculates progress over time and an animation model that maps that progress to specific property values. To maintain high performance, the engine delegates eligible properties like transform and opacity to the compositor thread while keeping a main-thread counterpart for style accuracy. The documentation highlights the complexity of managing lifecycle states, promise ordering, and composite operations to ensure web compatibility. Ultimately, these sources serve as a comprehensive guide for developers to understand how the rendering pipeline processes animated content within the Chromium ecosystem.

Blink’s BoxFragmentPainter: The Orchestrator of Physical Fragment Painting

The provided sources describe BoxFragmentPainter, a critical orchestration class within the Blink rendering engine of Chromium. This class serves as a central hub for translating layout fragments into visual display items and interactive hit-test data. It manages complex responsibilities, including the painting of backgrounds, borders, and masks, while delegating specific tasks to specialized painters for text and inline content. Architecturally, it acts as a bridge between modern LayoutNG fragment trees and legacy layout object paths to ensure rendering compatibility. The documents highlight its role in a multi-phase paint pipeline, where it handles performance-sensitive tasks like culling and metadata recording for features such as scrolling and ad highlighting. Ultimately, the class ensures that CSS painting specifications and event-targeting behaviors are accurately executed across diverse web content.

The RasterInvalidator Pipeline and Lifecycle in Blink

The provided sources describe the role and function of the RasterInvalidator within the Blink rendering engine's lifecycle. Positioned as the final step of the painting process, this component acts as a per-layer diff engine that identifies which specific pixels of a composited layer require re-rasterization. It operates during the paint-to-compositor handoff, comparing new paint artifacts against previous snapshots to calculate damage after the document has reached a clean paint state. By determining the symmetric difference between old and new display items and chunks, it provides the compositor with precise damage rectangles via the SetNeedsDisplayRect API. This mechanism ensures rendering efficiency by allowing the system to refresh only changed regions rather than entire layers. Ultimately, the documentation distinguishes this process from the PrePaint phase, noting that while PrePaint decides what must be repainted, the RasterInvalidator determines what must be rerasterized at the compositor level.