Imagick::sigmoidalContrastImage

(PECL imagick 2, PECL imagick 3)

Imagick::sigmoidalContrastImage — Ajusta el contraste de la imagen

Descripción

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

Ajusta el contraste de la imagen con un algoritmo de contraste sigmoide no lineal. Aumenta el contraste de la imagen utilizando una función de transferencia sigmoide sin saturar las luces altas y las sombras. alpha indica cuánto debe aumentarse el contraste: 0.00 para no hacer nada; 3.00 es un valor típico; 20.00 es un valor extremo. beta indica dónde estarán los tonos medios en la imagen resultante, como una fracción del rango del quantum: 0.0 corresponde a blanco, 0.5 a gris medio y 1.0 a negro (se debe multiplicar por getQuantumRange()['quantumRangeLong'] para obtener el valor a pasar).

Consúltense también los » ejemplos de ImageMagick -- Modificaciones de color — Contraste no lineal sigmoide.

Parámetros

sharpen: Si es true, el contraste aumentará; si es false, el contraste disminuirá.
alpha: La cantidad de contraste a aplicar. 1.00 representa una cantidad muy pequeña, 5.00 una cantidad significativa y 20.00 un valor extremo.
beta: Dónde debe situarse el punto medio del gradiente. Este valor debe estar en el intervalo de 0.00 a 1.00, multiplicado por el valor del quantum para ImageMagick.
channel: Canales de color sobre los cuales debe aplicarse el contraste.

Valores devueltos

Devuelve true en caso de éxito.

Errores/Excepciones

Lanza una ImagickException en caso de error.

Ejemplos

Ejemplo #1 Crea un degradado de imagen utilizando el método Imagick::sigmoidalContrastImage() para mezclar dos imágenes suavemente, donde la mezcla está definida por alpha y beta

<?php

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

    return $imagick;
}