Sharp toFormat方法

toFormat 方法是 Sharp 中用于指定输出图像格式的一个关键方法。通过 toFormat，你可以将处理后的图像转换为不同的图像格式，如 JPEG、PNG、WebP 等。

使用 toFormat 方法

toFormat 方法接受一个格式字符串作为参数，该字符串指定了输出图像的格式。Sharp 支持多种格式，包括但不限于 'jpeg'、'png'、'webp'、'tiff'、'avif' 等。

以下是一个使用 toFormat 方法的示例：

const sharp = require('sharp');
const fs = require('fs');

// 输入图像路径
const inputImagePath = 'input.png';
// 输出图像路径
const outputImagePath = 'output.jpeg';

// 读取图像并转换格式
sharp(inputImagePath)
  .toFormat('jpeg', { quality: 75 }) // 指定输出格式为 JPEG，并设置质量
  .toFile(outputImagePath, (err, info) => {
    if (err) {
      console.error('Error saving image:', err);
    } else {
      console.log('Image saved as', info.format, info.width, 'x', info.height);
    }
  });

在这个示例中，我们读取了一个 PNG 格式的输入图像，并使用 toFormat 方法将其转换为 JPEG 格式。我们还传递了一个选项对象 { quality: 75 } 来设置输出 JPEG 图像的质量（范围从 0 到 100）。最后，我们使用 toFile 方法将处理后的图像保存到文件中。

4. 链式调用与其他处理方法

Sharp 允许你将多个图像处理操作链接在一起，形成一个处理链。你可以在使用 toFormat 方法之前或之后添加其他处理方法，如 resize、extract、rotate 等。

以下是一个更复杂的示例，展示了如何链式调用多个处理方法：

sharp(inputImagePath)
  .resize(800, 600) // 调整图像大小
  .extract({ left: 10, top: 10, width: 780, height: 580 }) // 裁剪图像
  .rotate(45, { background: { r: 255, g: 255, b: 255 } }) // 旋转图像并设置背景色为白色
  .toFormat('png') // 指定输出格式为 PNG
  .toBuffer((err, data) => {
    if (err) {
      console.error('Error processing image:', err);
    } else {
      // 在这里，你可以使用 data Buffer 对象进行进一步的处理
      // 例如，将其发送到客户端、保存到数据库或写入文件
      console.log('Image processed successfully, Buffer size:', data.length);
      
      // 可选：将 Buffer 写入新文件
      fs.writeFile('processed_output.png', data, (writeFileErr) => {
        if (writeFileErr) {
          console.error('Error writing file:', writeFileErr);
        } else {
          console.log('Processed image saved to processed_output.png');
        }
      });
    }
  });

在这个示例中，我们链式调用了 resize、extract、rotate 和 toFormat 方法，最后使用 toBuffer 方法将处理后的图像数据转换为 Buffer 对象。

5. 注意事项

• 当使用 toFormat 方法时，请确保你指定的格式是 Sharp 支持的格式之一。
• 对于某些格式（如 JPEG），你可以通过传递选项对象来设置额外的参数，如质量、渐进式编码等。
• 如果你不需要将处理后的图像保存到文件或发送到客户端，而是想在内存中进一步处理它，你可以使用 toBuffer 方法获取图像的 Buffer 对象。

通过以上步骤，你应该能够成功地在 Node.js 中使用 Sharp 库的 toFormat 方法来转换图像的格式。

本文地址：https://www.tides.cn/p_node-sharp-to-farmat