Imagick adaptiveBlurImage() 函数

2025年3月17日 | 阅读 3 分钟

Imagick::adaptiveBlurImage() 函数是 PHP 的一个内置函数,它为提供的图片添加自适应模糊滤镜。自适应模糊的强度在图像边缘附近急剧减小,而普通模糊在整个图像中保持一致。这种效果导致图像变得模糊或不清晰。

这是一个实验性函数。在 PHP 的未来版本中,此函数的行为、名称以及所有关于此函数的文档都可能在不另行通知的情况下发生变化。使用此功能需自行承担风险。将自适应模糊滤镜应用于图像。自适应模糊的强度在图像边缘附近会显著下降,而普通模糊的强度在整个图像中保持一致。

语法

参数

此函数传递的不同参数说明如下:

  • 半径:高斯模糊的半径(像素),不包括中心像素。如果输入值为 0,半径将自动确定。
  • Sigma:高斯模糊的标准差(像素)。
  • 通道:为您的通道模式提供任何有效的通道常量。使用位运算符组合通道类型变量以应用于多个通道。Imagick::CHANNEL_ALL 是默认值。
    • 通道常量
    • 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 值。

错误/异常

如果传递给这些函数的参数不正确,或者在对指定图像执行模糊操作时出现问题,或者由于任何其他不正确的信息或配置,此函数将抛出异常或错误。

示例

输出

Imagick adaptiveBlurImage() Function

在上面编写的示例代码中,我们展示了 PHP 提供的自适应模糊图像函数的使用。在这个示例中,我们首先创建了一个 Imagick 类对象,在成功创建对象后,我们使用此对象通过传递两个整数值作为变量来调用自适应模糊图像函数。这两个整数参数将决定我们要添加到指定图像的模糊量。我们正在添加模糊的图像名称是 test.JPG。在成功模糊操作后,我们将能够看到 test.JPG 中添加了特定量的模糊。

因此,在这篇文章中,我们已经详细介绍了 PHP 提供的自适应模糊图像函数,用于为我们的图像添加特定量的模糊效果,我们还查看并理解了传递给此函数的不同参数。