pub struct BlipFill {
pub relationship_id: Option<String>,
pub mode: Option<BlipFillMode>,
pub crop: Option<CropRect>,
}Expand description
An image fill (<a:blipFill>, CT_BlipFillProperties). Confirmed against dml-picture.xsd’s
CT_Picture (nvPicPr/ blipFill/spPr) that this is the same type PowerPoint/Word/Excel all
use both for a real picture shape’s own always-present fill and for texturing an ordinary
shape with an image (EG_FillProperties’s blipFill choice, alongside noFill/solidFill/..)
— one model, Fill::Image, covers both uses.
The embedded-image reference, the stretch/tile choice, and cropping (<a:srcRect>, point 6) are
modeled. Not modeled: <a:duotone>/<a:lum>/other <a:blip> image effects, dpi/
rotWithShape attributes, and EG_FillModeProperties’s own fine-grained tiling/stretching
sub-rects (<a:tile>’s tx/ty/sx/ sy/flip/algn, <a:stretch>’s <a:fillRect>) —
all cosmetic refinements on top of “which image, does it stretch or tile, and is it cropped”.
Resolving the embedded image’s actual bytes is deliberately not this crate’s job: <a:blip r:embed="..">’s value is a bare relationship id (AG_Blob, confirmed in dml-main.xsd) —
drawing carries that id as a plain string, the same way it carries every other host-specific
reference (none, so far), and leaves resolving it through an actual OPC package/relationship set
to whichever host crate ends up consuming this (see word-ooxml::Image’s own r:embed handling
for the precedent this will eventually be generalized from).
Fields§
§relationship_id: Option<String><a:blip r:embed=".."> — the embedded image’s relationship id. None omits <a:blip>
entirely (a blipFill with no image set — unusual, but not schema-invalid, blip being
minOccurs="0").
mode: Option<BlipFillMode>EG_FillModeProperties — <a:stretch/> or <a:tile/>. None omits the choice entirely
(Office’s own default is an implicit stretch-to-fill).
crop: Option<CropRect><a:srcRect> (CT_RelativeRect) — crops the source image before it’s stretched/tiled into
the shape. None omits the element entirely (no cropping — the whole image is used), the
common case.