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

PECL imagick 2, PECL imagick 3 · imagick

Imagick::colorizeImage(mixed $colorize, mixed $opacity, bool $legacy = false): bool

Нужен общий цветовой вариант рисунка: примешать цвет оформления ко всем пикселям или к известной области макета.

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

В $image уже загружена отдельная копия рисунка. Стрелка вызывает метод объекта; запятые отделяют цвет, силу по каналам и режим совместимости. Кавычки обозначают строки: #2864c8 — синий цвет, gray(35%) — серое значение с каждой RGB-составляющей 35%. False — логическое «нет» старому режиму. На плашке 128 получим RGB(97,118,153). Точка с запятой завершает команду. Чтобы сохранить оригинал, до вызова создайте $image = clone $source; простое присваивание не копирует объект.

$image->colorizeImage('#2864c8', 'gray(35%)', false);

Это пояснение главного вызова. Полная скачиваемая программа ниже также загрузит вход, проверит результат и запишет сравнение. Основы: объект и метод, копия объекта, аргументы.

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

Imagick::colorizeImage(mixed $colorize, mixed $opacity, bool $legacy = false): bool

Colorize смешивает исходные каналы с заданным цветом. В современном вызове gray(35%) задаёт одинаковую долю 35% для R/G/B: result = original × 0.65 + color × 0.35. Даже крайние чёрный и белый сдвигаются; это ожидаемая потеря исходного размаха.

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

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

В PECL imagick 2.1.0 официально добавлены строковый цвет первым аргументом и float opacity вторым; прежде допускались только ImagickPixel. Позднейшая ветвь с legacy=false в проверенной 3.8.1 использует цвет для opacity, поэтому историческое описание float нельзя переносить в современный вызов без проверки. Raw-сигнатура мануала сохранена выше; для этих программ выбираем строки/объекты и false. Имена Reflection отличаются, поэтому примеры вызывают позиционные аргументы.

Пустой Imagick в проверенной версии даёт ImagickException. Неверная строка цвета также даёт ImagickException. Обвязка превращает отказ native-операции в исключение; чтение и запись могут отказать отдельно. Проверка ! означает «вернулся false», throw создаёт понятный отказ. Необработанное исключение завершит CLI-программу; веб-обработчик должен перехватить его, не показывая клиенту внутренние пути. True свидетельствует о выполнении, а качество выбирают по изображению.

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

<?php
declare(strict_types=1);

require __DIR__ . '/color-effects-fixture.php';
$source = loadColorEffectsSource();
$image = clone $source;
if (!$image->colorizeImage('#2864c8', 'gray(35%)', false)) {
    throw new RuntimeException('Не удалось применить colorizeImage');
}
saveColorEffectsComparison([$source, $image], 'colorize-basic.png');
$source->clear();
$image->clear();

colorize-basic.png

Практическая задача: Изменить только иллюстрацию, сохранив контрольные шкалы

Макет содержит картинку товара и контрольные цвета печати. Общий оттенок нужен только прямоугольнику картинки. Обрабатываем известную область 352×184 с началом x=24,y=36 и возвращаем её на независимую копию.

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

New ImagickPixel создаёт объект с разобранным цветом. $color хранит цвет заливки, $strength — цвет с компонентами 35%. Эти роли различны; clear вызывается у обоих после применения. Если нужно обрабатывать непрямоугольную форму, следующий шаг — явная маска, а не флаг канала.

<?php
declare(strict_types=1);

require __DIR__ . '/color-effects-fixture.php';
$source = loadColorEffectsSource();
$image = clone $source;
$region = clone $source;
$region->cropImage(352, 184, 24, 36);
$region->setImagePage(0, 0, 0, 0);
$color = new ImagickPixel('#2864c8');
$strength = new ImagickPixel('gray(35%)');
if (!$region->colorizeImage($color, $strength, false)) {
    throw new RuntimeException('Не удалось применить colorizeImage');
}
if (!$image->compositeImage($region, Imagick::COMPOSITE_OVER, 24, 36)) {
    throw new RuntimeException('Не удалось вернуть область');
}
$region->clear();
$color->clear();
$strength->clear();
saveColorEffectsComparison([$source, $image], 'colorize-region.png');
$source->clear();
$image->clear();

colorize-region.png

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

В выполненной сборке modern float 0.35 вызывает ImagickException, а rgba(0,0,0,0.35) при legacy=false оставляет RGB исходными: сила берётся из нулевых RGB-компонент, не из alpha этой строки. Gray(100%) полностью заменяет RGB цветом заливки; gray(0%) оставляет исходные RGB. Параметр opacity здесь нельзя без проверки приравнивать прозрачности выходного файла.

Оба основных сценария используют один непрозрачный sRGB PNG. Для прозрачного файла проверяйте alpha отдельно до и после операции; непрозрачный учебный результат не доказывает её сохранение. Для профилированных CMYK/ICC, линейного RGB, HDR и последовательностей кадров сначала определите формат, преобразования и обработку каждого кадра. Эффект не сохраняет документальную точность цвета: оригинал нужен отдельно.

Соседние инструменты: tintImage · negateImage · sepiaToneImage. Для яркости и контраста: тональная коррекция; для двоичного документа: пороги и отсечки.

• Imagick::colorizeImage
• Imagick 3.8.1 bindings
• ImageMagick 7.1.1-46 implementation

PECL imagick 2, PECL imagick 3 · imagick

Imagick::tintImage(mixed $tint, mixed $opacity, bool $legacy = false): bool

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

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

В $image находится отдельная копия. Стрелка вызывает метод, первый аргумент — цвет, второй — строка множителей RGB-вектора, третий false оставляет современное поведение. Gray(100%) означает полные множители каналов; это не требование сделать всё изображение непрозрачным. Чёрная и белая плашки останутся прежними, середина 128 в сохранённом PNG8 станет RGB(73,133,233). Точка с запятой завершает команду. Чтобы сохранить оригинал, до вызова создайте $image = clone $source; простое присваивание не копирует объект.

$image->tintImage('#2864c8', 'gray(100%)', false);

Это пояснение главного вызова. Полная скачиваемая программа ниже также загрузит вход, проверит результат и запишет сравнение. Основы: объект и метод, копия объекта, аргументы.

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

Imagick::tintImage(mixed $tint, mixed $opacity, bool $legacy = false): bool

Tint прибавляет цветовой вектор с весом f(x)=1−4×(x−0.5)². x — отдельная составляющая, приведённая к 0..1; в проверенной реализации вес вычисляется отдельно для R, G и B. На 0 и 1 вес равен нулю, около 0.5 максимален. Поэтому крайние компоненты сохраняются даже у насыщенного цветного пикселя.

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

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

В PECL imagick 2.1.0 официально добавлены строковый цвет первым аргументом и float opacity вторым; прежде допускались только ImagickPixel. Позднейшая ветвь с legacy=false в проверенной 3.8.1 использует цвет для opacity, поэтому историческое описание float нельзя переносить в современный вызов без проверки. Raw-сигнатура мануала сохранена выше; для этих программ выбираем строки/объекты и false. Имена Reflection отличаются, поэтому примеры вызывают позиционные аргументы.

Пустой Imagick в проверенной версии даёт ImagickException. Неверная строка цвета также даёт ImagickException. Обвязка превращает отказ native-операции в исключение; чтение и запись могут отказать отдельно. Проверка ! означает «вернулся false», throw создаёт понятный отказ. Необработанное исключение завершит CLI-программу; веб-обработчик должен перехватить его, не показывая клиенту внутренние пути. True свидетельствует о выполнении, а качество выбирают по изображению.

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

<?php
declare(strict_types=1);

require __DIR__ . '/color-effects-fixture.php';
$source = loadColorEffectsSource();
$image = clone $source;
if (!$image->tintImage('#2864c8', 'gray(100%)', false)) {
    throw new RuntimeException('Не удалось применить tintImage');
}
saveColorEffectsComparison([$source, $image], 'tint-basic.png');
$source->clear();
$image->clear();

tint-basic.png

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

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

TransformImageColorspace(GRAY) сознательно удаляет исходную цветность по правилам библиотеки. Второй transform в SRGB делает серые значения RGB-основой для цветного tint. $gray = clone $image сохраняет промежуточную основу перед изменением, чтобы на выходе показать весь путь данных. Значения не вычисляются простым средним (R+G+B)/3.

<?php
declare(strict_types=1);

require __DIR__ . '/color-effects-fixture.php';
$source = loadColorEffectsSource();
$image = clone $source;
$image->transformImageColorspace(Imagick::COLORSPACE_GRAY);
$image->transformImageColorspace(Imagick::COLORSPACE_SRGB);
$gray = clone $image;
if (!$image->tintImage('#2864c8', 'gray(100%)', false)) {
    throw new RuntimeException('Не удалось применить tintImage');
}
saveColorEffectsComparison([$source, $gray, $image], 'tint-grayscale.png');
$source->clear();
$gray->clear();
$image->clear();

tint-grayscale.png

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

При legacy=false float 0.35 в нашей версии отклонён как нераспознанный цвет. Чёрный rgba(0,0,0,0.35) не задаёт обычную силу tint: его RGB множители нулевые и полутона темнеют. Tint не превращает цветное фото в одноцветное: для этого сначала осознанно получите серую основу. Формула веса не равна обещанию сохранить воспринимаемую яркость каждого цвета; возможна обрезка составляющих в 0/максимум.

Оба основных сценария используют один непрозрачный sRGB PNG. Для прозрачного файла проверяйте alpha отдельно до и после операции; непрозрачный учебный результат не доказывает её сохранение. Для профилированных CMYK/ICC, линейного RGB, HDR и последовательностей кадров сначала определите формат, преобразования и обработку каждого кадра. Эффект не сохраняет документальную точность цвета: оригинал нужен отдельно.

Соседние инструменты: colorizeImage · negateImage · sepiaToneImage. Для яркости и контраста: тональная коррекция; для двоичного документа: пороги и отсечки.

• Imagick::tintImage
• Imagick 3.8.1 bindings
• ImageMagick 7.1.1-46 implementation

PECL imagick 2, PECL imagick 3 · imagick

Imagick::negateImage(bool $gray, int $channel = Imagick::CHANNEL_DEFAULT): bool

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

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

В $image загружен наш непрозрачный RGB-рисунок. Стрелка вызывает метод, false в круглых скобках разрешает инверсию всех пикселей. Второй аргумент пропущен и имеет default CHANNEL_DEFAULT. Красная RGB-плашка станет cyan, серый 64 станет 191. True изменил бы только серые пиксели, сохранив цветные. Точка с запятой завершает команду. Чтобы сохранить оригинал, до вызова создайте $image = clone $source; простое присваивание не копирует объект.

$image->negateImage(false);

Это пояснение главного вызова. Полная скачиваемая программа ниже также загрузит вход, проверит результат и запишет сравнение. Основы: объект и метод, копия объекта, аргументы.

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

Imagick::negateImage(bool $gray, int $channel = Imagick::CHANNEL_DEFAULT): bool

Negate заменяет выбранное значение на QuantumRange−значение. Для PNG8 на иллюстрации это 255−канал. Gray=true ограничивает операцию серыми пикселями; он не выполняет преобразование RGB в grayscale.

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

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

Пустой Imagick в проверенной версии даёт ImagickException. Обвязка превращает отказ native-операции в исключение; чтение и запись могут отказать отдельно. Проверка ! означает «вернулся false», throw создаёт понятный отказ. Необработанное исключение завершит CLI-программу; веб-обработчик должен перехватить его, не показывая клиенту внутренние пути. True свидетельствует о выполнении, а качество выбирают по изображению.

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

<?php
declare(strict_types=1);

require __DIR__ . '/color-effects-fixture.php';
$source = loadColorEffectsSource();
$image = clone $source;
if (!$image->negateImage(false)) {
    throw new RuntimeException('Не удалось применить negateImage');
}
$gray = clone $source;
if (!$gray->negateImage(true)) {
    throw new RuntimeException('Не удалось применить negateImage');
}
saveColorEffectsComparison([$source, $image, $gray], 'negate-basic.png');
$source->clear();
$image->clear();
$gray->clear();

negate-basic.png

Практическая задача: Получить диагностический вариант двух RGB-каналов

В служебном просмотре макета нужно выделить изменение красной и зелёной составляющих, сохранив синюю. Это проверка цветовых каналов всего растра; она не выделяет красные предметы и не выбирает прямоугольную область.

Одна вертикальная черта | — побитовое объединение флагов, это не логическое ||. Маска содержит RED и GREEN. Метод применяется ко всему изображению, но меняет только эти составляющие. Для обычного RGB-негатива с сохранением alpha добавляют BLUE, не ALPHA.

<?php
declare(strict_types=1);

require __DIR__ . '/color-effects-fixture.php';
$source = loadColorEffectsSource();
$image = clone $source;
$channels = Imagick::CHANNEL_RED | Imagick::CHANNEL_GREEN;
if (!$image->negateImage(false, $channels)) {
    throw new RuntimeException('Не удалось применить negateImage');
}
saveColorEffectsComparison([$source, $image], 'negate-channels.png');
$source->clear();
$image->clear();

negate-channels.png

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

На прозрачном RGBA в нашей ImageMagick 7 default инвертировал и alpha: непрозрачное могло стать прозрачным. Для сохранения alpha RGB-изображения задавайте RED|GREEN|BLUE явно. CHANNEL_ALL также не означает «только цвет». True не является конвертацией в серый, а JPEG после сжатия может содержать почти серые цветные пиксели: не считайте их гарантированно той же группой, что точная учебная шкала.

Оба основных сценария используют один непрозрачный sRGB PNG. Для прозрачного файла проверяйте alpha отдельно до и после операции; непрозрачный учебный результат не доказывает её сохранение. Для профилированных CMYK/ICC, линейного RGB, HDR и последовательностей кадров сначала определите формат, преобразования и обработку каждого кадра. Эффект не сохраняет документальную точность цвета: оригинал нужен отдельно.

Соседние инструменты: colorizeImage · tintImage · sepiaToneImage. Для яркости и контраста: тональная коррекция; для двоичного документа: пороги и отсечки.

• Imagick::negateImage
• Imagick 3.8.1 bindings
• ImageMagick 7.1.1-46 implementation

PECL imagick 2, PECL imagick 3 · imagick

Imagick::sepiaToneImage(float $threshold): bool

Нужен отдельный оформительский вариант иллюстрации с эффектом сепии или сепия внутри макета с сохранёнными служебными цветами.

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

В $image уже загружена независимая копия. Стрелка вызывает метод, число 80 в круглых скобках — единственный аргумент. В PHP-обвязке Imagick 3.8.1 оно пересчитывается в 80% QuantumRange: 80×65535/100=52428. Этот пересчёт уже выполняет расширение; дополнительное умножение в PHP не требуется. Справа будет оформительская сепия, а не двоичное чёрно-белое изображение. Точка с запятой завершает команду. Чтобы сохранить оригинал, до вызова создайте $image = clone $source; простое присваивание не копирует объект.

$image->sepiaToneImage(80);

Это пояснение главного вызова. Полная скачиваемая программа ниже также загрузит вход, проверит результат и запишет сравнение. Основы: объект и метод, копия объекта, аргументы.

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

Imagick::sepiaToneImage(float $threshold): bool

Сепия имитирует характер тонированного отпечатка. Raw-описание PHP Manual называет диапазон 0..QuantumRange и старт 80. Однако точная PHP-обвязка Imagick 3.8.1 вычисляет native threshold = PHP threshold × QuantumRange / 100. Поэтому для этой версии передаём PHP-значение 80 в шкале 0..100; на уровне MagickCore получается 52428 из 65535. Внутри также выполняются normalize/contrast.

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

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

Пустой Imagick в проверенной версии даёт ImagickException. Обвязка превращает отказ native-операции в исключение; чтение и запись могут отказать отдельно. Проверка ! означает «вернулся false», throw создаёт понятный отказ. Необработанное исключение завершит CLI-программу; веб-обработчик должен перехватить его, не показывая клиенту внутренние пути. True свидетельствует о выполнении, а качество выбирают по изображению.

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

<?php
declare(strict_types=1);

require __DIR__ . '/color-effects-fixture.php';
$source = loadColorEffectsSource();
$image = clone $source;
if (!$image->sepiaToneImage(80)) {
    throw new RuntimeException('Не удалось применить sepiaToneImage');
}
saveColorEffectsComparison([$source, $image], 'sepia-basic.png');
$source->clear();
$image->clear();

sepia-basic.png

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

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

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

<?php
declare(strict_types=1);

require __DIR__ . '/color-effects-fixture.php';
$source = loadColorEffectsSource();
$image = clone $source;
$region = clone $source;
$region->cropImage(352, 184, 24, 36);
$region->setImagePage(0, 0, 0, 0);
if (!$region->sepiaToneImage(80)) {
    throw new RuntimeException('Не удалось применить sepiaToneImage');
}
if (!$image->compositeImage($region, Imagick::COMPOSITE_OVER, 24, 36)) {
    throw new RuntimeException('Не удалось вернуть область');
}
$region->clear();
saveColorEffectsComparison([$source, $image], 'sepia-region.png');
$source->clear();
$image->clear();

sepia-region.png

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

Не переносите quantum-единицы MagickCore непосредственно в этот PHP-метод. В ограниченном preflight PHP 80 дал сепию, а 0.8×QuantumRange был повторно умножен внутри wrapper и дал ошибочный cyan-вариант. Файл официального XML-примера просто передаёт $sepia; он не выполняет умножения. Параметр не является двоичным порогом thresholdImage. Изменённые цвета и нормализация не восстанавливаются простым обратным вызовом.

Оба основных сценария используют один непрозрачный sRGB PNG. Для прозрачного файла проверяйте alpha отдельно до и после операции; непрозрачный учебный результат не доказывает её сохранение. Для профилированных CMYK/ICC, линейного RGB, HDR и последовательностей кадров сначала определите формат, преобразования и обработку каждого кадра. Эффект не сохраняет документальную точность цвета: оригинал нужен отдельно.

Соседние инструменты: colorizeImage · tintImage · negateImage. Для яркости и контраста: тональная коррекция; для двоичного документа: пороги и отсечки.

• Imagick::sepiaToneImage
• Imagick 3.8.1 bindings
• ImageMagick 7.1.1-46 implementation