Save Presentation
Overview
The Presentation class holds a presentation’s content. Whether creating a presentation from scratch or modifying an existing one, when finished, you want to save the presentation. With Aspose.Slides for PHP via Java, it can be saved as a file or stream. This article explains how to save a presentation in different ways:
Save Presentation to File
Save a presentation to file by calling the Presentation class Save method. Simply pass the file name and SaveFormat to the Save method.
The examples that follow show how to save a presentation with Aspose.Slides for PHP via Java.
# Instantiate a Presentation object that represents a PPT file
$pres = new Presentation();
try {
# ...do some work here...
# Save your presentation to a file
$pres->save("demoPass.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Save Presentation to Stream
It is possible to save a presentation to a stream by passing an output stream to the Presentation class Save method. There are many types of streams to which a presentation can be saved. In the below example we have created a new Presentation file, add text in shape and Save the presentation to the stream.
# Instantiate a Presentation object that represents a PPT file
$pres = new Presentation();
try {
$shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 200, 200, 200, 200);
# Add text to shape
$shape->getTextFrame()->setText("This demo shows how to Create PowerPoint file and save it to Stream.");
$os = new Java("java.io.FileOutputStream", "Save_As_Stream_out.pptx");
$pres->save($os, SaveFormat::Pptx);
$os->close();
} catch (JavaException $e) {
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Save Presentation with Predefined View Type
Aspose.Slides for PHP via Java provides a facility to set the view type for the generated presentation when it is opened in PowerPoint through the ViewProperties class. The setLastView property is used to set the view type by using the ViewType enumerator.
# Opening the presentation file
$pres = new Presentation();
try {
# Setting view type
$pres->getViewProperties()->setLastView(ViewType::SlideMasterView);
# Saving presentation
$pres->save("newDemo.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Saving Presentations to Strict Office Open XML Format
Aspose.Slides allows you to save the presentation in Strict Office Open XML format. For that purpose, it provides the PptxOptions class where you can set the Conformance property while saving the presentation file. If you set its value as Conformance.Iso29500_2008_Strict, then the output presentation file will be saved in Strict Open XML format.
The following sample code creates a presentation and saves it in the Strict Office Open XML format. While calling the Save method for the presentation, the PptxOptions object is passed into it with the Conformance property set as Conformance.Iso29500_2008_Strict.
# Instantiate a Presentation object that represents a PPT file
$pres = new Presentation();
try {
# Get the first slide
$slide = $pres->getSlides()->get_Item(0);
# Add an autoshape of type line
$slide->getShapes()->addAutoShape(ShapeType::Line, 50, 150, 300, 0);
#Set Strict Office Open XML Format save options
$options = new PptxOptions();
$options->setConformance(Conformance->Iso29500_2008_Strict);
# Save your presentation to a file
$pres->save("demoPass.pptx", SaveFormat::Pptx, $options);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Saving Presentations to Office Open XML format in Zip64 mode
An Office Open XML file is a ZIP-archive that has a 4 GB (2^32 bytes) limit on uncompressed size of a file, compressed size of a file, and total size of the archive, as well as a limit of 65,535 (2^16-1) files in the archive. ZIP64 format extensions increase the limits to 2^64.
The new IPptxOptions.Zip64Mode property allows you to choose when to use ZIP64 format extensions for the saved Office Open XML file.
This property provides the following modes:
- Zip64Mode.IfNecessary means that ZIP64 format extensions will only be used if the presentation falls outside the above limitations. This is the default mode.
- Zip64Mode.Never means that ZIP64 format extensions will not be used.
- Zip64Mode.Always means that ZIP64 format extensions will always be used.
The following code demonstrates how to save the presentation to PPTX format with ZIP64 format extensions:
$pres = new Presentation("Sample.pptx");
try {
$pptxOptions = new PptxOptions();
$pptxOptions->setZip64Mode(Zip64Mode::Always);
$pres->save("Sample-zip64.pptx", SaveFormat::Pptx, $pptxOptions);
} finally {
$pres->dispose();
}
NOTE
Saving in the Zip64Mode.Never mode will throw a PptxException if the presentation cannot be saved in ZIP32 format.Save Progress Updates in Percentage
New IProgressCallback interface has been added to ISaveOptions interface and SaveOptions abstract class. IProgressCallback interface represents a callback object for saving progress updates in percentage.
The following code snippets below show how to use IProgressCallback interface:
class ExportProgressHandler {
function reporting($progressValue) {
# Use progress percentage value here
$progress = java("java.lang.Double")->valueOf($progressValue)->intValue();
echo($progress . "% file converted");
}
}
# Opening the presentation file
$pres = new Presentation("ConvertToPDF.pptx");
try {
$saveOptions = new PdfOptions();
$progressHandler = java_closure(new ExportProgressHandler(), null, java("com.aspose.slides.IProgressCallback"));
$saveOptions->setProgressCallback($progressHandler);
$pres->save("ConvertToPDF.pdf", SaveFormat::Pdf, $saveOptions);
} finally {
$pres->dispose();
}