intrinsic-scale
v4.0.1
Published
Replicate background-size: cover/contain (scale+crop) for canvas/CSS/Node/… on any type of media.
Downloads
50,679
Maintainers
Readme
intrinsic-scale
Replicate
background-size: cover/contain
for canvas/CSS/Node/… on any type of media.
Many libraries that take care of replicating background-size
/object-fit
’s cover
/contain
have this functionality embedded. You can use this function anywhere, from the browser to calculate sizing on a canvas, to node when doing some image file resizing.
This module doesn't concern itself with getting the sizes or applying the values. You provide numbers, you get numbers.
Install
npm install intrinsic-scale
import resizeToFit from 'intrinsic-scale';
Usage
/*
Given an 50px 50px element in a 100px 200px parent
To be contained by its parent it must be of size 100px 100px
and be positioned at 0px 50px to be centered.
*/
const source = {width: 50, y: 50};
const target = {width: 100, height: 200};
const { width, height, x, y } = resizeToFit('contain', source, target);
console.log(width, height, x, y);
//100 100 0 50
/*
Given an 50px 50px element in a 100px 200px parent
To be covered in its parent it must be of size 200px 200px
and be positioned at -50px 0px to be centered.
*/
const source = {width: 50, y: 50};
const target = {width: 100, height: 200};
const { width, height, x, y } = resizeToFit('cover', source, target);
console.log(width, height, x, y);
//200 200 -50 0
Dependencies
No dependencies. It works in the browser and in node.
Used on
- https://fregante.github.io/art-cropper/ — Crops images making them fill a pre-set area.