Node sharp使用教程 Sharp读取metadata Sharp toFile方法 Sharp toBuffer方法 Sharp toFormat方法

Node sharp使用教程

栏目： NodeJs 发布时间：2024-12-13

node.js中的Sharp是一个流行的图像处理库，它支持多种图像文件格式，如JPEG、PNG、GIF、WebP、AVIF、SVG和TIFF。以下是一个详细的Sharp使用教程：

一、安装Sharp

安装Node.js和npm：
- 在系统上安装Node.js和npm（Node Package Manager）。
创建项目目录：
- 使用mkdir命令为项目创建目录，例如：mkdir process_images。
- 使用cd命令进入新创建的目录，例如：cd process_images。
初始化项目：
- 使用npm init命令创建package.json文件以跟踪项目依赖项。使用-y选项可以创建默认的package.json文件。
安装Sharp：
- 使用npm install sharp命令安装Sharp作为项目依赖。

二、Sharp的基本使用

引入Sharp模块：
```
const sharp = require('sharp');
```

读取图像并提取元数据：

创建一个Sharp实例，将图像路径作为参数传递。
使用metadata()方法提取图像的元数据，如格式、宽度、高度等。

async function getMetadata() {
    try {
        const metadata = await sharp('path/to/your/image.png').metadata();
        console.log(metadata);
    } catch (error) {
        console.log(`An error occurred during processing: ${error}`);
    }
}

getMetadata();

调整图像大小：

使用resize()方法调整图像大小。
使用toFile()方法将调整大小后的图像保存到指定路径。

async function resizeImage() {
    try {
        await sharp('path/to/your/image.png')
            .resize({ width: 150, height: 97 })
            .toFile('path/to/save/resized-image.png');
    } catch (error) {
        console.log(error);
    }
}

resizeImage();

更改图像格式和压缩图像：

使用format()方法更改图像格式。
对于JPEG格式，可以传递一个包含质量选项的对象来压缩图像。

async function convertAndCompressImage() {
    try {
        await sharp('path/to/your/image.png')
            .resize({ width: 800, height: 600 })
            .jpeg({ quality: 75 })
            .toFile('path/to/save/compressed-image.jpeg');
    } catch (error) {
        console.log(error);
    }
}

convertAndCompressImage();

裁剪图像：

使用extract()方法裁剪图像。该方法接受一个包含left、top、width和height属性的对象，用于指定裁剪区域。

async function cropImage() {
    try {
        await sharp('path/to/your/image.png')
            .extract({ left: 100, top: 100, width: 200, height: 200 })
            .toFile('path/to/save/cropped-image.png');
    } catch (error) {
        console.log(error);
    }
}

cropImage();

旋转图像：

使用rotate()方法旋转图像。该方法接受一个角度值作为参数。

async function rotateImage() {
    try {
        await sharp('path/to/your/image.png')
            .rotate(90) // 旋转90度
            .toFile('path/to/save/rotated-image.png');
    } catch (error) {
        console.log(error);
    }
}

rotateImage();

灰度化图像：

使用greyscale()方法将图像转换为灰度图像。

async function greyscaleImage() {
    try {
        await sharp('path/to/your/image.png')
            .greyscale()
            .toFile('path/to/save/greyscale-image.png');
    } catch (error) {
        console.log(error);
    }
}

greyscaleImage();

模糊图像：

使用blur()方法模糊图像。该方法接受一个包含sigma属性的对象，用于指定模糊程度。

async function blurImage() {
    try {
        await sharp('path/to/your/image.png')
            .blur(5) // 模糊程度为5
            .toFile('path/to/save/blurred-image.png');
    } catch (error) {
        console.log(error);
    }
}

blurImage();

合成图像和添加文本：

使用overlayWith()方法将一张图像覆盖到另一张图像上。
对于添加文本，可以先使用text-to-svg库将文本转换为SVG图像，然后使用overlayWith()方法将SVG图像覆盖到原图上。

const Text2SVG = require('text-to-svg');

async function addTextToImage() {
    const text2SVG = Text2SVG.loadSync();
    const attributes = { fill: 'white' };
    const options = { fontSize: 50, anchor: 'top-left', attributes };
    const svg = Buffer.from(text2SVG.getSVG('Hello, Sharp!', options));

    try {
        await sharp('path/to/your/image.png')
            .overlayWith(svg, { left: 10, top: 10 })
            .toFile('path/to/save/text-added-image.png');
    } catch (error) {
        console.log(error);
    }
}

addTextToImage();

三、注意事项

错误处理：
- 在进行图像处理时，务必添加错误处理逻辑，以便在发生错误时能够捕获并处理。
性能优化：
- 对于大型图像或批量图像处理任务，可以考虑使用流式处理或并行处理来提高性能。
依赖项：
- Sharp依赖于libvips库。在某些系统上，可能需要手动安装libvips。
文档和社区：
- 查阅Sharp的官方文档和GitHub仓库，以获取更多信息和示例代码。
- 加入Sharp的社区，与其他开发者交流和分享经验。

通过以上教程，您可以掌握Sharp的基本使用方法和常见图像处理操作。Sharp提供了丰富的功能和高效的性能，是Node.js中进行图像处理的强大工具。

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

Node sharp使用教程

一、安装Sharp

二、Sharp的基本使用

三、注意事项

推荐阅读