iTextSharp : ajouter une image au PDF

Quelles sont les fonctionnalités d'image offertes par chaque bibliothèque ?

• IronPDF: IronPDF simplifie l'ajout d'images aux PDF grâce à une prise en charge intégrée des images locales et distantes provenant d'URL . Son API permet de contrôler la position, la largeur et la mise à l'échelle. La bibliothèque prend en charge les contenus JPEG, PNG, GIF, SVG et WebGL . La fonction d'estampillage offre des méthodes pour le filigrane, les en-têtes de lettre et la superposition d'images. Le moteur de rendu de Chrome assure un rendu précis des graphismes complexes et des images réactives .

  iTextSharp : iTextSharp propose l'intégration d'images via son API de bas niveau. Elle offre une interface flexible prenant en charge les formats JPG et PNG. Cependant, vous aurez besoin de plus de code pour la personnalisation, notamment pour positionner les images avec précision ou pour implémenter la transparence et la rotation . La bibliothèque nécessite une gestion manuelle des systèmes de coordonnées et des calculs d'échelle. Il est souvent nécessaire d'implémenter ses propres contrôles de fenêtre d'affichage pour un dimensionnement adaptatif.

Comment gèrent-ils les fichiers volumineux et les opérations complexes ?

• IronPDF: IronPDF gère efficacement les fichiers PDF et les images volumineux grâce à une gestion de la mémoire améliorée. Les performances sont excellentes lors de la génération ou de la modification de fichiers PDF contenant des graphiques intégrés, ce qui convient aux applications serveur et aux déploiements Azure . La bibliothèque prend en charge les opérations asynchrones et le multithreading pour le traitement par lots. Les fonctionnalités d'optimisation des performances incluent la mise en cache intelligente et la génération parallèle de PDF .

  iTextSharp : iTextSharp peut être plus lent avec les fichiers volumineux ou les opérations d'image complexes. L'utilisation de la mémoire devient un problème lors du traitement simultané de plusieurs images ou lors de la manipulation d'images haute résolution . Cependant, il reste adapté à la plupart des applications lorsqu'il est correctement configuré. La bibliothèque ne dispose pas d' une optimisation de compression intégrée pour les opérations par lots.

Quelles sont les implications en termes de coûts pour une utilisation commerciale ?

• IronPDF: IronPDF propose une licence perpétuelle avec une tarification transparente via un achat unique. Cela permet d'éviter les frais d'abonnement récurrents. La bibliothèque propose des options d'essai gratuites et une assistance technique complète. La gestion des clés de licence est simple et offre de multiples options de configuration .

  iTextSharp : iTextSharp utilise la licence AGPL pour son utilisation en open source, ce qui nécessite la publication du code source. Les licences commerciales permettent de s'affranchir de cette exigence. La complexité des licences peut représenter un défi pour les applications commerciales. La compréhension des mises à niveau et des extensions de licences nécessite une planification minutieuse.

Comment installer et configurer IronPDF?

Installez IronPDF dans votre projet C# ou Visual Basic via NuGet . La bibliothèque prend en charge plusieurs méthodes d'installation, notamment Windows Installer et le déploiement Docker :

Install-Package IronPdf

Une fois installé, vous pouvez commencer à ajouter des images en utilisant la documentation de l'API d'IronPDF. La bibliothèque fonctionne parfaitement sur les plateformes Windows , Linux et macOS .

À quoi ressemble l'ajout d'images basiques dans IronPDF?

Démarrage rapide : Ajouter une image à un PDF avec IronPDF

L'ajout d'images aux PDF avec IronPDF nécessite un minimum de code grâce à l'API d'estampage.

Comment puis-je ajouter des filigranes et des images de fond ?

IronPDF excelle dans l'ajout de filigranes et d'images de fond aux PDF existants. La bibliothèque prend en charge plusieurs opérations d'estampage et un positionnement personnalisé :

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

Vous pouvez également créer des mises en page complexes avec plusieurs 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);

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)

Cet exemple utilise la classe ChromePdfRenderer pour générer un nouveau PDF à partir d'une chaîne HTML . L'outil d'estampage d'images d'IronPDF vous permet de créer une image à partir de l'URL fournie et de l'appliquer au PDF. Ceci démontre comment ajouter des images à votre page PDF avec un minimum de code. Les options de rendu offrent un contrôle total sur la qualité de la sortie.

Comment puis-je contrôler la position et les dimensions des images dans IronPDF?

IronPDF offre de nombreuses possibilités de personnalisation pour le placement des images. Vous spécifiez l'emplacement de la page en définissant l'alignement et le décalage grâce à la fonction de positionnement de l'outil d'estampage. La bibliothèque prend en charge à la fois le positionnement absolu avec coordonnées et le positionnement relatif à l'aide d'options d'alignement . Parmi les fonctionnalités avancées, on trouve des formats de papier personnalisés et le contrôle des marges pour des mises en page précises.

Comment installer et configurer iTextSharp ?

Installez iTextSharp via NuGet. Contrairement à la prise en charge complète des plateformes offerte par IronPDF, iTextSharp propose des options de déploiement limitées :

Install-Package itext7

Une fois la configuration terminée, procédez à l'ajout d'images à l'aide des fonctionnalités de manipulation de documents d'iTextSharp. La bibliothèque nécessite une configuration supplémentaire pour la gestion des polices et la prise en charge de l'UTF-8 .

À quoi ressemble l'ajout d'images basiques dans iTextSharp ?

Voici comment insérer une image avec 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

Comment puis-je ajouter plusieurs images et gérer des mises en page complexes ?

Pour des scénarios complexes comme la création de catalogues de produits ou d'albums photos , la mise en page est gérée manuellement. La fonction de table des matières et la prise en charge des signets d'IronPDF permettent d'organiser les documents de plusieurs pages :

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

L'image est ajoutée aux coordonnées (50, 100) et mise à l'échelle pour s'adapter à 200x200 pixels. Le PdfWriter crée le fichier de sortie, activant la fonctionnalité d'écriture PDF pour la gestion des images. Pour une meilleure organisation, pensez à utiliser des numéros de page et des en-têtes/pieds de page .

Comment puis-je contrôler la position et les dimensions des images dans iTextSharp ?

iTextSharp permet de contrôler le positionnement et la taille grâce à des calculs de coordonnées manuels. Vous pouvez redimensionner les images tout en conservant leurs proportions ou les étirer à des dimensions spécifiques. La méthode SetFixedPosition offre un contrôle précis du placement, et vous pouvez manipuler l'alignement et la rotation . Cependant, il lui manque les commandes de fenêtre d'affichage et les options de dimensionnement réactif d'IronPDF.

Comment gèrent-ils les différents formats d'image ?

IronPDF prend en charge tous les formats d'image :

• JPEG/JPG avec optimisation de la qualité
• PNG avec prise en charge de la transparence
• GIF (images fixes et animées)
• SVG avec graphiques vectoriels
• Fichiers TIFF, y compris les fichiers TIFF multipages
• WebP pour les images web modernes
• Images encodées en Base64
• Images provenant du stockage Blob Azure

iTextSharp prend en charge les formats standard :

• JPEG/JPG
• PNG avec canal alpha
• GIF (première image seulement)
• TIFF (une seule page)
• BMP et autres formats bitmap

Qu'en est-il de la qualité d'image et de la compression ?

IronPDF propose des options de compression intégrées permettant d'équilibrer la taille et la qualité des fichiers. La bibliothèque offre des fonctionnalités de nettoyage et d'aplatissement :

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

iTextSharp nécessite une gestion manuelle de la compression par manipulation des données d'image, ce qui augmente la complexité de la mise en œuvre pour les contrôles de qualité. Vous devez implémenter vous-même la conversion en niveaux de gris et les ajustements DPI .

Comment extraire des images de fichiers PDF existants ?

IronPDF offre des capacités d'extraction d'images fiables :

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