在 PDF 文件中添加图像

本指南将逐步指导您如何使用 Aspose.PDF for .NET 在 PDF 文件中添加图像。确保您已设置环境并按照以下步骤操作：

第1步：定义文档目录

开始之前，请确保为文档设置正确的目录。代替"YOUR DOCUMENT DIRECTORY"在代码中添加 PDF 文档所在目录的路径。

string dataDir = "YOUR DOCUMENT DIRECTORY";

步骤 2：打开文档

在此步骤中，我们将使用以下命令打开 PDF 文档Document Aspose.PDF 类。使用Document构造函数并传递 PDF 文档的路径。

Document pdfDocument = new Document(dataDir + "AddImage.pdf");

第三步：设置图像坐标

设置要添加的图像的坐标。变量lowerLeftX, lowerLeftY, upperRightX和upperRightY分别表示图像的左下角和右上角的坐标。

int lowerLeftX = 100;
int lowerLeftY = 100;
int upperRightX = 200;
int upperRightY = 200;

第四步：获取要添加图片的页面

要将图像添加到 PDF 文档的特定页面，我们首先需要检索该页面。在此示例中，我们将图像添加到文档的第二页（索引 1）。

Page page = pdfDocument.Pages[1];

第 5 步：从流中加载图像

现在我们将加载要添加到 PDF 文档中的图像。此示例假设您有一个名为aspose-logo.jpg与您的文档位于同一目录中。如有必要，请替换文件名。

FileStream imageStream = new FileStream(dataDir + "aspose-logo.jpg", FileMode.Open);

第 6 步：将图像添加到页面资源

要使用PDF文档中的图像，我们需要将其添加到页面的资源图像集合中。

page.Resources.Images.Add(imageStream);

步骤7：保存当前图形状态

在绘制图像之前，我们需要使用以下命令保存当前图形状态GSave操作员。这确保了对图形状态的更改可以稍后回滚。

page.Contents.Add(new Aspose.Pdf.Operators.GSave());

第8步：创建矩形和矩阵对象

我们现在将创建一个Rectangle对象和一个Matrix目的。矩形代表图像的位置和大小，而矩阵定义图像的放置方式。

Aspose.Pdf.Rectangle rectangle = new Aspose.Pdf.Rectangle(lower

LeftX, lowerLeftY, upperRightX, upperRightY);
Matrix matrix = new Matrix(new double[] { rectangle.URX - rectangle.LLX, 0, 0, rectangle.URY - rectangle.LLY, rectangle.LLX, rectangle.LLY });

第 9 步：连接图像放置矩阵

为了指定图像应如何放置在矩形中，我们使用ConcatenateMatrix操作员。该运算符定义将图像的坐标空间映射到页面的坐标空间的变换矩阵。

page.Contents.Add(new Aspose.Pdf.Operators.ConcatenateMatrix(matrix));

第10步：绘制图像

在此步骤中，我们将使用以下方法在页面上绘制图像Do操作员。这Do运算符从资源中获取图像名称并将其绘制到页面上。

XImage ximage = page.Resources.Images[page.Resources.Images.Count];
page.Contents.Add(new Aspose.Pdf.Operators.Do(ximage.Name));

步骤11：恢复图形状态

绘制图像后，我们需要使用以下命令恢复之前的图形状态GRestore操作员。

page.Contents.Add(new Aspose.Pdf.Operators.GRestore());

第12步：保存更新后的文档

最后，我们将更新的文档保存到新文件中。更新dataDir具有所需输出目录和文件名的变量。

dataDir = dataDir + "AddImage_out.pdf";
pdfDocument.Save(dataDir);

使用 Aspose.PDF for .NET 添加图像的示例源代码

//文档目录的路径。
string dataDir = "YOUR DOCUMENT DIRECTORY";
//打开文档
Document pdfDocument = new Document(dataDir+ "AddImage.pdf");
//设置坐标
int lowerLeftX = 100;
int lowerLeftY = 100;
int upperRightX = 200;
int upperRightY = 200;
//获取需要添加图片的页面
Page page = pdfDocument.Pages[1];
//将图像加载到流中
FileStream imageStream = new FileStream(dataDir + "aspose-logo.jpg", FileMode.Open);
//将图像添加到页面资源的图像集合
page.Resources.Images.Add(imageStream);
//使用GSave运算符：该运算符保存当前图形状态
page.Contents.Add(new Aspose.Pdf.Operators.GSave());
//创建矩形和矩阵对象
Aspose.Pdf.Rectangle rectangle = new Aspose.Pdf.Rectangle(lowerLeftX, lowerLeftY, upperRightX, upperRightY);
Matrix matrix = new Matrix(new double[] { rectangle.URX - rectangle.LLX, 0, 0, rectangle.URY - rectangle.LLY, rectangle.LLX, rectangle.LLY });
//使用ConcatenateMatrix（连接矩阵）运算符：定义图像的放置方式
page.Contents.Add(new Aspose.Pdf.Operators.ConcatenateMatrix(matrix));
XImage ximage = page.Resources.Images[page.Resources.Images.Count];
//使用 Do 运算符：该运算符绘制图像
page.Contents.Add(new Aspose.Pdf.Operators.Do(ximage.Name));
//使用GRestore运算符：该运算符恢复图形状态
page.Contents.Add(new Aspose.Pdf.Operators.GRestore());
dataDir = dataDir + "AddImage_out.pdf";
//保存更新的文档
pdfDocument.Save(dataDir);
Console.WriteLine("\nImage added successfully.\nFile saved at " + dataDir);

结论

在本教程中，我们学习了如何使用 Aspose.PDF for .NET 将图像添加到 PDF 文档。我们详细介绍了从打开文档到保存更新版本的每个步骤。通过遵循本指南，您现在应该能够使用 C# 和 Aspose.PDF 以编程方式将图像嵌入到 PDF 文件中。