Struct ImageBuilder 

pub struct ImageBuilder {
    pub source: ObjRef,
    pub matrix: Affine,
}

An image placement, ready to PageEdit::push.

The pixels are not supplied here: an image page object names an /XObject, and the regenerated stream writes /Name Do. Obtain the reference from PageEdit::image_of (an image the document already holds) or from EditDoc::embed_jpeg / EditDoc::embed_image (one this save is adding).

Fields

source: ObjRef

The image XObject.

matrix: Affine

Where it lands: the matrix mapping the unit square onto the page.

Affine::new([w, 0.0, 0.0, h, x, y]) places a w by h image with its lower-left corner at (x, y).

Implementations

impl ImageBuilder

pub fn at(source: ObjRef, rect: Rect) -> Self

Place source in the rectangle rect.

The image is stretched onto rect; nothing preserves its aspect ratio, so a caller that wants it kept sizes rect from EmbeddedImage::width and EmbeddedImage::height.

pub fn build(self) -> PageObject

The page object this describes.

The pixels are a one-by-one placeholder: a regenerated stream writes a Do naming the source, and never looks at them. Rendering the edited graph before saving would show the placeholder rather than the image, so render the saved file to see the result.

Trait Implementations

impl Clone for ImageBuilder

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageBuilder

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

Formats the value using the given formatter.

impl PartialEq for ImageBuilder

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ImageBuilder