Convert PowerPoint to PDF in JavaScript
Overview
Converting PowerPoint documents into PDF format offers several advantages, including ensuring compatibility across different devices and preserving the layout and formatting of your presentation. This article shows you how to convert presentations to PDF documents, use various options to control image quality, include hidden slides, password protect PDF documents, detect font substitutions, select slides for conversion, and apply compliance standards to output documents.
PowerPoint to PDF Conversions
Using Aspose.Slides, you can convert presentations in these formats to PDF:
- PPT
- PPTX
- ODP
To convert a presentation to PDF, you simply have to pass the file name as an argument in the Presentation class and then save the presentation as a PDF using a save method. The Presentation class exposes the save method that is typically used to convert a presentation to PDF.
NOTE
Aspose.Slides for Node.js via Java directly writes API information and Version Number in output documents. For example, when it converts a presentation to PDF, Aspose.Slides for Node.js via Java populates the Application field with the ‘Aspose.Slides’ value and the PDF Producer field with a value in ‘Aspose.Slides v XX.XX’ form. Note that you cannot instruct Aspose.Slides for Node.js via Java to change or remove this information from output documents.Aspose.Slides allows you to convert:
- an entire presentation to PDF
- specific slides in a presentation to PDF
- a presentation
Aspose.Slides exports presentations to PDF in a way that makes the contents of the resulting PDFs very similar to those in the original presentations. These known elements and attributes are often rendered properly in presentation to PDF conversions:
- images
- text boxes and other shapes
- texts and their formatting
- paragraphs and their formatting
- hyperlinks
- headers and footers
- bullets
- tables
Convert PowerPoint to PDF
The standard PowerPoint PDF conversion operation is executed using default options. In this case, Aspose.Slides tries to convert the provided presentation to PDF using optimal settings at the maximum quality levels.
This JavaScript code shows you how to convert a PowerPoint to PDF:
// Instantiates a Presentation class that represents a PowerPoint file
var pres = new aspose.slides.Presentation("PowerPoint.ppt");
try {
// Saves the presentation as a PDF
pres.save("PPT-to-PDF.pdf", aspose.slides.SaveFormat.Pdf);
} finally {
if (pres != null) {
pres.dispose();
}
}
Convert PowerPoint to PDF with Options
Aspose.Slides provides custom options—properties under the PdfOptions class—that allow you to customize the PDF (resulting from the conversion process), lock the PDF with a password, or even specify how the conversion process should go.
Convert PowerPoint to PDF with Custom Options
Using custom conversion options, you can set your preferred quality setting for raster images, specify how metafiles should be handled, set a compression level for texts, set DPI for images, etc.
The code example below demonstrates an operation in which a PowerPoint presentation is converted to PDF with several custom options:
// Instantiates the PdfOptions class
var pdfOptions = new aspose.slides.PdfOptions();
// Sets the quality for JPG images
pdfOptions.setJpegQuality(90);
// Sets DPI for images
pdfOptions.setSufficientResolution(300);
// Sets the behavior for metafiles
pdfOptions.setSaveMetafilesAsPng(true);
// Sets the text compression level for textual content
pdfOptions.setTextCompression(aspose.slides.PdfTextCompression.Flate);
// Defines the PDF compliance mode
pdfOptions.setCompliance(aspose.slides.PdfCompliance.Pdf15);
// Instantiates the Presentation class that represents a PowerPoint document
var presentation = new aspose.slides.Presentation("PowerPoint.pptx");
try {
// Saves the presentation as a PDF document
presentation.save("PowerPoint-to-PDF.pdf", aspose.slides.SaveFormat.Pdf, pdfOptions);
} finally {
presentation.dispose();
}
Convert PowerPoint to PDF with Hidden Slides
If a presentation contains hidden slides, you can use a custom option — the setShowHiddenSlides method from the PdfOptions class—to instruct Aspose.Slides to include the hidden slides as pages in the resulting PDF.
This JavaScript code shows you how to convert a PowerPoint presentation to PDF with hidden slides included:
// Instantiates a Presentation class that represents a PowerPoint file
var pres = new aspose.slides.Presentation("PowerPoint.pptx");
try {
// Instantiates the PdfOptions class
var pdfOptions = new aspose.slides.PdfOptions();
// Adds hidden slides
pdfOptions.setShowHiddenSlides(true);
// Saves the presentation as a PDF
pres.save("PowerPoint-to-PDF.pdf", aspose.slides.SaveFormat.Pdf, pdfOptions);
} finally {
if (pres != null) {
pres.dispose();
}
}
Convert PowerPoint to Password Protected PDF
This JavaScript code shows you how to convert a PowerPoint to a password-protected PDF (using protection parameters from the PdfOptions class):
// Instantiates a Presentation object that represents a PowerPoint file
var pres = new aspose.slides.Presentation("PowerPoint.pptx");
try {
// / Instantiates the PdfOptions class
var pdfOptions = new aspose.slides.PdfOptions();
// Sets PDF password and access permissions
pdfOptions.setPassword("password");
pdfOptions.setAccessPermissions(aspose.slides.PdfAccessPermissions.PrintDocument | aspose.slides.PdfAccessPermissions.HighQualityPrint);
// Saves the presentation as a PDF
pres.save("PPTX-to-PDF.pdf", aspose.slides.SaveFormat.Pdf, pdfOptions);
} finally {
if (pres != null) {
pres.dispose();
}
}
Detect Font Substitutions**
Aspose.Slides provides the getWarningCallback method under the SaveOptions class to allow you to detect font substitutions in a presentation to PDF conversion process.
This JavaScript code shows you how to detect font substitutions:
let loadOptions = new aspose.slides.LoadOptions();
let warningCallback = new FontSubstSendsWarningCallback();
loadOptions.warningCallback = warningCallback;
let pres;
try {
pres = new aspose.slides.Presentation("pres.pptx", loadOptions);
} catch (error) {
console.error("Error loading presentation:", error);
} finally {
if (pres) {
pres.dispose();
}
}
function FontSubstSendsWarningCallback() {
this.warning = function(warning) {
if (warning.warningType === aspose.slides.WarningType.CompatibilityIssue) {
return aspose.ReturnAction.Continue;
}
if (warning.warningType === aspose.slides.WarningType.DataLoss &&
warning.description.startsWith("Font will be substituted")) {
console.log("Font substitution warning: " + warning.description);
}
return aspose.slides.ReturnAction.Continue;
};
}
For more information on getting callbacks for font substitutions in a rendering process, see Getting Warning Callbacks for Fonts Substitution.
For more information on font substitution, see the Font Substitution article.
Convert Selected Slides in PowerPoint to PDF
This JavaScript code shows you how to convert specific slides in a PowerPoint presentation to PDF:
// Instantiates a Presentation object that represents a PowerPoint file
var pres = new aspose.slides.Presentation("PowerPoint.pptx");
try {
// Sets an array of slides positions
var slides = java.newArray("int", [1, 3]);
// Saves the presentation as a PDF
pres.save("PPTX-to-PDF.pdf", slides, aspose.slides.SaveFormat.Pdf);
} finally {
if (pres != null) {
pres.dispose();
}
}
Convert PowerPoint to PDF with Custom Slide Size
This JavaScript code shows you how to convert a PowerPoint when its slide size is specified to a PDF:
// Instantiates a Presentation object that represents a PowerPoint file
var pres = new aspose.slides.Presentation("SelectedSlides.pptx");
try {
var outPres = new aspose.slides.Presentation();
try {
var slide = pres.getSlides().get_Item(0);
outPres.getSlides().insertClone(0, slide);
// Sets the slide type and size
outPres.getSlideSize().setSize(612.0, 792.0, aspose.slides.SlideSizeScaleType.EnsureFit);
var pdfOptions = new aspose.slides.PdfOptions();
var options = pdfOptions.getNotesCommentsLayouting();
options.setNotesPosition(aspose.slides.NotesPositions.BottomFull);
outPres.save("PDFnotes_out.pdf", aspose.slides.SaveFormat.Pdf, pdfOptions);
} finally {
if (pres != null) {
pres.dispose();
}
}
} finally {
if (pres != null) {
pres.dispose();
}
}
Convert PowerPoint to PDF in Notes Slide View
This JavaScript code shows you how to convert a PowerPoint to PDF notes:
// Instantiates a Presentation class that represents a PowerPoint file
var pres = new aspose.slides.Presentation("SelectedSlides.pptx");
try {
var pdfOptions = new aspose.slides.PdfOptions();
var options = pdfOptions.getNotesCommentsLayouting();
options.setNotesPosition(aspose.slides.NotesPositions.BottomFull);
pres.save("Pdf_With_Notes.pdf", aspose.slides.SaveFormat.Pdf, pdfOptions);
} finally {
if (pres != null) {
pres.dispose();
}
}
Accessibility and Compliance Standards for PDF
Aspose.Slides allows you to use a conversion procedure that complies with Web Content Accessibility Guidelines (WCAG). You can export a PowerPoint document to PDF using any of these compliance standards: PDF/A1a, PDF/A1b, and PDF/UA.
This JavaScript code demonstrates a PowerPoint to PDF conversion operation in which multiple PDFs based on different compliance standards are obtained:
var pres = new aspose.slides.Presentation("pres.pptx");
try {
var pdfOptions = new aspose.slides.PdfOptions();
pdfOptions.setCompliance(aspose.slides.PdfCompliance.PdfA1a);
pres.save("pres-a1a-compliance.pdf", aspose.slides.SaveFormat.Pdf, pdfOptions);
pdfOptions.setCompliance(aspose.slides.PdfCompliance.PdfA1b);
pres.save("pres-a1b-compliance.pdf", aspose.slides.SaveFormat.Pdf, pdfOptions);
pdfOptions.setCompliance(aspose.slides.PdfCompliance.PdfUa);
pres.save("pres-ua-compliance.pdf", aspose.slides.SaveFormat.Pdf, pdfOptions);
} finally {
if (pres != null) {
pres.dispose();
}
}