imagejpeg - Выводит изображение в браузер или пишет в файл
Вернуться к: GD и функции для работы с изображениями Функции
imagejpeg
(PHP 4, PHP 5, PHP 7)
imagejpeg — Выводит изображение в браузер или пишет в файл
Описание
$image
[, string $filename
[, int $quality
]] )
Функция imagejpeg() создаёт файл JPEG
из изображенияimage.
Список параметров
-
image -
Ресурс изображения, полученный одной из функций создания изображений, например, такой как imagecreatetruecolor().
-
filename -
Путь для сохранения файла. Если не установлен или равен
NULL, изображение будет выведено в поток вывода в бинарном виде.Если вы хотите пропустить этот параметр и использовать
quality, то укажитеNULL. -
quality -
Необязательный параметр, и может принимать значения в диапазоне от 0 (низкое качество, маленький размер файла) до 100 (высокое качество, большой размер файла). По умолчанию используется качество IJG (около 75).
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
Примеры
Пример #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);
?>
Примечания
Замечание: Поддержка JPEG доступна только в случае, если PHP был скомпилирован с GD-1.8 или более поздней версии.
Замечание:
Если требуется вывести Progressive JPEG (прогрессивное представление данных), то необходимо использовать функцию imageinterlace() для активации соответствующего режима.
Смотрите также
- imagepng() - Вывод PNG изображения в броузер или файл
- imagegif() - Выводит изображение в браузер или пишет в файл
- imagewbmp() - Выводит изображение в браузер или пишет в файл
- imageinterlace() - Включение или выключение интерлейсинга
- imagetypes() - Возвращает список типов изображений, поддерживаемых PHP сборкой
Вернуться к: GD и функции для работы с изображениями Функции