imagejpeg

(PHP 4, PHP 5, PHP 7)

imagejpegВыводит изображение в браузер или пишет в файл

Описание

imagejpeg ( resource $image [, mixed $to = NULL [, int $quality = -1 ]] ) : bool

Функция imagejpeg() создаёт файл JPEG из изображенияimage.

Список параметров

image

Ресурс изображения, возвращаемый одной из функций создания изображений, например, такой как imagecreatetruecolor().

to

Путь, или открытый потоковый ресурс (который автоматически закрывается после завершения функции), для сохранения файла. Если не установлен или равен NULL, изображение будет выведено в поток вывода в бинарном виде.

quality

Необязательный параметр, и может принимать значения в диапазоне от 0 (низкое качество, маленький размер файла) до 100 (высокое качество, большой размер файла). По умолчанию (-1) используется качество IJG (около 75).

Возвращаемые значения

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

Предостережение

Однако, если libgd не может вывести изображения, эта функция вернет TRUE.

Список изменений

Версия Описание
5.4.0 Добавлена возможность использовать поток типа resource для to.
5.4.0 Запрещено задавать to пустой строкой для его пропуска..

Примеры

Пример #1 Вывод JPEG-изображения в браузер

<?php
// Создаём пустое изображение и добавляем текст
$im imagecreatetruecolor(12020);
$text_color imagecolorallocate($im2331491);
imagestring($im155,  'A Simple Text String'$text_color);

// Устанавливаем тип содержимого в заголовок, в данном случае image/jpeg
header('Content-Type: image/jpeg');

// Выводим изображение
imagejpeg($im);

// Освобождаем память
imagedestroy($im);
?>

Результатом выполнения данного примера будет что-то подобное:

Пример выведет изображение JPEG

Пример #2 Сохранение изображения JPEG в файл

<?php
// Создаём пустое изображение и добавляем текст
$im imagecreatetruecolor(12020);
$text_color imagecolorallocate($im2331491);
imagestring($im155,  'A Simple Text String'$text_color);

// Сохраняем изображение в 'simpletext.jpg'
imagejpeg($im'simpletext.jpg');

// Освобождаем память
imagedestroy($im);
?>

Пример #3 Вывод JPEG-изображения с 75% качеством в браузер

<?php
// Создаём пустое изображение и добавляем текст
$im imagecreatetruecolor(12020);
$text_color imagecolorallocate($im2331491);
imagestring($im155,  'A Simple Text String'$text_color);

// Устанавливаем тип содержимого в заголовок, в данном случае image/jpeg
header('Content-Type: image/jpeg');

// Пропускаем параметр filename, используя NULL, а затем устанавливаем качество в 75%
imagejpeg($imNULL75);

// Освобождаем память
imagedestroy($im);
?>

Примечания

Замечание:

Если требуется вывести Progressive JPEG (прогрессивное представление данных), то необходимо использовать функцию imageinterlace() для активации соответствующего режима.

Смотрите также

  • imagepng() - Вывод PNG изображения в браузер или файл
  • imagegif() - Выводит изображение в браузер или пишет в файл
  • imagewbmp() - Выводит изображение в браузер или пишет в файл
  • imageinterlace() - Включение или выключение интерлейсинга
  • imagetypes() - Возвращает список типов изображений, поддерживаемых PHP сборкой