Imagick::sigmoidalContrastImage

(PECL imagick 2, PECL imagick 3)

Imagick::sigmoidalContrastImage — Регулирует контраст изображения

Описание

public Imagick::sigmoidalContrastImage(
    bool $sharpen,
    float $alpha,
    float $beta,
    int $channel = Imagick::CHANNEL_DEFAULT
): bool

Регулирует контраст изображения с помощью алгоритма нелинейного сигмоидального контраста. Увеличьте контраст изображения с помощью сигмоидальной передаточной функции без насыщения светлых участков или теней. Контрастность указывает, насколько увеличить контраст (0 - нет; 3 - типичный; 20 - усиление); Средняя точка указывает, где попадают средние тона в результирующем изображении (0 - белый; 50 - средний серый; 100 - чёрный). Установите резкость на true для увеличения контрастности изображения, в противном случае контрастность уменьшается.

Список параметров

sharpen: Если true, контраст увеличивается, если false - уменьшается.
alpha: Количество применяемого контраста. 1 - очень мало, 5 - значительное, 20 - максимальная величина.
beta: Где будет середина градиента. Это значение должно быть в диапазоне от 0 до 1 - вне зависимости от квантового значения ImageMagick.
channel: К каким цветовым каналам будет применяться контраст.

Возвращаемые значения

Функция в случае успешной работы возвращает true.

Ошибки

Функция выбрасывает исключение ImagickException, если возникла ошибка.

Примеры

Пример #1 Создание градиентного изображения, используя Imagick::sigmoidalContrastImage(), подходящую для плавного смешивания двух изображений вместе, со смешиванием, определяемого контрастом и средней точкой.

<?php

function generateBlendImage($width, $height, $contrast = 10, $midpoint = 0.5) {
    $imagick = new Imagick();
    $imagick->newPseudoImage($width, $height, 'gradient:black-white');
    $quanta = $imagick->getQuantumRange();
    $imagick->sigmoidalContrastImage(true, $contrast, $midpoint * $quanta["quantumRangeLong"]);

    return $imagick;
}

?>