PHP Imagick adaptiveBlurImage() 函数
Imagick::adaptiveBlurImage() 函数是一个PHP内置函数,它可以给输入的图片添加自适应模糊滤镜。自适应模糊的强度在图像边缘附近急剧下降,而普通的模糊滤镜在整个图像上保持一致。由于这个效果,图像变得朦胧或不太清晰。
这是一个实验性的函数。在将来的PHP版本中,这个函数的行为、名称以及与该函数有关的所有其他文档都可能会变化,没有通知。使用此功能需自担风险。函数会对图像应用自适应模糊滤镜。自适应模糊滤镜的强度在图像边缘明显降低,而普通模糊滤镜在整个图像上保持一致。
语法
bool adaptiveBlurImage ( radius,sigma, $channel )
参数
传递给该函数的不同参数解释如下:
- radius 以像素为单位的高斯半径,不包括中心像素。如果输入0,半径将自动确定。
- Sigma: 以像素为单位的高斯标准差。
- Channel: 为您的通道模式提供任何有效的通道常量。将通道类型变量与位运算符结合起来应用于多个通道。Imagick::CHANNEL ALL为默认值。
- CHANNEL constants
- imagick::CHANNEL_UNDEFINED (int)
- imagick::CHANNEL_RED (int)
- imagick::CHANNEL_GRAY (int)
- imagick::CHANNEL_CYAN(int)
- imagick::CHANNEL_GREEN(int)
- imagick::CHANNEL_MAGENTA(int)
- imagick::CHANNEL_BLUE(int)
- imagick::CHANNEL_YELLOW(int)
- imagick::CHANNEL_ALPHA(int)
- imagick::CHANNEL_OPACITY(int)
- imagick::CHANNEL_MATTE(int)
- imagick::CHANNEL_BLACK(int)
- imagick::CHANNEL_INDEX(int)
- imagick::CHANNEL_ALL(int)
- imagick::CHANNEL_DEFAULT(int)
返回类型
这个函数的返回类型是布尔类型,这意味着这个函数的返回值取决于我们将要在图像上执行的模糊操作的成功与否。如果指定图像的模糊成功完成,这个函数的返回类型将是True值;另一方面,如果指定图像的模糊不成功或在指定操作中遇到了一些错误,这个函数的返回类型将是False值。
错误/异常
如果向这些函数指定的参数不正确,对于指定的图像执行模糊操作时会出现问题,或是由于其他不正确的信息或配置,该函数会抛出异常或错误。
示例
<?php
header('Content-type: image/jpeg');
image = new Imagick('test.jpg');image->adaptiveBlurImage(5,3);
echo $image;
?>
输出:
在上面的示例代码中,我们展示了PHP提供的自适应模糊图像函数的用法。首先,我们创建了一个Imagick类对象,在成功创建对象后,我们使用该对象调用自适应模糊图像函数,通过传递两个整数值作为变量。这两个整数参数将确定我们要添加到指定图像上的模糊程度。我们正在为其添加模糊的图像的名称是test.JPG,在成功进行模糊操作后,我们将能够看到test.JPG上添加了特定程度的模糊。
因此,在这篇文章中,我们已经了解了PHP提供的自适应模糊图像函数,可以为我们的图像添加特定数量的模糊效果,我们也看到并理解了传递给这个函数的不同参数。