Imagick::vignetteImage()函数—用法及示例

函数名：Imagick::vignetteImage()

适用版本：Imagick类是在PHP 5.1.3及以上版本中可用的。

用法： Imagick::vignetteImage()函数用于在图像的边缘创建一个渐变效果，以产生一个类似于晕影的效果。该函数接受多个参数来控制渐变效果的程度和颜色。以下是函数的语法：

bool Imagick::vignetteImage ( float $blackPoint , float $whitePoint , int $x , int $y )

参数说明：

• $blackPoint: 一个浮点数，用于定义渐变的黑色点的强度。值范围为0到1之间，0表示没有黑色效果，1表示完全黑色。通常情况下，建议使用0.5作为起始值。
• $whitePoint: 一个浮点数，用于定义渐变的白色点的强度。值范围为0到1之间，0表示没有白色效果，1表示完全白色。通常情况下，建议使用0.5作为起始值。
• $x: 渐变中心点的x坐标。该值为整数，表示相对于图像左上角的偏移量。
• $y: 渐变中心点的y坐标。该值为整数，表示相对于图像左上角的偏移量。

返回值： 如果成功创建了渐变效果，则返回true。如果发生错误，则返回false。

示例： 下面是一个使用Imagick::vignetteImage()函数创建渐变效果的示例：

// 创建一个Imagick对象并加载图像
$image = new Imagick('path/to/image.jpg');

// 创建渐变效果
$image->vignetteImage(0.5, 0.5, $image->getImageWidth() / 2, $image->getImageHeight() / 2);

// 显示图像
header('Content-Type: image/jpeg');
echo $image;

上述示例中，我们首先创建了一个Imagick对象并加载了一张图像。然后，我们调用vignetteImage()函数来创建渐变效果，其中黑色点和白色点的强度都设置为0.5，渐变中心点设置为图像中心。最后，我们将处理后的图像以JPEG格式输出。

这样，图像就会在边缘产生一个渐变效果，类似于晕影的效果。可以根据需要调整黑色点、白色点和渐变中心点的位置和强度来实现不同的效果。