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文档，如下所示。

打印页面