| |
Diese Übersicht beschreibt die Eigenschaften und die Funktionsweise der fpdf
Funktion Image(). Die hier aufgeführten Informationen basieren auf den
Originalinformationen des Entwicklers auf fpdf.org
und wurden ins Deutsche übersetzt. Sollten Sie Fehler feststellen, möchten
wir Sie bitten uns zu kontaktieren.
| Syntax: |
 |
Image(string file , float x , float y [, float w] [, float h] [, string type] [, mixed link]) |
| |
|
|
| Version: |
|
1.1 |
| |
|
|
| Beschreibung: |
|
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. |
| |
|
|
| 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):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: |
|
<?php
// 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();
?>
|
|
|
|
|
|
