GD- und Image-Funktionen
PHP Manual

imagejpeg

(PHP 4, PHP 5)

imagejpegGibt das Bild im Browser oder einer Datei aus.

Beschreibung

bool imagejpeg ( resource $image [, string $filename [, int $quality ]] )

imagejpeg() erzeugt eine JPEG-Datei aus dem übergebenen image.

Parameter-Liste

image

Eine von den verschiedenen Erzeugungsfunktionen wie imagecreatetruecolor() gelieferte Grafikressource.

filename

Der Pfad unter dem das Bild gespeichert werden soll. Ist dies nicht gesetzt oder NULL wird der rohe Bilddatenstrom direkt ausgegeben.

Um diesen Parameter zu übergehen, um den Parameter quality anzugeben kann NULL verwendet werden.

quality

quality ist optional und es kann ein Wert zwischen 0 (schlechteste Qualität, kleine Datei) und 100 (beste Qualität, größte Datei) übergeben werden. Der Standardwert ist der standardmäßige IJG-Qualitätswert (ungefähr 75).

Rückgabewerte

Gibt bei Erfolg TRUE zurück. Im Fehlerfall wird FALSE zurückgegeben.

Beispiele

Beispiel #1 Ein Bild ausgeben

<?php
// Erzeut ein leeres Bild und fügt ein wenig Text hinzu
$im imagecreatetruecolor(12020);
$text_color imagecolorallocate($im2331491);
imagestring($im155,  'A Simple Text String'$text_color);

// Die Content-Type-Kopfzeile senden, in diesem Fall image/jpeg
header('Content-Type: image/jpeg');

// Das Bild ausgeben
imagejpeg($im);

// Den Speicher freigeben
imagedestroy($im);
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

Ausgabe des Beispiels: Ein Bild ausgeben

Beispiel #2 Ein Bild speichern

<?php
// Erzeugt ein leeres Bild und fügt ein wenig Text hinzu
$im imagecreatetruecolor(12020);
$text_color imagecolorallocate($im2331491);
imagestring($im155,  'A Simple Text String'$text_color);

// Das Bild als 'simpletext.jpg' speichern
imagejpeg($im'simpletext.jpg');

// Den Speicher freigeben
imagedestroy($im);
?>

Beispiel #3 Das Bild mit 75% Qualität ausgeben

<?php
// Erzeugt ein leeres Bild und fügt ein wenig Text hinzu
$im imagecreatetruecolor(12020);
$text_color imagecolorallocate($im2331491);
imagestring($im155,  'A Simple Text String'$text_color);

// Die Content-Type-Kopfzeile senden, in diesem Fall image/jpeg
header('Content-Type: image/jpeg');

// Der Dateiname wird übergangen, indem NULL verwendet wird
// dann wird die Qualität auf 75% gesetzt
imagejpeg($imNULL75);

// Den Speicher freigeben
imagedestroy($im);
?>

Anmerkungen

Hinweis: Die Unterstützung von JPEG steht nur zur Verfügung, wenn PHP mit GD-1.8 oder höher übersetzt wurde.

Hinweis:

Falls Progessive JPEGs ausgegeben werden sollen, so muss Interlacing mittels imageinterlace() eingeschaltet werden.

Siehe auch


GD- und Image-Funktionen
PHP Manual