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(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

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

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

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

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

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


<?php
// Создаём пустое изображение и добавляем текст
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

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

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

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


<?php
// Создаём пустое изображение и добавляем текст
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5,  'A Simple Text String', $text_color);

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

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

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

Примечания

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

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

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