PHP: полный мануал с примерами, функциями и ООП

PECL imagick 2, PECL imagick 3 · imagick

Imagick::blurImage(float $radius, float $sigma, int $channel = ?): bool

Мелкие детали мешают подложке или фактура выглядит слишком резкой. Нужно смягчить соседние пиксели, сохранив исходный размер.

Сигнатура и параметры

Imagick::blurImage(float $radius, float $sigma, int $channel = ?): bool

BlurImage добавляет фильтр размытия; третий аргумент позволяет выбрать канал. В ImageMagick 7.1.1-46 используется последовательная свёртка двумя одномерными гауссовыми ядрами по перпендикулярным направлениям. Это объяснение текущей реализации, не обещание одинакового результата или скорости со всеми версиями gaussianBlurImage.

Возвращаемое значение, версии и отказ

Возвращается bool: true при успехе. Метод меняет текущие пиксели объекта Imagick и не возвращает отдельную картинку. $result = $image->blurImage(...) сохранит флаг, а не изображение. Копию создают заранее через clone. Доступность по официальному мануалу: PECL imagick 2, PECL imagick 3.

В Imagick 3.8.1 требуется непустое изображение; вызов на пустом объекте даёт ImagickException. Отказ underlying-операции также превращается в ImagickException. Запись файла — отдельный шаг, у неё могут быть свои ошибки. В примерах if с ! проверяет возвращённый false; необработанное исключение тоже остановит CLI и покажет отказ. В обработчике сайта его перехватывают и сообщают понятную ошибку, не выводя служебные пути пользователю.

Официальные смежные направления: Imagick::adaptiveBlurImage, Imagick::motionBlurImage, Imagick::radialBlurImage. Они решают другие варианты размытия, а не заменяются произвольным увеличением sigma.

Первый управляемый результат

<?php
declare(strict_types=1);

require __DIR__ . '/blur-fixture.php';
$source = loadBlurSource();
$image = clone $source;
if (!$image->blurImage(0, 1.2)) {
    throw new RuntimeException('Не удалось применить blurImage');
}
saveBlurComparison([$source, $image], 'blur-small.png');
$source->clear();
$image->clear();

blur-small.png

Практическая задача: Оставить центр чётким на мягкой подложке

У баннера есть заранее известная прямоугольная область с предметами. Размываем копию целиком, затем возвращаем исходный прямоугольник шириной 330 и высотой 185 с координат (35,25). Это ручная геометрия макета, не автоматическое выделение товара.

CropImage получает ширину, высоту, x и y; setImagePage сбрасывает смещение вырезанной страницы. CompositeImage возвращает её на размытую копию в те же координаты. В прямоугольник попадает исходный фон вместе с предметами — его край не повторяет силуэт товара.

<?php
declare(strict_types=1);

require __DIR__ . '/blur-fixture.php';
$source = loadBlurSource();
$image = clone $source;
if (!$image->blurImage(0, 4)) {
    throw new RuntimeException('Не удалось применить blurImage');
}
$foreground = clone $source;
$foreground->cropImage(330, 185, 35, 25);
$foreground->setImagePage(0, 0, 0, 0);
if (!$image->compositeImage($foreground, Imagick::COMPOSITE_OVER, 35, 25)) {
    throw new RuntimeException('Не удалось вернуть чёткую область');
}
$foreground->clear();
saveBlurComparison([$source, $image], 'sharp-center-soft-background.png');
$source->clear();
$image->clear();

sharp-center-soft-background.png

Ошибки, ограничения и альтернативы

В официальной сигнатуре буквально стоит channel = ?. Знак ? здесь означает неуказанный в документации default, а не значение для копирования в PHP. В проверенной PHP-сборке Reflection сообщает Imagick::CHANNEL_DEFAULT (134217727). Внутренняя обвязка IM7 при пропущенном параметре использует собственный sentinel IM_DEFAULT_CHANNEL/UndefinedChannel; это разные уровни описания. Не заменяйте пропущенный аргумент произвольным числом из C-кода. Примеры используют пропуск или именованную константу.

Для сервиса ограничьте размеры, допустимые форматы, параметры и число проходов. Большой radius/sigma требует более широкой окрестности и дополнительных ресурсов; разные реализации и размеры меняют стоимость. Без измерений на своей нагрузке нельзя обещать, что один метод всегда быстрее другого. Эти программы обрабатывают один непрозрачный RGB PNG; кадры анимации, профили и прозрачные границы требуют отдельной политики.

Сравнить: gaussianBlurImage · sharpenImage · unsharpMaskImage. Связанные темы: яркость и тональный контраст, рисование перед фильтрацией, перехват ошибки.

• Imagick::blurImage
• Imagick 3.8.1 bindings
• ImageMagick 7.1.1-46 spatial effects

PECL imagick 2, PECL imagick 3 · imagick

Imagick::gaussianBlurImage(float $radius, float $sigma, int $channel = Imagick::CHANNEL_DEFAULT): bool

Нужна гауссова мягкость по всей картинке или по конкретной составляющей цвета.

Сигнатура и параметры

Imagick::gaussianBlurImage(float $radius, float $sigma, int $channel = Imagick::CHANNEL_DEFAULT): bool

Метод сворачивает изображение с гауссовым оператором указанного радиуса и sigma. В официальном описании рекомендуют radius больше sigma либо radius 0 для автоматического выбора. В ImageMagick 7.1.1-46 этот метод строит двумерное гауссово ядро. BlurImage использует другой путь реализации; одинаковые параметры не обязывают все версии выдавать идентичные байты.

Возвращаемое значение, версии и отказ

Возвращается bool: true при успехе. Метод меняет текущие пиксели объекта Imagick и не возвращает отдельную картинку. $result = $image->gaussianBlurImage(...) сохранит флаг, а не изображение. Копию создают заранее через clone. Доступность по официальному мануалу: PECL imagick 2, PECL imagick 3.

В Imagick 3.8.1 требуется непустое изображение; вызов на пустом объекте даёт ImagickException. Отказ underlying-операции также превращается в ImagickException. Запись файла — отдельный шаг, у неё могут быть свои ошибки. В примерах if с ! проверяет возвращённый false; необработанное исключение тоже остановит CLI и покажет отказ. В обработчике сайта его перехватывают и сообщают понятную ошибку, не выводя служебные пути пользователю.

Первый управляемый результат

<?php
declare(strict_types=1);

require __DIR__ . '/blur-fixture.php';
$source = loadBlurSource();
$image = clone $source;
if (!$image->gaussianBlurImage(0, 2)) {
    throw new RuntimeException('Не удалось применить gaussianBlurImage');
}
saveBlurComparison([$source, $image], 'gaussian-blur.png');
$source->clear();
$image->clear();

gaussian-blur.png

Практическая задача: Размыть только красную составляющую

Для экспериментального цветового оформления нужна мягкость только в красном канале. Передаём явную channel-константу; это полезно, чтобы увидеть, что канал — составляющая всех пикселей, а не набор красных предметов.

<?php
declare(strict_types=1);

require __DIR__ . '/blur-fixture.php';
$source = loadBlurSource();
$image = clone $source;
if (!$image->gaussianBlurImage(0, 2, Imagick::CHANNEL_RED)) {
    throw new RuntimeException('Не удалось применить gaussianBlurImage');
}
saveBlurComparison([$source, $image], 'gaussian-red-channel.png');
$source->clear();
$image->clear();

gaussian-red-channel.png

Ошибки, ограничения и альтернативы

GaussianBlurImage вызывают у Imagick с пикселями, а не у ImagickDraw со списком команд. Если нужен мягкий отдельный знак, сначала нарисуйте его на отдельном изображении, затем размойте этот слой. Размывание всей готовой картинки смягчит и предметы, и текст; выбор RGB-канала не заменяет пространственную маску.

Для сервиса ограничьте размеры, допустимые форматы, параметры и число проходов. Большой radius/sigma требует более широкой окрестности и дополнительных ресурсов; разные реализации и размеры меняют стоимость. Без измерений на своей нагрузке нельзя обещать, что один метод всегда быстрее другого. Эти программы обрабатывают один непрозрачный RGB PNG; кадры анимации, профили и прозрачные границы требуют отдельной политики.

Сравнить: blurImage · sharpenImage · unsharpMaskImage. Связанные темы: яркость и тональный контраст, рисование перед фильтрацией, перехват ошибки.

• Imagick::gaussianBlurImage
• Imagick 3.8.1 bindings
• ImageMagick 7.1.1-46 spatial effects

PECL imagick 2, PECL imagick 3 · imagick

Imagick::sharpenImage(float $radius, float $sigma, int $channel = Imagick::CHANNEL_DEFAULT): bool

Готовое небольшое превью выглядит мягко, и нужно осторожно подчеркнуть контуры, проверив кайму и шум.

Сигнатура и параметры

Imagick::sharpenImage(float $radius, float $sigma, int $channel = Imagick::CHANNEL_DEFAULT): bool

SharpenImage повышает резкость свёрткой с гауссовым оператором выбранного радиуса и sigma. Официальный ориентир: radius больше sigma либо 0 для автоматического выбора. Усиливаются локальные различия у границ; новые достоверные детали из утраченных данных не появляются.

Возвращаемое значение, версии и отказ

Возвращается bool: true при успехе. Метод меняет текущие пиксели объекта Imagick и не возвращает отдельную картинку. $result = $image->sharpenImage(...) сохранит флаг, а не изображение. Копию создают заранее через clone. Доступность по официальному мануалу: PECL imagick 2, PECL imagick 3.

В Imagick 3.8.1 требуется непустое изображение; вызов на пустом объекте даёт ImagickException. Отказ underlying-операции также превращается в ImagickException. Запись файла — отдельный шаг, у неё могут быть свои ошибки. В примерах if с ! проверяет возвращённый false; необработанное исключение тоже остановит CLI и покажет отказ. В обработчике сайта его перехватывают и сообщают понятную ошибку, не выводя служебные пути пользователю.

Первый управляемый результат

<?php
declare(strict_types=1);

require __DIR__ . '/blur-fixture.php';
$source = loadBlurSource();
$image = clone $source;
if (!$image->sharpenImage(0, 0.8)) {
    throw new RuntimeException('Не удалось применить sharpenImage');
}
saveBlurComparison([$source, $image], 'sharpen-once.png');
$source->clear();
$image->clear();

sharpen-once.png

Практическая задача: Сравнить один проход и повторное усиление

При подготовке готового превью легко случайно повысить резкость дважды в разных обработчиках. Здесь повтор намеренный: третью панель создаём из уже обработанной второй, чтобы увидеть накопление.

<?php
declare(strict_types=1);

require __DIR__ . '/blur-fixture.php';
$source = loadBlurSource();
$image = clone $source;
if (!$image->sharpenImage(0, 0.8)) {
    throw new RuntimeException('Не удалось применить sharpenImage');
}
$twice = clone $image;
if (!$twice->sharpenImage(0, 0.8)) {
    throw new RuntimeException('Не удалось применить sharpenImage');
}
saveBlurComparison([$source, $image, $twice], 'sharpen-once-twice.png');
$source->clear();
$image->clear();
$twice->clear();

sharpen-once-twice.png

Ошибки, ограничения и альтернативы

Повторный вызов снова меняет уже обработанные пиксели и может усиливать ореолы и шум. Если исходный PDF растеризован с недостаточным разрешением или детали разрушены сильным уменьшением/размытием, один sharpen не восстановит их. Для отдельного управления силой и порогом сравните unsharpMaskImage. Не путайте этот метод с тональным contrastImage(true).

Для сервиса ограничьте размеры, допустимые форматы, параметры и число проходов. Большой radius/sigma требует более широкой окрестности и дополнительных ресурсов; разные реализации и размеры меняют стоимость. Без измерений на своей нагрузке нельзя обещать, что один метод всегда быстрее другого. Эти программы обрабатывают один непрозрачный RGB PNG; кадры анимации, профили и прозрачные границы требуют отдельной политики.

Сравнить: blurImage · gaussianBlurImage · unsharpMaskImage. Связанные темы: яркость и тональный контраст, рисование перед фильтрацией, перехват ошибки.

• Imagick::sharpenImage
• Imagick 3.8.1 bindings
• ImageMagick 7.1.1-46 spatial effects

PECL imagick 2, PECL imagick 3 · imagick

Imagick::unsharpMaskImage(float $radius, float $sigma, float $amount, float $threshold, int $channel = Imagick::CHANNEL_DEFAULT): bool

Нужно отдельно управлять размером деталей, силой усиления и защитой слабых различий от лишней резкости.

Сигнатура и параметры

Imagick::unsharpMaskImage(float $radius, float $sigma, float $amount, float $threshold, int $channel = Imagick::CHANNEL_DEFAULT): bool

Несмотря на unsharp в названии, метод повышает резкость: строит размытую копию, находит разницу «исходник минус размытие» и прибавляет её с коэффициентом amount. Radius и sigma управляют размытой опорой, amount — усилением, threshold — отбором слабых различий. Это четыре разные настройки, а не четыре способа задать один процент.

Возвращаемое значение, версии и отказ

Возвращается bool: true при успехе. Метод меняет текущие пиксели объекта Imagick и не возвращает отдельную картинку. $result = $image->unsharpMaskImage(...) сохранит флаг, а не изображение. Копию создают заранее через clone. Доступность по официальному мануалу: PECL imagick 2, PECL imagick 3.

В Imagick 3.8.1 требуется непустое изображение; вызов на пустом объекте даёт ImagickException. Отказ underlying-операции также превращается в ImagickException. Запись файла — отдельный шаг, у неё могут быть свои ошибки. В примерах if с ! проверяет возвращённый false; необработанное исключение тоже остановит CLI и покажет отказ. В обработчике сайта его перехватывают и сообщают понятную ошибку, не выводя служебные пути пользователю.

Первый управляемый результат

<?php
declare(strict_types=1);

require __DIR__ . '/blur-fixture.php';
$source = loadBlurSource();
$image = clone $source;
if (!$image->unsharpMaskImage(0, 1, 0.7, 0)) {
    throw new RuntimeException('Не удалось применить unsharpMaskImage');
}
saveBlurComparison([$source, $image], 'unsharp-mask.png');
$source->clear();
$image->clear();

unsharp-mask.png

Практическая задача: Сохранить слабый шум, усилив выраженную границу

Нужно подчеркнуть значимые края и не усиливать едва заметную фактуру. Сравниваем threshold 0 и 0.05 на независимых копиях одного входа, сохраняя radius 0, sigma 1 и amount 1.

<?php
declare(strict_types=1);

require __DIR__ . '/blur-fixture.php';
$source = loadBlurSource();
$image = clone $source;
if (!$image->unsharpMaskImage(0, 1, 1, 0)) {
    throw new RuntimeException('Не удалось применить unsharpMaskImage');
}
$twice = clone $source;
if (!$twice->unsharpMaskImage(0, 1, 1, 0.05)) {
    throw new RuntimeException('Не удалось применить unsharpMaskImage');
}
saveBlurComparison([$source, $image, $twice], 'unsharp-threshold.png');
$source->clear();
$image->clear();
$twice->clear();

unsharp-threshold.png

Ошибки, ограничения и альтернативы

Threshold не измеряет «важность предмета» и не удаляет шум: он может оставить малую разницу без усиления. Amount и threshold из другого редактора не обязательно имеют ту же шкалу. Формула и множитель 2 уточнены по конкретной версии ImageMagick; для иной версии проверьте результат. Чёрные/белые ореолы и квантование могут терять данные, поэтому противоположный фильтр не является отменой.

Для сервиса ограничьте размеры, допустимые форматы, параметры и число проходов. Большой radius/sigma требует более широкой окрестности и дополнительных ресурсов; разные реализации и размеры меняют стоимость. Без измерений на своей нагрузке нельзя обещать, что один метод всегда быстрее другого. Эти программы обрабатывают один непрозрачный RGB PNG; кадры анимации, профили и прозрачные границы требуют отдельной политики.

Сравнить: blurImage · gaussianBlurImage · sharpenImage. Связанные темы: яркость и тональный контраст, рисование перед фильтрацией, перехват ошибки.

• Imagick::unsharpMaskImage
• Imagick 3.8.1 bindings
• ImageMagick 7.1.1-46 spatial effects