• Stars
    star
    12,419
  • Rank 2,437 (Top 0.05 %)
  • Language
    JavaScript
  • Created over 9 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

An image processing library written entirely in JavaScript for Node, with zero external or native dependencies.

Jimp

JavaScript Image Manipulation Program

An image processing library for Node written entirely in JavaScript, with zero native dependencies

Notice of potentially breaking change

As of v0.10.4, core-js is no longer included with jimp or its extensions. If you rely on core-js, install it with either yarn add core-js or npm i core-js

Read before installing

Please be aware that Jimp is built on JavaScript implementations of image formats so in some cases that might allocate a lot of memory before using.

Installation

Installation: npm install --save jimp

API documentation can be found in the main jimp package

Supported Image Types

Image Manipulation Methods (Default Plugins)

  • blit - Blit an image onto another.
  • blur - Quickly blur an image.
  • color - Various color manipulation methods.
  • contain - Contain an image within a height and width.
  • cover - Scale the image to the given width and height keeping the aspect ratio.
  • displace - Displaces the image based on a displacement map
  • dither - Apply a dither effect to an image.
  • flip - Flip an image along its x or y axis.
  • gaussian - Hardcore blur.
  • invert - Invert an images colors
  • mask - Mask one image with another.
  • normalize - Normalize the colors in an image
  • print - Print text onto an image
  • resize - Resize an image.
  • rotate - Rotate an image.
  • scale - Uniformly scales the image by a factor.

Extra Plugins

  • circle - Creates a circle out of an image.
  • shadow - Creates a shadow on an image.
  • fisheye - Apply a fisheye effect to an image.
  • threshold - Lighten an image. Good for scanned drawing and signatures.

๐Ÿš€ If you want to add your plugins to this list make a PR! ๐Ÿš€

Custom Jimp

If you want to extend jimp or omit types or functions visit @jimp/custom.

  • Add file-types or switch encoder/decoders
  • Add add/remove plugins (image manipulation methods)

Contributing

Basically clone, change, test, push and pull request.

Please read the CONTRIBUTING documentation.

License

Jimp is licensed under the MIT license. Open Sans is licensed under the Apache license

Project Using Jimp

โญ nimp - Node based image manipulator. Procedurally create and edit images.

โญ node-vibrant - Extract prominent colors from an image.

โญ lqip - Low Quality Image Placeholders (LQIP) Module for Node

โญ webpack-pwa-manifest - A webpack plugin that generates a 'manifest.json' for your Progressive Web Application, with auto icon resizing and fingerprinting support.

โญ wdio-screenshot - A WebdriverIO plugin. Additional commands for taking screenshots with WebdriverIO.

โญ asciify-image - Convert images to ASCII art

โญ node-sprite-generator - Generates image sprites and their spritesheets (css, stylus, sass, scss or less) from sets of images. Supports retina sprites.

โญ merge-img - Merge multiple images into a single image

โญ postcss-resemble-image - Provide a gradient fallback for an image that loosely resembles the original.

โญ differencify - Perceptual diffing tool

โญ gifwrap - A Jimp-compatible library for working with GIFs

โญ replace-color - Replace color with another one pixel by pixel

โญ handwritten.js - Convert typed text to realistic handwriting!

Contributors โœจ

Thanks goes to these wonderful people (emoji key):


Andrew Lisowski

๐Ÿ’ป ๐Ÿš‡ ๐Ÿ“– โš ๏ธ

Oliver Moran

๐Ÿ’ป

strandedcity

๐Ÿ’ป

Edgar Hipp

๐Ÿ’ป

Corbin Crutchley

๐Ÿ’ป

Max G J Panas

๐Ÿ’ป

Michael Vogt

๐Ÿ’ป

Marcolino

๐Ÿ’ป

iwsfg

๐Ÿ’ป

arlecchino

๐Ÿ’ป

super-ienien

๐Ÿ’ป

Bennett Somerville

๐Ÿ’ป

Florian Barth

๐Ÿ’ป

Adam Rackis

๐Ÿ’ป

Aurรฉlio A. Heckert

๐Ÿ’ป

Daniel Tian

๐Ÿ’ป

Jeff Bonnes

๐Ÿ’ป

Russley Shaw

๐Ÿ’ป

CodeLenny

๐Ÿ’ป

Sebastian Skaล‚acki

๐Ÿ’ป

Turan Rustamli

๐Ÿ’ป

Vlad Turak

๐Ÿ’ป

ozelot379

๐Ÿ’ป

Adam Jones

๐Ÿ’ป

Ahmad Awais โšก๏ธ

๐Ÿ’ป

Andrei Picus

๐Ÿ’ป

Andy Chou

๐Ÿ’ป

Arjun Khoosal

๐Ÿ’ป

Arman

๐Ÿ’ป

Autom3

๐Ÿ’ป

Bernardo Farah

๐Ÿ’ป

Boon

๐Ÿ’ป

BrianRosamilia

๐Ÿ’ป

Carter Bancroft

๐Ÿ’ป

Chad Banfield

๐Ÿ’ป

Charaf Salmi

๐Ÿ’ป

ciffelia

๐Ÿ’ป

Cody Schrank

๐Ÿ’ป

Cru Scanlan

๐Ÿ’ป

Curtis Autery

๐Ÿ’ป

Dan

๐Ÿ’ป

Daniel Holmes

๐Ÿ’ป โš ๏ธ

Daniel Tschinder

๐Ÿ’ป

Daniel Kimani

๐Ÿ’ป

Dara Kong

๐Ÿ’ป

Denis Bendrikov

๐Ÿ’ป

Dennis Bartlett

๐Ÿ’ป

Dominique Rau

๐Ÿ’ป

Eirik Birkeland

๐Ÿ’ป

Emily Marigold Klassen

๐Ÿ’ป

Emmanuel Bourgerie

๐Ÿ’ป

Endre Szabo

๐Ÿ’ป

Eric Rabil

๐Ÿ’ป

Gal Horowitz

๐Ÿ’ป

GlitchyPSI

๐Ÿ’ป

Gustavo Ramos Rehermann

๐Ÿ’ป

Han Kruiger

๐Ÿ’ป

Igor Borges

๐Ÿ’ป

Ivan Ganev

๐Ÿ’ป

Ivan Koprda

๐Ÿ’ป

iwasawafag

๐Ÿ’ป

Jake Champion

๐Ÿ’ป

James Harris

๐Ÿ’ป

James Ross

๐Ÿ’ป

Jeremy Katz

๐Ÿ’ป

Jeroen Claassens

๐Ÿ’ป

Johannes Goslar

๐Ÿ’ป

J D Carmichael

๐Ÿ’ป

John-Robert Yrjรถlรค

๐Ÿ’ป

Jordan Danford

๐Ÿ’ป

Joseph

๐Ÿ’ป

Keith

๐Ÿ’ป

Keith Mitchell

๐Ÿ’ป

Kwyn Alice Meagher

๐Ÿ’ป

Lucy

๐Ÿ’ป

Marat Nagayev

๐Ÿ’ป

Marcel Mundl

๐Ÿ’ป

Mario Adrian

๐Ÿ’ป

Martin Trobรคck

๐Ÿ’ป

Matt Mc

๐Ÿ’ป

Max

๐Ÿ’ป

Maรซl Nison

๐Ÿ’ป

Michael Elhadad

๐Ÿ’ป

Milos Bejda

๐Ÿ’ป

Mithgol

๐Ÿ’ป

Nicolas Giard

๐Ÿ’ป

Nam Bok Rodriguez

๐Ÿ’ป

Nate Cavanaugh

๐Ÿ’ป

Nik

๐Ÿ’ป

Olly Banham

๐Ÿ’ป

Pasi Eronen

๐Ÿ’ป

Pavel Volyntsev

๐Ÿ’ป

Peter Theill

๐Ÿ’ป

Philip Hannent

๐Ÿ’ป

Philipp Laube

๐Ÿ’ป

Rahil Kabani

๐Ÿ’ป

Rob Moore

๐Ÿ’ป

Ruben Bridgewater

๐Ÿ’ป

Sam Broner

๐Ÿ’ป

Sam MacPherson

๐Ÿ’ป

Sander Weyens

๐Ÿ’ป

Shen Yiming

๐Ÿ’ป

Stefan Lau

๐Ÿ’ป

Steve Bazyl

๐Ÿ’ป

Steve Mao

๐Ÿ’ป

Stuart Hinson

๐Ÿ’ป

Tom Bull

๐Ÿ’ป

TonyStr

๐Ÿ’ป

Laurent

๐Ÿ’ป

Vincent Dufrasnes

๐Ÿ’ป

Vladimir Starkov

๐Ÿ’ป

Vojtฤ›ch ล tฤ›panฤรญk

๐Ÿ’ป

William Friesen

๐Ÿ’ป

Xiliang Chen

๐Ÿ’ป

Yonggang Luo

๐Ÿ’ป

austinfrey

๐Ÿ’ป

brownrw8

๐Ÿ’ป

Eliott C.

๐Ÿ’ป

d07RiV

๐Ÿ’ป

fabb

๐Ÿ’ป

fratzinger

๐Ÿ’ป

Guillem Cruz

๐Ÿ’ป

krudos

๐Ÿ’ป

mLuby

๐Ÿ’ป

mfuatnuroglu

๐Ÿ’ป

Matt Misbach

๐Ÿ’ป

netdown

๐Ÿ’ป

nopeless

๐Ÿ’ป

Oz Weiss

๐Ÿ’ป

popinguy

๐Ÿ’ป

qw3n

๐Ÿ’ป

rifflock

๐Ÿ’ป

s4tori

๐Ÿ’ป

sertal70

๐Ÿ’ป

xinbenlv

๐Ÿ’ป

xinnix

๐Ÿ’ป

ๅฝญๅ›ๆ€ก

๐Ÿ’ป

Andrey Kutejko

๐Ÿ“–

Ihor Bodnarchuk

๐Ÿ“–

Daniell

๐Ÿ’ป

MD KHAIRUL ISLAM

โš ๏ธ ๐Ÿ’ป

JunkMeal

๐Ÿ“–

Nicolas Morel

๐Ÿ’ป

Zach Stevenson

๐Ÿ’ป

AnotherPillow

๐Ÿ“–

Dathan

๐Ÿ’ป

This project follows the all-contributors specification. Contributions of any kind welcome!