Struct FrameTimestamps 

pub struct FrameTimestamps<'a> { /* private fields */ }

The per-frame timestamp sink the renderer records its pass boundaries through — a borrow of the host’s TimestampRing, or nothing at all.

Copy and one pointer wide, so it is threaded through the frame walk by value: every pass site asks it for its own timestamp_writes and takes None for an answer without a branch of its own. An inert sink (FrameTimestamps::default) is what an ordinary crate::EngineRenderer::encode passes, so the untimed frame path is the timed one with every answer None.

Implementations

impl<'a> FrameTimestamps<'a>

pub const fn inert() -> Self

A sink that times nothing.

pub fn new(ring: &'a TimestampRing) -> Self

A sink writing into ring, or an inert one when the ring is itself inert — a host holding a ring for a device without TIMESTAMP_QUERY records exactly the passes it always did.

pub fn is_active(&self) -> bool

Whether this sink writes anything at all.

pub fn writes(&self, span: EngineSpan) -> Option<RenderPassTimestampWrites<'a>>

The timestamp_writes for one pass belonging to span, or None for an untimed pass. Every call takes a fresh query pair, so a span made of several passes sums rather than overwriting itself.

Trait Implementations

impl<'a> Clone for FrameTimestamps<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for FrameTimestamps<'a>

impl<'a> Debug for FrameTimestamps<'a>

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

Formats the value using the given formatter.

impl<'a> Default for FrameTimestamps<'a>

fn default() -> Self

Returns the “default value” for a type.