Struct Presentation

Source

pub struct Presentation { /* private fields */ }

Expand description

Represents a PowerPoint presentation

Implementations§

Source §

impl Presentation

Source

pub fn new() -> Self

Create a new empty presentation

Source

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

Create a presentation with a title

Examples found in repository ?

examples/integrated_example.rs (line 15)

9fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
10    println!("Integrated PPTX Generation Example\n");
11
12    fs::create_dir_all("examples/output")?;
13
14    println!("1. Creating presentation with Presentation API...");
15    let pres = ppt_rs::Presentation::with_title("Integrated Example")
16        .add_slide(SlideContent::new("Welcome").add_bullet("Point 1"))
17        .add_slide(SlideContent::new("Details").add_bullet("Point 2"));
18    pres.save("examples/output/integrated_example.pptx")?;
19    println!("   Created: examples/output/integrated_example.pptx");
20
21    println!("2. Creating presentation with content API...");
22    let slides = vec![
23        SlideContent::new("Business Report").add_bullet("Q1 Results"),
24        SlideContent::new("Key Metrics").add_bullet("Revenue up 20%"),
25    ];
26    let data = create_pptx_with_content("Business Report", slides)?;
27    fs::write("examples/output/business_report.pptx", data)?;
28    println!("   Created: examples/output/business_report.pptx");
29
30    println!("3. Creating presentation with prelude helpers...");
31    pptx!("Helper Demo")
32        .slide("Shapes", &["Using helpers"])
33        .save("examples/output/helper_demo.pptx")?;
34    println!("   Created: examples/output/helper_demo.pptx");
35
36    println!("\nDone!");
37    Ok(())
38}

Source

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

Set the presentation title

Source

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

Add a slide to the presentation

Examples found in repository ?

examples/integrated_example.rs (line 16)

9fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
10    println!("Integrated PPTX Generation Example\n");
11
12    fs::create_dir_all("examples/output")?;
13
14    println!("1. Creating presentation with Presentation API...");
15    let pres = ppt_rs::Presentation::with_title("Integrated Example")
16        .add_slide(SlideContent::new("Welcome").add_bullet("Point 1"))
17        .add_slide(SlideContent::new("Details").add_bullet("Point 2"));
18    pres.save("examples/output/integrated_example.pptx")?;
19    println!("   Created: examples/output/integrated_example.pptx");
20
21    println!("2. Creating presentation with content API...");
22    let slides = vec![
23        SlideContent::new("Business Report").add_bullet("Q1 Results"),
24        SlideContent::new("Key Metrics").add_bullet("Revenue up 20%"),
25    ];
26    let data = create_pptx_with_content("Business Report", slides)?;
27    fs::write("examples/output/business_report.pptx", data)?;
28    println!("   Created: examples/output/business_report.pptx");
29
30    println!("3. Creating presentation with prelude helpers...");
31    pptx!("Helper Demo")
32        .slide("Shapes", &["Using helpers"])
33        .save("examples/output/helper_demo.pptx")?;
34    println!("   Created: examples/output/helper_demo.pptx");
35
36    println!("\nDone!");
37    Ok(())
38}

Source

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

Append slides from another presentation

Source

pub fn slide_count(&self) -> usize

Get the number of slides

Source

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

Get the slides in the presentation

Source

pub fn get_title(&self) -> &str

Get the presentation title

Source

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

Build the presentation as PPTX bytes

Source

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

Save the presentation to a file

Examples found in repository ?

examples/integrated_example.rs (line 18)

9fn main() -> std::result::Result<(), Box<dyn std::error::Error>> {
10    println!("Integrated PPTX Generation Example\n");
11
12    fs::create_dir_all("examples/output")?;
13
14    println!("1. Creating presentation with Presentation API...");
15    let pres = ppt_rs::Presentation::with_title("Integrated Example")
16        .add_slide(SlideContent::new("Welcome").add_bullet("Point 1"))
17        .add_slide(SlideContent::new("Details").add_bullet("Point 2"));
18    pres.save("examples/output/integrated_example.pptx")?;
19    println!("   Created: examples/output/integrated_example.pptx");
20
21    println!("2. Creating presentation with content API...");
22    let slides = vec![
23        SlideContent::new("Business Report").add_bullet("Q1 Results"),
24        SlideContent::new("Key Metrics").add_bullet("Revenue up 20%"),
25    ];
26    let data = create_pptx_with_content("Business Report", slides)?;
27    fs::write("examples/output/business_report.pptx", data)?;
28    println!("   Created: examples/output/business_report.pptx");
29
30    println!("3. Creating presentation with prelude helpers...");
31    pptx!("Helper Demo")
32        .slide("Shapes", &["Using helpers"])
33        .save("examples/output/helper_demo.pptx")?;
34    println!("   Created: examples/output/helper_demo.pptx");
35
36    println!("\nDone!");
37    Ok(())
38}

Source

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

Create a presentation from a PPTX file

Source

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

Export the presentation to HTML

Source

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

Export the presentation to PDF using LibreOffice

Requires LibreOffice to be installed and available via soffice command. On macOS, it also checks /Applications/LibreOffice.app/Contents/MacOS/soffice.

Source

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

Export slides to PNG images

Requires LibreOffice (for PDF conversion) and pdftoppm (from poppler). Images will be named slide-1.png, slide-2.png, etc. in the output directory.

Source