Developer Guide

This guide covers the core capabilities of Aspose.Slides FOSS for .NET with runnable code examples for each feature area.

In This Section

Page	Description
Features and Capabilities	Full list of supported features: slides, shapes, text, fill, effects, 3D formatting, notes, comments, images, and document properties.
Working with Images	Embed images into slides as picture frames from file or stream; control fill mode (stretch, tile).
Working with Connectors	Add bent, elbow, and straight connectors between shapes; set connection sites and line style.
Working with 3D Effects	Apply outer shadow, glow, blur, bevel, camera presets, light rigs, and materials to shapes.
Working with Comments	Add threaded review comments and speaker notes; manage comment authors; read annotations.

API Entry Point

Every operation starts with a Presentation object. Always use it with a using statement:

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

// Open existing
using var prs = new Presentation("input.pptx");
// work with prs
prs.Save("output.pptx", SaveFormat.Pptx);

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

// Create new
using var prs = new Presentation();
// work with prs
prs.Save("new.pptx", SaveFormat.Pptx);

The using statement ensures that internal resources are released when the scope exits. Do not store a Presentation reference beyond its using scope.

Supported Output Format

The only supported save format is PPTX (SaveFormat.Pptx). Export to PDF, HTML, SVG, or image formats is not available in this edition.

Key Classes

Class / Enum	Namespace	Description
`Presentation`	`Aspose.Slides.Foss`	Root container; implements `IDisposable`
`ShapeType`	`Aspose.Slides.Foss`	Enum for shape types (Rectangle, Ellipse, …)
`FillType`	`Aspose.Slides.Foss`	Enum for fill types (Solid, Gradient, …)
`NullableBool`	`Aspose.Slides.Foss`	Tri-state bool for formatting (True, False, NotDefined)
`SaveFormat`	`Aspose.Slides.Foss.Export`	Output format enum (only Pptx supported)
`PointF`	`Aspose.Slides.Foss.Drawing`	Float 2D point (used for comment positions)

Known Limitations

The following areas raise NotImplementedException in this edition:

Charts: no chart creation or modification
SmartArt: not supported
Animations and transitions: slide transitions and object animations cannot be set
Export formats: only PPTX save is supported; no PDF, HTML, SVG, or image export
Hyperlinks and action settings: link objects are not modifiable
VBA macros and digital signatures: not accessible

Unknown XML parts encountered during load are preserved verbatim on save, so round-tripping never removes content the library does not yet understand.