Struct ShapeProperties 

pub struct ShapeProperties {
    pub transform: Option<Transform2D>,
    pub geometry: Option<Geometry>,
    pub fill: Option<Fill>,
    pub line: Option<Line>,
    pub effects: Option<EffectList>,
    pub geometry_adjustments: Vec<GeometryAdjustment>,
}

A shape’s visual properties (<a:spPr>, CT_ShapeProperties): local position/size, geometry, fill, and line. Everything about how a shape looks, independent of where it is anchored in its host document (that part is never modeled here — see the crate-level doc comment).

Not modeled: 3D (a:scene3d/a:sp3d) — EG_EffectProperties’s <a:effectLst> choice (shadow/glow/reflection/soft edge) is modeled, see EffectList, point 10; its sibling choice <a:effectDag> (an effect graph, letting effects reference each other’s output — a materially more complex, rarely-authored mechanism) is not. bwMode (black-and-white print override) is not modeled either — a rarely-used printing hint.

Fields

transform: Option<Transform2D>

<a:xfrm> — position, size, rotation, flipping.

geometry: Option<Geometry>

EG_Geometry (<a:prstGeom>/<a:custGeom>) — the shape’s outline.

fill: Option<Fill>

EG_FillProperties (<a:noFill>/<a:solidFill>/<a:gradFill>/ <a:pattFill>/<a:blipFill>/<a:grpFill>) — how the shape’s interior is painted.

line: Option<Line>

<a:ln> — the shape’s outline stroke.

effects: Option<EffectList>

<a:effectLst> — shadow/glow/reflection/soft-edge effects.

geometry_adjustments: Vec<GeometryAdjustment>

<a:prstGeom>’s own <a:avLst> (CT_GeomGuideList) — adjustment handle values for a preset shape (a rounded rectangle’s corner radius, an arrow’s head size.). Only meaningful, and only ever written, when geometry is Some(Geometry::Preset(_)) — kept as a sibling field here (rather than inside Geometry::Preset itself) to avoid a breaking change to that enum’s existing tuple-variant shape, used at dozens of call sites across every host crate. Empty (the default) omits <a:avLst> entirely for a preset shape — schema- valid, meaning “use this preset’s own built-in default handles”. Grounded against a real fixture (a smiley-face preset with an explicit adj guide).

Implementations

impl ShapeProperties

pub fn new() -> ShapeProperties

Creates an empty set of shape properties (every field unset — a shape that inherits everything from its host’s defaults).

Examples found in repository

examples/hello_world_pptx.rs (line 19)

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 18)

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_shapes_and_placeholders.rs (line 19)

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 59)

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

examples/pptx_grouping_and_connectors.rs (line 28)

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

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

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

examples/pptx_text_formatting.rs (line 24)

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

    let spacing_shape = AutoShape::new(2, "Spacing")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_properties(
                        TextParagraphProperties::new()
                            .with_line_spacing(TextSpacing::Percent(150_000))
                            .with_space_before(TextSpacing::Points(1200))
                            .with_indent_emu(457_200)
                            .with_level(1),
                    )
                    .with_run(TextRun::text(
                        "Indented, 150% line spacing, 12pt space before.",
                    )),
            ),
        );

    let bullets_shape = AutoShape::new(2, "Bullets")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_800_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(
                    TextParagraph::new()
                        .with_properties(
                            TextParagraphProperties::new()
                                .with_bullet(BulletKind::Character("\u{2022}".to_string())),
                        )
                        .with_run(TextRun::text("Bulleted item")),
                )
                .with_paragraph(
                    TextParagraph::new()
                        .with_properties(TextParagraphProperties::new().with_bullet(
                            BulletKind::AutoNumber {
                                scheme: "arabicPeriod".to_string(),
                                start_at: None,
                            },
                        ))
                        .with_run(TextRun::text("Auto-numbered item")),
                ),
        );

    let autofit_shape = AutoShape::new(2, "Autofit")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(4_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_properties(
                    TextBodyProperties::new()
                        .with_autofit(TextAutofit::Shape)
                        .with_anchor(TextAnchor::Center)
                        .with_anchor_center(true),
                )
                .with_paragraph(TextParagraph::new().with_run(TextRun::text(
                    "This shape resizes to fit its text, centered both ways.",
                ))),
        );

    let casing_shape = AutoShape::new(2, "Casing")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text_with_properties(
                        "rendered in all caps, ",
                        TextRunProperties::new().with_text_caps(TextCaps::All),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "widely spaced, ",
                        TextRunProperties::new().with_character_spacing_points(3.0),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "highlighted",
                        TextRunProperties::new().with_highlight(Color::Rgb("FFFF00".to_string())),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "2",
                        TextRunProperties::new().with_baseline_percent(30.0),
                    )),
            ),
        );

    let field_shape = AutoShape::new(2, "Field")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(3_000_000, 500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text("Slide "))
                    .with_run(TextRun::field(
                        "{7A9E3F10-4B6C-4D2E-9A1F-8C5D6E7F0123}",
                        Some("slidenum".to_string()),
                        "1",
                    )),
            ),
        );

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(spacing_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(bullets_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(autofit_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(casing_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(field_shape)));

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

pub fn with_transform(self, transform: Transform2D) -> ShapeProperties

Sets the shape’s position/size/rotation (<a:xfrm>).

Examples found in repository

examples/hello_world_pptx.rs (lines 19-23)

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 (lines 18-22)

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_shapes_and_placeholders.rs (lines 19-23)

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 (lines 60-64)

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

examples/pptx_grouping_and_connectors.rs (lines 29-33)

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

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

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

examples/pptx_text_formatting.rs (lines 24-28)

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

    let spacing_shape = AutoShape::new(2, "Spacing")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_properties(
                        TextParagraphProperties::new()
                            .with_line_spacing(TextSpacing::Percent(150_000))
                            .with_space_before(TextSpacing::Points(1200))
                            .with_indent_emu(457_200)
                            .with_level(1),
                    )
                    .with_run(TextRun::text(
                        "Indented, 150% line spacing, 12pt space before.",
                    )),
            ),
        );

    let bullets_shape = AutoShape::new(2, "Bullets")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_800_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(
                    TextParagraph::new()
                        .with_properties(
                            TextParagraphProperties::new()
                                .with_bullet(BulletKind::Character("\u{2022}".to_string())),
                        )
                        .with_run(TextRun::text("Bulleted item")),
                )
                .with_paragraph(
                    TextParagraph::new()
                        .with_properties(TextParagraphProperties::new().with_bullet(
                            BulletKind::AutoNumber {
                                scheme: "arabicPeriod".to_string(),
                                start_at: None,
                            },
                        ))
                        .with_run(TextRun::text("Auto-numbered item")),
                ),
        );

    let autofit_shape = AutoShape::new(2, "Autofit")
        .with_text_box(true)
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(4_000_000, 1_000_000),
            ),
        )
        .with_text_body(
            TextBody::new()
                .with_properties(
                    TextBodyProperties::new()
                        .with_autofit(TextAutofit::Shape)
                        .with_anchor(TextAnchor::Center)
                        .with_anchor_center(true),
                )
                .with_paragraph(TextParagraph::new().with_run(TextRun::text(
                    "This shape resizes to fit its text, centered both ways.",
                ))),
        );

    let casing_shape = AutoShape::new(2, "Casing")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(6_000_000, 1_500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text_with_properties(
                        "rendered in all caps, ",
                        TextRunProperties::new().with_text_caps(TextCaps::All),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "widely spaced, ",
                        TextRunProperties::new().with_character_spacing_points(3.0),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "highlighted",
                        TextRunProperties::new().with_highlight(Color::Rgb("FFFF00".to_string())),
                    ))
                    .with_run(TextRun::text_with_properties(
                        "2",
                        TextRunProperties::new().with_baseline_percent(30.0),
                    )),
            ),
        );

    let field_shape = AutoShape::new(2, "Field")
        .with_properties(
            ShapeProperties::new().with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(3_000_000, 500_000),
            ),
        )
        .with_text_body(
            TextBody::new().with_paragraph(
                TextParagraph::new()
                    .with_run(TextRun::text("Slide "))
                    .with_run(TextRun::field(
                        "{7A9E3F10-4B6C-4D2E-9A1F-8C5D6E7F0123}",
                        Some("slidenum".to_string()),
                        "1",
                    )),
            ),
        );

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::AutoShape(spacing_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(bullets_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(autofit_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(casing_shape)))
        .with_slide(Slide::new().with_shape(Shape::AutoShape(field_shape)));

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

pub fn with_geometry(self, geometry: Geometry) -> ShapeProperties

Sets the shape’s outline (EG_Geometry).

pub fn with_fill(self, fill: Fill) -> ShapeProperties

Sets the shape’s interior fill (EG_FillProperties).

Examples found in repository

examples/pptx_theme_and_metadata.rs (line 65)

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

examples/pptx_grouping_and_connectors.rs (line 34)

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

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

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

pub fn with_line(self, line: Line) -> ShapeProperties

Sets the shape’s outline stroke (<a:ln>).

Examples found in repository

examples/pptx_grouping_and_connectors.rs (lines 113-117)

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

    // Every shape below sets an explicit fill (and the connector an
    // explicit line): with neither a fill/line nor a `<p:style>` theme
    // reference, a shape has nothing to paint and renders as fully
    // invisible — the slide then looks blank even though the shapes are
    // there. `AutoShape`/`Connector` have no `<p:style>` support yet, so an
    // explicit `Fill`/`Line` is the only way to make a shape actually show.
    let circle_fill = || Fill::Solid(Color::Rgb("4472C4".to_string()));

    let circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let label = AutoShape::new(12, "Label")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_200_000, 300_000)
                        .with_extent(1_500_000, 400_000),
                )
                .with_fill(Fill::Solid(Color::Rgb("E8622C".to_string()))),
        )
        .with_text_body(
            TextBody::new()
                .with_paragraph(TextParagraph::new().with_run(TextRun::text("Grouped label"))),
        );

    let group = ShapeGroup::new(2, "Group")
        .with_transform(
            (838_200, 838_200),
            (2_700_000, 1_000_000),
            (0, 0),
            (2_700_000, 1_000_000),
        )
        .with_shape(Shape::AutoShape(circle))
        .with_shape(Shape::AutoShape(label));

    let rotated_circle = AutoShape::new(11, "Circle").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(0, 0)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(circle_fill()),
    );
    let rotated_group = ShapeGroup::new(2, "Rotated and flipped group")
        .with_transform(
            (838_200, 838_200),
            (1_000_000, 1_000_000),
            (0, 0),
            (1_000_000, 1_000_000),
        )
        .with_rotation_degrees(45.0)
        .with_flip_horizontal(true)
        .with_shape(Shape::AutoShape(rotated_circle));

    let box_a = AutoShape::new(2, "Box A").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(838_200, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("2E86AB".to_string()))),
    );
    let box_b = AutoShape::new(3, "Box B").with_properties(
        ShapeProperties::new()
            .with_transform(
                Transform2D::new()
                    .with_offset(3_500_000, 838_200)
                    .with_extent(1_000_000, 1_000_000),
            )
            .with_fill(Fill::Solid(Color::Rgb("6FB98F".to_string()))),
    );
    // `Connector::new` leaves position/size unset, which the writer then
    // emits as a zero-size `<a:xfrm>` (off 0,0 / ext 0,0) — a real point
    // with no length, invisible regardless of line/fill. `stCxn`/`endCxn`
    // alone don't supply geometry; PowerPoint only recomputes it once you
    // drag one of the attached shapes. So this also sets an explicit
    // transform spanning Box A's right edge to Box B's left edge.
    let connector = Connector::new(4, "Connector")
        .with_properties(
            ShapeProperties::new()
                .with_transform(
                    Transform2D::new()
                        .with_offset(1_838_200, 1_338_200)
                        .with_extent(1_662_000, 0),
                )
                .with_line(
                    Line::new()
                        .with_width_emu(25_400)
                        .with_fill(Fill::Solid(Color::Rgb("000000".to_string()))),
                ),
        )
        .with_start_connection(2, 0)
        .with_end_connection(3, 0);

    let presentation = Presentation::new()
        .with_slide(Slide::new().with_shape(Shape::Group(group)))
        .with_slide(Slide::new().with_shape(Shape::Group(rotated_group)))
        .with_slide(
            Slide::new()
                .with_shape(Shape::AutoShape(box_a))
                .with_shape(Shape::AutoShape(box_b))
                .with_shape(Shape::Connector(connector)),
        );

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

pub fn with_effects(self, effects: EffectList) -> ShapeProperties

Sets the shape’s visual effects (<a:effectLst>).

pub fn with_geometry_adjustments( self, adjustments: Vec<GeometryAdjustment>, ) -> ShapeProperties

Sets a preset shape’s adjustment handle values (<a:avLst>); no effect unless geometry is also Some(Geometry::Preset(_)).

Trait Implementations

impl Clone for ShapeProperties

fn clone(&self) -> ShapeProperties

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ShapeProperties

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

Formats the value using the given formatter.

impl Default for ShapeProperties

fn default() -> ShapeProperties

Returns the “default value” for a type.

impl PartialEq for ShapeProperties

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ShapeProperties