iText - 向PDF新增影像

本章我們將學習如何使用 iText 庫將影像新增到 PDF 文件。

向Pdf新增影像

您可以透過例項化Document類來建立一個空的PDF文件。例項化此類時，需要將一個PdfDocument物件作為引數傳遞給它的建構函式。要向PDF新增影像，請建立需要新增的影像物件，並使用Document類的add()方法新增它。

以下是向PDF文件新增影像的步驟。

步驟1：建立PdfWriter物件

PdfWriter類表示PDF的DocWriter。此類屬於com.itextpdf.kernel.pdf包。此類的建構函式接受一個字串，表示要建立PDF檔案的路徑。

透過將一個字串值（表示您需要建立PDF的路徑）傳遞給它的建構函式來例項化PdfWriter類，如下所示。

// Creating a PdfWriter 
String dest = "C:/itextExamples/addingImage.pdf"; 
PdfWriter writer = new PdfWriter(dest);

當將此型別的物件傳遞給PdfDocument（類）時，新增到此文件的每個元素都將寫入指定的檔案。

步驟2：建立PdfDocument物件

PdfDocument類是表示iText中PDF文件的類。此類屬於com.itextpdf.kernel.pdf包。要例項化此類（以寫入模式），需要將PdfWriter類的物件傳遞給它的建構函式。

透過將上面建立的PdfWriter物件傳遞給它的建構函式來例項化PdfDocument類，如下所示。

// Creating a PdfDocument  
PdfDocument pdfDoc = new PdfDocument(writer);

建立PdfDocument物件後，您可以使用其類提供的相應方法新增各種元素，例如頁面、字型、檔案附件和事件處理程式。

步驟3：建立Document物件

com.itextpdf.layout包的Document類是建立獨立PDF時的根元素。此類的建構函式之一接受PdfDocument類的物件。

透過傳遞在前面步驟中建立的PdfDocument類的物件來例項化Document類，如下所示。

// Creating a Document   Document 
document = new Document(pdfDoc);

步驟4：建立Image物件

要建立image物件，首先使用ImageDataFactory類的create()方法建立一個ImageData物件。作為此方法的引數，傳遞一個字串引數，表示影像的路徑，如下所示。

// Creating an ImageData object 
String imageFile = "C:/itextExamples/javafxLogo.jpg"; 
ImageData data = ImageDataFactory.create(imageFile);

現在，例項化com.itextpdf.layout.element包的Image類。例項化時，將上面建立的ImageData物件作為引數傳遞給它的建構函式，如下所示。

// Creating an Image object 
Image img = new Image(data);

步驟5：將影像新增到文件

使用Document類的add()方法新增上一步中建立的影像物件，如下所示。

// Adding image to the document 
document.add(img);

步驟6：關閉文件

使用Document類的close()方法關閉文件，如下所示。

// Closing the document 
document.close();

示例

下面的Java程式演示瞭如何使用iText庫將影像新增到PDF文件。它建立一個名為addingImage.pdf的PDF文件，向其中新增一個影像，並將其儲存到C:/itextExamples/路徑。

將此程式碼儲存到名為AddingImage.java的檔案中。

import com.itextpdf.io.image.ImageData; 
import com.itextpdf.io.image.ImageDataFactory; 

import com.itextpdf.kernel.pdf.PdfDocument; 
import com.itextpdf.kernel.pdf.PdfWriter;

import com.itextpdf.layout.Document; 
import com.itextpdf.layout.element.Image;  

public class AddingImage {      
   public static void main(String args[]) throws Exception {              
      
      // Creating a PdfWriter       
      String dest = "C:/itextExamples/addingImage.pdf";       
      PdfWriter writer = new PdfWriter(dest);        
      
      // Creating a PdfDocument       
      PdfDocument pdf = new PdfDocument(writer);              
      
      // Creating a Document        
      Document document = new Document(pdf);              
      
      // Creating an ImageData object       
      String imFile = "C:/itextExamples/logo.jpg";       
      ImageData data = ImageDataFactory.create(imFile);              
      
      // Creating an Image object        
      Image image = new Image(data);                        
      
      // Adding image to the document       
      document.add(image);              
      
      // Closing the document       
      document.close();              
      
      System.out.println("Image added");    
   } 
}

使用以下命令從命令提示符編譯並執行儲存的Java檔案：

javac AddingImage.java 
java AddingImage

執行後，上述程式將建立一個PDF文件，顯示以下訊息。

Image added

如果您驗證指定的路徑，您可以找到建立的PDF文件，如下所示。

列印頁面