sharp

Overview

sharp is a high-speed Node-API module leveraging the libvips image processing library. It excels at converting large images to smaller, web-friendly formats like JPEG, PNG, WebP, GIF, and AVIF. Designed for Node.js >= 18.17.0, Deno, and Bun, sharp is significantly faster than ImageMagick and GraphicsMagick, achieving 4x-5x speed improvements due to libvips' efficient processing. It correctly handles color spaces, embedded ICC profiles, and alpha transparency. Operations include resizing, rotation, extraction, compositing, and gamma correction. Input can be streams, Buffer objects, or filesystem paths, with support for splitting a single input stream into multiple processing pipelines. Deep Zoom image pyramids can also be generated. It optimizes JPEG and PNG file sizes using mozjpeg and pngquant respectively, and animated GIFs using custom methods, eliminating the need for separate command-line tools.

Common tasks

Image Resizing Image Format Conversion Image Compositing Image Rotation Image Extraction

FAQ

View all

What image formats does sharp support?

sharp supports reading JPEG, PNG, WebP, GIF, AVIF, TIFF, and SVG images. Output images can be in JPEG, PNG, WebP, GIF, AVIF, and TIFF formats, as well as uncompressed raw pixel data.

How does sharp compare to ImageMagick and GraphicsMagick in terms of performance?

sharp is typically 4x-5x faster than ImageMagick and GraphicsMagick due to its use of libvips.

Does sharp handle color spaces and ICC profiles correctly?

Yes, sharp correctly handles color spaces, embedded ICC profiles, and alpha transparency channels.

Can I use sharp with streams and buffers?

Yes, streams, Buffer objects, and the filesystem can be used for input and output. A single input Stream can be split into multiple processing pipelines and output Streams.

FAQ+