photo-cropper-npm

Node.js package for:

• photo cropping (rectangle/aspect)
• panorama tile slicing (zoom/x/y pyramid)

Install

npm i photo-cropper-npm

For local development:

cd photo-cropper-npm
npm install

1) Crop CLI (photo-crop)

Rectangle crop:

photo-crop ./input.jpg -o ./output.jpg --x 120 --y 80 --width 1400 --height 900

Aspect crop:

photo-crop ./input.jpg -o ./output_16x9.jpg --aspect 16:9 --position center

2) Tile slicing CLI (photo-tiles)

Create panorama tile pyramid:

photo-tiles ./pano.jpg -o ./tiles --tile-size 256 --max-zoom 3 --overwrite

Output structure:

tiles/
  meta.json
  1/
    0/0.jpg 0/1.jpg ...
    1/0.jpg ...
  2/
    ...
  3/
    ...

Where:

• zoom=1 is max quality
• zoom=2 is half-resolution
• zoom=3 is quarter-resolution

API

import { cropImage, sliceToTiles } from 'photo-cropper-npm';

await cropImage({
  input: './input.jpg',
  output: './output.webp',
  aspect: '1:1',
  format: 'webp',
  quality: 90,
});

const tileResult = await sliceToTiles({
  input: './pano.jpg',
  outputDir: './tiles',
  tileSize: 256,
  maxZoom: 3,
  format: 'jpg',
  quality: 86,
  overwrite: true,
});

console.log(tileResult.levels);

Publish to npmjs

1. Set unique name in package.json.
2. Update version.
3. Login:

npm login

4. Publish:

npm publish --access public