在 Java 中將 PPT 與 PPTX 轉換為 PDF(含進階功能)
概述
在 Java 中將 PowerPoint 簡報 (PPT、PPTX、ODP 等) 轉換為 PDF 格式具有多項優勢,包括在不同裝置間的相容性以及保留簡報的版面配置與格式。本指南說明如何將簡報轉換為 PDF 文件、使用各種選項控制圖片品質、包含隱藏投影片、為 PDF 檔案設定密碼保護、偵測字型取代、選取特定投影片進行轉換,並將合規標準套用至輸出文件。
PowerPoint 轉 PDF 的轉換
使用 Aspose.Slides,您可以將以下格式的簡報轉換為 PDF:
- PPT
- PPTX
- ODP
要將簡報轉換為 PDF,只需將檔名作為參數傳遞給 Presentation 類別,然後使用 save 方法將簡報儲存為 PDF。Presentation 類別提供了通常用於將簡報轉換為 PDF 的 save 方法。
NOTE
Aspose.Slides for Java 會將其 API 資訊與版本號插入輸出文件。例如,將簡報轉換為 PDF 時,Aspose.Slides 會在 Application 欄位填入「Aspose.Slides」並在 PDF Producer 欄位填入「Aspose.Slides v XX.XX」的形式。注意,您無法指示 Aspose.Slides 修改或移除這些資訊。Aspose.Slides 可讓您轉換:
- 整個簡報至 PDF
- 從簡報中選取特定投影片至 PDF
Aspose.Slides 會將簡報匯出為 PDF,確保產生的 PDF 與原始簡報高度相符。轉換過程中會正確呈現以下元素與屬性:
- 圖片
- 文字方塊與圖形
- 文字格式
- 段落格式
- 超連結
- 頁首與頁腳
- 项目符號
- 表格
將 PowerPoint 轉換為 PDF
標準的 PowerPoint 轉 PDF 轉換程序使用預設選項。在此情況下,Aspose.Slides 會以最佳設定、最高品質層級將提供的簡報轉換為 PDF。
以下程式碼示範如何將簡報 (PPT、PPTX、ODP 等) 轉換為 PDF:
// 建立代表 PowerPoint 或 OpenDocument 檔案的 Presentation 類別實例。
Presentation presentation = new Presentation("PowerPoint.ppt");
try {
// 將簡報儲存為 PDF。
presentation.save("PPT-to-PDF.pdf", SaveFormat.Pdf);
} finally {
presentation.dispose();
}
使用選項將 PowerPoint 轉換為 PDF
Aspose.Slides 在 PdfOptions 類別下提供自訂選項——屬性,可讓您自訂產生的 PDF、以密碼鎖定 PDF,或指定轉換程序的執行方式。
使用自訂選項將 PowerPoint 轉換為 PDF
透過自訂轉換選項,您可以為點陣圖設定偏好的品質、指定圖形檔的處理方式、設定文字的壓縮等級、為圖片設定 DPI 等。
以下程式碼範例示範如何使用多項自訂選項將 PowerPoint 簡報轉換為 PDF:
// 建立 PdfOptions 類別的實例。
PdfOptions pdfOptions = new PdfOptions();
// 設定 JPG 圖片的品質。
pdfOptions.setJpegQuality((byte)90);
// 設定圖片的 DPI。
pdfOptions.setSufficientResolution(300);
// 設定中繼檔案的行為。
pdfOptions.setSaveMetafilesAsPng(true);
// 設定文字內容的壓縮等級。
pdfOptions.setTextCompression(PdfTextCompression.Flate);
// 定義 PDF 合規模式。
pdfOptions.setCompliance(PdfCompliance.Pdf15);
// 建立代表 PowerPoint 或 OpenDocument 檔案的 Presentation 類別實例。
Presentation presentation = new Presentation("PowerPoint.pptx");
try {
// 將簡報儲存為 PDF 文件。
presentation.save("PowerPoint-to-PDF.pdf", SaveFormat.Pdf, pdfOptions);
} finally {
presentation.dispose();
}
將隱藏投影片一併轉換為 PDF
若簡報包含隱藏投影片,可使用 PdfOptions 類別的 setShowHiddenSlides 方法,將隱藏投影片作為頁面加入最終的 PDF。
以下程式碼示範如何在 PDF 中包含隱藏投影片:
// 建立代表 PowerPoint 或 OpenDocument 檔案的 Presentation 類別實例。
Presentation presentation = new Presentation("PowerPoint.pptx");
try {
// 建立 PdfOptions 類別的實例。
PdfOptions pdfOptions = new PdfOptions();
// 新增隱藏投影片。
pdfOptions.setShowHiddenSlides(true);
// 將簡報儲存為 PDF。
presentation.save("PowerPoint-to-PDF.pdf", SaveFormat.Pdf, pdfOptions);
} finally {
presentation.dispose();
}
將 PowerPoint 轉換為受密碼保護的 PDF
以下程式碼示範如何使用 PdfOptions 類別的保護參數,將 PowerPoint 簡報轉換為受密碼保護的 PDF:
// 建立代表 PowerPoint 或 OpenDocument 檔案的 Presentation 類別實例。
Presentation presentation = new Presentation("PowerPoint.pptx");
try {
// 建立 PdfOptions 類別的實例。
PdfOptions pdfOptions = new PdfOptions();
// 設定 PDF 密碼與存取權限。
pdfOptions.setPassword("password");
pdfOptions.setAccessPermissions(PdfAccessPermissions.PrintDocument | PdfAccessPermissions.HighQualityPrint);
// 將簡報儲存為 PDF。
presentation.save("PPTX-to-PDF.pdf", SaveFormat.Pdf, pdfOptions);
} finally {
presentation.dispose();
}
偵測字型取代
Aspose.Slides 在 PdfOptions 類別下提供 setWarningCallback 方法,讓您在簡報轉 PDF 的過程中偵測字型取代情況。
以下程式碼示範如何偵測字型取代:
public static void main(String[] args) {
// 建立代表 PowerPoint 或 OpenDocument 檔案的 Presentation 類別實例。
Presentation presentation = new Presentation("sample.pptx");
// 在 PDF 選項中設定警告回呼。
PdfOptions pdfOptions = new PdfOptions();
pdfOptions.setWarningCallback(new FontSubstitutionHandler());
try {
// 將簡報儲存為 PDF。
presentation.save("output.pdf", SaveFormat.Pdf, pdfOptions);
} finally {
presentation.dispose();
}
}
// 警告回呼的實作。
private static class FontSubstitutionHandler implements IWarningCallback {
public int warning(IWarningInfo warning) {
if (warning.getWarningType() == WarningType.DataLoss &&
warning.getDescription().startsWith("Font will be substituted")) {
System.out.println("Font substitution warning: " + warning.getDescription());
}
return ReturnAction.Continue;
}
}
欲取得渲染過程中字型取代的回呼資訊,請參閱 取得字型取代的警告回呼。
欲取得更多字型取代相關資訊,請參閱 字型取代 文章。
將選取的投影片轉換為 PDF
以下程式碼示範如何只將 PowerPoint 簡報中的特定投影片轉換為 PDF:
// 建立代表 PowerPoint 或 OpenDocument 檔案的 Presentation 類別實例。
Presentation presentation = new Presentation("PowerPoint.pptx");
try {
// 設定投影片編號陣列。
int[] slides = { 1, 3 };
// 將簡報儲存為 PDF。
presentation.save("PPTX-to-PDF.pdf", slides, SaveFormat.Pdf);
} finally {
presentation.dispose();
}
使用自訂投影片尺寸將 PowerPoint 轉換為 PDF
以下程式碼示範如何以指定的投影片尺寸將 PowerPoint 簡報轉換為 PDF:
float slideWidth = 612;
float slideHeight = 792;
// 建立代表 PowerPoint 或 OpenDocument 檔案的 Presentation 類別實例。
Presentation presentation = new Presentation("SelectedSlides.pptx");
// 建立具有調整後投影片尺寸的新簡報。
Presentation resizedPresentation = new Presentation();
try {
// 設定自訂投影片尺寸。
resizedPresentation.getSlideSize().setSize(slideWidth, slideHeight, SlideSizeScaleType.EnsureFit);
// 從原始簡報複製第一張投影片。
ISlide slide = presentation.getSlides().get_Item(0);
resizedPresentation.getSlides().insertClone(0, slide);
// 將調整尺寸的簡報儲存為含備註的 PDF。
resizedPresentation.save("PDF_with_notes.pdf", SaveFormat.Pdf);
} finally {
resizedPresentation.dispose();
presentation.dispose();
}
在備註投影片檢視下將 PowerPoint 轉換為 PDF
以下程式碼示範如何將包含備註的 PowerPoint 簡報轉換為 PDF:
// 建立代表 PowerPoint 或 OpenDocument 檔案的 Presentation 類別實例。
Presentation presentation = new Presentation("SelectedSlides.pptx");
try {
// 使用備註版面配置設定 PDF 選項。
NotesCommentsLayoutingOptions notesOptions = new NotesCommentsLayoutingOptions();
notesOptions.setNotesPosition(NotesPositions.BottomFull);
PdfOptions pdfOptions = new PdfOptions();
pdfOptions.setSlidesLayoutOptions(notesOptions);
// 將簡報儲存為包含備註的 PDF。
presentation.save("PDF_with_notes.pdf", SaveFormat.Pdf, pdfOptions);
} finally {
presentation.dispose();
}
PDF 的可近性與合規標準
Aspose.Slides 允許您使用符合 Web Content Accessibility Guidelines (WCAG) 的轉換程序。您可透過以下合規標準將 PowerPoint 文件匯出為 PDF:PDF/A1a、PDF/A1b 與 PDF/UA。
以下程式碼示範依不同合規標準產生多個 PDF 的 PowerPoint 轉 PDF 程序:
Presentation presentation = new Presentation("pres.pptx");
try {
PdfOptions pdfOptions = new PdfOptions();
pdfOptions.setCompliance(PdfCompliance.PdfA1a);
presentation.save("pres-a1a-compliance.pdf", SaveFormat.Pdf, pdfOptions);
pdfOptions.setCompliance(PdfCompliance.PdfA1b);
presentation.save("pres-a1b-compliance.pdf", SaveFormat.Pdf, pdfOptions);
pdfOptions.setCompliance(PdfCompliance.PdfUa);
presentation.save("pres-ua-compliance.pdf", SaveFormat.Pdf, pdfOptions);
} finally {
presentation.dispose();
}
Note
Aspose.Slides 支援 PDF 轉換操作,可將 PDF 檔案轉換為常見格式。您可以執行 PDF 轉 HTML、PDF 轉圖片、PDF 轉 JPG、以及 PDF 轉 PNG 轉換。亦支援轉換至特殊格式的操作,如 PDF 轉 SVG、PDF 轉 TIFF、以及 PDF 轉 XML。注意: 匯出為 PDF/UA 時,Aspose.Slides 會將 SmartArt、圖表與公式等複雜圖形視為單一圖形。個別路徑元素不會保留為獨立內容,可能會被標記為雜項;僅會為整體圖形提供替代文字。
常見問題
我可以一次批量將多個 PowerPoint 檔案轉換為 PDF 嗎?
可以,Aspose.Slides 支援批次將多個 PPT 或 PPTX 檔案轉換為 PDF。您可以在程式中遍歷檔案並套用轉換程序。
可以為轉換後的 PDF 設定密碼保護嗎?
當然可以。使用 PdfOptions 類別在轉換過程中設定密碼與存取權限。
如何在 PDF 中包含隱藏投影片?
在 PdfOptions 類別中使用 setShowHiddenSlides 方法,即可將隱藏投影片納入最終 PDF。
Aspose.Slides 能否在 PDF 中保持高圖像品質?
可以,您可使用 setJpegQuality 與 setSufficientResolution 等方法於 PdfOptions 類別中控制圖像品質,確保 PDF 中的圖像保持高品質。
Aspose.Slides 是否支援 PDF/A 合規標準?
支援。Aspose.Slides 可匯出符合 各種標準 的 PDF,包括 PDF/A1a、PDF/A1b 與 PDF/UA,確保文件符合可近性與保存需求。