[函数]Imagick::previewImages()函数—用法及示例

函数名： Imagick::previewImages()

适用版本： Imagick 3.4.4 或更高版本

用法： Imagick::previewImages() 方法用于生成一系列图像的预览图像。它可以用于批量生成缩略图或快速预览图像。

语法： public Imagick::previewImages(int $columns, int $rows, int $preview, bool $bestfit = false) : Imagick

参数：

• $columns: 预览图像的列数。每行将包含 $columns 张图像。
• $rows: 预览图像的行数。每列将包含 $rows 张图像。
• $preview: 每个预览图像的最大尺寸（以像素为单位）。生成的预览图像将根据此尺寸进行缩放。
• $bestfit（可选）: 如果设置为 true，则将图像缩放到最接近指定尺寸的大小，同时保持其宽高比。默认值为 false。

返回值： 返回一个新的 Imagick 对象，其中包含生成的预览图像。

示例： 以下示例演示了如何使用 Imagick::previewImages() 方法生成一系列图像的预览图像。

// 创建一个 Imagick 对象并读取原始图像
$imagick = new Imagick('path/to/original_images/*.jpg');

// 生成预览图像
$previewImagick = $imagick->previewImages(4, 3, 200, true);

// 设置生成的预览图像的输出格式为 JPEG
$previewImagick->setImageFormat('jpeg');

// 保存预览图像到文件
$previewImagick->writeImages('path/to/output/previews.jpg', true);

在上面的示例中，我们首先创建了一个 Imagick 对象，并使用通配符路径读取了一系列原始图像。然后，我们调用了 previewImages() 方法来生成预览图像，其中每行有 4 张图像，每列有 3 张图像，每个预览图像的最大尺寸为 200 像素。我们还将 $bestfit 参数设置为 true，以确保生成的预览图像在保持宽高比的同时尽可能接近指定尺寸。

最后，我们将生成的预览图像的输出格式设置为 JPEG，并使用 writeImages() 方法将其保存到指定的输出文件夹中。

请注意，为了使用 Imagick::previewImages() 方法，您需要在服务器上安装 Imagick 扩展，并且您的 PHP 版本必须支持 Imagick 3.4.4 或更高版本。