Struct ExtractedLayer 

pub struct ExtractedLayer {

    pub main_entity: MainEntity,
    pub view_entity: Entity,
    pub retained: RetainedViewEntity,
    pub quad_entity: Entity,
    pub min: Vec2,
    pub size: UVec2,
    pub quad_clip: Option<Rect>,
    pub alpha: f32,
    pub target_format: TextureFormat,
    pub needs_capture: bool,
    pub chain: Option<ExtractedChain>,
    pub backdrop_chain: Option<ExtractedChain>,
    pub backdrop_quad_entity: Option<Entity>,
    pub outset: u32,
    pub corner_radius: [f32; 4],
    pub transform3d: Option<Mat4>,
    pub wants_mips: bool,
}

One promoted layer, as seen by the render world this frame.

Fields

main_entity: MainEntity

The layer root’s main-world entity (subtree identity).

view_entity: Entity

The synthetic capture view (render-world entity, lives one frame).

retained: RetainedViewEntity

The synthetic view’s phase key.

quad_entity: Entity

Render-world entity of the composite quad (carries LayerCompositeBatch after prepare).

min: Vec2

Capture anchor: fractional physical px, stock UI view space (top-left of the node’s border box — translation moves it without re-capturing).

size: UVec2

Capture texture size in whole texels.

quad_clip: Option<Rect>

The screen-space rect the composite quad clamps to (the layer root’s ancestor clipping, applied at composite time instead of capture time — see clip). None = unclipped.

alpha: f32

Composite-time group alpha.

target_format: TextureFormat

Color format of the camera target — capture textures must match, or the stolen items’ pipelines (specialized against the camera’s format) would be invalid for the capture pass.

needs_capture: bool

Whether this layer’s capture must re-render this frame. false = the persistent texture in LayerTextureStore already holds the correct pixels: the capture pass skips it, and its stolen phase items are dropped instead of re-drawn. Decided at extract time (main-world dirt ∪ missing/mismatched slot), then propagated up the enclosing chain — a re-capturing layer’s quad re-draws inside every enclosing capture.

chain: Option<ExtractedChain>

The layer root’s resolved filter chain, if any (always non-empty when present). Drives prepare_layer_filters; None clears the slot’s filter state (see FilterSlot).

backdrop_chain: Option<ExtractedChain>

The layer root’s resolved backdropFilter chain, if any (always non-empty and always_dirty when present — the source frame is live). Drives the backdrop snapshot + filter staging (backdrop::prepare_layer_backdrops); None clears the slot’s backdrop state.

backdrop_quad_entity: Option<Entity>

Render-world entity of the backdrop composite quad (the frosted underlay drawn one epsilon below the content quad). Spawned only when Self::backdrop_chain is present.

outset: u32

The quantized outset margin baked into min/size (LayerCaptureRect::outset). The backdrop quad shrinks by this to the un-inflated border box — frost must not paint in the outset ring.

corner_radius: [f32; 4]

The node’s layout-resolved corner radii, [top_left, top_right, bottom_right, bottom_left] physical px (from ComputedNode.border_radius — already clamped per corner to 0.5 * min(w, h), Bevy’s rule; matching what bevy_ui paints is the point). Consumed only by the backdrop quad’s uniform push: the frost is masked to the rounded border box. All-zero = square.

transform3d: Option<Mat4>

The layer’s composite-time 3D model matrix (screen-space homography, from LayerTransform3dMatrix). None = untransformed (absent style or identity params) — the quad takes the CPU clip path unchanged.

wants_mips: bool

Whether the layer carries the TRANSFORM3D promotion reason — its sampled texture allocates a mip chain (see mips). Keyed on the reason, not the matrix value: identity↔non-identity changes must never realloc/re-capture, and the chain stays warm for the first animated frame. Trilinear sampling itself engages only when Self::transform3d is Some AND the chain is valid.