https://github.com/spencermountain/crop-aspect

Last synced: 18 days ago
JSON representation

crop an image by a nearby aspect-ratio

README

crop an image by a nearby aspect-ratio

_{by

Spencer Kelly}

npm i -g crop-aspect

here's an image of an Apollo guidance computer:

![agc_user_interface](https://user-images.githubusercontent.com/399657/51630193-83f39b80-1f17-11e9-892e-9ecc1d072282.jpg)

#### it's **500x391px**.

this is a ratio of `1:0.782` *(or `4:2.346`)*

that is *almost* `4:3`, which is one of the most-commonly used aspect ratios ever.

This is a nodejs CLI script that chops-off a bit of the image, so that it fit's a nearby aspect ratio.

```
crop-aspect ./apolloComputer.jpg
```

this creates a file, `./apolloComputer-500.jpg`
that is **500x375px**.

this also works:
```
crop-aspect ./myImg.jpg 16:9
crop-aspect ./myImg.jpg golden
```

you can also call it from node:
```js
var cropAspect=require('crop-aspect')
cropAspect('./myImg.jpg','square').then(()=>{
console.log('done!')
})
```

[sharp](https://sharp.pixelplumbing.com) is doing all the heavy-lifting. This library is simply placing some opinionated aspect-ratios on top of it.

i mean, davinci thought math-sizes were nicer, so I figure ... well, i don't know.

it's using [fit-aspect-ratio](https://github.com/spencermountain/fit-aspect-ratio/) for the maths

work-in-progress

MIT