Struct Conversion 

pub struct Conversion {
    pub level: Level,
    pub compromises: Vec<Compromise>,
    pub refusals: Vec<Refusal>,
}

What a conversion produced, and what it cost.

Returned by the facade’s Document::to_pdfa whether or not the conversion succeeded: Conversion::refusals non-empty means no bytes were written and the file is unchanged, and an empty refusals with a non-empty Conversion::compromises means a file was written that is not the document that went in.

The three states are distinguishable without inspecting the byte count, which is the point — see Conversion::converted.

Fields

level: Level

The level converted to.

compromises: Vec<Compromise>

Everything the conversion did that changed the document’s meaning, in the order the pipeline did it.

Empty means the conversion was faithful: the file that came out draws what the file that went in drew.

refusals: Vec<Refusal>

Every compromise the policy did not authorize.

Non-empty means nothing was written. The conversion collects all of them rather than stopping at the first, so a caller can widen the policy once instead of discovering the obstacles one run at a time.

Implementations

impl Conversion

pub fn converted(&self) -> bool

Whether a file was written.

False exactly when Conversion::refusals is non-empty.

pub fn faithful(&self) -> bool

Whether a file was written and it draws what the input drew.

pub fn rasterized_pages(&self) -> Vec<u32>

The pages that were rendered to images, in page order.

The one compromise whose extent a caller almost always wants separately from the list, because it is the one that changes what a page fundamentally is.

Trait Implementations

impl Clone for Conversion

fn clone(&self) -> Conversion

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Conversion

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

Formats the value using the given formatter.

impl Display for Conversion

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

Formats the value using the given formatter.

impl Eq for Conversion

impl PartialEq for Conversion

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Conversion