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