====== std.pdf.image ======

Rasterbilder in PDF-Seiten einbetten: PNG und JPEG laden, als XObject registrieren und an beliebiger Position auf der Seite skaliert ausgeben. Unterstützte Formate: PNG (mit Alpha-Kanal), JPEG (RGB und Graustufen).

→ [[lyx_-_programmiersprache:units:pdf|std.pdf]] · [[lyx_-_programmiersprache:units:pdf:graphics|std.pdf.graphics]] · [[lyx_-_programmiersprache:units:pdf:page|std.pdf.page]]

----

===== Verwendung =====

<code lyx>
import std.pdf.image;

// PNG laden und auf Seite ausgeben
var img: PdfImage := PdfAddImage(doc, "logo.png");
PdfDrawImage(page, img, 72.0, 750.0, 120.0, 40.0);

// JPEG einbetten
var photo: PdfImage := PdfAddImageJpeg(doc, "photo.jpg");
PdfDrawImage(page, photo, 72.0, 500.0, 300.0, 200.0);

// Bild skaliert (Breite angeben, Höhe proportional)
var w: f64 := 200.0;
var h: f64 := PdfImageHeight(img) * (w / PdfImageWidth(img));
PdfDrawImage(page, img, 72.0, 600.0, w, h);
</code>

----

===== Funktionen =====

^ Signatur ^ Sichtbarkeit ^ Beschreibung ^
| ''PdfAddImage(doc: Pdf, path: pchar): PdfImage'' | pub | Lädt PNG-Datei und registriert sie als XObject |
| ''PdfAddImageJpeg(doc: Pdf, path: pchar): PdfImage'' | pub | Lädt JPEG-Datei und registriert sie als XObject |
| ''PdfDrawImage(page: PdfPage, img: PdfImage, x: f64, y: f64, w: f64, h: f64): void'' | pub | Gibt Bild an Position (x, y) mit Breite w und Höhe h aus |
| ''PdfImageWidth(img: PdfImage): f64'' | pub | Gibt Originalbreite des Bildes in Pixeln zurück |
| ''PdfImageHeight(img: PdfImage): f64'' | pub | Gibt Originalhöhe des Bildes in Pixeln zurück |

Letzte Aktualisierung: 2026-05-22