iTextSharp: Add Image to PDF

What Image Features Does Each Library Offer?

• IronPDF: IronPDF simplifies adding images to PDFs with built-in support for both local and remote images from URLs. Its API provides control over position, width, and scaling. The library supports JPEG, PNG, GIF, SVG, and WebGL content. The stamping functionality provides methods for watermarking, letterheads, and overlaying images. The Chrome rendering engine ensures accurate rendering of complex graphics and responsive images.

  iTextSharp: iTextSharp offers image embedding through its lower-level API. It provides a flexible interface handling JPG and PNG formats. However, you need more code for customization, especially when positioning images precisely or implementing transparency and rotation. The library requires manual handling of coordinate systems and scaling calculations. You often need to implement your own viewport controls for responsive sizing.

How Do They Handle Large Files and Complex Operations?

• IronPDF: IronPDF handles large PDFs and images efficiently through improve memory management. Performance excels when generating or modifying PDFs with embedded graphics, suitable for server applications and Azure deployments. The library supports async operations and multithreading for batch processing. Performance optimization features include intelligent caching and parallel PDF generation.

  iTextSharp: iTextSharp can be slower with large files or complex image operations. Memory usage becomes a concern when processing multiple images simultaneously or working with high-resolution images. However, it remains suitable for most applications when properly configured. The library lacks built-in compression optimization for batch operations.

What Are the Cost Implications for Commercial Use?

• IronPDF: IronPDF offers a perpetual license with transparent pricing through one-time purchase. This avoids recurring subscription costs. The library includes free trial options and complete technical support. License key management is straightforward with multiple configuration options.

  iTextSharp: iTextSharp uses AGPL for open-source use, requiring source code release. Commercial licenses avoid this requirement. The licensing complexity can challenge commercial applications. Understanding license upgrades and extensions requires careful planning.

How Do I Install and Configure IronPDF?

Install IronPDF in your C# or Visual Basic project via NuGet. The library supports multiple installation methods including Windows Installer and Docker deployment:

Install-Package IronPdf

Once installed, you can start adding images using IronPDF's API reference. The library works seamlessly across Windows, Linux, and macOS platforms.

What Does Basic Image Addition Look Like in IronPDF?

Quickstart: Add Image to PDF with IronPDF

Adding images to PDFs with IronPDF requires minimal code using the stamping API.

How Can I Add Watermarks and Background Images?

IronPDF excels at adding watermarks and background images to existing PDFs. The library supports multiple stamping operations and custom positioning:

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");

You can also create complex layouts with multiple images:

// 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);

This example uses the ChromePdfRenderer class to render a new PDF from an HTML string. Using IronPDF's image stamping tool, you create an image from the provided URL and apply it to the PDF. This demonstrates adding images to your PDF page with minimal code. The rendering options provide full control over output quality.

How Can I Control Image Position and Dimensions in IronPDF?

IronPDF provides extensive customization for image placement. You specify page location by setting alignment and offset through the stamping tool's positioning feature. The library supports both absolute positioning with coordinates and relative positioning using alignment options. Advanced features include custom paper sizes and margin control for precise layouts.

How Do I Install and Configure iTextSharp?

Install iTextSharp via NuGet. Unlike IronPDF's complete platform support, iTextSharp has limited deployment options:

Install-Package itext7

Once configured, proceed to add images using iTextSharp's document manipulation features. The library requires additional configuration for font management and UTF-8 support.

What Does Basic Image Addition Look Like in iTextSharp?

Here's how to insert an image using 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();
    }
}

How Can I Add Multiple Images and Handle Complex Layouts?

For complex scenarios like creating product catalogs or photo albums, you manage layout manually. IronPDF's table of contents feature and bookmark support can organize multi-page documents:

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();

The image is added at coordinates (50, 100) and scaled to fit within 200x200 pixels. The PdfWriter creates the output file, enabling PDF writer functionality for handling images. For better organization, consider using page numbers and headers/footers.

How Can I Control Image Position and Dimensions in iTextSharp?

iTextSharp provides control over positioning and size through manual coordinate calculations. You scale images while maintaining aspect ratio or stretch to specific dimensions. The SetFixedPosition method offers precise placement control, and you can manipulate alignment and rotation. However, it lacks IronPDF's viewport controls and responsive sizing options.

How Do They Handle Different Image Formats?

IronPDF supports complete image formats:

• JPEG/JPG with quality optimization
• PNG with transparency support
• GIF (static and animated frames)
• SVG with vector graphics
• TIFF including multi-page TIFF files
• WebP for modern web images
• Base64 encoded images
• Images from Azure Blob Storage

iTextSharp supports standard formats:

• JPEG/JPG
• PNG with alpha channel
• GIF (first frame only)
• TIFF (single page)
• BMP and other bitmap formats

What About Image Quality and Compression?

IronPDF provides built-in compression options balancing file size and quality. The library offers sanitization features and flattening capabilities:

// 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 requires manual compression handling through image data manipulation, increasing implementation complexity for quality controls. You must implement your own grayscale conversion and DPI adjustments.

How Can I Extract Images from Existing PDFs?

IronPDF provides reliable image extraction capabilities:

// 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