OfficeIMO.PowerPoint 1.0.27

Prefix Reserved
dotnet add package OfficeIMO.PowerPoint --version 1.0.27
                    
NuGet\Install-Package OfficeIMO.PowerPoint -Version 1.0.27
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="OfficeIMO.PowerPoint" Version="1.0.27" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="OfficeIMO.PowerPoint" Version="1.0.27" />
                    
Directory.Packages.props
<PackageReference Include="OfficeIMO.PowerPoint" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add OfficeIMO.PowerPoint --version 1.0.27
                    
#r "nuget: OfficeIMO.PowerPoint, 1.0.27"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package OfficeIMO.PowerPoint@1.0.27
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=OfficeIMO.PowerPoint&version=1.0.27
                    
Install as a Cake Addin
#tool nuget:?package=OfficeIMO.PowerPoint&version=1.0.27
                    
Install as a Cake Tool

OfficeIMO.PowerPoint — .NET PowerPoint Utilities

OfficeIMO.PowerPoint focuses on creating and editing .pptx presentations with Open XML.

  • Targets: netstandard2.0, net472 (Windows build), net8.0, net10.0
  • License: MIT
  • NuGet: OfficeIMO.PowerPoint
  • Dependencies: DocumentFormat.OpenXml

nuget version nuget downloads

See OfficeIMO.Examples for runnable samples. This README hosts PowerPoint‑specific usage and notes.

Runnable modern deck sample

To generate the richer validation sample deck with theme colors, theme fonts, background image, transitions, shape effects, charts, a table, and speaker notes:

dotnet run --project OfficeIMO.Examples/OfficeIMO.Examples.csproj -f net10.0 -- --modern-powerpoint

The sample writes Modern PowerPoint Deck.pptx to the examples Documents output folder and validates the generated Open XML package before reporting success.

To generate the designer examples used by the website screenshots:

dotnet run --project OfficeIMO.Examples/OfficeIMO.Examples.csproj -f net10.0 -- --powerpoint-design-brief
dotnet run --project OfficeIMO.Examples/OfficeIMO.Examples.csproj -f net10.0 -- --powerpoint-deck-plan

The first sample demonstrates explainable design recommendations. The second demonstrates semantic deck-plan scoring before rendering editable slides.

To run the full PowerPoint examples set without opening PowerPoint and validate every generated deck:

dotnet run --project OfficeIMO.Examples/OfficeIMO.Examples.csproj -f net10.0 -- --powerpoint

Install

dotnet add package OfficeIMO.PowerPoint

Quick sample

using OfficeIMO.PowerPoint;

using var ppt = PowerPointPresentation.Create("demo.pptx");
var slide = ppt.AddSlide();
slide.AddTitle("Hello PowerPoint");
var box = slide.AddTextBox("Generated with OfficeIMO.PowerPoint");
box.SetPositionCm(2, 2);
box.SetSizeCm(6, 2);
slide.Transition = SlideTransition.Fade;
slide.TransitionSpeed = SlideTransitionSpeed.Fast;
slide.TransitionDurationSeconds = 0.6;
slide.TransitionAdvanceOnClick = false;
slide.TransitionAdvanceAfterSeconds = 4;
ppt.Save();

Encrypted Presentations

using var ppt = PowerPointPresentation.Create("secure.pptx");
var slide = ppt.AddSlide();
slide.AddTitle("Confidential");
ppt.SaveEncrypted("secure.pptx", "secret");

using var reopened = PowerPointPresentation.OpenEncrypted("secure.pptx", "secret");

Designer composition sample

For business decks where you want polished placement without manually positioning every text box, use the designer composition helpers. They create editable PowerPoint shapes, text, optional pictures, and theme-driven layouts. Use PowerPointDesignIntent and layout variants when the same content should not produce the same slide every time.

using OfficeIMO.PowerPoint;

using var ppt = PowerPointPresentation.Create("designer-demo.pptx");
ppt.SlideSize.SetPreset(PowerPointSlideSizePreset.Screen16x9);
var alternatives = PowerPointDeckDesign.CreateAlternativesFromBrand("#008C95", "client-demo",
    name: "Client Theme", eyebrow: "Client Group",
    footerLeft: "CLIENT", footerRight: "Service deck");
var design = alternatives[1]; // pick the stable Editorial creative direction for this deck
var deck = ppt.UseDesigner(design);

// Or use a recipe when you want a scenario-specific family of distinct directions.
var portfolioAlternatives = PowerPointDesignRecipe.ConsultingPortfolio.CreateAlternativesFromBrand("#008C95", "client-demo",
    name: "Client Theme", footerLeft: "CLIENT", footerRight: "Service deck");
var portfolioDesign = portfolioAlternatives[0]; // Board Story, Field Proof, Quiet Appendix, ...

// Recipes can also be selected from plain-language purpose text.
var recipeChoices = PowerPointDesignRecipe.DescribeBuiltIns(); // names, keywords, directions, fonts, and moods
var purposeMatches = PowerPointDesignRecipe.DescribeMatches("technical rollout proposal");
var recipe = PowerPointDesignRecipe.FindBuiltIn("technical rollout proposal")
    ?? PowerPointDesignRecipe.ConsultingPortfolio;

// For the shortest path, start the deck composer directly from brand and purpose text.
var quickDeck = ppt.UseDesigner("#008C95", "client-demo", "technical rollout proposal",
    name: "Client Theme", footerLeft: "CLIENT", footerRight: "Service deck");

// Use a design brief when brand, purpose, identity, and custom directions should travel together.
var brief = PowerPointDesignBrief
    .FromBrand("#008C95", "client-demo", "technical rollout proposal")
    .WithIdentity("Client Theme", footerLeft: "CLIENT", footerRight: "Service deck")
    .WithCreativeDirectionPack(PowerPointCreativeDirectionPack.FieldProof)
    .WithPalette(surfaceColor: "#F6FAFC", panelBorderColor: "#D5E3EA");
var choices = brief.DescribeAlternatives(3); // direction, mood, fonts, and palette preview
var recommendations = brief.RecommendAlternatives(3); // preference score and reasons before choosing
var briefDeck = ppt.UseDesigner(brief, alternativeIndex: 1);

var packs = PowerPointDesignBrief.DescribeCreativeDirectionPacks(); // pack names, recipes, palette, and layout strategy

// A deck plan lets callers describe the story while the designer chooses the slide compositions.
var plan = new PowerPointDeckPlan()
    .AddSection("Case Study", "Project portfolio", "cover")
    .AddCaseStudy("Example client",
        new[] {
            new PowerPointCaseStudySection("Client", "A concise customer story."),
            new PowerPointCaseStudySection("Challenge", "Many details needed structure."),
            new PowerPointCaseStudySection("Solution", "Separate story, evidence, and outcome."),
            new PowerPointCaseStudySection("Result", "Keep the output editable and readable.")
        },
        seed: "case-study")
    .AddProcess("How we work", "Transparent phases reduce risk",
        new[] {
            new PowerPointProcessStep("Analysis", "Understand the environment and constraints."),
            new PowerPointProcessStep("Discovery", "Review configuration and dependencies."),
            new PowerPointProcessStep("Delivery", "Implement changes in controlled stages.")
        },
        seed: "process",
        configure: options => {
            options.Variant = PowerPointProcessLayoutVariant.Rail;
            options.ConnectorStyle = PowerPointProcessConnectorStyle.SegmentArrows;
        })
    .AddCustom("Custom detail", composer => {
        composer.AddTitle("Custom detail", "Use raw composition when a planned slide needs something special.");
        var layout = composer.UsePreset(PowerPointCompositionPreset.Auto);
        composer.AddVisualFrame(layout.Visual);
        composer.AddMetricStrip(new[] { new PowerPointMetric("2", "modes") },
            layout.Metrics);
    }, seed: "custom-detail");
var plannedSlides = plan.DescribeSlides(); // kind, title, seed, and content count
var planDiagnostics = plan.ValidateSlides(); // density, clipping, and bounds issues before rendering
var renderPreview = brief.DescribeDeckPlan(plan, alternativeIndex: 1); // variants, layout reasons, fonts, and seeds
var planChoices = brief.DescribeDeckPlanAlternatives(plan, 3); // includes content-fit score and reasons
var recommendedPlan = brief.RecommendDeckPlanAlternative(plan, 3); // strongest content-fit choice first
var recommendedDeck = ppt.UseDesigner(brief, plan, alternativeCount: 3); // choose the recommended design
var livePreview = recommendedDeck.DescribeSlides(plan); // seed preview accounts for slides already composed in this deck
recommendedDeck.AddSlides(plan); // validates errors before rendering and keeps warnings inspectable

// Process slides can keep the same semantic steps while changing only the connector treatment.
recommendedDeck.AddProcessSlide("Delivery path", null,
    new[] {
        new PowerPointProcessStep("Assess", "Map the current state."),
        new PowerPointProcessStep("Pilot", "Validate with a small group."),
        new PowerPointProcessStep("Rollout", "Move in controlled waves.")
    },
    configure: options => {
        options.Variant = PowerPointProcessLayoutVariant.Rail;
        options.ConnectorStyle = PowerPointProcessConnectorStyle.StepDots;
    });

// Raw composition can use named presets and surface variants instead of hand-picked coordinates.
recommendedDeck.ComposeSlide(composer => {
    composer.AddTitle("Advisor summary", "The preset gives structure; the content remains yours.");
    var layout = composer.UsePreset(PowerPointCompositionPreset.MetricStory,
        PowerPointCompositionVariant.VisualLead);
    composer.AddCardGrid(recommendedPlan.ContentFitReasons.Take(3)
        .Select((reason, index) => new PowerPointCardContent("Signal " + (index + 1), new[] { reason })),
        layout.Primary,
        new PowerPointCardGridSlideOptions { SurfaceStyle = PowerPointCardSurfaceStyle.Hairline });
    composer.AddVisualFrame(layout.Visual, PowerPointVisualFrameVariant.ProofBoard);
    composer.AddMetricStrip(new[] {
        new PowerPointMetric(recommendedPlan.ContentFitScore.ToString(), "fit score"),
        new PowerPointMetric(recommendedPlan.Slides.Count.ToString(), "slides")
    }, layout.Metrics, PowerPointMetricStripVariant.SeparatedTiles);
}, seed: "advisor-summary");

// Visual frames can switch between dashboard, collage, diagram, device, and proof-board treatments.
recommendedDeck.AddCapabilitySlide("Evidence", "Choose visual support without hand-drawing a frame.",
    new[] {
        new PowerPointCapabilitySection("Proof", "Editable evidence area.", new[] { "Screenshot", "Certificate" })
    },
    configure: options => options.VisualFrameVariant = PowerPointVisualFrameVariant.DeviceMockup);

// Direction motifs can be explicit too: triangles, chevrons, dots, bars, or none.
recommendedDeck.AddSectionSlide("Approach", "A calmer opening rhythm", "approach",
    configure: options => {
        options.DirectionMotifStyle = PowerPointDirectionMotifStyle.Dots;
        options.TitleAccentStyle = PowerPointTitleAccentStyle.KickerRule;
    });

// Or supply your own creative directions so decks do not all share the same house style.
var clientDirections = new[] {
    new PowerPointDesignDirection("Board Brief", PowerPointDesignMood.Corporate,
        PowerPointSlideDensity.Relaxed, PowerPointVisualStyle.Soft, "Georgia", "Aptos",
        showDirectionMotif: false),
    new PowerPointDesignDirection("Field Ops", PowerPointDesignMood.Energetic,
        PowerPointSlideDensity.Compact, PowerPointVisualStyle.Geometric, "Poppins", "Segoe UI")
};
var clientAlternatives = PowerPointDeckDesign.CreateAlternativesFromBrand("#008C95", "client-demo",
    clientDirections, name: "Client Theme", footerLeft: "CLIENT");
var uniqueBrief = PowerPointDesignBrief.FromBrand("#008C95", "client-demo")
    .WithIdentity("Client Theme", footerLeft: "CLIENT")
    .WithDirections(clientDirections)
    .WithPaletteStyle(PowerPointPaletteStyle.CoolNeutral)
    .WithTypographyStyle(PowerPointTypographyStyle.EditorialSerif)
    .WithLayoutStrategy(PowerPointAutoLayoutStrategy.Compact)
    .WithPreferredDensities(PowerPointSlideDensity.Compact);

deck.AddSectionSlide("Case Study", "Project portfolio", "cover",
    options => options.SectionVariant = PowerPointSectionLayoutVariant.EditorialRail);

deck.AddCaseStudySlide("Example client",
    new[] {
        new PowerPointCaseStudySection("Client", "A concise customer story."),
        new PowerPointCaseStudySection("Challenge", "Many details needed structure."),
        new PowerPointCaseStudySection("Solution", "Separate story, evidence, and outcome."),
        new PowerPointCaseStudySection("Result", "Keep the output editable and readable.")
    },
    seed: "case-study",
    configure: options => options.Variant = PowerPointCaseStudyLayoutVariant.EditorialSplit);

deck.AddProcessSlide("How we work", "Transparent phases reduce risk",
    new[] {
        new PowerPointProcessStep("Analysis", "Understand the environment and constraints."),
        new PowerPointProcessStep("Discovery", "Review configuration and dependencies."),
        new PowerPointProcessStep("Delivery", "Implement changes in controlled stages.")
    },
    seed: "process",
    configure: options => options.Variant = PowerPointProcessLayoutVariant.NumberedColumns);

deck.AddCardGridSlide("Scope of services", "Cards choose their own grid.",
    new[] {
        new PowerPointCardContent("Deployments", new[] { "Intune", "Autopilot" }),
        new PowerPointCardContent("Maintenance", new[] { "Incidents", "Monitoring" }),
        new PowerPointCardContent("Audits", new[] { "Configuration", "Security" })
    },
    seed: "services",
    configure: options => options.Variant = PowerPointCardGridLayoutVariant.SoftTiles);

deck.AddLogoWallSlide("Proof points", "Reusable logo and certification wall.",
    new[] {
        new PowerPointLogoItem("Lenovo", "Partner"),
        new PowerPointLogoItem("Samsung", "Devices"),
        new PowerPointLogoItem("Epson", "Service")
    },
    seed: "proof",
    configure: options => options.FeatureTitle = "Featured certification");

deck.AddCoverageSlide("Service coverage", "Pins are normalized inside the editable map panel.",
    new[] {
        new PowerPointCoverageLocation("Warszawa", 0.60, 0.48),
        new PowerPointCoverageLocation("Gdansk", 0.55, 0.18),
        new PowerPointCoverageLocation("Krakow", 0.58, 0.78)
    },
    seed: "coverage",
    configure: options => {
        options.MapLabel = "Editable locations";
    });

deck.AddCapabilitySlide("Service capability", "Structured text with visual support.",
    new[] {
        new PowerPointCapabilitySection("Warranty service",
            "Nationwide support for distributed environments.",
            new[] { "Computers and notebooks", "Printers and scanners" }),
        new PowerPointCapabilitySection("Extended care",
            "Support beyond standard vendor warranty.",
            new[] { "SLA options", "Continuity monitoring" })
    },
    seed: "capability",
    configure: options => {
        options.VisualKind = PowerPointCapabilityVisualKind.CoverageMap;
        options.VisualLabel = "Service locations";
        options.Locations.Add(new PowerPointCoverageLocation("Warszawa", 0.60, 0.48));
        options.Locations.Add(new PowerPointCoverageLocation("Gdansk", 0.55, 0.18));
        options.Metrics.Add(new PowerPointMetric("8", "locations"));
    });

deck.ComposeSlide(composer => {
    composer.AddTitle("Custom slide", "Use primitives when a recipe is too fixed.");
    var columns = composer.ContentColumns(2);
    composer.AddCardGrid(new[] {
        new PowerPointCardContent("Story", new[] { "Context", "Need" }),
        new PowerPointCardContent("Evidence", new[] { "Metrics", "Visual" })
    }, columns[0]);
    composer.AddCoverageMap(new[] {
        new PowerPointCoverageLocation("North", 0.45, 0.20),
        new PowerPointCoverageLocation("Central", 0.60, 0.48)
    }, columns[1].TakeTopCm(3.0));
    composer.AddCalloutBand("Use composer regions when the slide needs its own structure.",
        columns[1].TakeBottomCm(1.5));
}, "custom");

ppt.Save();

Runnable sample:

dotnet run --project OfficeIMO.Examples/OfficeIMO.Examples.csproj -f net10.0 -- --designer-powerpoint
dotnet run --project OfficeIMO.Examples/OfficeIMO.Examples.csproj -f net10.0 -- --powerpoint-layout-strategy

The helpers are intentionally not fixed templates. Start with PowerPointDeckDesign.FromBrand(...) to define the deck personality once, including brand color, stable seed, mood, fonts, and chrome. Use a named PowerPointDesignDirection such as Structured, Editorial, Quiet, Signal, or Executive when you want a recognizable creative direction without hand-tuning every slide. Use PowerPointDesignRecipe values such as ConsultingPortfolio, ExecutiveBrief, TechnicalProposal, or TransformationRoadmap when you want a scenario-specific family of alternatives instead of one house style repeated across every client deck. The deck design configures per-slide PowerPointDesignIntent values so repeated content can receive stable but different accents, motifs, and automatic layout choices. Auto variants use both the design intent and the content shape: dense card grids stay compact, softer moods get softer cards, long processes stay readable, proof slides emphasize supplied certificate details, many locations become list-plus-map slides, section-heavy capability slides stack into readable panels, and content-rich case studies choose stronger structure. Use PowerPointDeckDesign.CreateAlternativesFromBrand(...) with either a count, custom directions, or a recipe when you want stable choices from the same brand before choosing the deck personality.

Use PowerPointDesignBrief.WithLayoutStrategy(...) when Auto variants should lean toward content fit, seeded design variety, compact business layouts, or more visual hero/proof compositions without hardcoding every slide variant. Use WithTypographyStyle(...) when the same brand and slide plan should feel more editorial, executive, technical, or friendly without rewriting every creative direction. Use SurfaceStyle on card-grid options when cards should be elevated, flat, hairline, or accent-washed without changing the card content or layout. Use DirectionMotifStyle on slide options when the small movement markers should be triangles, chevrons, dots, bars, or hidden entirely for quieter slides. Use TitleAccentStyle on section-slide options when titles should use an underline, side rule, editorial kicker rule, or no extra accent without changing the section layout. Use RecommendDeckPlanAlternative(...) when callers want the library to pick the strongest content-fit alternative from the same plan while still returning the selected design index and reasons. Use presentation.UseDesigner(brief, plan, alternativeCount: ...) when the caller wants to skip manual ranking and compose with the recommended alternative directly. Run the layout strategy sample when you want to compare the same semantic PowerPointDeckPlan rendered through different brief-level palette and layout choices. Use explicit layout variants when a deck needs a controlled art direction, or use ComposeDesignerSlide and PowerPointLayoutBox regions when the slide needs a custom composition while still reusing cards, metrics, process steps, logo walls, coverage maps, and callout bands.

Common Tasks by Example

Title + content

var slide = ppt.AddSlide();
slide.AddTitle("Quarterly Review");
slide.AddTextBox("Agenda\n• Intro\n• KPIs\n• Next Steps",
    PowerPointUnits.Cm(1.5), PowerPointUnits.Cm(2.5), PowerPointUnits.Cm(7.5), PowerPointUnits.Cm(3.0));

Bullets (API)

var box = slide.AddTextBox("Agenda:");
box.AddBullets(new[] { "Intro", "KPIs", "Next Steps" });

Numbered lists

var box = slide.AddTextBox("Plan:");
box.AddNumberedList(new[] { "Discover", "Design", "Deliver" });

Text styles + spacing

var box = slide.AddTextBox("Highlights");
box.AddBullets(new[] { "Readable defaults", "Auto spacing", "Consistent styles" });
box.ApplyTextStyle(PowerPointTextStyle.Body.WithColor("1F4E79"));
box.ApplyAutoSpacing(lineSpacingMultiplier: 1.15, spaceAfterPoints: 2);

Markdown rich text

var box = slide.AddTextBox(string.Empty);
box.SetMarkdown("""
    # Launch plan
    - **Owner:** Platform
    - Track `net472` and [docs](https://example.com)
    """);

Text box layout (margins + autofit)

using A = DocumentFormat.OpenXml.Drawing;

var box = slide.AddTextBox("Inset text");
box.SetTextMarginsCm(0.3, 0.2, 0.3, 0.2);
box.SetTextAutoFit(PowerPointTextAutoFit.Normal,
    new PowerPointTextAutoFitOptions(fontScalePercent: 85, lineSpaceReductionPercent: 10));
box.TextVerticalAlignment = A.TextAnchoringTypeValues.Center;

Images

slide.AddPicture("logo.png",
    PowerPointUnits.Cm(23), PowerPointUnits.Cm(1.2), PowerPointUnits.Cm(5), PowerPointUnits.Cm(2));

using var logoStream = File.OpenRead("logo.png");
slide.AddPicture(logoStream, ImagePartType.Png,
    PowerPointUnits.Cm(23), PowerPointUnits.Cm(1.2), PowerPointUnits.Cm(5), PowerPointUnits.Cm(2));

slide.AddPicture("diagram.svg",
    PowerPointUnits.Cm(2), PowerPointUnits.Cm(2), PowerPointUnits.Cm(8), PowerPointUnits.Cm(4));

Embedded audio and video

var video = slide.AddVideo("demo.mp4", posterImagePath: "poster.png",
    left: PowerPointUnits.Cm(2), top: PowerPointUnits.Cm(3),
    width: PowerPointUnits.Cm(12), height: PowerPointUnits.Cm(6.75));

var audio = slide.AddAudio("voiceover.mp3",
    left: PowerPointUnits.Cm(2), top: PowerPointUnits.Cm(11));

var mediaFrames = slide.Media;

SmartArt

var smartArt = slide.AddSmartArt(PowerPointSmartArtType.BasicProcess,
    left: PowerPointUnits.Cm(2), top: PowerPointUnits.Cm(3),
    width: PowerPointUnits.Cm(12), height: PowerPointUnits.Cm(7));
smartArt.SetNodeText(0, "OfficeIMO-native process");

Create and edit with streams

using var stream = new MemoryStream();

using (var ppt = PowerPointPresentation.Create(stream)) {
    ppt.AddSlide().AddTitle("Created in memory");
}

using (var ppt = PowerPointPresentation.Open(stream, readOnly: false, autoSave: true)) {
    ppt.AddSlide().AddTitle("Updated from the same stream");
}

Background image

slide.SetBackgroundImage("hero.png");

Background gradient

slide.SetBackgroundGradient("0F172A", "2563EB");
slide.SetBackgroundGradient("0F172A", "2563EB", 45d);

Simple shapes

slide.AddRectangle(PowerPointUnits.Cm(1), PowerPointUnits.Cm(1),
    PowerPointUnits.Cm(3), PowerPointUnits.Cm(1))
    .Fill("#E7F7FF")
    .Stroke("#007ACC");

Lines (dash + arrows)

using A = DocumentFormat.OpenXml.Drawing;

var line = slide.AddLine(
    PowerPointUnits.Cm(1), PowerPointUnits.Cm(1),
    PowerPointUnits.Cm(8), PowerPointUnits.Cm(1));
line.OutlineColor = "2F5597";
line.OutlineDash = A.PresetLineDashValues.Dash;
line.SetLineEnds(A.LineEndValues.Triangle, A.LineEndValues.Stealth,
    A.LineEndWidthValues.Medium, A.LineEndLengthValues.Medium);

Shape effects (shadow + glow + blur)

var card = slide.AddRectangle(PowerPointUnits.Cm(1), PowerPointUnits.Cm(4),
    PowerPointUnits.Cm(6), PowerPointUnits.Cm(2), "Card");
card.FillColor = "FFFFFF";
card.OutlineColor = "D0D0D0";
card.SetShadow("000000", blurPoints: 6, distancePoints: 4,
    angleDegrees: 270, transparencyPercent: 40);
card.SetGlow("000000", radiusPoints: 3, transparencyPercent: 60);
card.SetSoftEdges(1.5);
card.SetBlur(2, grow: false);

Shape effects (reflection)

var logo = slide.AddRectangle(PowerPointUnits.Cm(10), PowerPointUnits.Cm(4),
    PowerPointUnits.Cm(4), PowerPointUnits.Cm(2), "Logo");
logo.SetReflection(blurPoints: 4, distancePoints: 2, directionDegrees: 270,
    fadeDirectionDegrees: 90, startOpacityPercent: 60, endOpacityPercent: 0);

Align + distribute shapes

slide.AlignShapes(slide.Shapes, PowerPointShapeAlignment.Left);
slide.DistributeShapes(slide.Shapes, PowerPointShapeDistribution.Horizontal);   

slide.AlignShapesToSlideContent(slide.Shapes, PowerPointShapeAlignment.Left,
    marginEmus: PowerPointUnits.Cm(1));
slide.DistributeShapesToSlideContent(slide.Shapes, PowerPointShapeDistribution.Horizontal,
    marginEmus: PowerPointUnits.Cm(1));
slide.DistributeShapes(slide.Shapes, PowerPointShapeDistribution.Horizontal,
    PowerPointShapeAlignment.Bottom);

slide.DistributeShapesWithSpacing(slide.Shapes, PowerPointShapeDistribution.Horizontal,
    spacingEmus: PowerPointUnits.Cm(0.5), center: true);

slide.DistributeShapesWithSpacing(slide.Shapes, PowerPointShapeDistribution.Horizontal,
    spacingEmus: PowerPointUnits.Cm(0.5), PowerPointShapeAlignment.Right);      
slide.DistributeShapesWithSpacing(slide.Shapes, PowerPointShapeDistribution.Horizontal,
    spacingEmus: PowerPointUnits.Cm(0.5), PowerPointShapeAlignment.Right,
    PowerPointShapeAlignment.Bottom);

slide.DistributeShapesWithSpacing(slide.Shapes, PowerPointShapeDistribution.Horizontal,
    new PowerPointShapeSpacingOptions {
        SpacingEmus = PowerPointUnits.Cm(0.4),
        ClampSpacingToBounds = true,
        Alignment = PowerPointShapeAlignment.Center,
        CrossAxisAlignment = PowerPointShapeAlignment.Bottom
    });
slide.DistributeShapesWithSpacing(slide.Shapes, PowerPointShapeDistribution.Horizontal,
    new PowerPointShapeSpacingOptions {
        SpacingEmus = PowerPointUnits.Cm(0.4),
        ScaleToFitBounds = true,
        PreserveAspect = true
    });

slide.DistributeShapesWithSpacingToSlideContent(slide.Shapes, PowerPointShapeDistribution.Horizontal,
    spacingEmus: PowerPointUnits.Cm(0.5), marginEmus: PowerPointUnits.Cm(1));

slide.StackShapes(slide.Shapes, PowerPointShapeStackDirection.Horizontal,
    spacingEmus: PowerPointUnits.Cm(0.3), PowerPointShapeAlignment.Bottom);
slide.StackShapesToSlideContent(slide.Shapes, PowerPointShapeStackDirection.Vertical,
    spacingEmus: PowerPointUnits.Cm(0.3), marginEmus: PowerPointUnits.Cm(1));

slide.StackShapes(slide.Shapes, PowerPointShapeStackDirection.Horizontal,
    spacingEmus: PowerPointUnits.Cm(0.3), PowerPointShapeStackJustify.Center);

slide.StackShapes(slide.Shapes, PowerPointShapeStackDirection.Horizontal,       
    new PowerPointShapeStackOptions {
        SpacingEmus = PowerPointUnits.Cm(0.4),
        ClampSpacingToBounds = true,
        Justify = PowerPointShapeStackJustify.Center
    });
slide.StackShapes(slide.Shapes, PowerPointShapeStackDirection.Horizontal,
    new PowerPointShapeStackOptions {
        SpacingEmus = PowerPointUnits.Cm(0.4),
        ScaleToFitBounds = true,
        PreserveAspect = true
    });

Resize shapes

slide.ResizeShapes(slide.Shapes, PowerPointShapeSizeDimension.Width, PowerPointShapeSizeReference.Largest);
slide.ResizeShapesCm(slide.Shapes, widthCm: 3.0, heightCm: null);

Shape bounds + movement

var shape = slide.AddRectangle(0, 0, PowerPointUnits.Cm(3), PowerPointUnits.Cm(2));

shape.Right = PowerPointUnits.Cm(10);
shape.CenterX = PowerPointUnits.Cm(12);
shape.Bounds = PowerPointLayoutBox.FromCentimeters(2, 2, 4, 2);

shape.MoveBy(PowerPointUnits.Cm(0.5), PowerPointUnits.Cm(0.25));
shape.Resize(PowerPointUnits.Cm(5), PowerPointUnits.Cm(2), PowerPointShapeAnchor.Center);
shape.Scale(1.2, PowerPointShapeAnchor.BottomRight);

var inArea = slide.GetShapesInBounds(
    PowerPointLayoutBox.FromCentimeters(1, 1, 5, 3),
    includePartial: true);

Grid layout

slide.ArrangeShapesInGrid(slide.Shapes,
    new PowerPointLayoutBox(0, 0, 8000, 4000),
    columns: 4, rows: 2, gutterX: 200, gutterY: 200,
    flow: PowerPointShapeGridFlow.RowMajor);

slide.ArrangeShapesInGridAuto(slide.Shapes,
    new PowerPointLayoutBox(0, 0, 8000, 4000));

slide.ArrangeShapesInGridAuto(slide.Shapes,
    new PowerPointLayoutBox(0, 0, 8000, 4000),
    new PowerPointShapeGridOptions { MinColumns = 2, MaxColumns = 4, TargetCellAspect = 1.0 });

slide.ArrangeShapesInGridToSlideContent(slide.Shapes, columns: 3, rows: 2,
    marginEmus: PowerPointUnits.Cm(1), gutterX: PowerPointUnits.Cm(0.5));

Fit shapes to bounds

slide.FitShapesToBounds(slide.Shapes, new PowerPointLayoutBox(0, 0, 8000, 4500));
slide.FitShapesToSlideContentCm(slide.Shapes, marginCm: 1.0, preserveAspect: true, center: true);

Group + ungroup shapes

var group = slide.GroupShapes(slide.Shapes);
slide.UngroupShape(group);

slide.AlignGroupChildren(group, PowerPointShapeAlignment.Left);
slide.DistributeGroupChildrenWithSpacing(group, PowerPointShapeDistribution.Horizontal,
    spacingEmus: PowerPointUnits.Cm(0.4));
slide.StackGroupChildren(group, PowerPointShapeStackDirection.Vertical,
    new PowerPointShapeStackOptions { SpacingEmus = PowerPointUnits.Cm(0.3) });
slide.ArrangeGroupChildrenInGrid(group, columns: 2, rows: 2);

var groupTextBoxes = slide.GetGroupTextBoxes(group);
var groupBoundsCm = slide.GetGroupChildBoundsCm(group);

Arrange + duplicate shapes

slide.BringForward(shape);
slide.SendBackward(shape);
slide.BringToFront(shape);
slide.SendToBack(shape);

var copy = slide.DuplicateShapeCm(shape, 0.5, 0.5);

Shape lookup + metadata

var title = slide.AddTextBox("Quarterly update");
title.Name = "Hero Title";
title.AltText = "Main slide title";

var found = slide.GetShapeByName<PowerPointTextBox>("Hero Title");
var sameShape = slide.GetShapeById(found!.Id!.Value);

var copy = found.DuplicateCm(0.4, 0.4);
copy.Name = "Hero Title Copy";

found.Hidden = true;
copy.Remove();

Slide properties

ppt.BuiltinDocumentProperties.Title = "Contoso Review";
ppt.ApplicationProperties.Company = "Contoso";

Slide visibility + duplication

var duplicate = ppt.DuplicateSlide(0);
duplicate.Hidden = true;

Single-slide export and optional previews

ppt.ExportSlide(0, "slide-preview-source.pptx");

if (PowerPointPreviewExporter.TryExportSlides(
        "slide-preview-source.pptx",
        "preview",
        out var preview,
        PowerPointPreviewExportFormat.Png)) {
    var pngFiles = preview.Files;
}

Preview export is optional and host-dependent. OfficeIMO creates the .pptx with Open XML; PowerPointPreviewExporter uses installed Microsoft PowerPoint automation only when the caller explicitly asks for rendered PNG/JPEG slide previews.

Slide layouts + theme helpers

using DocumentFormat.OpenXml.Presentation;

var layouts = ppt.GetSlideLayouts();
var titleLayoutIndex = ppt.GetLayoutIndex(SlideLayoutValues.Title);

var slide = ppt.AddSlide(SlideLayoutValues.TitleOnly);
slide.SetLayout("Title and Content");

ppt.SetThemeColor(PowerPointThemeColor.Accent1, "FF0000");
ppt.SetThemeLatinFonts("Aptos", "Calibri");
ppt.SetThemeFonts(new PowerPointThemeFontSet(
    majorLatin: "Aptos",
    minorLatin: "Calibri",
    majorEastAsian: "MS Mincho",
    minorEastAsian: "Yu Gothic",
    majorComplexScript: "Arial",
    minorComplexScript: "Tahoma"));

// Apply updates across all masters
ppt.SetThemeColorForAllMasters(PowerPointThemeColor.Accent2, "00B0F0");
ppt.SetThemeLatinFontsForAllMasters("Aptos", "Calibri");
ppt.SetThemeNameForAllMasters("Contoso Theme");

Import slide from another deck

using var source = PowerPointPresentation.Open("source.pptx");
var imported = ppt.ImportSlide(source, sourceIndex: 0);
imported.AddTextBox("Imported content");

Charts (formatting)

using C = DocumentFormat.OpenXml.Drawing.Charts;

var chart = slide.AddChart();
var labelTemplate = new PowerPointChartDataLabelTemplate {
    ShowValue = true,
    ShowCategoryName = true,
    Position = C.DataLabelPositionValues.OutsideEnd,
    NumberFormat = "0.0",
    Separator = " - ",
    TextColor = "1F4E79",
    FillColor = "FFFFFF",
    LineColor = "1F4E79",
    LineWidthPoints = 0.5
};

chart.SetTitle("Sales Trend")
     .SetChartAreaStyle(fillColor: "F2F2F2", lineColor: "404040", lineWidthPoints: 1.25)
     .SetPlotAreaStyle(fillColor: "FFFFFF", lineColor: "00B0F0", lineWidthPoints: 0.5)
     .SetTitleTextStyle(fontSizePoints: 18, bold: true, color: "1F4E79", fontName: "Calibri")
     .ClearTitleTextStyle()
     .SetLegend(C.LegendPositionValues.Right)
     .SetLegendTextStyle(fontSizePoints: 9, italic: true, color: "404040", fontName: "Calibri")
     .ClearLegendTextStyle()
     .SetDataLabels(showValue: true)
     .SetDataLabelPosition(C.DataLabelPositionValues.OutsideEnd)
     .SetDataLabelNumberFormat("#,##0.0", sourceLinked: false)
     .SetDataLabelTextStyle(fontSizePoints: 9, color: "1F4E79")
     .SetDataLabelShapeStyle(fillColor: "FFFFFF", lineColor: "1F4E79", lineWidthPoints: 0.5)
     .SetDataLabelLeaderLines(showLeaderLines: true, lineColor: "1F4E79", lineWidthPoints: 0.5)
     .SetDataLabelSeparator(" | ")
     .SetDataLabelTemplate(labelTemplate)
     .SetDataLabelCallouts(enabled: true, lineColor: "1F4E79", lineWidthPoints: 0.5)
     .SetSeriesDataLabelTemplate(0, labelTemplate)
     .SetSeriesDataLabelTextStyle(0, bold: true, color: "C00000")
     .SetSeriesDataLabelSeparator(0, " / ")
     .SetSeriesDataLabels(0, showValue: true, showCategoryName: true, position: C.DataLabelPositionValues.Top, numberFormat: "0.0")
     .SetSeriesDataLabelCallouts(0, enabled: true, lineColor: "C00000", lineWidthPoints: 0.75)
     .SetSeriesDataLabelForPoint(0, 1, showValue: true, showCategoryName: true, position: C.DataLabelPositionValues.OutsideEnd, numberFormat: "0.00")
     .SetSeriesDataLabelTemplateForPoint(0, 1, labelTemplate)
     .SetSeriesDataLabelLeaderLines(0, showLeaderLines: true, lineColor: "C00000", lineWidthPoints: 0.75)
     .SetSeriesDataLabelCalloutsForPoint(0, 1, enabled: true)
     .SetSeriesDataLabelSeparatorForPoint(0, 1, " | ")
     .SetSeriesDataLabelTextStyleForPoint(0, 1, fontSizePoints: 11, bold: true, color: "C00000")
     .SetSeriesDataLabelShapeStyleForPoint(0, 1, fillColor: "FFF2CC", lineColor: "C00000", lineWidthPoints: 0.75)
     .SetSeriesTrendline(0, C.TrendlineValues.Polynomial, order: 2, lineColor: "ED7D31", lineWidthPoints: 1.5)
     .SetCategoryAxisTitle("Quarter")
     .SetCategoryAxisTitleTextStyle(fontSizePoints: 11, bold: true, color: "1F4E79", fontName: "Calibri")
     .ClearCategoryAxisTitleTextStyle()
     .SetCategoryAxisLabelTextStyle(fontSizePoints: 9, color: "404040", fontName: "Calibri")
     .ClearCategoryAxisLabelTextStyle()
     .SetCategoryAxisLabelRotation(45)
     .SetCategoryAxisTickLabelPosition(C.TickLabelPositionValues.High)
     .SetCategoryAxisGridlines(showMajor: true, lineColor: "D9D9D9", lineWidthPoints: 0.5)
     .ClearCategoryAxisGridlines()
     .SetValueAxisTitle("Revenue")
     .SetValueAxisTitleTextStyle(fontSizePoints: 10, italic: true, color: "C55A11", fontName: "Arial")
     .ClearValueAxisTitleTextStyle()
     .SetValueAxisLabelTextStyle(fontSizePoints: 9, italic: true, color: "595959", fontName: "Arial")
     .ClearValueAxisLabelTextStyle()
     .SetValueAxisTickLabelPosition(C.TickLabelPositionValues.Low)
     .SetValueAxisGridlines(showMajor: true, showMinor: true, lineColor: "C0C0C0", lineWidthPoints: 0.75)
     .ClearValueAxisGridlines()
     .SetValueAxisNumberFormat("#,##0.00")
     .SetCategoryAxisReverseOrder()
     .SetValueAxisScale(minimum: 0, maximum: 100, majorUnit: 20, minorUnit: 10)
     .SetValueAxisCrossing(C.CrossesValues.Maximum)
     .SetValueAxisCrossBetween(C.CrossBetweenValues.Between)
     .SetValueAxisDisplayUnits(C.BuiltInUnitValues.Thousands, "Thousands USD", showLabel: true)
     .SetCategoryAxisCrossing(C.CrossesValues.Minimum)
     .SetSeriesFillColor(0, "4472C4")
     .SetSeriesLineColor("Series 2", "ED7D31", widthPoints: 1)
     .SetSeriesMarker(0, C.MarkerStyleValues.Circle, size: 6, fillColor: "FFFFFF", lineColor: "4472C4");

chart.ClearDataLabels();
chart.ClearSeriesDataLabels(0);
chart.ClearSeriesDataLabelForPoint(0, 1);

Pie and doughnut charts

var chartData = new PowerPointChartData(
    new[] { "North", "South", "West" },
    new[] { new PowerPointChartSeries("Revenue", new[] { 10d, 20d, 30d }) });

slide.AddPieChart(chartData)
    .SetTitle("Revenue Share")
    .SetDataLabels(showValue: true, showPercent: true);

slide.AddDoughnutChart(chartData, PowerPointUnits.Cm(10), PowerPointUnits.Cm(2),
    PowerPointUnits.Cm(8), PowerPointUnits.Cm(5))
    .SetTitle("Revenue Mix");

Scatter chart axes

var scatterData = new PowerPointScatterChartData(new[] {
    new PowerPointScatterChartSeries("Revenue", new[] { 1d, 2d, 3d, 4d }, new[] { 10d, 15d, 12d, 18d })
});

slide.AddScatterChart(scatterData)
    .SetTitle("Revenue Scatter")
    .SetScatterXAxisTitle("Month")
    .SetScatterYAxisTitle("Revenue")
    .SetScatterXAxisTitleTextStyle(fontSizePoints: 11, bold: true, color: "1F4E79", fontName: "Calibri")
    .SetScatterYAxisTitleTextStyle(fontSizePoints: 10, italic: true, color: "C55A11", fontName: "Arial")
    .ClearScatterXAxisTitleTextStyle()
    .ClearScatterYAxisTitleTextStyle()
    .SetScatterXAxisLabelTextStyle(fontSizePoints: 9, bold: true, color: "404040", fontName: "Calibri")
    .SetScatterYAxisLabelTextStyle(fontSizePoints: 10, italic: true, color: "1F4E79", fontName: "Arial")
    .ClearScatterXAxisLabelTextStyle()
    .ClearScatterYAxisLabelTextStyle()
    .SetScatterXAxisLabelRotation(45)
    .SetScatterYAxisLabelRotation(-30)
    .SetScatterXAxisTickLabelPosition(C.TickLabelPositionValues.Low)
    .SetScatterYAxisTickLabelPosition(C.TickLabelPositionValues.High)
    .SetScatterXAxisGridlines(showMajor: true, lineColor: "D9D9D9", lineWidthPoints: 0.5)
    .SetScatterYAxisGridlines(showMajor: true, showMinor: true, lineColor: "C0C0C0", lineWidthPoints: 0.75)
    .ClearScatterXAxisGridlines()
    .ClearScatterYAxisGridlines()
    .SetScatterXAxisNumberFormat("0.0")
    .SetScatterYAxisNumberFormat("#,##0.00")
    .SetScatterXAxisDisplayUnits(C.BuiltInUnitValues.Hundreds, "Hundreds X", showLabel: true)
    .SetScatterYAxisDisplayUnits(1000d, "Thousands Y", showLabel: true)
    .SetScatterXAxisScale(minimum: 1, maximum: 12, majorUnit: 1)
    .SetScatterYAxisScale(minimum: 0, maximum: 20, majorUnit: 5)
    .SetScatterYAxisCrossing(crossesAt: 2d);

Layouts and notes (fluent)

using OfficeIMO.PowerPoint.Fluent;

ppt.AsFluent()
   .Slide(masterIndex: 0, layoutIndex: 0, s =>
   {
       s.Title("Fluent Slide");
       s.Bullets("One", "Two", "Three");
       s.Notes("Talking points for the presenter");
   });

Tables (data binding)

record SalesRow(string Product, int Q1, int Q2);

var rows = new[] {
    new SalesRow("Alpha", 12, 15),
    new SalesRow("Beta", 9, 11)
};

var columns = new[] {
    PowerPointTableColumn<SalesRow>.Create("Product", r => r.Product).WithWidthCm(4.0),
    PowerPointTableColumn<SalesRow>.Create("Q1", r => r.Q1),
    PowerPointTableColumn<SalesRow>.Create("Q2", r => r.Q2)
};

slide.AddTable(rows, columns, left: PowerPointUnits.Cm(1.5), top: PowerPointUnits.Cm(4),
    width: PowerPointUnits.Cm(20), height: PowerPointUnits.Cm(6));

Tables (merged cells)

var table = slide.AddTable(rows: 4, columns: 4, left: PowerPointUnits.Cm(1.5),  
    top: PowerPointUnits.Cm(4), width: PowerPointUnits.Cm(20), height: PowerPointUnits.Cm(6));
table.GetCell(0, 0).Text = "Merged header";
table.MergeCells(0, 0, 0, 3);

Tables (formatting helpers)

using A = DocumentFormat.OpenXml.Drawing;

var table = slide.AddTable(rows: 3, columns: 3, left: PowerPointUnits.Cm(1), top: PowerPointUnits.Cm(5),
    width: PowerPointUnits.Cm(18), height: PowerPointUnits.Cm(5));

table.SetRowHeightsEvenly();
table.SetCellPaddingCm(0.2, 0.1, 0.2, 0.1);
table.SetCellAlignment(A.TextAlignmentTypeValues.Center, A.TextAnchoringTypeValues.Center,
    startRow: 0, endRow: 0, startColumn: 0, endColumn: 2);
table.SetCellBorders(TableCellBorders.All, "E0E0E0", widthPoints: 0.5,
    dash: A.PresetLineDashValues.Dash);
table.GetCell(0, 0).SetTextAutoFit(PowerPointTextAutoFit.Normal,
    new PowerPointTextAutoFitOptions(fontScalePercent: 80, lineSpaceReductionPercent: 10));

Tables (style presets)

var themed = slide.AddTable(rows: 4, columns: 4,
    styleName: "Medium Style 2 - Accent 1",
    left: PowerPointUnits.Cm(1), top: PowerPointUnits.Cm(1),
    width: PowerPointUnits.Cm(18), height: PowerPointUnits.Cm(5),
    firstRow: true, bandedRows: true);

var headerOnly = slide.AddTable(rows: 3, columns: 3,
    preset: PowerPointTableStylePreset.HeaderOnly,
    left: PowerPointUnits.Cm(1), top: PowerPointUnits.Cm(7),
    width: PowerPointUnits.Cm(18), height: PowerPointUnits.Cm(5));

Guides & grid

ppt.SnapToGrid = true;
ppt.SetGridSpacingCm(0.5, 0.5);

ppt.ClearGuides();
ppt.AddGuideCm(PowerPointGuideOrientation.Vertical, 2.0);
ppt.AddColumnGuidesCm(columnCount: 3, marginCm: 1.0, gutterCm: 0.5,
    includeOuterEdges: true);

Placeholders (layout-driven)

using DocumentFormat.OpenXml.Presentation;

var slide = ppt.AddSlide(masterIndex: 0, layoutIndex: 1);
var title = slide.GetPlaceholder(PlaceholderValues.Title);
title?.SetTextMarginsCm(0.2, 0.1, 0.2, 0.1);
if (title != null) title.Text = "Layout Placeholder";

var layoutPlaceholders = slide.GetLayoutPlaceholders();
var titleBounds = slide.GetLayoutPlaceholderBounds(PlaceholderValues.Title);
if (titleBounds != null) {
    var aligned = slide.AddTextBox("Aligned to layout");
    titleBounds.Value.ApplyTo(aligned);
}

int textLayout = ppt.GetLayoutIndex(SlideLayoutValues.Text);
ppt.EnsureLayoutHeaderFooterPlaceholders(
    layoutIndex: textLayout,
    footerText: "Confidential",
    dateTimeText: "2026-05-16",
    slideNumberText: "#");

Replace text

ppt.ReplaceText("FY24", "FY25", includeTables: true, includeNotes: true);

Sections

ppt.AddSection("Intro", startSlideIndex: 0);
ppt.AddSection("Results", startSlideIndex: 2);
ppt.RenameSection("Results", "Deep Dive");

var sections = ppt.GetSections();

Feature Highlights

  • Slides: add, import, duplicate, reorder, hide, edit, and section slides
  • Sections: add, rename, and list sections
  • Shapes: basic rectangles/ellipses/lines with fill/stroke, line styles, shadows/glow/soft edges/blur/reflection; align/distribute; z-order + duplicate
  • Images: add images from file/stream (PNG/JPEG/GIF/BMP/TIFF/SVG/EMF/WMF/ICO/PCX)
  • Media: embed audio/video with playback relationships and generated or supplied poster frames
  • SmartArt: add native Basic Process SmartArt and edit node text
  • Properties: set built‑in and application properties
  • Themes & transitions: default theme/table styles + slide transitions
  • Guides & grid: snap, spacing, and guide helpers
  • Text boxes: markdown rich text, margins, auto-fit, vertical alignment
  • Tables: styling + merged cells + sizing helpers
  • Placeholders: read/update layout placeholders
  • Backgrounds: set background images
  • Text replacement: find/replace across slides
  • Charts: add + format titles/legend/labels/series/markers
  • Export: save a slide as a standalone .pptx and optionally render previews through installed PowerPoint automation

Feature Matrix (scope today)

  • 📽️ Slides
    • ✅ Add slides; ✅ import/duplicate/reorder; ✅ hide/show; ✅ sections; ✅ set title; ✅ add text boxes; ✅ markdown/bullets
  • 🖼️ Media & Shapes
    • ✅ Insert images including SVG; ✅ embed audio/video; ✅ basic shapes (rect/ellipse/line) with fill/stroke + effects; ✅ align/distribute/arrange
  • 🗒️ Notes & Layout
    • ✅ Speaker notes; ✅ guides/grid helpers; ✅ native footer/date/slide-number layout placeholders; ⚠️ basic layout selection
  • 🧩 SmartArt
    • ✅ Native Basic Process diagram parts; ✅ editable node text
  • 📋 Tables
    • ⚠️ Basic styling + merged cells
  • 📊 Charts
    • ✅ Add clustered column, pie, and doughnut charts; ✅ title/legend/labels; ✅ axis formatting; ✅ series fill/line/markers
  • ✨ Themes/Transitions
    • ✅ Default theme + full table styles; ✅ slide transitions (fade/wipe/push/etc.)

Roadmap: richer shape/text APIs, layout/master controls, advanced charts — tracked in issues.

Why OfficeIMO.PowerPoint (today)

  • Cross‑platform Open XML authoring; optional PowerPoint automation is isolated to preview export
  • Simple API surface to add slides, titles, text, bullets, images, media, and SmartArt without repair prompts
  • Fluent helpers available for quick demos and templated decks

Measurements

Positions and sizes are stored in EMUs (English Metric Units). Use PowerPointUnits or the SetPositionCm/SetSizeCm helpers to work in centimeters, inches, or points.

Slide size presets

ppt.SlideSize.SetPreset(PowerPointSlideSizePreset.Screen16x9);
ppt.SlideSize.SetPreset(PowerPointSlideSizePreset.Screen4x3, portrait: true);
ppt.SlideSize.SetSizeCm(25.4, 14.0); // custom size
var ratio = ppt.SlideSize.AspectRatio;
var portrait = ppt.SlideSize.IsPortrait;

Layout helpers

var content = ppt.SlideSize.GetContentBoxCm(1.5);
var columns = ppt.SlideSize.GetColumnsCm(2, marginCm: 1.5, gutterCm: 1.0);      
columns[0].ApplyTo(slide.AddTextBox("Left column"));
columns[1].ApplyTo(slide.AddTextBox("Right column"));

Layout boxes as parameters

var content = ppt.SlideSize.GetContentBoxCm(1.5);
var columns = content.SplitColumnsCm(2, 1.0);
slide.AddTextBox("Left column", columns[0]);
slide.AddPicture("logo.png", columns[1]);

Dependencies & License

  • DocumentFormat.OpenXml: range [3.5.1, 4.0.0)
  • License: MIT
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 is compatible.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on OfficeIMO.PowerPoint:

Package Downloads
OfficeIMO.Reader

Unified, read-only document extraction facade for OfficeIMO (Word/Excel/PowerPoint/Markdown/PDF) intended for AI ingestion.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on OfficeIMO.PowerPoint:

Repository Stars
EvotecIT/PSWriteOffice
PowerShell Module to create and edit Microsoft Word, Microsoft Excel, and Microsoft PowerPoint documents without having Microsoft Office installed.
Version Downloads Last Updated
1.0.27 0 5/20/2026
1.0.26 167 5/19/2026
1.0.25 260 5/18/2026
1.0.24 480 5/16/2026
1.0.23 359 5/14/2026
1.0.22 546 5/14/2026
1.0.21 640 5/7/2026
1.0.20 521 5/1/2026
1.0.19 427 4/27/2026
1.0.18 597 4/10/2026
1.0.17 140 4/9/2026
1.0.16 363 4/3/2026
1.0.15 145 4/1/2026
1.0.14 299 3/23/2026
1.0.13 999 3/19/2026
1.0.12 139 3/18/2026
1.0.11 142 3/18/2026
1.0.10 176 3/16/2026
1.0.9 141 3/15/2026
1.0.8 477 3/13/2026
Loading failed