Struct Presentation 

pub struct Presentation {
    pub slides: Vec<Slide>,
    pub slide_width_emu: i64,
    pub slide_height_emu: i64,
    pub theme: Option<Theme>,
    pub properties: DocumentProperties,
    pub table_styles: Vec<SlideTableStyle>,
    pub embedded_fonts: Vec<EmbeddedFont>,
}

A .pptx presentation: an ordered list of slides, plus the slide size.

A real PowerPoint package also always carries a slide master, at least one slide layout, and a theme — but this crate has no customizable model for the slide master/layout (still a single minimal, fixed pair under the hood; the reader ignores their content entirely, it only resolves each slide’s own shapes). The theme, however, is customizable (theme) — unlike the master/layout, a slide master’s theme relationship is mandatory per ECMA-376 but its actual color/font content is the single most visible piece of a deck’s visual identity, so it gets its own model rather than staying permanently fixed like excel-ooxml’s theme.

Fields

slides: Vec<Slide>

The slides, in display order.

slide_width_emu: i64

<p:sldSz cx=".." cy="..">, in EMUs.

slide_height_emu: i64

theme: Option<Theme>

This presentation’s color/font theme. None (the default) still always produces a complete ppt/theme/theme1.xml — the part itself is mandatory, not optional, unlike e.g. word-ooxml::Document.theme — just with Office’s own built-in default colors/fonts (Theme::office_default) rather than a caller-supplied palette.

properties: DocumentProperties

Document metadata (docProps/core.xml/app.xml/custom.xml). Ports excel-ooxml’s own DocumentProperties posture unchanged (same fields, same “each None/empty stays an omitted, schema-valid element/part” behavior).

table_styles: Vec<SlideTableStyle>

Package-wide custom table styles (ppt/tableStyles.xml’s own <a:tblStyle> entries, beyond the single fixed built-in one this crate always declares as def). Referenced by id from SlideTable::style_id. An empty Vec (the default) means every table in this presentation uses the fixed built-in style, unchanged.

embedded_fonts: Vec<EmbeddedFont>

TrueType/OpenType fonts embedded directly in the package (ppt/fonts/fontN.fntdata, <p:embeddedFontLst>). Lets a presentation carry a non-standard font so it renders correctly even on a machine that doesn’t have that font installed. An empty Vec (the default) omits <p:embeddedFontLst> entirely and leaves <p:presentation>’s own embedTrueTypeFonts attribute unset, same “only write what was actually set” convention as every other optional part in this crate.

Implementations

impl Presentation

pub fn new() -> Presentation

Creates an empty presentation (no slides), with the default 16:9 widescreen slide size and no custom theme (Office’s own built-in default colors/fonts are used).

Examples found in repository

examples/hello_world_pptx.rs (line 32)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("hello_world.pptx");

    let text_box = AutoShape::new(2, "Hello box")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 1_365_250)
                    .with_extent(7_772_400, 1_200_150),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Hello, world!"))),
        );

    // `Presentation` and `Slide` both come from `office_toolkit::prelude`.
    let presentation =
        Presentation::new().with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)));
    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());

    // Read the file back to confirm it is a valid .pptx.
    let reopened = Presentation::open_file(&path)?;
    println!("Slide count: {}", reopened.slides.len());

    Ok(())
}

examples/pptx_notes_and_comments.rs (line 59)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_notes_and_comments.pptx");

    let title = |text: &str| {
        AutoShape::new(2, "Title")
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(8_000_000, 1_000_000),
                ),
            )
            .with_text_body(
                TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(text))),
            )
    };

    let notes_slide = Slide::new()
        .with_shape(Shape::AutoShape(title("A slide with speaker notes")))
        .with_notes(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text("Remember to mention the Q3 numbers here.")),
            ),
        );

    let commented_slide = Slide::new()
        .with_shape(Shape::AutoShape(title("A slide with reviewer comments")))
        .with_comment(
            SlideComment::new(
                "Reviewer",
                "RV",
                "2026-07-21T10:00:00",
                "This claim needs a source.",
            )
            .with_position(1_000_000, 2_000_000),
        )
        .with_comment(
            SlideComment::new(
                "Editor",
                "ED",
                "2026-07-21T11:30:00",
                "Looks good otherwise.",
            )
            .with_position(3_000_000, 2_000_000),
        );

    let presentation = Presentation::new()
        .with_slide(notes_slide)
        .with_slide(commented_slide);

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

examples/pptx_media.rs (line 69)

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(())
}

examples/pptx_tables.rs (line 76)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_tables.pptx");

    let plain_table = SlideTable::new(2, "Plain table", 5_000_000, 1_500_000)
        .with_offset(838_200, 838_200)
        .with_column_widths(vec![2_500_000, 2_500_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Name"))
                .with_cell(cell("Score")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Alice"))
                .with_cell(cell("92")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Bob"))
                .with_cell(cell("87")),
        );

    let merged_table = SlideTable::new(2, "Merged cells", 5_000_000, 1_000_000)
        .with_offset(838_200, 838_200)
        .with_column_widths(vec![1_667_000, 1_667_000, 1_666_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Spanning header").with_horizontal_span(3))
                .with_cell(TableCell::horizontally_merged())
                .with_cell(TableCell::horizontally_merged()),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("A"))
                .with_cell(cell("B"))
                .with_cell(cell("C")),
        );

    let styled_table = SlideTable::new(2, "Styled table", 5_000_000, 1_500_000)
        .with_offset(838_200, 838_200)
        .with_style_id("{66BB4812-77A1-49B3-BDF9-0CCEB564D7B5}")
        .with_style_first_row(true)
        .with_style_band_rows(true)
        .with_column_widths(vec![2_500_000, 2_500_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Header A"))
                .with_cell(cell("Header B")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("1"))
                .with_cell(cell("2")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("3"))
                .with_cell(cell("4")),
        );

    let presentation = Presentation::new()
        .with_table_style(
            SlideTableStyle::new(
                "{66BB4812-77A1-49B3-BDF9-0CCEB564D7B5}",
                "Custom Table Style",
            )
            .with_first_row(
                TableStylePart::new()
                    .with_fill(Fill::Solid(Color::Rgb("2E74B5".to_string())))
                    .with_bold(true)
                    .with_text_color(Color::Rgb("FFFFFF".to_string())),
            )
            .with_band1_horizontal(
                TableStylePart::new().with_fill(Fill::Solid(Color::Rgb("F2F2F2".to_string()))),
            ),
        )
        .with_slide(Slide::new().with_shape(Shape::Table(plain_table)))
        .with_slide(Slide::new().with_shape(Shape::Table(merged_table)))
        .with_slide(Slide::new().with_shape(Shape::Table(styled_table)));

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

examples/pptx_shapes_and_placeholders.rs (line 83)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_shapes_and_placeholders.pptx");

    let plain_shape = AutoShape::new(2, "Plain autoshape")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("A plain autoshape."))),
        );

    let text_box = AutoShape::new(2, "Text box")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("A genuine text box (txBox=\"1\").")),
        ));

    let title = AutoShape::new(2, "Title placeholder")
        .with_placeholder(Placeholder::new(PlaceholderKind::CenterTitle))
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(10_515_600, 1_325_563),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Title placeholder"))),
        );
    let subtitle =
        AutoShape::new(3, "Subtitle placeholder")
            .with_placeholder(Placeholder::new(PlaceholderKind::SubTitle).with_index(1))
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 2_400_000)
                        .with_extent(10_515_600, 800_000),
                ),
            )
            .with_text_body(TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text("Subtitle placeholder")),
            ));

    let hyperlinked_shape = AutoShape::new(2, "Hyperlinked shape")
        .with_hyperlink("https://www.rust-lang.org")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("Click this shape to open a link.")),
        ));

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(plain_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(title))
                .with_shape(Shape::AutoShape(subtitle)),
        )
        .with_slide(Slide::new().with_shape(Shape::AutoShape(hyperlinked_shape)));

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

examples/pptx_theme_and_metadata.rs (line 79)

fn main() -> office_toolkit::Result<()> {
    // A custom theme and an embedded font. `Theme`/`ColorScheme`/
    // `FontScheme` have no `with_*` builders in this crate — only
    // `office_default()` or plain struct literals.
    let custom_theme = Theme {
        name: "Custom Brand".to_string(),
        colors: ColorScheme {
            dark1: "1B1B1B".to_string(),
            light1: "FFFFFF".to_string(),
            dark2: "0A2540".to_string(),
            light2: "F5F5F5".to_string(),
            accent1: "0A2540".to_string(),
            accent2: "E8622C".to_string(),
            accent3: "2E86AB".to_string(),
            accent4: "6FB98F".to_string(),
            accent5: "F4A259".to_string(),
            accent6: "8E4585".to_string(),
            hyperlink: "1155CC".to_string(),
            followed_hyperlink: "6B3FA0".to_string(),
        },
        fonts: FontScheme {
            major_latin: "Georgia".to_string(),
            minor_latin: "Verdana".to_string(),
        },
    };

    // Placeholder bytes — a real .pptx would carry genuine TrueType/
    // OpenType font data here.
    let embedded_font = EmbeddedFont::new("Custom Sans")
        .with_regular(vec![0u8; 16])
        .with_bold(vec![0u8; 16]);

    // A slide with no shapes at all renders as a blank page — nothing shows
    // the custom theme actually took effect. `drawing::Color` has no
    // scheme-relative variant yet (`<a:schemeClr>` isn't modeled, see that
    // enum's own doc comment), so this can't reference the theme's accent1
    // symbolically; it uses the same literal hex values the theme itself
    // was built from, purely so the slide visibly matches the palette above.
    let title_shape = AutoShape::new(2, "Title")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(6_000_000, 1_500_000),
                )
                .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.accent1.clone()))),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text_with_properties(
                    "Custom Brand theme — Georgia / Verdana, accent1 = #0A2540",
                    TextRunProperties::new()
                        .with_font_family(custom_theme.fonts.major_latin.clone())
                        .with_font_size_points(24.0)
                        .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.light1.clone()))),
                )),
            ),
        );

    let themed_presentation = Presentation::new()
        .with_theme(custom_theme)
        .with_embedded_font(embedded_font)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(title_shape)));
    let theme_path = output_path("pptx_theme.pptx");
    themed_presentation.save_to_file(&theme_path)?;
    println!("Wrote {}", theme_path.display());

    // Document metadata (docProps/core.xml, app.xml, and custom.xml).
    let properties = DocumentProperties::new()
        .with_title("Metadata example")
        .with_author("Example Author")
        .with_subject("Presentation-level features")
        .with_custom_property(
            "ProjectCode",
            CustomPropertyValue::Text("PPTX-META".to_string()),
        );
    // Same reasoning as `title_shape` above: an empty slide would render
    // blank, so a text shape spells out where the metadata actually lives.
    let metadata_shape = AutoShape::new(2, "Note")
        .with_properties(ShapeProperties::new().with_transform(Transform2D::new().with_offset(838_200, 838_200).with_extent(7_000_000, 1_000_000)))
        .with_text_body(TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(
            "This presentation's metadata is in File > Info (title, author, subject, and a custom \"ProjectCode\" property) — not on this slide.",
        ))));
    let metadata_presentation = Presentation::new()
        .with_properties(properties)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(metadata_shape)));
    let metadata_path = output_path("pptx_metadata.pptx");
    metadata_presentation.save_to_file(&metadata_path)?;
    println!("Wrote {}", metadata_path.display());

    Ok(())
}

Additional examples can be found in:

• examples/pptx_grouping_and_connectors.rs
• examples/pptx_text_formatting.rs

pub fn with_slide(self, slide: Slide) -> Presentation

Appends a slide.

Examples found in repository

examples/hello_world_pptx.rs (line 32)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("hello_world.pptx");

    let text_box = AutoShape::new(2, "Hello box")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 1_365_250)
                    .with_extent(7_772_400, 1_200_150),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Hello, world!"))),
        );

    // `Presentation` and `Slide` both come from `office_toolkit::prelude`.
    let presentation =
        Presentation::new().with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)));
    presentation.save_to_file(&path)?;
    println!("Wrote {}", path.display());

    // Read the file back to confirm it is a valid .pptx.
    let reopened = Presentation::open_file(&path)?;
    println!("Slide count: {}", reopened.slides.len());

    Ok(())
}

examples/pptx_notes_and_comments.rs (line 60)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_notes_and_comments.pptx");

    let title = |text: &str| {
        AutoShape::new(2, "Title")
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(8_000_000, 1_000_000),
                ),
            )
            .with_text_body(
                TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(text))),
            )
    };

    let notes_slide = Slide::new()
        .with_shape(Shape::AutoShape(title("A slide with speaker notes")))
        .with_notes(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text("Remember to mention the Q3 numbers here.")),
            ),
        );

    let commented_slide = Slide::new()
        .with_shape(Shape::AutoShape(title("A slide with reviewer comments")))
        .with_comment(
            SlideComment::new(
                "Reviewer",
                "RV",
                "2026-07-21T10:00:00",
                "This claim needs a source.",
            )
            .with_position(1_000_000, 2_000_000),
        )
        .with_comment(
            SlideComment::new(
                "Editor",
                "ED",
                "2026-07-21T11:30:00",
                "Looks good otherwise.",
            )
            .with_position(3_000_000, 2_000_000),
        );

    let presentation = Presentation::new()
        .with_slide(notes_slide)
        .with_slide(commented_slide);

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

examples/pptx_media.rs (line 70)

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(())
}

examples/pptx_tables.rs (line 92)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_tables.pptx");

    let plain_table = SlideTable::new(2, "Plain table", 5_000_000, 1_500_000)
        .with_offset(838_200, 838_200)
        .with_column_widths(vec![2_500_000, 2_500_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Name"))
                .with_cell(cell("Score")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Alice"))
                .with_cell(cell("92")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Bob"))
                .with_cell(cell("87")),
        );

    let merged_table = SlideTable::new(2, "Merged cells", 5_000_000, 1_000_000)
        .with_offset(838_200, 838_200)
        .with_column_widths(vec![1_667_000, 1_667_000, 1_666_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Spanning header").with_horizontal_span(3))
                .with_cell(TableCell::horizontally_merged())
                .with_cell(TableCell::horizontally_merged()),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("A"))
                .with_cell(cell("B"))
                .with_cell(cell("C")),
        );

    let styled_table = SlideTable::new(2, "Styled table", 5_000_000, 1_500_000)
        .with_offset(838_200, 838_200)
        .with_style_id("{66BB4812-77A1-49B3-BDF9-0CCEB564D7B5}")
        .with_style_first_row(true)
        .with_style_band_rows(true)
        .with_column_widths(vec![2_500_000, 2_500_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Header A"))
                .with_cell(cell("Header B")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("1"))
                .with_cell(cell("2")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("3"))
                .with_cell(cell("4")),
        );

    let presentation = Presentation::new()
        .with_table_style(
            SlideTableStyle::new(
                "{66BB4812-77A1-49B3-BDF9-0CCEB564D7B5}",
                "Custom Table Style",
            )
            .with_first_row(
                TableStylePart::new()
                    .with_fill(Fill::Solid(Color::Rgb("2E74B5".to_string())))
                    .with_bold(true)
                    .with_text_color(Color::Rgb("FFFFFF".to_string())),
            )
            .with_band1_horizontal(
                TableStylePart::new().with_fill(Fill::Solid(Color::Rgb("F2F2F2".to_string()))),
            ),
        )
        .with_slide(Slide::new().with_shape(Shape::Table(plain_table)))
        .with_slide(Slide::new().with_shape(Shape::Table(merged_table)))
        .with_slide(Slide::new().with_shape(Shape::Table(styled_table)));

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

examples/pptx_shapes_and_placeholders.rs (line 84)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_shapes_and_placeholders.pptx");

    let plain_shape = AutoShape::new(2, "Plain autoshape")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("A plain autoshape."))),
        );

    let text_box = AutoShape::new(2, "Text box")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("A genuine text box (txBox=\"1\").")),
        ));

    let title = AutoShape::new(2, "Title placeholder")
        .with_placeholder(Placeholder::new(PlaceholderKind::CenterTitle))
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(10_515_600, 1_325_563),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Title placeholder"))),
        );
    let subtitle =
        AutoShape::new(3, "Subtitle placeholder")
            .with_placeholder(Placeholder::new(PlaceholderKind::SubTitle).with_index(1))
            .with_properties(
                ShapeProperties::new().with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 2_400_000)
                        .with_extent(10_515_600, 800_000),
                ),
            )
            .with_text_body(TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text("Subtitle placeholder")),
            ));

    let hyperlinked_shape = AutoShape::new(2, "Hyperlinked shape")
        .with_hyperlink("https://www.rust-lang.org")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(5_000_000, 1_000_000),
            ),
        )
        .with_text_body(TextBody::new().with_paragraph(
            TextParagraph::new().with_run(TextRun::text("Click this shape to open a link.")),
        ));

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(plain_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(text_box)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(title))
                .with_shape(Shape::AutoShape(subtitle)),
        )
        .with_slide(Slide::new().with_shape(Shape::AutoShape(hyperlinked_shape)));

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

examples/pptx_theme_and_metadata.rs (line 82)

fn main() -> office_toolkit::Result<()> {
    // A custom theme and an embedded font. `Theme`/`ColorScheme`/
    // `FontScheme` have no `with_*` builders in this crate — only
    // `office_default()` or plain struct literals.
    let custom_theme = Theme {
        name: "Custom Brand".to_string(),
        colors: ColorScheme {
            dark1: "1B1B1B".to_string(),
            light1: "FFFFFF".to_string(),
            dark2: "0A2540".to_string(),
            light2: "F5F5F5".to_string(),
            accent1: "0A2540".to_string(),
            accent2: "E8622C".to_string(),
            accent3: "2E86AB".to_string(),
            accent4: "6FB98F".to_string(),
            accent5: "F4A259".to_string(),
            accent6: "8E4585".to_string(),
            hyperlink: "1155CC".to_string(),
            followed_hyperlink: "6B3FA0".to_string(),
        },
        fonts: FontScheme {
            major_latin: "Georgia".to_string(),
            minor_latin: "Verdana".to_string(),
        },
    };

    // Placeholder bytes — a real .pptx would carry genuine TrueType/
    // OpenType font data here.
    let embedded_font = EmbeddedFont::new("Custom Sans")
        .with_regular(vec![0u8; 16])
        .with_bold(vec![0u8; 16]);

    // A slide with no shapes at all renders as a blank page — nothing shows
    // the custom theme actually took effect. `drawing::Color` has no
    // scheme-relative variant yet (`<a:schemeClr>` isn't modeled, see that
    // enum's own doc comment), so this can't reference the theme's accent1
    // symbolically; it uses the same literal hex values the theme itself
    // was built from, purely so the slide visibly matches the palette above.
    let title_shape = AutoShape::new(2, "Title")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(6_000_000, 1_500_000),
                )
                .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.accent1.clone()))),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text_with_properties(
                    "Custom Brand theme — Georgia / Verdana, accent1 = #0A2540",
                    TextRunProperties::new()
                        .with_font_family(custom_theme.fonts.major_latin.clone())
                        .with_font_size_points(24.0)
                        .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.light1.clone()))),
                )),
            ),
        );

    let themed_presentation = Presentation::new()
        .with_theme(custom_theme)
        .with_embedded_font(embedded_font)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(title_shape)));
    let theme_path = output_path("pptx_theme.pptx");
    themed_presentation.save_to_file(&theme_path)?;
    println!("Wrote {}", theme_path.display());

    // Document metadata (docProps/core.xml, app.xml, and custom.xml).
    let properties = DocumentProperties::new()
        .with_title("Metadata example")
        .with_author("Example Author")
        .with_subject("Presentation-level features")
        .with_custom_property(
            "ProjectCode",
            CustomPropertyValue::Text("PPTX-META".to_string()),
        );
    // Same reasoning as `title_shape` above: an empty slide would render
    // blank, so a text shape spells out where the metadata actually lives.
    let metadata_shape = AutoShape::new(2, "Note")
        .with_properties(ShapeProperties::new().with_transform(Transform2D::new().with_offset(838_200, 838_200).with_extent(7_000_000, 1_000_000)))
        .with_text_body(TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(
            "This presentation's metadata is in File > Info (title, author, subject, and a custom \"ProjectCode\" property) — not on this slide.",
        ))));
    let metadata_presentation = Presentation::new()
        .with_properties(properties)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(metadata_shape)));
    let metadata_path = output_path("pptx_metadata.pptx");
    metadata_presentation.save_to_file(&metadata_path)?;
    println!("Wrote {}", metadata_path.display());

    Ok(())
}

Additional examples can be found in:

• examples/pptx_grouping_and_connectors.rs
• examples/pptx_text_formatting.rs

pub fn add_slide(&mut self) -> &mut Slide

Appends an empty slide and returns a mutable reference to it, to build it up in place (presentation.add_slide().add_shape(..)). A &mut self counterpart to Self::with_slide, for building a presentation slide-by-slide in a loop without the consuming builder’s presentation = presentation.with_slide(..) reassignment on every iteration.

pub fn with_slide_size(self, width_emu: i64, height_emu: i64) -> Presentation

Overrides the slide size (default: 16:9 widescreen).

pub fn with_theme(self, theme: Theme) -> Presentation

Sets a custom color/font theme, replacing Office’s own built-in default.

Examples found in repository

examples/pptx_theme_and_metadata.rs (line 80)

fn main() -> office_toolkit::Result<()> {
    // A custom theme and an embedded font. `Theme`/`ColorScheme`/
    // `FontScheme` have no `with_*` builders in this crate — only
    // `office_default()` or plain struct literals.
    let custom_theme = Theme {
        name: "Custom Brand".to_string(),
        colors: ColorScheme {
            dark1: "1B1B1B".to_string(),
            light1: "FFFFFF".to_string(),
            dark2: "0A2540".to_string(),
            light2: "F5F5F5".to_string(),
            accent1: "0A2540".to_string(),
            accent2: "E8622C".to_string(),
            accent3: "2E86AB".to_string(),
            accent4: "6FB98F".to_string(),
            accent5: "F4A259".to_string(),
            accent6: "8E4585".to_string(),
            hyperlink: "1155CC".to_string(),
            followed_hyperlink: "6B3FA0".to_string(),
        },
        fonts: FontScheme {
            major_latin: "Georgia".to_string(),
            minor_latin: "Verdana".to_string(),
        },
    };

    // Placeholder bytes — a real .pptx would carry genuine TrueType/
    // OpenType font data here.
    let embedded_font = EmbeddedFont::new("Custom Sans")
        .with_regular(vec![0u8; 16])
        .with_bold(vec![0u8; 16]);

    // A slide with no shapes at all renders as a blank page — nothing shows
    // the custom theme actually took effect. `drawing::Color` has no
    // scheme-relative variant yet (`<a:schemeClr>` isn't modeled, see that
    // enum's own doc comment), so this can't reference the theme's accent1
    // symbolically; it uses the same literal hex values the theme itself
    // was built from, purely so the slide visibly matches the palette above.
    let title_shape = AutoShape::new(2, "Title")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(6_000_000, 1_500_000),
                )
                .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.accent1.clone()))),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text_with_properties(
                    "Custom Brand theme — Georgia / Verdana, accent1 = #0A2540",
                    TextRunProperties::new()
                        .with_font_family(custom_theme.fonts.major_latin.clone())
                        .with_font_size_points(24.0)
                        .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.light1.clone()))),
                )),
            ),
        );

    let themed_presentation = Presentation::new()
        .with_theme(custom_theme)
        .with_embedded_font(embedded_font)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(title_shape)));
    let theme_path = output_path("pptx_theme.pptx");
    themed_presentation.save_to_file(&theme_path)?;
    println!("Wrote {}", theme_path.display());

    // Document metadata (docProps/core.xml, app.xml, and custom.xml).
    let properties = DocumentProperties::new()
        .with_title("Metadata example")
        .with_author("Example Author")
        .with_subject("Presentation-level features")
        .with_custom_property(
            "ProjectCode",
            CustomPropertyValue::Text("PPTX-META".to_string()),
        );
    // Same reasoning as `title_shape` above: an empty slide would render
    // blank, so a text shape spells out where the metadata actually lives.
    let metadata_shape = AutoShape::new(2, "Note")
        .with_properties(ShapeProperties::new().with_transform(Transform2D::new().with_offset(838_200, 838_200).with_extent(7_000_000, 1_000_000)))
        .with_text_body(TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(
            "This presentation's metadata is in File > Info (title, author, subject, and a custom \"ProjectCode\" property) — not on this slide.",
        ))));
    let metadata_presentation = Presentation::new()
        .with_properties(properties)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(metadata_shape)));
    let metadata_path = output_path("pptx_metadata.pptx");
    metadata_presentation.save_to_file(&metadata_path)?;
    println!("Wrote {}", metadata_path.display());

    Ok(())
}

pub fn with_properties(self, properties: DocumentProperties) -> Presentation

Sets this presentation’s document metadata.

Examples found in repository

examples/pptx_theme_and_metadata.rs (line 104)

fn main() -> office_toolkit::Result<()> {
    // A custom theme and an embedded font. `Theme`/`ColorScheme`/
    // `FontScheme` have no `with_*` builders in this crate — only
    // `office_default()` or plain struct literals.
    let custom_theme = Theme {
        name: "Custom Brand".to_string(),
        colors: ColorScheme {
            dark1: "1B1B1B".to_string(),
            light1: "FFFFFF".to_string(),
            dark2: "0A2540".to_string(),
            light2: "F5F5F5".to_string(),
            accent1: "0A2540".to_string(),
            accent2: "E8622C".to_string(),
            accent3: "2E86AB".to_string(),
            accent4: "6FB98F".to_string(),
            accent5: "F4A259".to_string(),
            accent6: "8E4585".to_string(),
            hyperlink: "1155CC".to_string(),
            followed_hyperlink: "6B3FA0".to_string(),
        },
        fonts: FontScheme {
            major_latin: "Georgia".to_string(),
            minor_latin: "Verdana".to_string(),
        },
    };

    // Placeholder bytes — a real .pptx would carry genuine TrueType/
    // OpenType font data here.
    let embedded_font = EmbeddedFont::new("Custom Sans")
        .with_regular(vec![0u8; 16])
        .with_bold(vec![0u8; 16]);

    // A slide with no shapes at all renders as a blank page — nothing shows
    // the custom theme actually took effect. `drawing::Color` has no
    // scheme-relative variant yet (`<a:schemeClr>` isn't modeled, see that
    // enum's own doc comment), so this can't reference the theme's accent1
    // symbolically; it uses the same literal hex values the theme itself
    // was built from, purely so the slide visibly matches the palette above.
    let title_shape = AutoShape::new(2, "Title")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(6_000_000, 1_500_000),
                )
                .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.accent1.clone()))),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text_with_properties(
                    "Custom Brand theme — Georgia / Verdana, accent1 = #0A2540",
                    TextRunProperties::new()
                        .with_font_family(custom_theme.fonts.major_latin.clone())
                        .with_font_size_points(24.0)
                        .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.light1.clone()))),
                )),
            ),
        );

    let themed_presentation = Presentation::new()
        .with_theme(custom_theme)
        .with_embedded_font(embedded_font)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(title_shape)));
    let theme_path = output_path("pptx_theme.pptx");
    themed_presentation.save_to_file(&theme_path)?;
    println!("Wrote {}", theme_path.display());

    // Document metadata (docProps/core.xml, app.xml, and custom.xml).
    let properties = DocumentProperties::new()
        .with_title("Metadata example")
        .with_author("Example Author")
        .with_subject("Presentation-level features")
        .with_custom_property(
            "ProjectCode",
            CustomPropertyValue::Text("PPTX-META".to_string()),
        );
    // Same reasoning as `title_shape` above: an empty slide would render
    // blank, so a text shape spells out where the metadata actually lives.
    let metadata_shape = AutoShape::new(2, "Note")
        .with_properties(ShapeProperties::new().with_transform(Transform2D::new().with_offset(838_200, 838_200).with_extent(7_000_000, 1_000_000)))
        .with_text_body(TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(
            "This presentation's metadata is in File > Info (title, author, subject, and a custom \"ProjectCode\" property) — not on this slide.",
        ))));
    let metadata_presentation = Presentation::new()
        .with_properties(properties)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(metadata_shape)));
    let metadata_path = output_path("pptx_metadata.pptx");
    metadata_presentation.save_to_file(&metadata_path)?;
    println!("Wrote {}", metadata_path.display());

    Ok(())
}

pub fn with_table_style(self, table_style: SlideTableStyle) -> Presentation

Appends a custom table style.

Examples found in repository

examples/pptx_tables.rs (lines 77-91)

fn main() -> office_toolkit::Result<()> {
    let path = output_path("pptx_tables.pptx");

    let plain_table = SlideTable::new(2, "Plain table", 5_000_000, 1_500_000)
        .with_offset(838_200, 838_200)
        .with_column_widths(vec![2_500_000, 2_500_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Name"))
                .with_cell(cell("Score")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Alice"))
                .with_cell(cell("92")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Bob"))
                .with_cell(cell("87")),
        );

    let merged_table = SlideTable::new(2, "Merged cells", 5_000_000, 1_000_000)
        .with_offset(838_200, 838_200)
        .with_column_widths(vec![1_667_000, 1_667_000, 1_666_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Spanning header").with_horizontal_span(3))
                .with_cell(TableCell::horizontally_merged())
                .with_cell(TableCell::horizontally_merged()),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("A"))
                .with_cell(cell("B"))
                .with_cell(cell("C")),
        );

    let styled_table = SlideTable::new(2, "Styled table", 5_000_000, 1_500_000)
        .with_offset(838_200, 838_200)
        .with_style_id("{66BB4812-77A1-49B3-BDF9-0CCEB564D7B5}")
        .with_style_first_row(true)
        .with_style_band_rows(true)
        .with_column_widths(vec![2_500_000, 2_500_000])
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("Header A"))
                .with_cell(cell("Header B")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("1"))
                .with_cell(cell("2")),
        )
        .with_row(
            TableRow::new(500_000)
                .with_cell(cell("3"))
                .with_cell(cell("4")),
        );

    let presentation = Presentation::new()
        .with_table_style(
            SlideTableStyle::new(
                "{66BB4812-77A1-49B3-BDF9-0CCEB564D7B5}",
                "Custom Table Style",
            )
            .with_first_row(
                TableStylePart::new()
                    .with_fill(Fill::Solid(Color::Rgb("2E74B5".to_string())))
                    .with_bold(true)
                    .with_text_color(Color::Rgb("FFFFFF".to_string())),
            )
            .with_band1_horizontal(
                TableStylePart::new().with_fill(Fill::Solid(Color::Rgb("F2F2F2".to_string()))),
            ),
        )
        .with_slide(Slide::new().with_shape(Shape::Table(plain_table)))
        .with_slide(Slide::new().with_shape(Shape::Table(merged_table)))
        .with_slide(Slide::new().with_shape(Shape::Table(styled_table)));

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

pub fn with_embedded_font(self, font: EmbeddedFont) -> Presentation

Appends an embedded font.

Examples found in repository

examples/pptx_theme_and_metadata.rs (line 81)

fn main() -> office_toolkit::Result<()> {
    // A custom theme and an embedded font. `Theme`/`ColorScheme`/
    // `FontScheme` have no `with_*` builders in this crate — only
    // `office_default()` or plain struct literals.
    let custom_theme = Theme {
        name: "Custom Brand".to_string(),
        colors: ColorScheme {
            dark1: "1B1B1B".to_string(),
            light1: "FFFFFF".to_string(),
            dark2: "0A2540".to_string(),
            light2: "F5F5F5".to_string(),
            accent1: "0A2540".to_string(),
            accent2: "E8622C".to_string(),
            accent3: "2E86AB".to_string(),
            accent4: "6FB98F".to_string(),
            accent5: "F4A259".to_string(),
            accent6: "8E4585".to_string(),
            hyperlink: "1155CC".to_string(),
            followed_hyperlink: "6B3FA0".to_string(),
        },
        fonts: FontScheme {
            major_latin: "Georgia".to_string(),
            minor_latin: "Verdana".to_string(),
        },
    };

    // Placeholder bytes — a real .pptx would carry genuine TrueType/
    // OpenType font data here.
    let embedded_font = EmbeddedFont::new("Custom Sans")
        .with_regular(vec![0u8; 16])
        .with_bold(vec![0u8; 16]);

    // A slide with no shapes at all renders as a blank page — nothing shows
    // the custom theme actually took effect. `drawing::Color` has no
    // scheme-relative variant yet (`<a:schemeClr>` isn't modeled, see that
    // enum's own doc comment), so this can't reference the theme's accent1
    // symbolically; it uses the same literal hex values the theme itself
    // was built from, purely so the slide visibly matches the palette above.
    let title_shape = AutoShape::new(2, "Title")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(838_200, 838_200)
                        .with_extent(6_000_000, 1_500_000),
                )
                .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.accent1.clone()))),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new().with_run(TextRun::text_with_properties(
                    "Custom Brand theme — Georgia / Verdana, accent1 = #0A2540",
                    TextRunProperties::new()
                        .with_font_family(custom_theme.fonts.major_latin.clone())
                        .with_font_size_points(24.0)
                        .with_fill(Fill::Solid(Color::Rgb(custom_theme.colors.light1.clone()))),
                )),
            ),
        );

    let themed_presentation = Presentation::new()
        .with_theme(custom_theme)
        .with_embedded_font(embedded_font)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(title_shape)));
    let theme_path = output_path("pptx_theme.pptx");
    themed_presentation.save_to_file(&theme_path)?;
    println!("Wrote {}", theme_path.display());

    // Document metadata (docProps/core.xml, app.xml, and custom.xml).
    let properties = DocumentProperties::new()
        .with_title("Metadata example")
        .with_author("Example Author")
        .with_subject("Presentation-level features")
        .with_custom_property(
            "ProjectCode",
            CustomPropertyValue::Text("PPTX-META".to_string()),
        );
    // Same reasoning as `title_shape` above: an empty slide would render
    // blank, so a text shape spells out where the metadata actually lives.
    let metadata_shape = AutoShape::new(2, "Note")
        .with_properties(ShapeProperties::new().with_transform(Transform2D::new().with_offset(838_200, 838_200).with_extent(7_000_000, 1_000_000)))
        .with_text_body(TextBody::new().with_paragraph(TextParagraph::new().with_run(TextRun::text(
            "This presentation's metadata is in File > Info (title, author, subject, and a custom \"ProjectCode\" property) — not on this slide.",
        ))));
    let metadata_presentation = Presentation::new()
        .with_properties(properties)
        .with_slide(Slide::new().with_shape(Shape::AutoShape(metadata_shape)));
    let metadata_path = output_path("pptx_metadata.pptx");
    metadata_presentation.save_to_file(&metadata_path)?;
    println!("Wrote {}", metadata_path.display());

    Ok(())
}

impl Presentation

pub fn read_from<R>(reader: R) -> Result<Presentation, Error>

where R: Read + Seek,

Reads a .pptx package from a seekable byte source.

impl Presentation

pub fn write_to<W>(&self, writer: W) -> Result<W, Error>

where W: Write + Seek,

Writes this presentation to a seekable byte sink as a valid .pptx package: [Content_Types].xml, _rels/.rels, ppt/presentation.xml (+ rels), one ppt/slides/slideN.xml (+ rels) per slide, a single fixed ppt/slideMasters/slideMaster1.xml (+ rels), ppt/slideLayouts/slideLayout1.xml (+ rels), ppt/theme/theme1.xml, ppt/presProps.xml, ppt/viewProps.xml, ppt/tableStyles.xml, docProps/core.xml, docProps/app.xml, plus ppt/media/imageN.*/ ppt/charts/chartN.xml for any picture/chart shape, plus (only if at least one slide has notes) a single fixed ppt/notesMasters/notesMaster1.xml and one ppt/notesSlides/notesSlideN.xml per slide that has notes, plus (only if at least one slide has comments) a single ppt/commentAuthors.xml and one ppt/comments/commentN.xml per slide that has comments. ppt/theme/theme1.xml’s content follows self.theme (Office’s own built-in default when unset) — see this module’s own doc comment for why the slide master/layout pair itself stays fixed.

Trait Implementations

impl Clone for Presentation

fn clone(&self) -> Presentation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Presentation

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

Formats the value using the given formatter.

impl Default for Presentation

fn default() -> Presentation

Returns the “default value” for a type.

impl OpenFile for Presentation

Available on crate feature powerpoint only.

fn open_file(path: impl AsRef<Path>) -> Result<Self>

Reads self from the file at path.

impl PartialEq for Presentation

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

Equality operator ==.

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

Inequality operator !=.

impl SaveToFile for Presentation

Available on crate feature powerpoint only.

fn save_to_file(&self, path: impl AsRef<Path>) -> Result<()>

Writes self to the file at path, creating it (or truncating an existing one) as needed.

impl StructuralPartialEq for Presentation