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

PECL imagick 2, PECL imagick 3 · imagick

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

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

Самая маленькая запись

В $image уже загружена отдельная копия. 0 — автоматический радиус, 1.2 — sigma в пикселях. Третий аргумент пропущен и имеет default channel. Размытие будет зависеть от найденных перепадов; это не выбор только внешней рамки. Стрелка вызывает метод объекта, круглые скобки содержат аргументы, запятые их отделяют, точка с запятой завершает команду. Для сохранения оригинала до вызова создайте $image = clone $source; простое присваивание не копирует объект.

$image->adaptiveBlurImage(0, 1.2);

Это пояснение ядра. Полная программа ниже также загрузит вход, задаст virtual pixels, проверит возврат и запишет PNG. Подготовка: объект и метод, clone, массив и ключ.

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

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

Адаптивное размытие зависит от обнаруженных перепадов изображения: около границ деталей оно слабее, чем вдали от них. Здесь edges — не только внешняя рамка файла. В точной реализации строится EdgeImage, его уровни нормируются, карта размывается и нормируется снова; по ней выбирается одно из ядер. Это численная карта, не распознавание товара или текста.

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

Результат bool: true при успехе. Метод меняет пиксели текущего Imagick; $ok = $image->adaptiveBlurImage(...) сохранит флаг, не новую картинку. Обязательность и default приведены в исходной сигнатуре выше. Доступность PHP Manual: PECL imagick 2, PECL imagick 3.

Официальное ограничение: Imagick должен быть собран с ImageMagick 6.2.9 или новее. Номер библиотеки ImageMagick отличается от номера PHP-расширения Imagick.

В проверенной версии пустой Imagick даёт ImagickException; native-отказ обвязка также превращает в исключение. Чтение и запись могут отказать отдельно. If с ! проверяет false, throw прекращает программу сообщением; clear после записи освобождает ресурсы. В веб-обработчике перехватите исключение и покажите понятный отказ без внутренних путей. Возвращаемое true не подтверждает художественное качество или удаление шума.

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

<?php
declare(strict_types=1);

require __DIR__ . '/adaptive-fixture.php';
$source = loadAdaptiveSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$image = clone $source;
if (!$image->adaptiveBlurImage(0, 1.2)) {
    throw new RuntimeException('Не удалось применить adaptiveBlurImage');
}
saveAdaptiveComparison([$source, $image], 'adaptive-blur-basic.png');
$source->clear();
$image->clear();

adaptive-blur-basic.png

Практическая задача: Обработать только изображение товара, сохранив заголовок и образцы

Картинку коробки и кружки нужно смягчить, а заголовок и контрольные участки оставить точными. Её прямоугольник известен из макета; применяем фильтр к отдельной вырезке и возвращаем её на независимую копию.

CropImage получает ширину 352, высоту 184 и начало x=24,y=36; setImagePage сбрасывает виртуальное смещение вырезки. После фильтра compositeImage с COMPOSITE_OVER возвращает область в (24,36). $region — отдельный объект. Выбрана известная геометрия макета; автоматического обнаружения товара здесь нет. При жёстком стыке обработанной области оценивайте шов.

<?php
declare(strict_types=1);

require __DIR__ . '/adaptive-fixture.php';
$source = loadAdaptiveSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$image = clone $source;
$region = clone $source;
$region->cropImage(352, 184, 24, 36);
$region->setImagePage(0, 0, 0, 0);
if (!$region->adaptiveBlurImage(0, 1.2)) {
    throw new RuntimeException('Не удалось применить adaptiveBlurImage');
}
if (!$image->compositeImage($region, Imagick::COMPOSITE_OVER, 24, 36)) {
    throw new RuntimeException('Не удалось вернуть область');
}
$region->clear();
saveAdaptiveComparison([$source, $image], 'adaptive-blur-region.png');
$source->clear();
$image->clear();

adaptive-blur-region.png

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

Высокочастотный шум сам создаёт признаки границ, а слабая полезная деталь может быть сглажена. Метод не гарантирует сохранения каждой буквы. В текущей C-версии sigma=0 возвращает неизменённую копию с true; radius=0 при положительном sigma выбирает ядро автоматически. Увеличение sigma без оценки образца не является улучшением.

Для приложения выбирайте конечные radius≥0 и sigma>0 с верхними пределами по разрешению; selective threshold ограничьте осмысленной долей диапазона, motion angle — понятным диапазоном градусов. Это политика приложения, не обещание полной валидации Imagick. Большая окрестность и adaptive-карта стоят памяти и времени: ограничьте площадь, число кадров и число копий, измерьте свою нагрузку. Сравнительной гарантии скорости здесь нет.

В preflight явный CHANNEL_RED у всех четырёх методов сохранил G/B. Канал — составляющая всего растра; несколько флагов объединяются |, например Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN | Imagick::CHANNEL_BLUE. Uniform alpha=50% сохранилась в ограниченном опыте с default и RGB-маской, но это не проверка прозрачного края и не общая гарантия alpha. Основные программы работают с непрозрачным sRGB PNG; произвольная alpha, ICC/CMYK, HDR и кадры требуют отдельной проверки.

Связанные методы: adaptiveSharpenImage · selectiveBlurImage · motionBlurImage. Предыдущий шаг: обычное размытие, резкость и unsharp mask; для диапазона: нормализация и хвосты гистограммы.

В исходном списке See Also перечислены blurImage, motionBlurImage и radialBlurImage. Официальная связанная карточка: radialBlurImage. Радиальный эффект рассматривается отдельно от этой адаптивной операции.

• Imagick::adaptiveBlurImage
• Imagick 3.8.1 PHP-wrapper
• ImageMagick 7.1.1-46 effect.c

PECL imagick 2, PECL imagick 3 · imagick

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

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

Самая маленькая запись

В $image находится отдельная копия. 0 разрешает автоматически выбрать радиус; 1.2 задаёт sigma в пикселях. Channel пропущен и берётся по default. Обрабатываются найденные перепады; шум тоже может участвовать в них. Стрелка вызывает метод объекта, круглые скобки содержат аргументы, запятые их отделяют, точка с запятой завершает команду. Для сохранения оригинала до вызова создайте $image = clone $source; простое присваивание не копирует объект.

$image->adaptiveSharpenImage(0, 1.2);

Это пояснение ядра. Полная программа ниже также загрузит вход, задаст virtual pixels, проверит возврат и запишет PNG. Подготовка: объект и метод, clone, массив и ключ.

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

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

Адаптивная резкость действует сильнее около найденных границ и слабее вдали. Точная библиотека строит карту EdgeImage с нормированием и размытием и выбирает ядро резкости по этой карте. Усиливаются существующие различия; новых достоверных деталей фильтр не создаёт.

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

Результат bool: true при успехе. Метод меняет пиксели текущего Imagick; $ok = $image->adaptiveSharpenImage(...) сохранит флаг, не новую картинку. Обязательность и default приведены в исходной сигнатуре выше. Доступность PHP Manual: PECL imagick 2, PECL imagick 3.

Официальное ограничение: Imagick должен быть собран с ImageMagick 6.2.9 или новее. Номер библиотеки ImageMagick отличается от номера PHP-расширения Imagick.

В проверенной версии пустой Imagick даёт ImagickException; native-отказ обвязка также превращает в исключение. Чтение и запись могут отказать отдельно. If с ! проверяет false, throw прекращает программу сообщением; clear после записи освобождает ресурсы. В веб-обработчике перехватите исключение и покажите понятный отказ без внутренних путей. Возвращаемое true не подтверждает художественное качество или удаление шума.

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

<?php
declare(strict_types=1);

require __DIR__ . '/adaptive-fixture.php';
$source = loadAdaptiveSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$image = clone $source;
if (!$image->adaptiveSharpenImage(0, 1.2)) {
    throw new RuntimeException('Не удалось применить adaptiveSharpenImage');
}
saveAdaptiveComparison([$source, $image], 'adaptive-sharpen-basic.png');
$source->clear();
$image->clear();

adaptive-sharpen-basic.png

Практическая задача: Сравнить смягчение и последующую осторожную резкость

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

Первый adaptiveBlurImage меняет $image. Затем $smoothed = clone $image сохраняет промежуточную копию; следующий adaptiveSharpenImage меняет только $image. Поэтому три панели показывают весь путь: вход → смягчение → усиление. Одна и та же sigma=0.8 у двух методов не означает взаимно обратные операции.

<?php
declare(strict_types=1);

require __DIR__ . '/adaptive-fixture.php';
$source = loadAdaptiveSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$image = clone $source;
if (!$image->adaptiveBlurImage(0, 0.8)) {
    throw new RuntimeException('Не удалось применить adaptiveBlurImage');
}
$smoothed = clone $image;
if (!$image->adaptiveSharpenImage(0, 0.8)) {
    throw new RuntimeException('Не удалось применить adaptiveSharpenImage');
}
saveAdaptiveComparison([$source, $smoothed, $image], 'adaptive-sharpen-after-smoothing.png');
$source->clear();
$smoothed->clear();
$image->clear();

adaptive-sharpen-after-smoothing.png

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

Шум и JPEG-артефакты тоже имеют перепады и могут усилиться. Возможны ореолы и обрезка значений; повторная резкость не восстанавливает оригинал. True и одинаковый размер файла не доказывают полезное изменение. При sigma=0 текущая реализация возвращает неизменённую копию. Проверяйте текст, фон и контуры на одинаковом масштабе.

Для приложения выбирайте конечные radius≥0 и sigma>0 с верхними пределами по разрешению; selective threshold ограничьте осмысленной долей диапазона, motion angle — понятным диапазоном градусов. Это политика приложения, не обещание полной валидации Imagick. Большая окрестность и adaptive-карта стоят памяти и времени: ограничьте площадь, число кадров и число копий, измерьте свою нагрузку. Сравнительной гарантии скорости здесь нет.

В preflight явный CHANNEL_RED у всех четырёх методов сохранил G/B. Канал — составляющая всего растра; несколько флагов объединяются |, например Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN | Imagick::CHANNEL_BLUE. Uniform alpha=50% сохранилась в ограниченном опыте с default и RGB-маской, но это не проверка прозрачного края и не общая гарантия alpha. Основные программы работают с непрозрачным sRGB PNG; произвольная alpha, ICC/CMYK, HDR и кадры требуют отдельной проверки.

Связанные методы: adaptiveBlurImage · selectiveBlurImage · motionBlurImage. Предыдущий шаг: обычное размытие, резкость и unsharp mask; для диапазона: нормализация и хвосты гистограммы.

• Imagick::adaptiveSharpenImage
• Imagick 3.8.1 PHP-wrapper
• ImageMagick 7.1.1-46 effect.c

PECL imagick 3 >= 3.3.0 · imagick

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

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

Самая маленькая запись

Первая строка получает массив сведений о native-диапазоне. Квадратные скобки выбирают ключ quantumRangeLong; знак = сохраняет максимум в $quantum. Во второй строке 0 задаёт автоматический радиус, 1.2 — sigma в пикселях, звёздочка умножает максимум на 0.05. Получается порог 5% диапазона, то есть 3276.75 при Q16=65535. Imagick::getQuantumRange() — статический вызов метода класса: :: со скобками вызывает метод без создания отдельного объекта; это отличается от чтения константы без скобок. Стрелка вызывает метод объекта, круглые скобки содержат аргументы, запятые их отделяют, точка с запятой завершает команду. Для сохранения оригинала до вызова создайте $image = clone $source; простое присваивание не копирует объект.

$quantum = Imagick::getQuantumRange()['quantumRangeLong'];
$image->selectiveBlurImage(0, 1.2, $quantum * 0.05);

Это пояснение ядра. Полная программа ниже также загрузит вход, задаст virtual pixels, проверит возврат и запишет PNG. Подготовка: объект и метод, clone, массив и ключ.

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

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

Библиотека сравнивает модуль разности интенсивностей соседнего и текущего пикселя с threshold. В точном C условие строгое: abs(contrast) < threshold. Подходящие соседи участвуют во взвешенном среднем. Это не независимое сравнение каждой R/G/B-компоненты и не порог, превращающий изображение в чёрно-белое.

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

Результат bool: true при успехе. Метод меняет пиксели текущего Imagick; $ok = $image->selectiveBlurImage(...) сохранит флаг, не новую картинку. Обязательность и default приведены в исходной сигнатуре выше. Доступность PHP Manual: PECL imagick 3 >= 3.3.0.

SelectiveBlurImage добавлен в PECL imagick 3.3.0. Краткий официальный текст не раскрывает аргументы подробно; единицы выше дополнены по точным PHP-wrapper и C-библиотеке и ограниченному native-запуску.

В проверенной версии пустой Imagick даёт ImagickException; native-отказ обвязка также превращает в исключение. Чтение и запись могут отказать отдельно. If с ! проверяет false, throw прекращает программу сообщением; clear после записи освобождает ресурсы. В веб-обработчике перехватите исключение и покажите понятный отказ без внутренних путей. Возвращаемое true не подтверждает художественное качество или удаление шума.

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

<?php
declare(strict_types=1);

require __DIR__ . '/adaptive-fixture.php';
$source = loadAdaptiveSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$image = clone $source;
$quantum = Imagick::getQuantumRange()['quantumRangeLong'];
if (!$image->selectiveBlurImage(0, 1.2, $quantum * 0.05)) {
    throw new RuntimeException('Не удалось применить selectiveBlurImage');
}
saveAdaptiveComparison([$source, $image], 'selective-blur-basic.png');
$source->clear();
$image->clear();

selective-blur-basic.png

Практическая задача: Выбрать компромисс между зернистостью и слабой деталью

На ровном участке есть слабый прямоугольник всего на 8 уровней светлее основы. Сравним строгий допуск 2% диапазона с 12%: более широкий допуск позволяет смешивать больше различающихся соседей, но может сгладить нужную слабую деталь.

Обе копии получены из $source: второй опыт не продолжает первый. Изменён только threshold, radius/sigma остаются 0/1.2. Сравнивайте разброс на ровной части шума и видимость прямоугольника +8 отдельно от сильной границы 60/196. Уменьшив шум, можно одновременно убрать полезное различие.

<?php
declare(strict_types=1);

require __DIR__ . '/adaptive-fixture.php';
$source = loadAdaptiveSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$image = clone $source;
$quantum = Imagick::getQuantumRange()['quantumRangeLong'];
if (!$image->selectiveBlurImage(0, 1.2, $quantum * 0.02)) {
    throw new RuntimeException('Не удалось применить selectiveBlurImage');
}
$looser = clone $source;
if (!$looser->selectiveBlurImage(0, 1.2, $quantum * 0.12)) {
    throw new RuntimeException('Не удалось применить selectiveBlurImage');
}
saveAdaptiveComparison([$source, $image, $looser], 'selective-blur-thresholds.png');
$source->clear();
$image->clear();
$looser->clear();

selective-blur-thresholds.png

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

Threshold=0 не включает даже равную интенсивность из-за строгого <; когда сумма весов почти нулевая, C сохраняет исходный канал. В preflight 0 и literal 0.05 дали неизменённый образец, 0.05×QuantumRange изменил его. Ровно QuantumRange не включает разность, строго равную этому максимуму: нельзя без условий обещать полный Gaussian. Больший допуск способен стереть слабую полезную деталь; это осознанный компромисс.

Для приложения выбирайте конечные radius≥0 и sigma>0 с верхними пределами по разрешению; selective threshold ограничьте осмысленной долей диапазона, motion angle — понятным диапазоном градусов. Это политика приложения, не обещание полной валидации Imagick. Большая окрестность и adaptive-карта стоят памяти и времени: ограничьте площадь, число кадров и число копий, измерьте свою нагрузку. Сравнительной гарантии скорости здесь нет.

В preflight явный CHANNEL_RED у всех четырёх методов сохранил G/B. Канал — составляющая всего растра; несколько флагов объединяются |, например Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN | Imagick::CHANNEL_BLUE. Uniform alpha=50% сохранилась в ограниченном опыте с default и RGB-маской, но это не проверка прозрачного края и не общая гарантия alpha. Основные программы работают с непрозрачным sRGB PNG; произвольная alpha, ICC/CMYK, HDR и кадры требуют отдельной проверки.

Связанные методы: adaptiveBlurImage · adaptiveSharpenImage · motionBlurImage. Предыдущий шаг: обычное размытие, резкость и unsharp mask; для диапазона: нормализация и хвосты гистограммы.

• Imagick::selectiveBlurImage
• Imagick 3.8.1 PHP-wrapper
• ImageMagick 7.1.1-46 effect.c

PECL imagick 2, PECL imagick 3 · imagick

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

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

Самая маленькая запись

В $image загружена отдельная копия. Три аргумента: автоматический радиус 0, sigma=3 пикселя и угол 0 градусов. Это горизонтальное направление оператора; контрольный импульс покажет фактическую сторону следа. Channel пропущен. Стрелка вызывает метод объекта, круглые скобки содержат аргументы, запятые их отделяют, точка с запятой завершает команду. Для сохранения оригинала до вызова создайте $image = clone $source; простое присваивание не копирует объект.

$image->motionBlurImage(0, 3, 0);

Это пояснение ядра. Полная программа ниже также загрузит вход, задаст virtual pixels, проверит возврат и запишет PNG. Подготовка: объект и метод, clone, массив и ключ.

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

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

Метод сворачивает изображение направленным Gaussian-оператором. Radius/sigma задают масштаб в пикселях, angle — угол в градусах. В проверенной реализации исходный импульс при 0° оставил горизонтальный след влево, при 90° вверх, при 45° вверх-влево. Размеры остаются прежними, поэтому часть следа у рамки зависит от virtual pixels.

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

Результат bool: true при успехе. Метод меняет пиксели текущего Imagick; $ok = $image->motionBlurImage(...) сохранит флаг, не новую картинку. Обязательность и default приведены в исходной сигнатуре выше. Доступность PHP Manual: PECL imagick 2, PECL imagick 3.

Channel влияет начиная с ImageMagick 6.4.4; точный PHP-wrapper использует канальную ветвь при MagickLibVersion >0x643. В более старой ветви этот аргумент игнорируется.

В проверенной версии пустой Imagick даёт ImagickException; native-отказ обвязка также превращает в исключение. Чтение и запись могут отказать отдельно. If с ! проверяет false, throw прекращает программу сообщением; clear после записи освобождает ресурсы. В веб-обработчике перехватите исключение и покажите понятный отказ без внутренних путей. Возвращаемое true не подтверждает художественное качество или удаление шума.

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

<?php
declare(strict_types=1);

require __DIR__ . '/adaptive-fixture.php';
$source = loadAdaptiveSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$image = clone $source;
if (!$image->motionBlurImage(0, 3, 0)) {
    throw new RuntimeException('Не удалось применить motionBlurImage');
}
saveAdaptiveComparison([$source, $image], 'motion-blur-basic.png');
$source->clear();
$image->clear();

motion-blur-basic.png

Практическая задача: Подобрать вертикальный или диагональный след для макета

Оформительский вариант баннера должен иметь выбранное направление следа. Сравниваем 90° и 45° при одинаковом масштабе размытия на независимых копиях; белая контрольная точка делает направление видимым.

В растровых координатах x растёт вправо, y вниз. Положительные углы этой реализации в контрольном опыте дали следы к меньшим x/y. Данные — фактический результат, а не стрелка, нарисованная по названию параметра. Угол и sigma подбирают к задаче оформления, не к направлению реального объекта.

<?php
declare(strict_types=1);

require __DIR__ . '/adaptive-fixture.php';
$source = loadAdaptiveSource();
$source->setImageVirtualPixelMethod(Imagick::VIRTUALPIXELMETHOD_EDGE);
$image = clone $source;
if (!$image->motionBlurImage(0, 3, 90)) {
    throw new RuntimeException('Не удалось применить motionBlurImage');
}
$diagonal = clone $source;
if (!$diagonal->motionBlurImage(0, 3, 45)) {
    throw new RuntimeException('Не удалось применить motionBlurImage');
}
saveAdaptiveComparison([$source, $image, $diagonal], 'motion-blur-angles.png');
$source->clear();
$image->clear();
$diagonal->clear();

motion-blur-angles.png

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

Это добавление смаза, а не deblur. Направление следа оператора не устанавливает реальное направление движения на фотографии. Соседние пиксели за рамкой берутся по virtual-pixel policy: EDGE и TILE дали разные результаты на контрольном preflight. Большая sigma может скрыть надпись; не применяйте эффект к единственному оригиналу.

Для приложения выбирайте конечные radius≥0 и sigma>0 с верхними пределами по разрешению; selective threshold ограничьте осмысленной долей диапазона, motion angle — понятным диапазоном градусов. Это политика приложения, не обещание полной валидации Imagick. Большая окрестность и adaptive-карта стоят памяти и времени: ограничьте площадь, число кадров и число копий, измерьте свою нагрузку. Сравнительной гарантии скорости здесь нет.

В preflight явный CHANNEL_RED у всех четырёх методов сохранил G/B. Канал — составляющая всего растра; несколько флагов объединяются |, например Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN | Imagick::CHANNEL_BLUE. Uniform alpha=50% сохранилась в ограниченном опыте с default и RGB-маской, но это не проверка прозрачного края и не общая гарантия alpha. Основные программы работают с непрозрачным sRGB PNG; произвольная alpha, ICC/CMYK, HDR и кадры требуют отдельной проверки.

Связанные методы: adaptiveBlurImage · adaptiveSharpenImage · selectiveBlurImage. Предыдущий шаг: обычное размытие, резкость и unsharp mask; для диапазона: нормализация и хвосты гистограммы.

• Imagick::motionBlurImage
• Imagick 3.8.1 PHP-wrapper
• ImageMagick 7.1.1-46 effect.c