imageistruecolor
imagelayereffect
Image-Funktionen
PHP Manual

# imagejpeg

(PHP 4, PHP 5)

imagejpeg — Ausgabe des Bildes im Browser oder als Datei

### 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 der Datei, in die geschrieben werden soll. Wenn dies nicht gesetzt oder `NULL` ist, so wird die Bilddatei 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(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, '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:

Beispiel #2 Ein Bild speichern

`<?php
// Erzeugt ein leeres Bild und fügt ein wenig Text hinzu
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, '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(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, '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($im, NULL, 75);
// 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

- imagepng() - Ausgabe eines Bildes im Browser oder als Datei im PNG-Format
- imagegif() - Ausgabe des Bildes im Browser oder als Datei
- imagewbmp() - Output image to browser or file
- imageinterlace() - Schaltet die Interlaced-Darstellung eines Bildes an oder aus
- imagetypes() - Gibt die von der aktuell verwendeten PHP-Version unterstützten Grafik-Formate zurück

imageistruecolor
imagelayereffect
Image-Funktionen
PHP Manual