iTextSharp : ajouter une image au PDF

Quelles fonctions d'image chaque bibliothèque offre-t-elle ?

• IronPDF : IronPDF simplifie l'ajout d'images aux PDFs avec un support intégré pour les images locales ainsi que celles provenant d'URLs. Son API fournit un contrôle sur la position, la largeur et le redimensionnement. La bibliothèque supporte JPEG, PNG, GIF, SVG, et le contenu WebGL. La fonctionnalité d'estampillage offre des méthodes pour l'application de filigranes, d'en-têtes et pour superposer des images. Le moteur de rendu Chrome assure un rendu précis des graphiques complexes et des images adaptatives.

  iTextSharp : iTextSharp propose l'intégration d'image via son API de bas niveau. Il offre une interface flexible qui gère les formats JPG et PNG. Cependant, il vous faut plus de code pour personnaliser, spécialement lorsque vous positionnez des images précisément ou que vous implémentez de la transparence et rotation. La bibliothèque nécessite un traitement manuel des systèmes de coordonnées et des calculs de mise à l'échelle. Vous devez souvent mettre en œuvre vos propres contrôles de viewport pour un redimensionnement adapté.

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

• IronPDF : IronPDF gère efficacement les grands PDFs et images grâce à une gestion améliorée de la mémoire. Les performances sont excellentes lors de la création ou de la modification des PDFs avec des graphiques intégrés, idéal pour les applications serveur et les déploiements Azure. La bibliothèque supporte les opérations asynchrones et le multithreading pour le traitement par lots. Les fonctionnalités d'optimisation des performances incluent une mise en cache intelligente et la génération parallèle de PDFs.

  iTextSharp : iTextSharp peut être plus lent avec les fichiers volumineux ou les opérations d'image complexes. L'utilisation de la mémoire devient préoccupante lors du traitement de plusieurs images simultanément ou lors du travail avec des 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 en lots.

Quelles sont les implications de coût pour une utilisation commerciale ?

• IronPDF : IronPDF propose une licence perpétuelle avec un prix transparent via un achat unique. Cela évite les coûts d'abonnement récurrents. La bibliothèque inclut des options d'essai gratuit et un support technique complet. La gestion des clés de licence est simple avec plusieurs options de configuration.

  iTextSharp : iTextSharp utilise AGPL pour une utilisation open source, nécessitant la publication du code source. Les licences commerciales évitent cette exigence. La complexité de la licence peut poser un défi aux applications commerciales. Comprendre les mises à niveau et les extensions de licence demande 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 incluant Windows Installer et le déploiement Docker :

Install-Package IronPdf

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

À quoi ressemble l'ajout d'une image de base dans IronPDF ?

Démarrage rapide : Ajouter une image au PDF avec IronPDF

Ajouter des images aux PDFs avec IronPDF nécessite peu de code en utilisant l'API d'estampillage.

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

IronPDF excelle à ajouter des filigranes et des images de fond aux PDFs existants. La bibliothèque prend en charge des opérations d'estampillage multiples 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");

Vous pouvez également créer des agencements 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);

Cet exemple utilise la classe ChromePdfRenderer pour rendre un nouveau PDF à partir d'une chaîne HTML. En utilisant l'outil d'estampillage d'image d'IronPDF, vous créez une image à partir de l'URL fournie et l'appliquez au PDF. Cela démontre l'ajout d'images à votre page PDF avec un code minimal. Les options de rendu offrent un contrôle total sur la qualité de sortie.

Comment puis-je contrôler la position et les dimensions de l'image dans IronPDF ?

IronPDF offre une personnalisation étendue pour le placement des images. Vous spécifiez l'emplacement de la page en définissant l'alignement et le décalage via la fonction de positionnement de l'outil d'estampillage. La bibliothèque supporte à la fois le positionnement absolu avec des coordonnées et le positionnement relatif utilisant des options d'alignement. Les fonctionnalités avancées incluent des tailles de papier personnalisées et le contrôle des marges pour des mises en page précises.

Comment installer et configurer iTextSharp ?

Installez iTextSharp via NuGet. Contrairement au support de plateforme complet d'IronPDF, iTextSharp a des options de déploiement limitées :

Install-Package itext7

Une fois configuré, procédez à l'ajout d'images en utilisant les fonctionnalités de manipulation de document d'iTextSharp. La bibliothèque nécessite des configurations additionnelles pour la gestion des polices et le support UTF-8.

À quoi ressemble l'ajout d'une image de base dans iTextSharp ?

Voici comment insérer une image en utilisant 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();
    }
}

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 photo, vous gérez manuellement la mise en page. La fonction de table des matières d'IronPDF et le support des signets peuvent organiser des documents multipages :

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

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

Comment puis-je contrôler la position et les dimensions de l'image dans iTextSharp ?

iTextSharp offre un contrôle sur le positionnement et la taille à travers des calculs de coordonnées manuels. Vous redimensionnez les images tout en maintenant le rapport d'aspect ou en les étirant à des dimensions spécifiques. La méthode SetFixedPosition propose un contrôle de placement précis, et vous pouvez manipuler l'alignement et la rotation. Cependant, elle manque des contrôles de viewport d'IronPDF et des options de taille adaptative.

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

IronPDF prend en charge des formats d'image complets :

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

iTextSharp supporte les formats standards :

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

Et concernant la qualité et la compression de l'image ?

IronPDF offre des options de compression intégrées équilibrant la taille du fichier et la qualité. La bibliothèque propose des fonctionnalités de désinfection et des capacités 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

iTextSharp nécessite une gestion manuelle de la compression via la manipulation des données d'image, augmentant la complexité d'implémentation pour contrôler la qualité. Vous devez implémenter votre propre conversion en niveaux de gris et des ajustements DPI.

Comment puis-je extraire des images de PDFs existants ?

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

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