Img-to-matterjs NPM

Images to Matterjs

Images to Matterjs (img-to-matterjs) is simple images transformation library. It transforms image(shape from image) into json file with matter js compatible vertices for creating custom matterjs physics objects.

What it does

Description

How it does

It loads images and convert into canvas image object then slice image then grab data bitmaps and iterate over to determine edge all founded sub blocks are redrawed to right position. Concave shape can be produced. Images are always processed horizontally so if image height > image width image is rotated.

Usage

Installation steps

npm install img-to-matterjs

Input json Config example:

{
    "input": "img/src",
    "output": "output/jsons",
    "imgIsJson": false,
    "splitBy": 0.10,
    "scale": 1,
    "precise": 0.5
}

Input json Config explained:

input: images input directory
output: json output directory
imgIsJson: whether produce one json with all images or json per image
splitBy: define thickness of one strip relative to image width value 0.1 means tenth of width
scale: define scale factor value 1 means don't scale
precise: defines how high detail (density) of vertices will be produced value 0.25 means reduction down to one quarter

Run programatically

let itm = require('img-to-matterjs');

let config = {
    "input": "img/src",
    "output": "output/jsons",
    "imgIsJson": false,
    "splitBy": 0.10,
    "scale": 1,
    "precise": 0.5
}

itm(config);