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

函数名： Imagick::convolveImage()

适用版本： Imagick 3.1.0以上版本

函数描述： 该函数用于将图像与指定的卷积核进行卷积操作，以应用特定的图像增强或滤波效果。

用法：

bool Imagick::convolveImage ( array $kernel [, int $channel = Imagick::CHANNEL_ALL ] )

参数说明：

• $kernel：一个包含卷积核数值的数组。卷积核是一个二维数组，用于指定卷积操作的权重。数组的大小应为奇数，例如3x3、5x5等。卷积核的大小决定了滤波的效果。
• $channel（可选）：指定要应用卷积操作的通道，默认为Imagick::CHANNEL_ALL，表示应用于所有通道。也可以指定特定的通道，如Imagick::CHANNEL_RED、Imagick::CHANNEL_GREEN等。

返回值： 如果成功应用卷积操作，则返回true。如果发生错误，则返回false。

示例：

// 创建Imagick对象并读取图像
$image = new Imagick('input.jpg');

// 定义一个3x3的卷积核
$kernel = [
    [-1, -1, -1],
    [-1,  8, -1],
    [-1, -1, -1]
];

// 应用卷积操作
$image->convolveImage($kernel);

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

上述示例中，我们创建了一个3x3的卷积核，该卷积核可以提高图像的锐度。然后，我们调用convolveImage()函数将卷积核应用于图像。最后，将处理后的图像以JPEG格式输出。

请注意，卷积操作可能会改变图像的颜色、亮度和对比度等。因此，在使用此函数时应谨慎选择卷积核以获得所需的效果。