Image

Einfügen eines Bildes

Fügt ein Bild in die aktuelle Seite ein. Die Position der oberen/linken Ecke des Bildes muß explizit angegeben werden. Für die Bestimmung der aktuellen Position können Sie GetX() und GetY() verwenden. Die für die Ausgabe zu verwendende Bildgröße kann auf drei verschiedene Arten bestimmt werden.

  • Explizite Angabe der Höhe und Breite des Bildes (in der festgelegten Maßeinheit)
  • Explizite Angabe eines Maßes (Höhe oder Breite). Das fehlende Maß wird unter Beibehaltung der Seitenverhältnisse anhand der Originalgröße berechnet.
  • Keine Angabe einer Bildgröße. Dieses erzeugt eine Ausgabe des Bildes mit 72 dpi.

Es werden die Bildformate JPEG (Joint Photographic Experts Group) und PNG (Portable Network Graphics) unterstüzt. Für Bilder im JPEG Format sind alle Varianten zulässig:

  • Graustufenbilder
  • Truecolor (24 Bit)
  • CMYK (32 Bit)

Beim PNG Format werden folgende Varianten unterstützt:

  • Graustufenbilder (8 Bit, 256 Graustufen)
  • Farbpaletten
  • Truecolor (24 Bit)

nicht unterstützt, werden:

  • Interlacing (schrittweiser Aufbau)
  • Alpha Channel

Falls Farbtransparenz verwendet wird, wird die Information mit in das Dokument übernommen, jedoch ist die Darstellung mit Farbtransparenz erst ab dem Acrobat Reader 4 und höher möglich. Das zugrunde liegende Dateiformat kann explizit durch einen Parameter bestimmt werden oder ergibt sich aus der verwendeten Dateierweiterung. Ein Bild kann mit einer Verknüpfung versehen werden. Hinweis. Wird ein und dasselbe Bild mehrmals innerhalb des Dokuments verwendet, erfolgt die Einbindung des Bildes in das Dokument trotzdem nur einmal.

Syntax

Image(string file , float x , float y [, float w] [, float h] [, string type] [, mixed link])

Parameter

file string

Pfad zur Bilddatei die eingebunden werden soll.

x float

Horizontale Position (X-Achse) der linken/oberen Ecke an der das Bild ausgegeben werden soll.

y float

Vertikale Position (Y-Achse) der linken/oberen Ecke an der das Bild ausgegeben werden soll.

w (optional) float

Breite des auszugebenden Bildes. Wird keine Breite definiert oder wird die Breite mit 0 angegeben, erfolgt eine automatische Ermittlung der Breite anhand der ggf. angegebenen Höhe oder der Originalgröße.

h (optional) float

Höhe des auszugebenden Bildes. Wird keine Höhe definiert oder wird die Höhe mit 0 angegeben, erfolgt eine automatische Ermittlung der Höhe anhand der ggf. angegebenen Breite oder der Originalgröße.

type (optional) string

Zugrunde liegendes Bildformat. Mögliche Werte hierfür sind (Groß- / Kleinschreibung wird nicht beachtet):

  • JPG
  • JPEG
  • PNG
  • GIF

Falls das Bildformat nicht explizit bestimmt wird, erfolgt eine Bestimmung des Formats anhand der Dateierweiterung.

link (optional) mixed

URL oder die Kennung einer Verknüpfung die zuvor mit AddLink() zum Dokument hinzugefügt wurde.

Siehe auch

AddLink

Beispiel

// Objekt aus FPDF Klasse erzeugen
$pdf = new FPDF();

// Dokument öffnen
$pdf->Open();

// Erste Seite erstellen
$pdf->AddPage();

// Bild einfügen (Position x = 0 / y = 0)
$pdf->Image('bilddatei.png', 0, 0);

// Bild einfügen (Position x = 10 / y = 20)
$pdf->Image('bilddatei.png', 10, 20);


// Bild einfügen und die Breite bestimmen
// Die Höhe des Bildes wird hierbei unter Berücksichtigung
// des Seitenverhältnisses berechnet
// Ist die Originalbreite des Bildes 200 Pixel und die
// Originalhöhe des Bildes 40 Pixel, wird in dem folgenden
// Beispiel eine Höhe von 20 Pixel berechnet (1/2 Breite = 1/2 Höhe).
// Bei einer Originalbreite des Bildes von 400 Pixeln und
// einer Originalbreite von 40 Pixeln, wird in dem folgenden
// Beispiel eine Höhe von 10 Pixeln verwendet (1/4 Breite = 1/4 Höhe)
$pdf->Image('bilddatei.png', 10, 20, 100);

// Wird als Höhe 0 angegeben, hat dieses den gleichen Effekt
// wie im vorherigen Beispiel
$pdf->Image('bilddatei.png', 10, 20, 100, 0);


// Wird die Breite des Bildes mit 0 angegeben, erfolgt die
// Berechnung der Breite unter Berücksichtigung des
// Seitenverhältnisses wie im vorherigen Beispiel
$pdf->Image('bilddatei.png', 10, 20, 0, 10);


// Wird sowohl die Breite als auch die Höhe mit 0 angegeben, werden
// die Originalgrößen des Bildes verwendet.
$pdf->Image('bilddatei.png', 10, 20, 0, 0);


// Bild mit Typangabe einfügen
$pdf->Image('bilddatei.png', 10, 20, 0, 0, 'PNG');
$pdf->Image('bilddatei.png', 10, 20, 0, 0, 'png');
$pdf->Image('bilddatei.png', 10, 20, 0, 0, 'Png');


// Bild mit Link einfügen
$pdf->Image('bilddatei.png', 10, 20, 0, 0, '', 'http://www.fpdf.de/');


// Dokument ausgeben
$pdf->Output();