iTextSharp: Dodaj obraz do PDF

Jakie funkcje oferuje każda z bibliotek?

• IronPDF: IronPDF ułatwia dodawanie obrazów do plików PDF dzięki wbudowanej obsłudze zarówno obrazów lokalnych, jak i zdalnych z adresów URL. Jego API zapewnia kontrolę nad położeniem, szerokością i skalowaniem. Biblioteka obsługuje treści w formatach JPEG, PNG, GIF, SVG i WebGL. Funkcja stemplowania udostępnia metody dodawania znaków wodnych, nagłówków listowych i nakładania obrazów. Silnik renderujący Chrome zapewnia dokładne renderowanie złożonej grafiki i responsywnych obrazów.

  iTextSharp: iTextSharp oferuje osadzanie obrazów za pośrednictwem swojego API niższego poziomu. Zapewnia elastyczny interfejs obsługujący formaty JPG i PNG. Jednak do dostosowania potrzeba więcej kodu, zwłaszcza przy precyzyjnym pozycjonowaniu obrazów lub wdrażaniu przezroczystości i obracania. Biblioteka wymaga ręcznej obsługi układów współrzędnych i obliczeń skalowania. Często konieczne jest wdrożenie własnych elementów sterujących oknem wyświetlania w celu zapewnienia responsywnego dostosowywania rozmiaru.

Jak radzą sobie z dużymi plikami i złożonymi operacjami?

• IronPDF: IronPDF efektywnie obsługuje duże pliki PDF i obrazy dzięki ulepszonemu zarządzaniu pamięcią. Wyróżnia się wydajnością podczas generowania lub modyfikowania plików PDF z osadzoną grafiką, nadając się do zastosowań serwerowych i wdrożeń w Azure. Biblioteka obsługuje operacje asynchroniczne i wielowątkowość do przetwarzania wsadowego. Funkcje optymalizacji wydajności obejmują inteligentne buforowanie i równoległe generowanie plików PDF.

  iTextSharp: iTextSharp może działać wolniej w przypadku dużych plików lub złożonych operacji na obrazach. Zużycie pamięci staje się problemem podczas jednoczesnego przetwarzania wielu obrazów lub pracy z obrazami o wysokiej rozdzielczości. Jednak po odpowiedniej konfiguracji nadal nadaje się do większości zastosowań. Biblioteka nie posiada wbudowanej optymalizacji kompresji dla operacji wsadowych.

Jakie są konsekwencje finansowe w przypadku wykorzystania komercyjnego?

• IronPDF: IronPDF oferuje Licencję wieczystą z przejrzystymi cenami w ramach jednorazowego zakupu. Pozwala to uniknąć powtarzających się kosztów subskrypcji. Biblioteka oferuje bezpłatne wersje próbne oraz pełne wsparcie techniczne. Zarządzanie kluczami licencyjnymi jest proste i oferuje wiele opcji konfiguracyjnych.

  iTextSharp: iTextSharp wykorzystuje licencję AGPL do użytku open source, wymagającą udostępnienia kodu źródłowego. Licencje komercyjne nie podlegają temu wymogowi. Złożoność licencji może stanowić wyzwanie dla zastosowań komercyjnych. Zrozumienie aktualizacji i przedłużeń licencji wymaga starannego planowania.

Jak zainstalować i skonfigurować IronPDF?

Zainstaluj IronPDF w swoim projekcie C# lub Visual Basic za pomocą NuGet. Biblioteka obsługuje wiele metod instalacji, w tym instalator Windows Installer i wdrożenie w Dockerze:

Install-Package IronPdf

Po zainstalowaniu możesz zacząć dodawać obrazy, korzystając z Dokumentacji API IronPDF. Biblioteka działa płynnie na platformach Windows, Linux i macOS.

Jak wygląda podstawowe dodawanie obrazów w IronPDF?

Szybki start: Dodaj obraz do pliku PDF za pomocą IronPDF

Dodawanie obrazów do plików PDF za pomocą IronPDF wymaga minimalnej ilości kodu przy użyciu interfejsu API stemplowania.

Jak mogę dodać znaki wodne i obrazy tła?

IronPDF doskonale sprawdza się w dodawaniu znaków wodnych i obrazów tła do istniejących plików PDF. Biblioteka obsługuje wiele operacji stemplowania i niestandardowe pozycjonowanie:

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

Można również tworzyć złożone układy zawierające wiele obrazów:

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

W tym przykładzie wykorzystano klasę ChromePdfRenderer do renderowania nowego pliku PDF na podstawie ciągu znaków HTML. Korzystając z narzędzia do stemplowania obrazów IronPDF, można utworzyć obraz na podstawie podanego adresu URL i zastosować go w pliku PDF. Poniżej przedstawiono przykład dodawania obrazów do strony PDF przy użyciu minimalnej ilości kodu. Opcje renderowania zapewniają pełną kontrolę nad jakością wyniku.

Jak mogę kontrolować położenie i wymiary obrazów w IronPDF?

IronPDF zapewnia szerokie możliwości dostosowania rozmieszczenia obrazów. Lokalizację strony określa się, ustawiając wyrównanie i przesunięcie za pomocą funkcji pozycjonowania narzędzia do stemplowania. Biblioteka obsługuje zarówno pozycjonowanie absolutne za pomocą współrzędnych, jak i pozycjonowanie względne z wykorzystaniem opcji wyrównania. Zaawansowane funkcje obejmują niestandardowe rozmiary papieru i kontrolę marginesów, co pozwala na precyzyjne tworzenie układów.

Jak zainstalować i skonfigurować iTextSharp?

Zainstaluj iTextSharp za pośrednictwem NuGet. W przeciwieństwie do pełnej obsługi platformy przez IronPDF, iTextSharp ma ograniczone opcje wdrażania:

Install-Package itext7

Po skonfigurowaniu przejdź do dodawania obrazów, korzystając z funkcji manipulacji dokumentami iTextSharp. Biblioteka wymaga dodatkowej konfiguracji w zakresie zarządzania czcionkami i obsługi UTF-8.

Jak wygląda podstawowe dodawanie obrazów w iTextSharp?

Oto jak wstawić obraz za pomocą 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

Jak mogę dodać wiele obrazów i obsłużyć złożone układy?

W przypadku złożonych scenariuszy, takich jak tworzenie katalogów produktów lub albumów ze zdjęciami, układ stron należy zarządzać ręcznie. Funkcja spisu treści oraz obsługa zakładek w IronPDF umożliwiają porządkowanie dokumentów wielostronicowych:

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

Obraz jest dodawany w współrzędnych (50, 100) i skalowany tak, aby zmieścił się w obszarze 200x200 pikseli. PdfWriter tworzy plik wyjściowy, włączając funkcję generatora PDF do obsługi obrazów. Aby zapewnić lepszą organizację tekstu, warto rozważyć użycie numerów stron oraz nagłówków i stopek.

Jak mogę kontrolować położenie i wymiary obrazów w iTextSharp?

iTextSharp zapewnia kontrolę nad pozycjonowaniem i rozmiarem poprzez ręczne obliczanie współrzędnych. Można skalować obrazy, zachowując proporcje lub rozciągając je do określonych wymiarów. Metoda SetFixedPosition zapewnia precyzyjną kontrolę nad rozmieszczeniem elementów oraz umożliwia manipulowanie wyrównaniem i obrotem. Brakuje jednak w nim elementów sterujących oknem podglądu oraz opcji responsywnego dostosowywania rozmiaru, które oferuje IronPDF.

Jak radzą sobie z różnymi formatami obrazów?

IronPDF obsługuje wszystkie formaty obrazów:

• JPEG/JPG z optymalizacją jakości
• Plik PNG z obsługą przezroczystości
• GIF (klatki statyczne i animowane)
• SVG z grafiką wektorową
• TIFF, w tym wielostronicowe pliki TIFF
• WebP dla nowoczesnych obrazów internetowych
• Obrazy zakodowane w Base64
• Obrazy z usługi Azure Blob Storage

iTextSharp obsługuje standardowe formaty:

• JPEG/JPG
• Plik PNG z kanałem alfa
• GIF (tylko pierwsza klatka)
• TIFF (pojedyncza strona)
• BMP i inne formaty bitmapowe

A co z jakością obrazu i kompresją?

IronPDF oferuje wbudowane opcje kompresji, które pozwalają zachować równowagę między rozmiarem pliku a jakością. Biblioteka oferuje funkcje czyszczenia danych oraz możliwości spłaszczania:

// 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 wymaga ręcznej obsługi kompresji poprzez manipulację danymi obrazu, co zwiększa złożoność wdrożenia w zakresie kontroli jakości. Należy samodzielnie zaimplementować konwersję do skali szarości oraz dostosowanie DPI.

Jak mogę wyodrębnić obrazy z istniejących plików PDF?

IronPDF zapewnia niezawodne funkcje wyodrębniania obrazów:

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