MaskJPG

Alpha PNG → SVG + JPG

Installation

npm i @resolute/maskjpg

Examples

Simple <svg> with base64 encoded JPG

const maskjpg = require('@resolute/maskjpg');
const { svg } = await maskjpg('http://pngimg.com/uploads/pancake/pancake_PNG122.png');

Store JPG file and reference in <svg>

const maskjpg = require('@resolute/maskjpg');
const { svg, jpg } = await maskjpg('./local/path/to/image.png', {
  uri: '/img/image.jpg'
});
fs.promises.writeFile('/docroot/img/image.jpg', jpg);
console.log(svg); // <svg …</svg>

Usage

maskjpg

Param	Type	Description
input	string | Buffer	filename, URL, or Buffer of an alpha PNG
options	object	optional
options.width	number	Resize width of generated image. Default: input image width
options.quality	number	1-100 qaulity of JPG. Default: 80
options.uri	string	string Web path to JPG or undefined base64 encoded data uri (default).
options.attr	{[key: string]: string}	Attributes to add to <svg> tag. Default: none

Returns: Promise<{ svg: string, jpg: Buffer }>

Throws: If input is invalid.

Example

const maskjpg = require('@resolute/maskjpg');
const { 
  svg // <svg> string with base64 encoded JPG
} = await maskjpg('http://pngimg.com/uploads/pancake/pancake_PNG122.png', {
  width: 300,
  quality: 85,
  });

CLI

maskjpg http://pngimg.com/uploads/pancake/pancake_PNG122.png > pancake.svg