Nedev.FileConverters.PptxToPdf 0.1.0

Nedev.FileConverters.PptxToPdf

A high-performance .NET library for converting PPTX (PowerPoint) files to PDF with zero third-party dependencies. Also ships with a ready-to-use command-line tool.

Features

• Zero Dependencies: No external NuGet packages required for core functionality
• Core Integration: Implements IFileConverter from Nedev.FileConverters.Core
• Multi-Target: Supports both .NET 8.0 and .NET Standard 2.1
• Parallel Processing: Optional slide-level parallelization for faster conversion
• Stream-Based: Support for both file path and stream-based conversion
• CJK Support: Proper handling of Chinese, Japanese, and Korean characters

Feature Completeness

Core Pipeline

PPTX Parsing

Shape Rendering

Fill & Outline

Text Rendering

Font Handling

Image Support

Table Rendering

Charts

SmartArt

Background

Performance

Installation

NuGet Package

Install-Package Nedev.FileConverters.PptxToPdf

Build from Source

git clone <repository-url>
cd FileConverters.PptxToPdf
dotnet build src/Nedev.FileConverters.PptxToPdf/Nedev.FileConverters.PptxToPdf.csproj

Usage

Using Core Package (Recommended)

using Nedev.FileConverters;

// Automatic discovery via FileConverter attribute
using var inputStream = File.OpenRead("input.pptx");
using var outputStream = File.Create("output.pdf");
using var convertedStream = Converter.Convert(inputStream, "pptx", "pdf");
convertedStream.CopyTo(outputStream);

As a Library

using Nedev.FileConverters.PptxToPdf;

var converter = new PptxToPdfConverter();

// Basic conversion
converter.Convert("input.pptx", "output.pdf");

// Parallel mode (faster for large decks)
converter.Convert("input.pptx", "output.pdf", parallel: true);

// Stream-based conversion
using var input = File.OpenRead("input.pptx");
using var output = File.Create("output.pdf");
converter.Convert(input, output);

Command-Line Tool

# Basic
Nedev.FileConverters.PptxToPdf.Cli input.pptx output.pdf

# With parallel processing
Nedev.FileConverters.PptxToPdf.Cli input.pptx output.pdf --parallel

# Using Core package's Converter
Nedev.FileConverters.PptxToPdf.Cli input.pptx output.pdf --core

# Help
Nedev.FileConverters.PptxToPdf.Cli --help

Project Structure

src/
├── Nedev.FileConverters.PptxToPdf/                    # Core library
│   ├── PptxToPdfConverter.cs                           # Public API entry point
│   ├── PptxToPdfFileConverter.cs                       # IFileConverter implementation
│   ├── Pptx/                                         # PPTX / OOXML parsing
│   │   ├── PptxDocument.cs                             # ZIP archive reader & part loader
│   │   ├── Presentation.cs                             # Presentation-level properties
│   │   ├── Slide.cs                                    # Slide & connector parsing
│   │   ├── SlideMaster.cs                               # Master, layout, color map, text styles
│   │   ├── Theme.cs                                    # Theme colors, fonts, effects
│   │   ├── Shape.cs                                    # AutoShape geometry, fill, text
│   │   ├── GroupShape.cs                               # Group shape tree
│   │   ├── Picture.cs                                  # Embedded image references
│   │   ├── Table.cs                                    # Table, row, cell, borders
│   │   ├── Chart.cs                                    # Chart data & series
│   │   ├── SmartArt.cs                                 # SmartArt diagrams
│   │   ├── Background.cs                                # Slide background
│   │   ├── Hyperlink.cs                                 # Hyperlink resolution
│   │   ├── Animation.cs                                 # Animation data model
│   │   ├── Notes.cs                                    # Speaker notes & comments
│   │   └── DocumentProperties.cs                        # Core / extended metadata
│   ├── Pdf/                                           # PDF generation
│   │   ├── PdfDocument.cs                               # PDF object tree & serialization
│   │   ├── PdfObjects.cs                                # Low-level PDF object types
│   │   ├── PdfRenderer.cs                               # Slide → PDF content stream
│   │   ├── FontManager.cs                               # Standard font mapping & metrics
│   │   ├── EmbeddedFontManager.cs                         # System font embedding (Type0)
│   │   ├── FontEmbedder.cs                              # TrueType font file reader
│   │   ├── GradientRenderer.cs                           # Gradient shading patterns
│   │   ├── PathRenderer.cs                              # Custom geometry → PDF paths
│   │   └── ImageEffectsRenderer.cs                      # Shadow, glow, reflection, etc.
│   ├── Image/                                         # Image processing
│   │   ├── ImageConverter.cs                           # Format conversion (PNG/GIF/BMP/TIFF → JPEG)
│   │   └── ImageDecoder.cs                             # Raw pixel extraction
│   └── Models/                                        # Shared data models
│       ├── Color.cs                                    # Color representation & conversion
│       ├── Enums.cs                                    # Shared enumerations
│       ├── Fill.cs, Outline.cs                          # Fill & outline models
│       ├── Paragraph.cs                                  # Paragraph & run models
│       ├── Rect.cs, Geometry.cs                          # Geometry primitives
│       ├── ShapeTypeMapping.cs                           # OOXML preset → internal shape type
│       ├── TextProperties.cs                             # Text body / paragraph properties
│       ├── Transform2D.cs                                # 2-D transform
│       ├── GradientStop.cs                              # Gradient stop model
│       └── ShapeEffects.cs                              # Shadow, glow, reflection effects
└── Nedev.FileConverters.PptxToPdf.Cli/               # Command-line interface
    └── Program.cs

Integration with Nedev.FileConverters.Core

This package integrates seamlessly with Nedev.FileConverters.Core:

• Automatic Discovery: The PptxToPdfFileConverter class is decorated with [FileConverter("pptx", "pdf")] attribute
• Unified API: Use Nedev.FileConverters.Converter.Convert() for consistent interface across all converters
• DI Support: Can be registered in dependency injection containers
• Extensibility: Easy to add more converters following the same pattern

Requirements

• .NET 8.0 or .NET Standard 2.1 compatible runtime
• Nedev.FileConverters.Core 0.1.0 or later
• No third-party NuGet packages required for core functionality

License

This project is licensed under the MIT License.