(PECL imagick 2, PECL imagick 3)
Imagick::contrastStretchImage — 增强彩色图像的对比度
$black_point, float $white_point, int $channel = Imagick::CHANNEL_DEFAULT): bool通过调整像素颜色以跨越所有可用颜色的范围来增强彩色图像的对比度。如果Imagick已针对ImageMagick 6.2.9或更高版本编译，则此方法可用。
black_point黑点。
white_point白点。
channel提供任何对您的通道模式有效的通道常量。要应用于多个通道，请使用按位运算符组合channeltype常量。Imagick::CHANNEL_ALL。参考此通道常量列表。
成功时返回true。
黑点和白点指的是像素的绝对数量。在下面的示例中，彩色图像首先被去饱和（转换为灰度图像），然后最暗的90%像素变为黑色，最亮的5%变为白色，而90%到95%之间的像素变为灰度。
<?php
$im = new Imagick ("some_image.jpg");
list ($width, $height) = array_values ($im->getImageGeometry ());
$im->modulateImage (100, 0, 100);
$im->contrastStretchImage ($width * $height * 0.90, $width * $height * 0.95);
$im->writeImage ("temp.jpg");
echo "<img src=\"temp.jpg\">";
?>试图弄清楚黑点和白点可以取什么值以及它们的效果是什么几乎让我抓狂。但是，这个方法有效
<?php
$width = 480;
$height = 360;
$mask = new Imagick ();
$mask->newImage ($width, $height, "black");
$draw = new ImagickDraw ();
$draw->setFillColor ("white");
$draw->ellipse ($width / 2, $height / 2, $width * 5 / 12, $height * 5 / 12, 0, 360);
$mask->drawImage ($draw);
$mask->blurImage (0, 50);
$mask->contrastStretchImage (10, 125000);
$mask->writeImage ("mask.png");
?>
结果将是一个渐晕蒙版，角上的像素为纯黑色，中间的像素为纯白色（如果注释掉该行则并非如此）。将白色值降低到例如100，会使大部分灰色像素变为白色。