Struct PictureImage 

pub struct PictureImage {
    pub mimetype: String,
    pub width: u32,
    pub height: u32,
    pub data: Vec<u8>,
    pub dpi: u32,
    pub display_size: Option<[f32; 2]>,
}

An extracted picture’s raw encoded bytes plus its mimetype and pixel size — the docling.rs analogue of docling-core’s ImageRef.

Fields

mimetype: String

e.g. image/png, image/jpeg.

width: u32

height: u32

data: Vec<u8>

The image file bytes, exactly as embedded (PNG/JPEG/…).

dpi: u32

Pixels per inch of the image relative to the page it came from — docling-core’s ImageRef.dpi, which consumers use to map pixels back to points. A crop rendered from a PDF page at s px/pt is 72·s (docling: int(72 * images_scale), #519); an image embedded in an office file has no render scale and keeps docling’s 72 (Self::DEFAULT_DPI).

display_size: Option<[f32; 2]>

The size the picture is displayed at in its document, in inches ([width, height], #834): a DOCX drawing’s wp:extent, an ODT frame’s svg:width / svg:height — not the bitmap’s pixel size above, which docling’s ImageRef.size carries. None when the format has no such extent (a PDF crop, a standalone image). The Pandoc export writes it as the Image’s width / height attributes, as Pandoc’s own readers do; docling’s JSON has no field for it, so the JSON export leaves it out.

Implementations

impl PictureImage

pub const DEFAULT_DPI: u32 = 72

docling’s ImageRef default when no render scale applies.

pub fn dpi_for_scale(scale: f32) -> u32

The dpi of an image rendered at scale pixels per PDF point (72·scale, rounded — int() would floor 143.99… to 143).

pub fn data_uri(&self) -> String

A data: URI for the image (data:<mimetype>;base64,<…>).

Trait Implementations

impl Clone for PictureImage

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 PictureImage

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

Formats the value using the given formatter.

impl PartialEq for PictureImage

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PictureImage