Skip to main content
Get Started

PowerPoint Presentations

Edit on GitHub

Overview of the OfficeIMO.PowerPoint package for generating .pptx decks with slides, text, tables, charts, and notes.

PowerPoint Presentations

OfficeIMO.PowerPoint lets you build .pptx presentations from a higher-level object model instead of stitching raw Open XML parts together yourself. It is designed for generated decks, reporting pipelines, demo content, and repeatable presentation output that needs to stay readable in source control.

Good fit scenarios

  • Create status decks, release reviews, and customer reports from application data.
  • Generate training material or runbook slides as part of CI, build, or scheduled jobs.
  • Reuse the same source data across Word, Excel, PowerPoint, and Reader pipelines.
  • Produce presentations on servers, containers, or developer machines without PowerPoint installed.

Core building blocks

TypePurpose
PowerPointPresentationRoot document for creating, loading, saving, and organizing slides
PowerPointSlideIndividual slide surface for titles, text boxes, tables, charts, images, and notes
PowerPointTextBoxRich text container with bullets, formatted runs, margins, and auto-fit
PowerPointTableStrongly typed table surface with styles, column widths, row heights, and merged cells
PowerPointChartChart host for series-driven visualizations inside a slide
PowerPointNotesSpeaker notes attached to a slide
PowerPointLayoutBoxMeasurement helper for content regions, columns, and spacing
PowerPointDesignBriefBrand, purpose, palette, and design preferences used to generate alternatives
PowerPointDeckPlanSemantic sequence of designer slides that can be scored before rendering

Designer decks

For decks that should look intentional without hand-positioning every object, use designer briefs and semantic deck plans. A brief can propose several visual directions from the same brand, while a deck plan lets the library score how well those directions fit the content before rendering editable slides.

PowerPoint designer deck plan process slide
PowerPointDesignBrief brief = PowerPointDesignBrief
    .FromBrand("#008C95", "client-demo", "technical rollout proposal")
    .WithIdentity("Client Theme", footerLeft: "CLIENT", footerRight: "Service deck")
    .WithVariety(PowerPointDesignVariety.Exploratory);

PowerPointDeckPlan plan = new PowerPointDeckPlan()
    .AddSection("Service proposal", "Generated from a semantic plan.")
    .AddProcess("Implementation path", "The selected design handles layout.",
        new[] {
            new PowerPointProcessStep("Discover", "Collect constraints."),
            new PowerPointProcessStep("Design", "Choose the target model."),
            new PowerPointProcessStep("Roll out", "Deliver in waves.")
        });

var best = brief.DescribeDeckPlanAlternatives(plan, 3)
    .OrderByDescending(alternative => alternative.ContentFitScore)
    .First();

using var presentation = PowerPointPresentation.Create("proposal.pptx");
presentation.SlideSize.SetPreset(PowerPointSlideSizePreset.Screen16x9);
presentation.UseDesigner(brief, best.Index).AddSlides(plan);
presentation.Save();

Designer Decks shows design recommendations, deck-plan scoring, raw composition primitives, and screenshots from runnable examples.

Quick start

using OfficeIMO.PowerPoint;

using var presentation = PowerPointPresentation.Create("status-update.pptx");
const double marginCm = 1.5;

var content = presentation.SlideSize.GetContentBoxCm(marginCm);
var slide = presentation.AddSlide();

var title = slide.AddTitleCm(
    "Weekly Status",
    content.LeftCm,
    content.TopCm,
    content.WidthCm,
    1.4);

if (title.Paragraphs.Count > 0)
{
    PowerPointTextStyle.Title.WithColor("1F4E79").Apply(title.Paragraphs[0]);
}

var agenda = slide.AddTextBoxCm(
    string.Empty,
    content.LeftCm,
    content.TopCm + 2.0,
    content.WidthCm,
    content.HeightCm - 2.0);

agenda.AddBullets(new[]
{
    "Deployment completed successfully",
    "Customer onboarding toolkit updated",
    "Performance metrics improved week over week"
});

presentation.Save();
  1. Create a presentation and get a content box from SlideSize so positioning stays consistent.
  2. Add slides and establish structure with title, body, and supporting shapes or tables.
  3. Populate content from your domain data, not from hard-coded presentation markup.
  4. Add speaker notes, sections, theme tweaks, or layout helpers when the deck grows.
  5. Save the file and ship it as a build artifact, report attachment, or generated deliverable.

Layout and content model

  • Use SlideSize.GetContentBoxCm(...) to reserve consistent margins around the live slide area.
  • Use GetColumnsCm(...) when you want balanced two- or three-column compositions.
  • Work in centimeters, points, or EMUs through the built-in unit helpers depending on the scenario.
  • Add titles, text boxes, tables, charts, images, and notes to the same PowerPointSlide surface.
  • Pair OfficeIMO.PowerPoint with OfficeIMO.Excel when chart/table data already exists in workbook form.
  • Use OfficeIMO.Reader when the same pipeline later needs extraction or chunking from generated decks.
  • Use PSWriteOffice when you want the same presentation automation from PowerShell rather than C#.

Further reading