[函数]ImagickKernel::fromBuiltIn()函数—用法及示例

函数名：ImagickKernel::fromBuiltIn()

适用版本：PHP 5 >= 5.4.0, PHP 7, PECL imagick >= 2.3.0

函数描述：该函数根据指定的内置滤镜名称创建一个新的ImagickKernel对象。

用法：

ImagickKernel ImagickKernel::fromBuiltIn ( string $kernelName [, string $kernelString ] )

参数：

• $kernelName：必需，内置滤镜名称。可以是以下值之一：
  • "unity"：创建一个单位矩阵滤镜。
  • "gaussian"：创建一个高斯滤镜。
  • "laplacian"：创建一个Laplacian滤镜。
  • "sobel"：创建一个Sobel滤镜。
  • "prewitt"：创建一个Prewitt滤镜。
  • "compass"：创建一个Compass滤镜。
  • "roberts"：创建一个Roberts滤镜。
  • "kirsch"：创建一个Kirsch滤镜。
  • "diamond"：创建一个Diamond滤镜。
  • "square"：创建一个Square滤镜。
  • "rectangle"：创建一个Rectangle滤镜。
  • "octagon"：创建一个Octagon滤镜。
  • "disk"：创建一个Disk滤镜。
  • "plus"：创建一个Plus滤镜。
  • "cross"：创建一个Cross滤镜。
  • "ring"：创建一个Ring滤镜。
  • "peaks"：创建一个Peaks滤镜。
  • "edges"：创建一个Edges滤镜。
  • "corners"：创建一个Corners滤镜。
  • "diagonals"：创建一个Diagonals滤镜。
  • "lineEnds"：创建一个LineEnds滤镜。
• $kernelString：可选，滤镜的字符串表示。默认为null。

返回值：返回一个新的ImagickKernel对象。

示例：

// 创建一个高斯滤镜
$kernel = ImagickKernel::fromBuiltIn("gaussian");

// 创建一个单位矩阵滤镜
$kernel = ImagickKernel::fromBuiltIn("unity");

// 创建一个自定义滤镜
$kernelString = "0, -1, 0; -1, 5, -1; 0, -1, 0";
$kernel = ImagickKernel::fromBuiltIn("custom", $kernelString);

注意事项：

• 该函数需要安装Imagick扩展才能使用。
• $kernelString参数是可选的，如果不提供，则使用内置滤镜的默认字符串表示。
• 可以使用ImagickKernel类的其他方法来修改和操作滤镜对象。