PDF, który odnosi się do obrazów przez ścieżki plików lub URL, niesie ze sobą ukrytą zależność. W momencie, gdy dokument opuszcza maszynę, na której został stworzony, działa w bezstanowej funkcji chmurowej lub jest archiwizowany przez lata, te odniesienia mogą się wyłączyć, pozostawiając puste pola tam, gdzie powinno być logo lub wykres. Osadzanie obrazów bezpośrednio w HTML jako dane URI base64 usuwa tę zależność, a IronPDF renderuje wynik w pełni samodzielny PDF.

Problem biznesowy

Usługa fakturowania przenosi się do Azure lub AWS Lambda, gdzie dostęp do systemu plików jest ograniczony i efemeryczny, więc ścieżki obrazów, które działały lokalnie, nie rozwiązują się już. Narzędzie do raportowania wysyła e-mailem dokumenty, które muszą być wyświetlane poprawnie wiele lat później, długi czas po zmianie oryginalnego serwera zasobów. Pipeline składa dokumenty z obrazów generowanych w czasie rzeczywistym, które nigdy nie były zapisywane na dysku. W każdym przypadku zewnętrzne odniesienia do obrazów są obciążeniem.

Osadzanie obrazów jako dane URI

Schemat ma trzy kroki: odczytanie bajtów obrazu, konwersja na base64 i umieszczenie wyniku w tagu <img> z odpowiadającym typem MIME. Renderowany PDF następnie przechowuje obraz w pliku.

using IronPdf;
using System;

byte[] imageBytes = System.IO.File.ReadAllBytes("logo.png");
string dataUri = "data:image/png;base64," + Convert.ToBase64String(imageBytes);
string html = $"<img src='{dataUri}'>";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("self-contained.pdf");

using IronPdf;
using System;

byte[] imageBytes = System.IO.File.ReadAllBytes("logo.png");
string dataUri = "data:image/png;base64," + Convert.ToBase64String(imageBytes);
string html = $"<img src='{dataUri}'>";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("self-contained.pdf");

To samo podejście działa dla obrazów generowanych w czasie rzeczywistym, takich jak wykres lub kod kreskowy tworzony w pamięci, przez kodowanie bajtów bezpośrednio bez tworzenia tymczasowego pliku. Wiele formatów jest obsługiwanych, o ile URI danych deklaruje poprawny typ: PNG, JPEG, GIF, SVG (image/svg+xml) i WebP.

Punkty do zaplanowania

• Base64 dodaje rozmiar: Kodowanie zwiększa rozmiar bajtów każdego obrazu o około jedną trzecią, co ląduje zarówno w HTML, jak i PDF. W przypadku dokumentów z dużą ilością obrazów, należy je skompresować lub zmniejszyć przed kodowaniem i zastosować kompresję PDF po.
• Dopasuj typ MIME: Prefiks musi pasować do formatu, takiego jak data:image/jpeg;base64, dla JPEG, inaczej obraz się nie wyświetli.
• Brak zależności od systemu plików: Ponieważ obraz podróżuje wewnątrz dokumentu, renderowanie nie polega na dostępnej ścieżce lub serwerze zasobów, co sprawia, że jest niezawodne w środowiskach chmurowych i kontenerowych.
• Mniej pobrań: Osadzone obrazy unikają dodatkowych wywołań HTTP lub systemu plików podczas renderowania, co poprawia przepustowość, kiedy dokument zawiera wiele małych obrazów.

Wynik

Przez osadzanie obrazów jako danych URI, zespoły generują PDF, które renderują się identycznie, niezależnie od tego, czy działają na laptopie, czy w serwerless funkcji, i które zachowują każdy obraz nienaruszony, gdy są wysyłane e-mailem lub archiwizowane. Pełne szczegóły formatu i przykłady znajdują się w przewodniku osadzania obrazów z DataURIs.