[函数]Gmagick::writeimage()函数—用法及示例

函数名：Gmagick::writeimage()

函数描述：该函数用于将Gmagick对象中的图像写入到指定的文件中。

适用版本：Gmagick::writeimage() 函数适用于 Gmagick 扩展版本 1.1.0 及以上。

用法：

Gmagick::writeimage ( string $filename [, bool $all_frames = FALSE ] ) : Gmagick

参数：

• $filename：要写入图像的文件名，可以是相对路径或绝对路径。
• $all_frames（可选）：如果设置为 true，则将所有帧写入到文件中。默认情况下，只写入第一帧。

返回值：成功时返回 Gmagick 对象，出错时返回 false。

示例：

<?php
try {
    // 创建 Gmagick 对象
    $image = new Gmagick('path/to/image.jpg');
    
    // 调用 writeimage() 方法将图像写入到文件
    $image->writeimage('path/to/output.jpg');
    
    echo '图像写入成功！';
} catch (GmagickException $e) {
    echo '发生错误：' . $e->getMessage();
}
?>

以上示例将读取 path/to/image.jpg 图像文件，并将其写入到 path/to/output.jpg 文件中。如果写入成功，将输出 "图像写入成功！"。如果发生错误，将捕获 GmagickException 异常并输出错误信息。

注意：在使用 Gmagick 扩展之前，确保已经安装了 GraphicsMagick 或 ImageMagick 软件，并启用了 Gmagick 扩展。