(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)
imagecopyresampled — Копирование и изменение размера изображения с ресемплированием
$dst_image
,$src_image
,$dst_x
,$dst_y
,$src_x
,$src_y
,$dst_width
,$dst_height
,$src_width
,$src_height
imagecopyresampled() копирует прямоугольную часть одного изображения на другое изображение, интерполируя значения пикселов таким образом, чтобы уменьшение размера изображения не уменьшало его чёткости.
Другими словами, imagecopyresampled() берет прямоугольный
участок из src_image
с шириной
src_width
и высотой src_height
на
координатах src_x
,src_y
и помещает
его в прямоугольный участок изображения dst_image
шириной
dst_width
и высотой dst_height
на
координатах dst_x
,dst_y
.
Если координаты, ширина или высота исходного и конечного изображений различны,
копируемый фрагмент будет растянут или сжат. Координаты отсчитываются от левого
верхнего угла изображения. Функцию можно использовать для наложения участков
на то же изображение, с которого они скопированы (если
dst_image
имеет то же значение, что и
src_image
), но если участки будут пересекаться, результат
непредсказуем.
dst_image
Ресурс целевого изображения.
src_image
Ресурс исходного изображения.
dst_x
x-координата результирующего изображения.
dst_y
y-координата результирующего изображения.
src_x
x-координата исходного изображения.
src_y
y-координата исходного изображения.
dst_width
Результирующая ширина.
dst_height
Результирующая высота.
src_width
Ширина исходного изображения.
src_height
Высота исходного изображения.
Возвращает true
в случае успешного выполнения или false
в случае возникновения ошибки.
Версия | Описание |
---|---|
8.0.0 |
dst_image и src_image теперь ожидают экземпляр
GdImage;
ранее ожидался ресурс (resource).
|
Пример #1 Простой пример
В этом примере изображение будет сжато до половины исходного размера.
<?php
// файл
$filename = 'test.jpg';
$percent = 0.5;
// тип содержимого
header('Content-Type: image/jpeg');
// получение новых размеров
list($width, $height) = getimagesize($filename);
$new_width = $width * $percent;
$new_height = $height * $percent;
// ресэмплирование
$image_p = imagecreatetruecolor($new_width, $new_height);
$image = imagecreatefromjpeg($filename);
imagecopyresampled($image_p, $image, 0, 0, 0, 0, $new_width, $new_height, $width, $height);
// вывод
imagejpeg($image_p, null, 100);
?>
Результатом выполнения данного примера будет что-то подобное:
Пример #2 Ресэмплирование изображения с сохранением пропорций
В этом примере изображение будет сжато до 200 пикселов по ширине или высоте, смотря что больше.
<?php
// файл
$filename = 'test.jpg';
// задание максимальной ширины и высоты
$width = 200;
$height = 200;
// тип содержимого
header('Content-Type: image/jpeg');
// получение новых размеров
list($width_orig, $height_orig) = getimagesize($filename);
$ratio_orig = $width_orig/$height_orig;
if ($width/$height > $ratio_orig) {
$width = $height*$ratio_orig;
} else {
$height = $width/$ratio_orig;
}
// ресэмплирование
$image_p = imagecreatetruecolor($width, $height);
$image = imagecreatefromjpeg($filename);
imagecopyresampled($image_p, $image, 0, 0, 0, 0, $width, $height, $width_orig, $height_orig);
// вывод
imagejpeg($image_p, null, 100);
?>
Результатом выполнения данного примера будет что-то подобное:
Замечание:
Существует проблема связанная с ограничениями палитровых изображений (255+1 цвет). Ресэмплирование или фильтрация изображения требует больше цветов, чем 255. Для расчёта нового пиксела и его цвета применяется некоторое приближение. В случае палитровых изображений мы пытаемся создать новый цвет, а если это не удаётся, мы выбираем ближайший (теоретически) вычисленный цвет. Это не всегда визуально ближайший цвет. Такой подход может давать в результате пустые (или визуально пустые) изображения. Для устранения этой проблемы, пожалуйста, используйте truecolor-изображения в качестве результирующих, создаваемые функцией imagecreatetruecolor().