Avatar Builder

Avatar builder, build multi avatar (cat, github, 8bit, square, identicon, etc) or compose avatar

Install

npm install avatar-builder --save

Usage

const Avatar = require('avatar-builder').default;

const avatar = Avatar.builder(Avatar.Image.margin(Avatar.Image.circleMask(Avatar.Image.identicon())),128,128, {cache: Avatar.Cache.lru()});
avatar.create('gabriel').then(buffer => fs.writeFileSync('avatar-gabriel.png', buffer));
avatar.create('allaigre').then(buffer => fs.writeFileSync('avatar-allaigre.png', buffer));

import Avatar from 'avatar-builder';

const avatar = Avatar.builder(Avatar.Image.margin(Avatar.Image.circleMask(Avatar.Image.identicon())),128,128, {cache: Avatar.Cache.lru()});
avatar.create('gabriel').then(buffer => fs.writeFileSync('avatar-gabriel.png', buffer));
avatar.create('allaigre').then(buffer => fs.writeFileSync('avatar-allaigre.png', buffer));

Content typescript definition

More example in sample.js

Predefined avatar

Triangle

Example 1 :

const Avatar = require('avatar-builder').default;

const avatar = Avatar.triangleBuilder(128);

avatar.create('gabriel').then(buffer => {/* png buffer */});

Square

Source : https://github.com/flouthoc/minBlock.js

Example 1 :

const Avatar = require('avatar-builder').default;

const avatar = Avatar.squareBuilder(128);

avatar.create('gabriel').then(buffer => {/* png buffer */});

Identicon

Source : https://github.com/donpark/identicon

Example 1 :

const Avatar = require('avatar-builder').default;

const avatar = Avatar.identiconBuilder(128);

avatar.create('gabriel').then(buffer => {/* png buffer */});

GitHub

Example 1 :

const Avatar = require('avatar-builder').default;

const avatar = Avatar.githubBuilder(128);

avatar.create('gabriel').then(buffer => {/* png buffer */});

Cat

Images sources : CC-By 4.0 attribution: David Revoy https://framagit.org/Deevad/cat-avatar-generator

Example 1 :

const Avatar = require('avatar-builder').default;

const avatar = Avatar.catBuilder(128);

avatar.create('gabriel').then(buffer => {/* png buffer */});

Example 2 :

const Avatar = require('avatar-builder').default;

const avatar = Avatar.builder(
                 Avatar.Image.margin(Avatar.Image.roundedRectMask(Avatar.Image.compose(
                   Avatar.Image.randomFillStyle(),
                   Avatar.Image.shadow(Avatar.Image.margin(Avatar.Image.cat(), 8), {blur: 5, offsetX: 2.5, offsetY: -2.5,color:'rgba(0,0,0,0.75)'})
                 ), 32), 8),
                 128, 128);

avatar.create('gabriel').then(buffer => {/* png buffer */});

8 bit

Images sources : https://github.com/o1egl/govatar

Example 1 :

const Avatar = require('avatar-builder').default;

const avatar = Avatar.male8bitBuilder(128);

avatar.create('gabriel').then(buffer => {/* png buffer */});

Example 2 :

const Avatar = require('avatar-builder').default;

const avatar = Avatar.female8bitBuilder(128);

avatar.create('gabriel').then(buffer => {/* png buffer */});

Cache

Compose cache

Example, cache with lru and folder

const Avatar = require('avatar-builder').default;

const avatar = Avatar.catBuilder(128, { cache: Avatar.Cache.compose(Avatar.Cache.lru(), Avatar.Cache.folder()) });

avatar.create('gabriel').then(buffer => {/* png buffer */});

Functions

Builder

function	description
Avatar.builder(image,width,height,options)	Create a avatar builder with image builder and size and options
Avatar.catBuilder(size,options)	Create a cat avatar builder with size and options
Avatar.githubBuilder(size,precision,options)	Create a github avatar builder with size and options
Avatar.triangleBuilder(size,prevision,colors,options)	Create a triangle avatar builder with size and options
Avatar.identiconBuilder(size,options)	Create a identicon avatar builder with size and options
Avatar.squareBuilder(size,precision,colors,options)	Create a square avatar builder with size and options
Avatar.female8bitBuilder(size,options)	Create a 8bit female avatar builder with size and options
Avatar.male8bitBuilder(size,options)	Create a 8bit male avatar builder with size and options

Image builder

function	description
Avatar.Image.compose(images)	Compose images
Avatar.Image.random(images)	Choose random image in list
Avatar.Image.margin(image,margin)	Add margin to image
Avatar.Image.fillStyle(fillStyle)	Solid image with color
Avatar.Image.randomFillStyle(fillStyles)	Solid image with random color
Avatar.Image.circleMask(image)	Circle mask
Avatar.Image.roundedRectMask(image,radius)	Rounded rect mask
Avatar.Image.shadow(image,shadow)	Add shadow below image
Avatar.Image.scoreShadow(image,shadowColor)	Add score shadow above image
Avatar.Image.longShadow(image,shadowColor)	Add long shadow below image
Avatar.Image.group(pathLocation,groups)	Compose png by group
Avatar.Image.identicon(patchSize,backgroundColor)	Create a identicon image
Avatar.Image.square(precision,colors)	Create mini block image
Avatar.Image.triangle(precision,colors)	Create triangle image
Avatar.Image.github(precision)	Create github image
Avatar.Image.cat()	Create cat image
Avatar.Image.male8bit()	Create male 8bit image
Avatar.Image.female8bit()	Create female 8bit image
Avatar.Image.grid(image,gridx,gridy)	Create grid with gridx * gridy images

Cache

function	description
Avatar.Cache.memory()	Use memory cache, all elements in map
Avatar.Cache.lru(options)	Use LRU cache (default max 50 elements)
Avatar.Cache.folder(location)	Save element in folder (default ./tmp/avatar)
Avatar.Cache.compose(caches)	Compose multi cache