Struct PrimitiveDrawHeader 

pub struct PrimitiveDrawHeader {
    pub prim_instance_index: PrimitiveInstanceIndex,
    pub clip_chain: ClipChainInstance,
    pub state: DrawState,
    pub clip_task_index: ClipTaskIndex,
    pub kind_scratch: KindScratchHandle,
    pub segment_instance_index: Index<BrushSegmentation>,
    pub compositor_surface_kind: CompositorSurfaceKind,
    pub snapped_local_rect: LayoutRect,
}

Information stored for a visible primitive about the visible rect and associated clip information.

Fields

prim_instance_index: PrimitiveInstanceIndex

Back-reference to the prim instance this draw belongs to. Currently redundant with the identity-indexed lookup from scratch.frame.draws[PrimitiveInstanceIndex.0], but reserved for a follow-up that switches the storage to push-per-draw — readers iterating draws directly will need this to reach the instance.

clip_chain: ClipChainInstance

The clip chain instance that was built for this primitive.

state: DrawState

Current visibility state of the primitive.

clip_task_index: ClipTaskIndex

An index into the clip task instances array in the primitive store. If this is ClipTaskIndex::INVALID, then the primitive has no clip mask. Otherwise, it may store the offset of the global clip mask task for this primitive, or the first of a list of clip task ids (one per segment).

kind_scratch: KindScratchHandle

Per-kind scratch handle for this draw. Variant matches the drawn prim’s PrimitiveKind; None for kinds without per- frame scratch (e.g. ImageBorder, gradients, BackdropCapture, BoxShadow, Rectangle/YuvImage).

segment_instance_index: Index<BrushSegmentation>

Index into PrimitiveFrameScratch.segment_instances for prims that opt into segmented brush rendering (Rectangle, YuvImage, non-tiled Image). UNUSED for prims that don’t segment, or for the trivial single-segment case. Built fresh each frame in build_segments_if_needed.

compositor_surface_kind: CompositorSurfaceKind

Per-frame compositing decision for Image / YuvImage primitives. Set during the visibility pass by tile-cache promotion logic; Blit for kinds that aren’t candidates for compositor surfaces or for draws that didn’t get promoted this frame.

snapped_local_rect: LayoutRect

Local-space rect of the primitive after device-pixel snapping has been applied. Populated for every prim each frame by frame_snap::snap_frame_rects (snapping PrimitiveInstance.unsnapped_prim_rect against the current spatial tree) before any visibility / prepare consumer reads it.

Implementations

impl PrimitiveDrawHeader

pub fn new() -> Self

Allocate a fresh draw header. snapped_local_rect is left at zero here; the per-frame snap pass overwrites it before any consumer runs.

pub fn reset(&mut self)

Trait Implementations

impl Clone for PrimitiveDrawHeader

fn clone(&self) -> PrimitiveDrawHeader

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PrimitiveDrawHeader

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Serialize for PrimitiveDrawHeader

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for PrimitiveDrawHeader