@jimp/plugin-rotate

What is @jimp/plugin-rotate?

@jimp/plugin-rotate is a plugin for the Jimp image processing library that provides functionality to rotate images. It allows users to rotate images by a specified number of degrees, either clockwise or counterclockwise.

What are @jimp/plugin-rotate's main functionalities?

Rotate Image

This feature allows you to rotate an image by a specified number of degrees. In this example, the image is rotated by 90 degrees and then saved to a new file.

const Jimp = require('jimp');

Jimp.read('path/to/image.jpg')
  .then(image => {
    return image.rotate(90) // rotate image by 90 degrees
      .write('path/to/rotated-image.jpg'); // save
  })
  .catch(err => {
    console.error(err);
  });

Rotate Image with Background Color

This feature allows you to rotate an image by a specified number of degrees and fill the background with a specified color. In this example, the image is rotated by 45 degrees with a white background.

const Jimp = require('jimp');

Jimp.read('path/to/image.jpg')
  .then(image => {
    return image.rotate(45, false, 0xFFFFFFFF) // rotate image by 45 degrees with white background
      .write('path/to/rotated-image.jpg'); // save
  })
  .catch(err => {
    console.error(err);
  });

Other packages similar to @jimp/plugin-rotate

sharp

Sharp is a high-performance image processing library that supports a wide range of image transformations, including rotation. It is known for its speed and efficiency, making it a popular choice for server-side image processing. Compared to @jimp/plugin-rotate, Sharp offers more advanced features and better performance.

gm

GraphicsMagick (gm) is a powerful image processing library that provides a wide range of image manipulation capabilities, including rotation. It is a wrapper for the GraphicsMagick and ImageMagick tools, which are well-known for their robustness and versatility. Compared to @jimp/plugin-rotate, gm offers more comprehensive image processing functionalities.

lwip

lwip is a lightweight image processing library that supports basic image transformations, including rotation. It is designed to be simple and easy to use, making it suitable for small-scale image processing tasks. Compared to @jimp/plugin-rotate, lwip is more lightweight but may lack some of the advanced features offered by Jimp.

README

@jimp/plugin-rotate

Rotate an image.

Rotates the image clockwise by a number of degrees. By default the width and height of the image will be resized appropriately.

Usage

• @param {number} deg the number of degrees to rotate the image by
• @param {string|boolean} mode (optional) resize mode or a boolean, if false then the width and height of the image will not be changed
• @param {function(Error, Jimp)} cb (optional) a callback for when complete

import jimp from 'jimp';

async function main() {
  const image = await jimp.read('test/image.png');

  image.rotate(90);
}

main();