imagejpeg

(PHP 4, PHP 5, PHP 7, PHP 8)

imagejpegВивід зображення в браузер чи файл.

Опис

imagejpeg(GdImage $image, resource|string|null $file = null, int $quality = -1): bool

imagejpeg() creates a JPEG file from the given image.

Параметри

image

Об'єкт GdImage, що повертається однією з функцій створення зображення, такою як imagecreatetruecolor().

file

Шлях або відкритий ресурс потоку (котрий автоматично закривається після повернення з цієї функції) для збереження файла. Якщо не встановлено або дорівнює null, буде виведено двійковий код зображення.

quality

quality is optional, and ranges from 0 (worst quality, smaller file) to 100 (best quality, biggest file). The default (-1) uses the default IJG quality value (about 75).

Значення, що повертаються

Повертає true у разі успіху або false в разі помилки.

Застереження

Проте, якщо libgd не може вивести зображення, ця функція повертає true.

Помилки/виключення

Throws a ValueError if quality is invalid.

Журнал змін

Версія Опис
8.4.0 Now throws a ValueError if quality is invalid.
8.0.0 Тепер image має бути примірником GdImage. Раніше очікувався gd-resource.

Приклади

Приклад #1 Outputting a JPEG image to the browser

<?php
// Create a blank image and add some text
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);

// Set the content type header - in this case image/jpeg
header('Content-Type: image/jpeg');

// Output the image
imagejpeg($im);
?>

Поданий вище приклад виведе щось схоже на:

Output of example : Outputting a JPEG image

Приклад #2 Saving a JPEG image to a file

<?php
// Create a blank image and add some text
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);

// Save the image as 'simpletext.jpg'
imagejpeg($im, 'simpletext.jpg');
?>

Приклад #3 Outputting the image at 75% quality to the browser

<?php
// Create a blank image and add some text
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, 'A Simple Text String', $text_color);

// Set the content type header - in this case image/jpeg
header('Content-Type: image/jpeg');

// Skip the file parameter using NULL, then set the quality to 75%
imagejpeg($im, NULL, 75);
?>

Примітки

Зауваження:

If you want to output Progressive JPEGs, you need to set interlacing on with imageinterlace().

Прогляньте також

  • imagepng() - Output a PNG image to either the browser or a file
  • imagegif() - Вивід зображення в браузер чи файл.
  • imagewbmp() - Вивід зображення в браузер чи файл.
  • imageinterlace() - Enable or disable interlace
  • imagetypes() - Return the image types supported by this PHP build