Struct RenderReport 

#[non_exhaustive]
pub struct RenderReport {
    pub skipped: Vec<SkippedContent>,
    pub unlisted: u64,
}

What a page render could not reproduce faithfully: content dropped outright (an undecodable image, an unreadable form) and content painted as an approximation (a pattern fill as flat gray). Empty means every construct the render encountered was painted as the page describes it.

Two things are deliberately not reported, because they are configured behavior rather than a failure: text left unpainted by the requested GlyphPainting tier — its font never loaded — and content clipped or transformed off the page. A code a loaded font has no glyph for is a real loss and IS reported, as SkippedKind::Glyph.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

skipped: Vec<SkippedContent>

Distinct drops in the order first encountered, at most 64 entries (see count for repeats and RenderReport::unlisted for the overflow).

unlisted: u64

Drops that arrived after skipped reached its 64-entry cap and so are counted but not described.

Implementations

impl RenderReport

pub fn is_empty(&self) -> bool

Whether the page rasterized with nothing dropped or approximated.

pub fn summary(&self) -> Option<String>

A one-line human summary counting drops per kind, or None when nothing was dropped: "2 images, 1 shading skipped".

pub fn warnings(&self) -> Vec<String>

One human-readable line per distinct drop, for callers that warn about them: "1 image skipped: unsupported filter /JPXDecode".

Trait Implementations

impl Clone for RenderReport

fn clone(&self) -> RenderReport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RenderReport

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

Formats the value using the given formatter.

impl Default for RenderReport

fn default() -> RenderReport

Returns the “default value” for a type.

impl Eq for RenderReport

impl PartialEq for RenderReport

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RenderReport