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

<?php
declare(strict_types=1);

require __DIR__ . '/tone-fixture.php';
$source = loadToneSource();
$image = clone $source;
if (!$image->brightnessContrastImage(0, 25)) {
    throw new RuntimeException('Не удалось применить brightnessContrastImage');
}
saveToneComparison([$source, $image], 'brightness-contrast.png');
$source->clear();
$image->clear();

Результат: Слева исходник, справа контраст 25 при brightness 0: тёмный образец 64 стал 42, светлый 192 — 213; края шкалы могут обрезаться до 0/255. Размеры и расположение предметов остались прежними. Архив примера содержит example.php, tone-fixture.php и source.png.b64. Распакуйте все три файла рядом и выполните php example.php в доступной для записи папке с PHP/Imagick. Помощник восстановит исходный source.png без интернета; полученный PNG откройте обычным просмотрщиком. Слева всегда исходник, справа обработанная копия; при трёх панелях порядок указан в описании. Названия/стрелки на поясняющих иллюстрациях не рисуются PHP-программой. Файл имеет 800×280 пикселей, без изменения геометрии предметов.

<?php
declare(strict_types=1);

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

Результат: Справа изменён только красный канал: серый 128 превратился в RGB (158,128,128). По всему изображению G/B остались исходными. Нейтральные серые стали цветными — ожидаемое следствие выбора одного канала. Архив примера содержит example.php, tone-fixture.php и source.png.b64. Распакуйте все три файла рядом и выполните php example.php в доступной для записи папке с PHP/Imagick. Помощник восстановит исходный source.png без интернета; полученный PNG откройте обычным просмотрщиком. Слева всегда исходник, справа обработанная копия; при трёх панелях порядок указан в описании. Названия/стрелки на поясняющих иллюстрациях не рисуются PHP-программой. Файл имеет 800×280 пикселей, без изменения геометрии предметов.

<?php
declare(strict_types=1);

require __DIR__ . '/tone-fixture.php';
$source = loadToneSource();
$image = clone $source;
if (!$image->modulateImage(120, 100, 100)) {
    throw new RuntimeException('Не удалось применить modulateImage');
}
saveToneComparison([$source, $image], 'modulate-brightness.png');
$source->clear();
$image->clear();

Результат: Справа brightness 120 при saturation 100 и hue 100: средний серый 128 стал 153, чёрный образец остался 0. Это другой способ осветления, чем прибавка brightnessContrastImage: одинаковые числа не означают одинаковый результат. Архив примера содержит example.php, tone-fixture.php и source.png.b64. Распакуйте все три файла рядом и выполните php example.php в доступной для записи папке с PHP/Imagick. Помощник восстановит исходный source.png без интернета; полученный PNG откройте обычным просмотрщиком. Слева всегда исходник, справа обработанная копия; при трёх панелях порядок указан в описании. Названия/стрелки на поясняющих иллюстрациях не рисуются PHP-программой. Файл имеет 800×280 пикселей, без изменения геометрии предметов.

<?php
declare(strict_types=1);

require __DIR__ . '/tone-fixture.php';
$source = loadToneSource();
$image = clone $source;
if (!$image->modulateImage(100, 65, 150)) {
    throw new RuntimeException('Не удалось применить modulateImage');
}
saveToneComparison([$source, $image], 'muted-hue-variant.png');
$source->clear();
$image->clear();

Результат: Справа цвета коробки и кружки изменены и менее насыщенны, нейтральные серые образцы остались серыми с исходными значениями. Hue 150 означает сдвиг примерно+90°, а не 150°. Результат не обещает совпадение с CSS hue-rotate. Архив примера содержит example.php, tone-fixture.php и source.png.b64. Распакуйте все три файла рядом и выполните php example.php в доступной для записи папке с PHP/Imagick. Помощник восстановит исходный source.png без интернета; полученный PNG откройте обычным просмотрщиком. Слева всегда исходник, справа обработанная копия; при трёх панелях порядок указан в описании. Названия/стрелки на поясняющих иллюстрациях не рисуются PHP-программой. Файл имеет 800×280 пикселей, без изменения геометрии предметов.

<?php
declare(strict_types=1);

require __DIR__ . '/tone-fixture.php';
$source = loadToneSource();
$image = clone $source;
if (!$image->gammaImage(1.6)) {
    throw new RuntimeException('Не удалось применить gammaImage');
}
saveToneComparison([$source, $image], 'gamma-midtones.png');
$source->clear();
$image->clear();

Результат: Справа gamma 1.6: серые 64/128/192 стали 107/165/213; чёрный 0 и белый 255 сохранились. Изменение нелинейное: разные исходные тона изменились на разное число единиц. Архив примера содержит example.php, tone-fixture.php и source.png.b64. Распакуйте все три файла рядом и выполните php example.php в доступной для записи папке с PHP/Imagick. Помощник восстановит исходный source.png без интернета; полученный PNG откройте обычным просмотрщиком. Слева всегда исходник, справа обработанная копия; при трёх панелях порядок указан в описании. Названия/стрелки на поясняющих иллюстрациях не рисуются PHP-программой. Файл имеет 800×280 пикселей, без изменения геометрии предметов.

<?php
declare(strict_types=1);

require __DIR__ . '/tone-fixture.php';
$source = loadToneSource();
$image = clone $source;
if (!$image->gammaImage(0.7, Imagick::CHANNEL_RED)) {
    throw new RuntimeException('Не удалось применить gammaImage');
}
saveToneComparison([$source, $image], 'red-channel-gamma.png');
$source->clear();
$image->clear();

Результат: Справа серый 128 стал RGB (95,128,128),64 —RGB (35,64,64),192 —RGB (170,192,192). Чёрный/белый края красного канала сохранились, G/B во всём изображении остались исходными. Архив примера содержит example.php, tone-fixture.php и source.png.b64. Распакуйте все три файла рядом и выполните php example.php в доступной для записи папке с PHP/Imagick. Помощник восстановит исходный source.png без интернета; полученный PNG откройте обычным просмотрщиком. Слева всегда исходник, справа обработанная копия; при трёх панелях порядок указан в описании. Названия/стрелки на поясняющих иллюстрациях не рисуются PHP-программой. Файл имеет 800×280 пикселей, без изменения геометрии предметов.

<?php
declare(strict_types=1);

require __DIR__ . '/tone-fixture.php';
$source = loadToneSource();
$image = clone $source;
if (!$image->contrastImage(true)) {
    throw new RuntimeException('Не удалось применить contrastImage');
}
saveToneComparison([$source, $image], 'contrast-direction.png');
$source->clear();
$image->clear();

Результат: Справа contrastImage(true): серый 64 стал 50,192 — 205, средний 128 почти не сместился. Никакой геометрической резкости или нового контура метод не создаёт: sharpen здесь имя флага направления контраста. Архив примера содержит example.php, tone-fixture.php и source.png.b64. Распакуйте все три файла рядом и выполните php example.php в доступной для записи папке с PHP/Imagick. Помощник восстановит исходный source.png без интернета; полученный PNG откройте обычным просмотрщиком. Слева всегда исходник, справа обработанная копия; при трёх панелях порядок указан в описании. Названия/стрелки на поясняющих иллюстрациях не рисуются PHP-программой. Файл имеет 800×280 пикселей, без изменения геометрии предметов.

<?php
declare(strict_types=1);

require __DIR__ . '/tone-fixture.php';
$source = loadToneSource();
$image = clone $source;
if (!$image->contrastImage(false)) {
    throw new RuntimeException('Не удалось применить contrastImage');
}
$twice = clone $image;
if (!$twice->contrastImage(false)) {
    throw new RuntimeException('Не удалось применить contrastImage');
}
saveToneComparison([$source, $image, $twice], 'soften-once-twice.png');
$source->clear();
$image->clear();
$twice->clear();

Результат: Три панели слева направо: исходник, одно снижение контраста, два последовательных снижения. После первого серый 64 стал 77,192 — 178; после второго значения приблизились к середине ещё сильнее. false не отменяет предыдущее true и не восстанавливает потерянные при обрезании детали. Архив примера содержит example.php, tone-fixture.php и source.png.b64. Распакуйте все три файла рядом и выполните php example.php в доступной для записи папке с PHP/Imagick. Помощник восстановит исходный source.png без интернета; полученный PNG откройте обычным просмотрщиком. Слева всегда исходник, справа обработанная копия; при трёх панелях порядок указан в описании. Названия/стрелки на поясняющих иллюстрациях не рисуются PHP-программой. Файл имеет 1200×280 пикселей, без изменения геометрии предметов.