Gmagick::modulateimage()函数—用法及示例

函数名：Gmagick::modulateimage()

函数描述：该函数用于调整图像的亮度、饱和度和色调。

适用版本：Gmagick扩展模块需要安装并启用，适用于PHP版本5.4.0及以上。

语法：public Gmagick::modulateimage(float $brightness, float $saturation, float $hue)

参数：

• $brightness（浮点型）：设置亮度的倍数，取值范围为0到2。1表示不改变亮度，小于1表示降低亮度，大于1表示增加亮度。
• $saturation（浮点型）：设置饱和度的倍数，取值范围为0到2。1表示不改变饱和度，小于1表示降低饱和度，大于1表示增加饱和度。
• $hue（浮点型）：设置色调的倍数，取值范围为0到360。0表示不改变色调，小于0表示逆时针旋转色调，大于0表示顺时针旋转色调。

返回值：成功时返回true，失败时返回false。

示例：

// 创建一个Gmagick对象
$image = new Gmagick('path/to/image.jpg');

// 调整图像的亮度、饱和度和色调
$image->modulateimage(1.2, 1.5, 45);

// 保存修改后的图像
$image->write('path/to/new_image.jpg');

上述示例中，我们首先创建了一个Gmagick对象，将路径为'path/to/image.jpg'的图像加载进来。然后使用modulateimage()函数将图像的亮度增加20%（1.2倍），饱和度增加50%（1.5倍），色调顺时针旋转45度。最后，使用write()函数将修改后的图像保存到'path/to/new_image.jpg'路径下。

请注意，使用该函数需要安装Gmagick扩展，并且启用了对应的PHP模块。