Struct PresentStats 

pub struct PresentStats {
    pub buffer_age: u8,
    pub with_damage: bool,
    pub bytes_copied: u64,
    pub surface_width: u32,
    pub surface_height: u32,
    pub raster: Duration,
    pub acquire: Duration,
    pub present: Duration,
    pub renderer: &'static str,
}

What the last present did.

The platform records one of these after every frame it presents and, when the window was opened with a PresentStatsHandle, publishes it there for the application to read.

Fields

buffer_age: u8

The buffer age the platform reported, in presents.

An age of 0 means the buffer contents were unknown and the present copied the whole surface.

with_damage: bool

Whether the present carried only the damaged region.

A present without damage copied and presented the whole surface.

bytes_copied: u64

How many surface bytes the present copied from the renderer’s pixmap.

Four bytes per pixel, so a full present of a 100 by 100 surface copies 40,000 bytes. The GPU path reports none: it draws straight onto the window surface and copies no pixmap.

surface_width: u32

The width of the presented surface in physical pixels.

surface_height: u32

The height of the presented surface in physical pixels.

raster: Duration

How long the renderer took to paint this frame’s damage into its surface.

On the GPU path this is the whole draw, whose submission reaches the GPU asynchronously.

acquire: Duration

How long the platform waited for a free window buffer before the present could start.

A compositor that still holds the previous buffers makes this wait, often for up to one display refresh. It is time spent blocked, not work.

present: Duration

How long the present took, from holding a free window buffer to handing it back to the platform: the copy and the submission, without the wait that PresentStats::acquire holds.

renderer: &'static str

Which renderer presented the frame, as its name: cpu or gpu.

Empty until the first present.

Trait Implementations

impl Clone for PresentStats

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PresentStats

impl Debug for PresentStats

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

Formats the value using the given formatter.

impl Default for PresentStats

fn default() -> Self

Returns the “default value” for a type.

impl Eq for PresentStats

impl PartialEq for PresentStats

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PresentStats