iTextSharp：向 PDF 添加图像

每个图库提供哪些图像功能？

• IronPDF： IronPDF 简化了向 PDF 添加图像的操作，内置支持来自 URL 的本地图像和远程图像。 其 API 提供对位置、宽度和缩放的控制。 该库支持 JPEG、PNG、GIF、 SVG和WebGL 内容。 印章功能提供了添加水印、信头和叠加图像的方法。 Chrome渲染引擎可确保复杂图形和响应式图像的精确渲染。

  iTextSharp： iTextSharp 通过其底层 API 提供图像嵌入功能。 它提供了一个灵活的接口，可以处理 JPG 和 PNG 格式。 但是，自定义需要更多代码，尤其是在精确定位图像或实现透明度和旋转时。 该库需要手动处理坐标系和比例计算。 为了实现响应式尺寸，您通常需要实现自己的视口控件。

它们如何处理大型文件和复杂操作？

• IronPDF： IronPDF 通过改进内存管理，高效地处理大型 PDF 和图像。 在生成或修改带有嵌入式图形的 PDF 时性能优异，适用于服务器应用程序和Azure 部署。 该库支持异步操作和多线程批量处理。 性能优化功能包括智能缓存和并行 PDF 生成。

  iTextSharp： iTextSharp 在处理大文件或复杂图像操作时速度可能会较慢。 当同时处理多张图像或处理高分辨率图像时，内存使用情况会成为一个问题。 但是，只要配置得当，它仍然适用于大多数应用场景。 该库缺少针对批量操作的内置压缩优化功能。

商业用途的成本影响是什么？

• IronPDF： IronPDF 提供永久许可证，一次性购买即可享受透明定价。 这样可以避免产生持续的订阅费用。 该图书馆提供免费试用选项和完整的技术支持。 许可证密钥管理非常简单，提供多种配置选项。

  iTextSharp： iTextSharp 使用 AGPL 进行开源，要求发布源代码。 商业许可证可以免除这项要求。 许可的复杂性可能会给商业应用带来挑战。 了解许可证升级和延期需要周密的计划。

如何安装和配置 IronPDF？

通过NuGet将 IronPDF 安装到您的 C# 或 Visual Basic 项目中。 该库支持多种安装方法，包括Windows Installer和Docker 部署：

Install-Package IronPdf

安装完成后，您可以使用 IronPDF 的API 参考开始添加图像。 该库可在Windows 、 Linux和macOS平台上无缝运行。

IronPDF 中的基本图像添加功能是什么样的？

快速入门：使用 IronPDF 向 PDF 添加图像

使用 IronPDF 的印章 API 向 PDF 添加图像只需要编写极少的代码。

如何添加水印和背景图片？

IronPDF 擅长为现有 PDF 添加水印和背景图像。 该库支持多种冲压操作和自定义定位：

using IronPdf;
using IronPdf.Editing;

// Load an existing PDF
PdfDocument pdf = PdfDocument.FromFile("invoice.pdf");

// Create a watermark with transparency
ImageStamper watermark = new ImageStamper("watermark.png")
{
    Opacity = 30,  // 30% opacity for subtle watermarking
    Rotation = -45, // Diagonal watermark
    HorizontalAlignment = HorizontalAlignment.Center,
    VerticalAlignment = VerticalAlignment.Middle
};

// Apply watermark to all pages
pdf.ApplyStamp(watermark);

// Add a header logo
ImageStamper logo = new ImageStamper("company-logo.png")
{
    HorizontalOffset = Length.Millimeters(10),
    VerticalOffset = Length.Millimeters(10),
    Width = 150,
    Height = 50
};

pdf.ApplyStamp(logo, PageSelection.FirstPage);
pdf.SaveAs("watermarked-invoice.pdf");

using IronPdf;
using IronPdf.Editing;

// Load an existing PDF
PdfDocument pdf = PdfDocument.FromFile("invoice.pdf");

// Create a watermark with transparency
ImageStamper watermark = new ImageStamper("watermark.png")
{
    Opacity = 30,  // 30% opacity for subtle watermarking
    Rotation = -45, // Diagonal watermark
    HorizontalAlignment = HorizontalAlignment.Center,
    VerticalAlignment = VerticalAlignment.Middle
};

// Apply watermark to all pages
pdf.ApplyStamp(watermark);

// Add a header logo
ImageStamper logo = new ImageStamper("company-logo.png")
{
    HorizontalOffset = Length.Millimeters(10),
    VerticalOffset = Length.Millimeters(10),
    Width = 150,
    Height = 50
};

pdf.ApplyStamp(logo, PageSelection.FirstPage);
pdf.SaveAs("watermarked-invoice.pdf");

您还可以创建包含多张图片的复杂布局：

// Add images from Base64 strings
string base64Image = Convert.ToBase64String(File.ReadAllBytes("signature.png"));
HtmlStamper signatureStamp = new HtmlStamper($"<img src='data:image/png;base64,{base64Image}'/>");
signatureStamp.HorizontalAlignment = HorizontalAlignment.Right;
signatureStamp.VerticalAlignment = VerticalAlignment.Bottom;
pdf.ApplyStamp(signatureStamp);

// Add images from Base64 strings
string base64Image = Convert.ToBase64String(File.ReadAllBytes("signature.png"));
HtmlStamper signatureStamp = new HtmlStamper($"<img src='data:image/png;base64,{base64Image}'/>");
signatureStamp.HorizontalAlignment = HorizontalAlignment.Right;
signatureStamp.VerticalAlignment = VerticalAlignment.Bottom;
pdf.ApplyStamp(signatureStamp);

PDF 查看器显示一个简单的文档，其中包含"Hello World"文本和位于页面中心的 IronPDF 徽标水印——演示了 IronPDF 的图像水印功能，该功能可精确定位并控制不透明度。

本示例使用ChromePdfRenderer类从HTML 字符串渲染新的 PDF。 使用 IronPDF 的图像盖章工具，您可以从提供的 URL 创建图像并将其应用到 PDF 中。 这演示了如何用最少的代码向PDF 页面添加图像。 渲染选项可让您完全控制输出质量。

如何在IronPDF中控制图像位置和尺寸？

IronPDF 为图像放置提供了广泛的自定义选项。 您可以通过印章工具的定位功能设置对齐方式和偏移量来指定页面位置。 该库支持使用坐标进行绝对定位和使用对齐选项进行相对定位。 高级功能包括自定义纸张尺寸和边距控制，以实现精确的布局。

如何安装和配置 iTextSharp？

通过 NuGet 安装 iTextSharp。 与 IronPDF 的全面平台支持不同，iTextSharp 的部署选项有限：

Install-Package itext7

配置完成后，即可使用 iTextSharp 的文档操作功能添加图像。 该库需要额外的配置才能进行字体管理和UTF-8 支持。

iTextSharp 中的基本图像添加功能是什么样的？

以下是如何使用 iTextSharp 插入图片：

using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.IO.Image;

class Program
{
    public static void Main(string[] args)
    {
        // Initialize PDF writer
        var pdfWriter = new PdfWriter("output.pdf");

        // Initialize PDF document
        var pdfDocument = new iText.Kernel.Pdf.PdfDocument(pdfWriter);

        // Initialize document
        var document = new Document(pdfDocument);

        // Create ImageData from image file
        ImageData imageData = ImageDataFactory.Create("iText.png");

        // Create an Image instance
        Image image = new Image(imageData);

        // Set fixed position for the image in the PDF
        image.SetFixedPosition(50, 100);  // x, y coordinates

        // Scale image to fit within specified dimensions
        image.ScaleToFit(200, 200);  // Width, Height

        // Add image to document
        document.Add(image);

        // Close the document
        document.Close();
    }
}

using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.IO.Image;

class Program
{
    public static void Main(string[] args)
    {
        // Initialize PDF writer
        var pdfWriter = new PdfWriter("output.pdf");

        // Initialize PDF document
        var pdfDocument = new iText.Kernel.Pdf.PdfDocument(pdfWriter);

        // Initialize document
        var document = new Document(pdfDocument);

        // Create ImageData from image file
        ImageData imageData = ImageDataFactory.Create("iText.png");

        // Create an Image instance
        Image image = new Image(imageData);

        // Set fixed position for the image in the PDF
        image.SetFixedPosition(50, 100);  // x, y coordinates

        // Scale image to fit within specified dimensions
        image.ScaleToFit(200, 200);  // Width, Height

        // Add image to document
        document.Add(image);

        // Close the document
        document.Close();
    }
}

如何添加多张图片并处理复杂的布局？

对于创建产品目录或相册等复杂场景，您需要手动管理布局。 IronPDF的目录功能和书签支持可以整理多页文档：

using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.IO.Image;
using iText.Layout.Properties;

// Create a grid of images
var pdfWriter = new PdfWriter("catalog.pdf");
var pdfDocument = new PdfDocument(pdfWriter);
var document = new Document(pdfDocument);

// Add images in a grid layout
float xPosition = 50;
float yPosition = 750;
int imagesPerRow = 3;
int currentImage = 0;

string[] imageFiles = { "product1.jpg", "product2.jpg", "product3.jpg", 
                       "product4.jpg", "product5.jpg", "product6.jpg" };

foreach (string imagePath in imageFiles)
{
    ImageData imageData = ImageDataFactory.Create(imagePath);
    Image image = new Image(imageData);

    // Calculate position
    int column = currentImage % imagesPerRow;
    int row = currentImage / imagesPerRow;

    float x = xPosition + (column * 180);
    float y = yPosition - (row * 250);

    image.SetFixedPosition(x, y);
    image.ScaleToFit(150, 200);

    document.Add(image);
    currentImage++;
}

document.Close();

using iText.Kernel.Pdf;
using iText.Layout;
using iText.Layout.Element;
using iText.IO.Image;
using iText.Layout.Properties;

// Create a grid of images
var pdfWriter = new PdfWriter("catalog.pdf");
var pdfDocument = new PdfDocument(pdfWriter);
var document = new Document(pdfDocument);

// Add images in a grid layout
float xPosition = 50;
float yPosition = 750;
int imagesPerRow = 3;
int currentImage = 0;

string[] imageFiles = { "product1.jpg", "product2.jpg", "product3.jpg", 
                       "product4.jpg", "product5.jpg", "product6.jpg" };

foreach (string imagePath in imageFiles)
{
    ImageData imageData = ImageDataFactory.Create(imagePath);
    Image image = new Image(imageData);

    // Calculate position
    int column = currentImage % imagesPerRow;
    int row = currentImage / imagesPerRow;

    float x = xPosition + (column * 180);
    float y = yPosition - (row * 250);

    image.SetFixedPosition(x, y);
    image.ScaleToFit(150, 200);

    document.Add(image);
    currentImage++;
}

document.Close();

PDF 查看器显示一个居中的 ITEXT 徽标，徽标下方是"CORE"字样，页面其余部分为空白——这是 iTextSharp 图像插入功能的示例输出，演示了其基本的定位和缩放功能。

图片被添加到坐标 (50, 100) 处，并缩放至 200x200 像素大小。 PdfWriter创建输出文件，使PDF 写入器能够处理图像。 为了更好地组织内容，可以考虑使用页码和页眉/页脚。

如何在iTextSharp中控制图像位置和尺寸？

iTextSharp 通过手动坐标计算提供对定位和大小的控制。 您可以缩放图像，同时保持宽高比，或者拉伸到特定尺寸。 SetFixedPosition方法提供精确的放置控制，您可以调整对齐方式和旋转角度。 但是，它缺少 IronPDF 的视口控制和响应式尺寸选项。

它们如何处理不同的图像格式？

IronPDF支持所有图像格式：

• JPEG/JPG质量优化 -支持透明度的 PNG GIF（静态和动态帧）
• SVG 矢量图形
• TIFF 文件，包括多页 TIFF 文件
• WebP 用于现代网络图像
• Base64编码图像 来自 Azure Blob 存储的图像

iTextSharp支持标准格式：

• JPEG/JPG
• 带透明通道的PNG图像
• GIF（仅第一帧）
• TIFF（单页）
• BMP 和其他位图格式

图像质量和压缩情况如何？

IronPDF提供内置的压缩选项，可在文件大小和质量之间取得平衡。 该库提供数据清理功能和数据扁平化功能：

// Configure compression when rendering
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.JpegQuality = 85; // 0-100 quality scale

// Compress existing PDFs with images
PdfDocument pdf = PdfDocument.FromFile("large-images.pdf");
pdf.CompressImages(60); // Compress to 60% quality
pdf.SaveAs("compressed.pdf");

// Additional optimization options
renderer.RenderingOptions.GrayScale = true; // Convert to grayscale
renderer.RenderingOptions.DPI = 150; // Reduce DPI for web viewing

// Configure compression when rendering
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.JpegQuality = 85; // 0-100 quality scale

// Compress existing PDFs with images
PdfDocument pdf = PdfDocument.FromFile("large-images.pdf");
pdf.CompressImages(60); // Compress to 60% quality
pdf.SaveAs("compressed.pdf");

// Additional optimization options
renderer.RenderingOptions.GrayScale = true; // Convert to grayscale
renderer.RenderingOptions.DPI = 150; // Reduce DPI for web viewing

iTextSharp需要通过图像数据处理进行手动压缩处理，这增加了质量控制的实现复杂性。 您必须自行实现灰度转换和DPI调整。

如何从现有PDF文件中提取图像？

IronPDF 提供可靠的图像提取功能：

// Extract all images from a PDF
PdfDocument pdf = PdfDocument.FromFile("document.pdf");
var images = pdf.ExtractAllImages();

foreach (var image in images)
{
    // Save extracted images
    image.SaveAs($"extracted_image_{images.IndexOf(image)}.png");
}

// Extract images from specific pages
var pageImages = pdf.ExtractImagesFromPage(0); // First page

// Extract all images from a PDF
PdfDocument pdf = PdfDocument.FromFile("document.pdf");
var images = pdf.ExtractAllImages();

foreach (var image in images)
{
    // Save extracted images
    image.SaveAs($"extracted_image_{images.IndexOf(image)}.png");
}

// Extract images from specific pages
var pageImages = pdf.ExtractImagesFromPage(0); // First page