https://github.com/tpkn/make-failover
Making failover images with a blink of an eye
https://github.com/tpkn/make-failover
Last synced: about 1 month ago
JSON representation
Making failover images with a blink of an eye
- Host: GitHub
- URL: https://github.com/tpkn/make-failover
- Owner: tpkn
- License: mit
- Created: 2018-09-19T19:19:40.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-09-01T22:03:45.000Z (almost 7 years ago)
- Last Synced: 2025-12-03T03:41:59.205Z (6 months ago)
- Language: JavaScript
- Size: 20.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Make Failover [](https://www.npmjs.org/package/make-failover)
Making failover images with a blink of an eye
A silent module based on [ImageMagick](https://imagemagick.org) for making failover images with specified properties.
## API
```javascript
await MakeFailover(output_path, width, height[, options])
```
### output_path
**Type**: _String_
Output file path with extension (`.jpg`, `.png`, `.gif`, `.svg`, ...)
### width
**Type**: _Number_
Image width, `> 0` and `<= 99999` pixels
### height
**Type**: _Number_
Image height, `> 0` and `<= 99999` pixels
### options.bin
**Type**: _String_
**Default**: `./bin/convert.exe`
Path to `convert.exe` file. This binary is not included, but you can [download it from here](https://imagemagick.org/script/download.php).
### options.quality
**Type**: _Number_
**Default**: `75`
### options.border_stroke
**Type**: _Number_
**Default**: `1`
Border stroke size
### options.border_color
**Type**: _String_
**Default**: `#000000`
### options.bg_color
**Type**: _String_
**Default**: `#ffffff`
### options.enable_macros
**Type**: _Boolean_
**Default**: `false`
Enable/disable replacing macros in output file name
| Macros | Result |
| ------ | ------ |
| `%width%` | `300` |
| `%height%` | `250` |
| `%size%` | `300x250` |
| `%time%` | `1537450293541` |
| `%uniq%` | `jmam7jgr0r` |
## Usage
```javascript
const path = require('path');
const MakeFailover = require('make-failover');
let width = 300;
let height = 250;
let output = path.join(__dirname, 'failover_%uniq%.jpg')
MakeFailover(width, height, output, {
enable_macros: true,
border_stroke: 20,
border_color: '#ff9900',
bg_color: '#00ffbb',
quality: 90
})
.then(result => {
// => C:/make-failover/failover_jmam7jgr0r.jpg
})
.catch(err => {})
```