iTextSharp: Adicionar imagem ao PDF

Que recursos de imagem cada biblioteca oferece?

• IronPDF: O IronPDF simplifica a adição de imagens a PDFs com suporte integrado para imagens locais e remotas provenientes de URLs . Sua API oferece controle sobre posição, largura e escala. A biblioteca suporta conteúdo JPEG, PNG, GIF, SVG e WebGL . A funcionalidade de carimbo oferece métodos para marcas d'água, cabeçalhos e sobreposição de imagens. O mecanismo de renderização do Chrome garante a renderização precisa de gráficos complexos e imagens responsivas .

  iTextSharp: O iTextSharp oferece incorporação de imagens através de sua API de nível inferior. Oferece uma interface flexível que suporta os formatos JPG e PNG. No entanto, você precisa de mais código para personalização, especialmente ao posicionar imagens com precisão ou implementar transparência e rotação . A biblioteca requer o manuseio manual de sistemas de coordenadas e cálculos de escala. Muitas vezes é necessário implementar seus próprios controles de viewport para dimensionamento responsivo.

Como eles lidam com arquivos grandes e operações complexas?

• IronPDF: O IronPDF lida com PDFs e imagens grandes de forma eficiente, melhorando o gerenciamento de memória . O desempenho é excelente na geração ou modificação de PDFs com gráficos incorporados, sendo adequado para aplicações de servidor e implantações no Azure . A biblioteca oferece suporte a operações assíncronas e multithreading para processamento em lote. Os recursos de otimização de desempenho incluem cache inteligente e geração paralela de PDFs .

  iTextSharp: O iTextSharp pode ficar mais lento com arquivos grandes ou operações complexas de imagem. O uso de memória torna-se uma preocupação ao processar várias imagens simultaneamente ou ao trabalhar com imagens de alta resolução . No entanto, continua sendo adequado para a maioria das aplicações quando configurado corretamente. A biblioteca não possui otimização de compressão integrada para operações em lote.

Quais são as implicações de custo para o uso comercial?

• IronPDF: O IronPDF oferece uma licença perpétua com preços transparentes através de uma compra única. Isso evita custos recorrentes de assinatura. A biblioteca inclui opções de teste gratuitas e suporte técnico completo. O gerenciamento de chaves de licença é simples, com diversas opções de configuração .

  iTextSharp: O iTextSharp utiliza a licença AGPL para uso em código aberto, exigindo a liberação do código-fonte. As licenças comerciais dispensam essa exigência. A complexidade do licenciamento pode representar um desafio para as aplicações comerciais. Compreender as atualizações e extensões de licenças exige um planejamento cuidadoso.

Como faço para instalar e configurar o IronPDF?

Instale o IronPDF em seu projeto C# ou Visual Basic via NuGet . A biblioteca suporta vários métodos de instalação , incluindo o Windows Installer e a implantação via Docker :

Install-Package IronPdf

Após a instalação, você pode começar a adicionar imagens usando a API de referência do IronPDF. A biblioteca funciona perfeitamente nas plataformas Windows , Linux e macOS .

Como é a adição básica de imagens no IronPDF?

Início rápido: Adicionar imagem ao PDF com o IronPDF

Adicionar imagens a PDFs com o IronPDF requer um código mínimo, utilizando a API de carimbo.

Como posso adicionar marcas d'água e imagens de fundo?

O IronPDF se destaca na adição de marcas d'água e imagens de fundo a PDFs existentes. A biblioteca suporta múltiplas operações de estampagem e posicionamento personalizado :

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

Imports IronPdf
Imports IronPdf.Editing

' Load an existing PDF
Dim pdf As PdfDocument = PdfDocument.FromFile("invoice.pdf")

' Create a watermark with transparency
Dim watermark As New ImageStamper("watermark.png") With {
    .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
Dim logo As New ImageStamper("company-logo.png") With {
    .HorizontalOffset = Length.Millimeters(10),
    .VerticalOffset = Length.Millimeters(10),
    .Width = 150,
    .Height = 50
}

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

Você também pode criar layouts complexos com várias imagens :

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

Imports System
Imports System.IO

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

Este exemplo utiliza a classe ChromePdfRenderer para renderizar um novo PDF a partir de uma string HTML . Usando a ferramenta de carimbo de imagem do IronPDF, você cria uma imagem a partir da URL fornecida e a aplica ao PDF. Este exemplo demonstra como adicionar imagens à sua página PDF com o mínimo de código. As opções de renderização oferecem controle total sobre a qualidade da saída.

Como posso controlar a posição e as dimensões da imagem no IronPDF?

O IronPDF oferece ampla personalização para o posicionamento de imagens. Você especifica a localização da página definindo o alinhamento e o deslocamento por meio do recurso de posicionamento da ferramenta de carimbo. A biblioteca suporta tanto o posicionamento absoluto com coordenadas quanto o posicionamento relativo usando opções de alinhamento . Os recursos avançados incluem tamanhos de papel personalizados e controle de margens para layouts precisos.

Como faço para instalar e configurar o iTextSharp?

Instale o iTextSharp via NuGet. Ao contrário do suporte completo a plataformas do IronPDF, o iTextSharp possui opções de implantação limitadas:

Install-Package itext7

Após a configuração, prossiga para a adição de imagens utilizando os recursos de manipulação de documentos do iTextSharp. A biblioteca requer configuração adicional para gerenciamento de fontes e suporte a UTF-8 .

Como é a adição básica de imagens no iTextSharp?

Veja como inserir uma imagem usando o 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();
    }
}

Imports iText.Kernel.Pdf
Imports iText.Layout
Imports iText.Layout.Element
Imports iText.IO.Image

Friend Class Program
	Public Shared Sub Main(ByVal args() As String)
		' Initialize PDF writer
		Dim pdfWriter As New PdfWriter("output.pdf")

		' Initialize PDF document
		Dim pdfDocument = New iText.Kernel.Pdf.PdfDocument(pdfWriter)

		' Initialize document
		Dim document As New Document(pdfDocument)

		' Create ImageData from image file
		Dim imageData As ImageData = ImageDataFactory.Create("iText.png")

		' Create an Image instance
		Dim image As 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()
	End Sub
End Class

Como posso adicionar várias imagens e lidar com layouts complexos?

Para cenários complexos, como a criação de catálogos de produtos ou álbuns de fotos , você gerencia o layout manualmente. O recurso de sumário e o suporte a marcadores do IronPDF permitem organizar documentos com várias páginas:

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

Imports iText.Kernel.Pdf
Imports iText.Layout
Imports iText.Layout.Element
Imports iText.IO.Image
Imports iText.Layout.Properties

' Create a grid of images
Dim pdfWriter As New PdfWriter("catalog.pdf")
Dim pdfDocument As New PdfDocument(pdfWriter)
Dim document As New Document(pdfDocument)

' Add images in a grid layout
Dim xPosition As Single = 50
Dim yPosition As Single = 750
Dim imagesPerRow As Integer = 3
Dim currentImage As Integer = 0

Dim imageFiles As String() = {"product1.jpg", "product2.jpg", "product3.jpg", "product4.jpg", "product5.jpg", "product6.jpg"}

For Each imagePath As String In imageFiles
    Dim imageData As ImageData = ImageDataFactory.Create(imagePath)
    Dim image As New Image(imageData)

    ' Calculate position
    Dim column As Integer = currentImage Mod imagesPerRow
    Dim row As Integer = currentImage \ imagesPerRow

    Dim x As Single = xPosition + (column * 180)
    Dim y As Single = yPosition - (row * 250)

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

    document.Add(image)
    currentImage += 1
Next

document.Close()

A imagem é adicionada nas coordenadas (50, 100) e redimensionada para caber em 200x200 pixels. O comando PdfWriter cria o arquivo de saída, habilitando a funcionalidade de gravação de PDF para lidar com imagens. Para melhor organização, considere usar números de página e cabeçalhos/rodapés .

Como posso controlar a posição e as dimensões da imagem no iTextSharp?

O iTextSharp oferece controle sobre o posicionamento e o tamanho por meio de cálculos manuais de coordenadas. Você pode redimensionar imagens mantendo a proporção ou esticá-las para dimensões específicas. O método SetFixedPosition oferece controle preciso de posicionamento e permite manipular alinhamento e rotação . No entanto, ele não possui os controles de viewport e as opções de dimensionamento responsivo do IronPDF.

Como eles lidam com diferentes formatos de imagem?

O IronPDF suporta todos os formatos de imagem:

• JPEG/JPG com otimização de qualidade
• PNG com suporte para transparência
• GIF (quadros estáticos e animados)
• SVG com gráficos vetoriais
• TIFF, incluindo arquivos TIFF com várias páginas
• WebP para imagens web modernas
• Imagens codificadas em Base64
• Imagens do Armazenamento de Blobs do Azure

O iTextSharp suporta formatos padrão:

• JPEG/JPG
• PNG com canal alfa
• GIF (apenas o primeiro quadro)
• TIFF (página única)
• BMP e outros formatos de bitmap

E quanto à qualidade da imagem e à compressão?

O IronPDF oferece opções de compressão integradas que equilibram o tamanho e a qualidade do arquivo. A biblioteca oferece recursos de higienização e capacidade de achatamento de dados :

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

Imports IronPdf

' Configure compression when rendering
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.JpegQuality = 85 ' 0-100 quality scale

' Compress existing PDFs with images
Dim pdf As PdfDocument = 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

O iTextSharp exige o tratamento manual da compressão por meio da manipulação de dados de imagem, aumentando a complexidade da implementação para os controles de qualidade. Você deve implementar sua própria conversão para escala de cinza e ajustes de DPI .

Como posso extrair imagens de PDFs existentes?

O IronPDF oferece recursos confiáveis ​​de extração de imagens :

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

Imports System

' Extract all images from a PDF
Dim pdf As PdfDocument = PdfDocument.FromFile("document.pdf")
Dim images = pdf.ExtractAllImages()

For Each image In images
    ' Save extracted images
    image.SaveAs($"extracted_image_{images.IndexOf(image)}.png")
Next

' Extract images from specific pages
Dim pageImages = pdf.ExtractImagesFromPage(0) ' First page