shichen b6c5ecc67a init 10 kuukautta sitten
..
dist b6c5ecc67a init 10 kuukautta sitten
es b6c5ecc67a init 10 kuukautta sitten
node_modules b6c5ecc67a init 10 kuukautta sitten
src b6c5ecc67a init 10 kuukautta sitten
test b6c5ecc67a init 10 kuukautta sitten
CHANGELOG.md b6c5ecc67a init 10 kuukautta sitten
LICENSE b6c5ecc67a init 10 kuukautta sitten
README.md b6c5ecc67a init 10 kuukautta sitten
index.d.ts b6c5ecc67a init 10 kuukautta sitten
package.json b6c5ecc67a init 10 kuukautta sitten

README.md

@jimp/plugin-contain

Contain an image within a height and width.

Scale the image to the given width and height keeping the aspect ratio. Some parts of the image may be letter boxed.

Usage

  • @param {number} w the width to resize the image to
  • @param {number} h the height to resize the image to
  • @param {number} alignBits (optional) A bitmask for horizontal and vertical alignment
  • @param {string} mode (optional) a scaling method (e.g. Jimp.RESIZE_BEZIER)
  • @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.contain(150, 100);
}

main();

Align modes

The following constants can be passed to image.contain:

Jimp.HORIZONTAL_ALIGN_LEFT;
Jimp.HORIZONTAL_ALIGN_CENTER;
Jimp.HORIZONTAL_ALIGN_RIGHT;

Jimp.VERTICAL_ALIGN_TOP;
Jimp.VERTICAL_ALIGN_MIDDLE;
Jimp.VERTICAL_ALIGN_BOTTOM;

For example:

image.contain(250, 250, Jimp.HORIZONTAL_ALIGN_LEFT | Jimp.VERTICAL_ALIGN_TOP);
image.contain(
  250,
  250,
  Jimp.HORIZONTAL_ALIGN_RIGHT | Jimp.VERTICAL_ALIGN_BOTTOM
);

Default align mode for image.contain is:

Jimp.HORIZONTAL_ALIGN_CENTER | Jimp.VERTICAL_ALIGN_MIDDLE;