https://github.com/hanamura/rebounds.js
Rectangle scaling functions.
https://github.com/hanamura/rebounds.js
geometry layout utility
Last synced: about 1 month ago
JSON representation
Rectangle scaling functions.
- Host: GitHub
- URL: https://github.com/hanamura/rebounds.js
- Owner: hanamura
- License: mit
- Created: 2014-01-28T07:06:39.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2016-12-25T07:49:44.000Z (almost 9 years ago)
- Last Synced: 2025-03-07T21:11:24.345Z (8 months ago)
- Topics: geometry, layout, utility
- Language: JavaScript
- Size: 15.6 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# rebounds.js [](https://travis-ci.org/hanamura/rebounds.js)
Rectangle scaling functions.
## Installation
```sh
npm install rebounds
```
## Functions
### rebounds.fit(space, rect, options = {positionX: 0.5, positionY: 0.5, reduce: true, expand: true})
alias: **rebounds.showAll**
Returns scaled `rect` bounds to fit into `space`.
```javascript
rebounds.fit(
{width: 100, height: 100},
{width: 200, height: 50}
);
// => {width: 100, height: 25, x: 0, y: 37.5}
rebounds.fit(
{width: 100, height: 100},
{width: 200, height: 50},
{reduce: false}
);
// => {width: 200, height: 50, x: -50, y: 25}
```
### rebounds.fill(space, rect, options = {positionX: 0.5, positionY: 0.5, reduce: true, expand: true})
alias: **rebounds.noBorder**
Returns scaled `rect` bounds to fill `space`.
```javascript
rebounds.fill(
{width: 100, height: 100},
{width: 200, height: 50}
);
// => {width: 400, height: 100, x: -150, y: 0}
rebounds.fill(
{width: 100, height: 100},
{width: 200, height: 50},
{expand: false}
);
// => {width: 200, height: 50, x: -50, y: 25}
```
### rebounds.remain(space, rect, options = {positionX: 0.5, positionY: 0.5})
alias: **rebounds.noScale**
Returns non-scaled `rect` bounds repositioned against `space`.
```javascript
rebounds.remain(
{width: 100, height: 100},
{width: 200, height: 50}
);
// => {width: 200, height: 50, x: -50, y: 25}
```
### rebounds.stretch(space, rect, options = {positionX: 0.5, positionY: 0.5})
alias: **rebounds.exactFit**
Returns `rect` bounds stretched into the same size with `space`.
```javascript
rebounds.stretch(
{width: 100, height: 100},
{width: 200, height: 50}
);
// => {width: 100, height: 100, x: 0, y: 0}
```
### rebounds.position(space, rect, options = {positionX: 0.5, positionY: 0.5})
Returns coordinates of `rect` repositioned against `space`.
```javascript
rebounds.position(
{width: 100, height: 100},
{width: 200, height: 50}
);
// => {x: -50, y: 25}
rebounds.position(
{width: 100, height: 100, x: 50, y: 50},
{width: 200, height: 50}
);
// => {x: 0, y: 75}
rebounds.position(
{width: 100, height: 100},
{width: 200, height: 50},
{
positionX: rebounds.LEFT, // rebounds.LEFT === 0
positionY: rebounds.BOTTOM // rebounds.BOTTOM === 1
}
);
// => {x: 0, y: 50}
```