Struct Presentation 

pub struct Presentation { /* private fields */ }

Represents a PowerPoint presentation

Implementations

impl Presentation

pub fn new() -> Self

Create a new empty presentation

pub fn with_title(title: &str) -> Self

Create a presentation with a title

pub fn title(self, title: &str) -> Self

Set the presentation title

pub fn add_slide(self, slide: SlideContent) -> Self

Add a slide to the presentation

pub fn add_presentation(self, other: Presentation) -> Self

Append slides from another presentation

pub fn slide_count(&self) -> usize

Get the number of slides

pub fn slides(&self) -> &[SlideContent]

Get the slides in the presentation

pub fn get_title(&self) -> &str

Get the presentation title

pub fn with_theme(self, theme: PresentationTheme) -> Self

Apply a custom color/font theme to the generated PPTX

pub fn with_settings(self, settings: PresentationSettings) -> Self

Set presentation-level settings (theme, slide show, print, etc.)

pub fn build(&self) -> Result<Vec<u8>>

Build the presentation as PPTX bytes

pub fn into_bytes(self) -> Result<Vec<u8>>

Consume the presentation and build PPTX bytes without cloning slide data.

pub fn save<P: AsRef<Path>>(&self, path: P) -> Result<()>

Save the presentation to a file

pub fn from_path<P: AsRef<Path>>(path: P) -> Result<Self>

Create a presentation from a PPTX file

pub fn save_as_html<P: AsRef<Path>>(&self, path: P) -> Result<()>

Export the presentation to HTML

pub fn save_as_pdf<P: AsRef<Path>>(&self, output_path: P) -> Result<()>

Export the presentation to PDF using pure-Rust vector rendering.

Each slide is rendered as a native PDF page with title, bullets, and content drawn as vector text and graphics. No external binaries (LibreOffice, Poppler, etc.) are required.

pub fn save_as_pdf_via_pdfrs<P: AsRef<Path>>( &self, output_path: P, options: &PdfExportOptions, ) -> Result<()>

Export the presentation to PDF with custom options using the pure-Rust pdfrs engine.

Like Presentation::save_as_pdf but allows customizing orientation, font, font size, and which Markdown sections are included.

Arguments

• output_path - Path to the PDF file to write.
• options - crate::export::pdf_export::PdfExportOptions controlling orientation, font, font size, and which Markdown sections are included.

pub fn to_pdf_bytes(&self, options: &PdfExportOptions) -> Result<Vec<u8>>

Render the presentation to PDF bytes using the pure-Rust pdfrs engine.

Returns the raw PDF byte buffer instead of writing to disk. Useful for embedding in HTTP responses, mailing systems, or piping to other tools.

Requires the pdf-native Cargo feature.

pub fn save_as_png<P: AsRef<Path>>(&self, output_dir: P) -> Result<()>

Export slides to PNG images

Requires pdftoppm (from poppler) to be installed. Images will be named slide-1.png, slide-2.png, etc. in the output directory.

pub fn from_pdf<P: AsRef<Path>>(path: P) -> Result<Self>

Create a presentation from a PDF file (each page becomes a slide)

Requires pdftoppm (from poppler) to be installed.

pub fn save_as_markdown<P: AsRef<Path>>(&self, path: P) -> Result<()>

Export the presentation to Markdown format

Arguments

• path - Output file path

Example

pub fn save_as_markdown_with_options<P: AsRef<Path>>( &self, path: P, options: &MarkdownOptions, ) -> Result<()>

Export the presentation to Markdown with custom options

pub fn save_as_images<P: AsRef<Path>>( &self, output_dir: P, options: &ImageExportOptions, ) -> Result<Vec<PathBuf>>

Export slides to image files (PNG/JPEG)

Uses LibreOffice for raster image rendering. Requires LibreOffice to be installed.

Arguments

• output_dir - Directory to save images
• options - Image export options (format, DPI, quality)

Returns

Vector of paths to generated image files

pub fn save_slide_as_image<P: AsRef<Path>>( &self, slide_number: usize, output_path: P, options: &ImageExportOptions, ) -> Result<PathBuf>

Export a specific slide to an image file

Arguments

• slide_number - 1-based slide number
• output_path - Output file path
• options - Image export options

pub fn save_thumbnail<P: AsRef<Path>>( &self, output_path: P, width: u32, ) -> Result<PathBuf>

Render a thumbnail of the first slide

Arguments

• output_path - Output file path
• width - Desired width in pixels

pub fn compress<P: AsRef<Path>>( &self, output_path: P, options: &CompressionOptions, ) -> Result<CompressionResult>

Compress and optimize the presentation

Saves a compressed version with reduced file size.

Arguments

• output_path - Path for compressed PPTX file
• options - Compression options (level, features to remove)

Returns

Compression result with statistics

Example

pub fn analyze_size(&self) -> Result<PptxAnalysis>

Get file size analysis

Returns analysis of what contributes to file size.

Trait Implementations

impl Clone for Presentation

fn clone(&self) -> Presentation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Presentation

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

Formats the value using the given formatter.

impl Default for Presentation

fn default() -> Presentation

Returns the “default value” for a type.