Struct SlideMedia 

pub struct SlideMedia {
    pub id: u32,
    pub name: String,
    pub data: Vec<u8>,
    pub format: MediaFormat,
    pub offset_emu: (i64, i64),
    pub extent_emu: (i64, i64),
    pub poster_image: Option<(Vec<u8>, PictureFormat)>,
}

An embedded video or audio clip (<p:pic> carrying an <a:videoFile r:link=".">/<a:audioFile r:link="."> reference in its own <p:nvPr>, instead of the plain <a:blip> image an ordinary Picture has).

Real PowerPoint (2010+) also writes a Microsoft-proprietary <p:extLst><p:ext><p14:media r:embed=".."/></p:ext></p:extLst> alongside the core <a:videoFile>/<a:audioFile> element, referencing the same media part a second time for its own newer UI features — not modeled here (an extension outside ECMA-376 itself, same “skip Microsoft-only extensions” posture this crate already takes for <a:extLst> generally); the core relationship alone is schema-complete and should still play in real PowerPoint.

<p:timing> (autoplay/on-click trigger, bookmarks, trim points) lives at the slide level, not on the shape itself, and is a materially larger, separate feature — not modeled. Unlike Picture, this type has no shape_properties field: the writer always produces a plain default rectangle (<a:prstGeom prst="rect">, no custom fill/ line), and any non-default geometry/fill/line an existing file’s own <p:pic> might carry is simply discarded when read back — a video/audio clip’s own outline styling is a rare, cosmetic refinement didn’t ask for.

Fields

id: u32

<p:cNvPr id=".."> — same uniqueness rules as AutoShape::id.

name: String

<p:cNvPr name="..">.

data: Vec<u8>

The raw, encoded media bytes (e.g. the bytes of a .mp4 file).

format: MediaFormat

The media’s encoding, also used to pick the media part’s extension/ content type and to tell video from audio (format.is_video()).

offset_emu: (i64, i64)

<a:off x=".." y="..">, in EMUs — same “never optional, no separate anchor” posture as Picture::offset_emu.

extent_emu: (i64, i64)

<a:ext cx=".." cy="..">, in EMUs.

poster_image: Option<(Vec<u8>, PictureFormat)>

This clip’s poster frame (<p:blipFill>’s own <a:blip>, the still image real PowerPoint shows before playback) — the raw image bytes plus its format. None omits <a:blip> from <p:blipFill> entirely (schema-valid — blip is minOccurs="0" — but the clip will render with no visible thumbnail until played).

Implementations

impl SlideMedia

pub fn new( id: u32, name: impl Into<String>, data: impl Into<Vec<u8>>, format: MediaFormat, width_emu: i64, height_emu: i64, ) -> SlideMedia

Creates a media clip at the given size, positioned at (0, 0), with no poster frame.

Examples found in repository

examples/pptx_media.rs (lines 49-56)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_media.pptx");
    let image_bytes = std::fs::read(image_fixture_path())?;

    let embedded_picture = Picture::new(
        2,
        "Embedded picture",
        image_bytes.clone(),
        PictureFormat::Png,
        3_000_000,
        2_000_000,
    )
    .with_offset(838_200, 838_200)
    .with_description("Project test image");

    let linked_picture = Picture::new(
        2,
        "Externally linked picture",
        image_bytes,
        PictureFormat::Png,
        3_000_000,
        2_000_000,
    )
    .with_offset(838_200, 838_200)
    .with_external_link("https://example.com/original-image.png");

    // Placeholder bytes — a real .pptx would carry a genuine video file
    // here. This example only demonstrates the model/writer plumbing.
    let poster_image = vec![0x89, 0x50, 0x4E, 0x47]; // fake, just enough bytes to have *some* data
    let media = SlideMedia::new(
        2,
        "Video clip",
        vec![0u8; 16],
        MediaFormat::Mp4,
        4_000_000,
        2_250_000,
    )
    .with_offset(838_200, 838_200)
    .with_poster_image(poster_image, PictureFormat::Png);

    let chart = SlideChart::new(
        2,
        "Quarterly revenue",
        sample_chart_space(),
        6_000_000,
        3_500_000,
    )
    .with_offset(838_200, 838_200);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Picture(embedded_picture)))
        .with_slide(Slide::new().with_shape(Shape::Picture(linked_picture)))
        .with_slide(Slide::new().with_shape(Shape::Media(media)))
        .with_slide(Slide::new().with_shape(Shape::Chart(Box::new(chart))));

    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());
    Ok(())
}

pub fn with_offset(self, x_emu: i64, y_emu: i64) -> SlideMedia

Sets this clip’s position.

Examples found in repository

examples/pptx_media.rs (line 57)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_media.pptx");
    let image_bytes = std::fs::read(image_fixture_path())?;

    let embedded_picture = Picture::new(
        2,
        "Embedded picture",
        image_bytes.clone(),
        PictureFormat::Png,
        3_000_000,
        2_000_000,
    )
    .with_offset(838_200, 838_200)
    .with_description("Project test image");

    let linked_picture = Picture::new(
        2,
        "Externally linked picture",
        image_bytes,
        PictureFormat::Png,
        3_000_000,
        2_000_000,
    )
    .with_offset(838_200, 838_200)
    .with_external_link("https://example.com/original-image.png");

    // Placeholder bytes — a real .pptx would carry a genuine video file
    // here. This example only demonstrates the model/writer plumbing.
    let poster_image = vec![0x89, 0x50, 0x4E, 0x47]; // fake, just enough bytes to have *some* data
    let media = SlideMedia::new(
        2,
        "Video clip",
        vec![0u8; 16],
        MediaFormat::Mp4,
        4_000_000,
        2_250_000,
    )
    .with_offset(838_200, 838_200)
    .with_poster_image(poster_image, PictureFormat::Png);

    let chart = SlideChart::new(
        2,
        "Quarterly revenue",
        sample_chart_space(),
        6_000_000,
        3_500_000,
    )
    .with_offset(838_200, 838_200);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Picture(embedded_picture)))
        .with_slide(Slide::new().with_shape(Shape::Picture(linked_picture)))
        .with_slide(Slide::new().with_shape(Shape::Media(media)))
        .with_slide(Slide::new().with_shape(Shape::Chart(Box::new(chart))));

    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());
    Ok(())
}

pub fn with_poster_image( self, data: impl Into<Vec<u8>>, format: PictureFormat, ) -> SlideMedia

Sets this clip’s poster frame image.

Examples found in repository

examples/pptx_media.rs (line 58)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_media.pptx");
    let image_bytes = std::fs::read(image_fixture_path())?;

    let embedded_picture = Picture::new(
        2,
        "Embedded picture",
        image_bytes.clone(),
        PictureFormat::Png,
        3_000_000,
        2_000_000,
    )
    .with_offset(838_200, 838_200)
    .with_description("Project test image");

    let linked_picture = Picture::new(
        2,
        "Externally linked picture",
        image_bytes,
        PictureFormat::Png,
        3_000_000,
        2_000_000,
    )
    .with_offset(838_200, 838_200)
    .with_external_link("https://example.com/original-image.png");

    // Placeholder bytes — a real .pptx would carry a genuine video file
    // here. This example only demonstrates the model/writer plumbing.
    let poster_image = vec![0x89, 0x50, 0x4E, 0x47]; // fake, just enough bytes to have *some* data
    let media = SlideMedia::new(
        2,
        "Video clip",
        vec![0u8; 16],
        MediaFormat::Mp4,
        4_000_000,
        2_250_000,
    )
    .with_offset(838_200, 838_200)
    .with_poster_image(poster_image, PictureFormat::Png);

    let chart = SlideChart::new(
        2,
        "Quarterly revenue",
        sample_chart_space(),
        6_000_000,
        3_500_000,
    )
    .with_offset(838_200, 838_200);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Picture(embedded_picture)))
        .with_slide(Slide::new().with_shape(Shape::Picture(linked_picture)))
        .with_slide(Slide::new().with_shape(Shape::Media(media)))
        .with_slide(Slide::new().with_shape(Shape::Chart(Box::new(chart))));

    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());
    Ok(())
}

Trait Implementations

impl Clone for SlideMedia

fn clone(&self) -> SlideMedia

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SlideMedia

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

Formats the value using the given formatter.

impl PartialEq for SlideMedia

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SlideMedia