Big Ears

Implementation of Face Generator by The Visual Team. Licensed under CC BY 4.0.

note

While our code is MIT licensed, the design is licensed under CC BY 4.0. See license overview for more information.

Usage

HTTP-API (recommended)

Our free HTTP-API is the easiest way to use this avatar style. Just use the following URL as image source.

https://avatars.dicebear.com/api/big-ears/:seed.svg

See the HTTP API documentation for more information.

NPM

Install the Avatars and this avatar style with the following command.

npm install --save @dicebear/avatars @dicebear/big-ears

Now you are ready to create your first Avatar.

import { createAvatar } from '@dicebear/avatars';

import * as style from '@dicebear/big-ears';

let svg = createAvatar(style, {

seed: 'custom-seed',

// ... and other options

});

Options

Base options

seed Seed Alias: s Default: undefined Type: string

dataUri Data URI Default: false Type: boolean

flip Flip Default: false Type: boolean

rotate Rotate Default: 0 Type: integer Minimum: 0 Maximum: 360

scale Scale Default: 100 Type: integer Minimum: 0 Maximum: 200

radius Radius Alias: r Default: 0 Type: integer Minimum: 0 Maximum: 50

size Size Default: undefined Type: integer Minimum: 1

backgroundColor Background Color Alias: b Default: undefined Type:

translateX Translate X% Default: 0 Type: integer Minimum: -100 Maximum: 100

translateY Translate Y% Default: 0 Type: integer Minimum: -100 Maximum: 100

Style options

hair Hair Default: long20, long19, long18, long17, long16, long15, long14, long13, long12, long11, long10, long09, long08, long07, long06, long05, long04, long03, long02, long01, short20, short19, short18, short17, short16, short15, short14, short13, short12, short11, short10, short09, short08, short07, short06, short05, short04, short03, short02, short01 Type: array Items: Type: string Enum: long20, long19, long18, long17, long16, long15, long14, long13, long12, long11, long10, long09, long08, long07, long06, long05, long04, long03, long02, long01, short20, short19, short18, short17, short16, short15, short14, short13, short12, short11, short10, short09, short08, short07, short06, short05, short04, short03, short02, short01

face Face Default: variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01 Type: array Items: Type: string Enum: variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

mouth Mouth Default: variant0708, variant0707, variant0706, variant0705, variant0704, variant0703, variant0702, variant0701, variant0405, variant0605, variant0604, variant0603, variant0602, variant0601, variant0505, variant0504, variant0503, variant0502, variant0501, variant0404, variant0403, variant0402, variant0401, variant0305, variant0304, variant0303, variant0302, variant0301, variant0205, variant0204, variant0203, variant0202, variant0201, variant0105, variant0104, variant0103, variant0102, variant0101 Type: array Items: Type: string Enum: variant0708, variant0707, variant0706, variant0705, variant0704, variant0703, variant0702, variant0701, variant0405, variant0605, variant0604, variant0603, variant0602, variant0601, variant0505, variant0504, variant0503, variant0502, variant0501, variant0404, variant0403, variant0402, variant0401, variant0305, variant0304, variant0303, variant0302, variant0301, variant0205, variant0204, variant0203, variant0202, variant0201, variant0105, variant0104, variant0103, variant0102, variant0101

ear Ear Default: variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01 Type: array Items: Type: string Enum: variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

eyes Eyes Default: variant32, variant31, variant30, variant29, variant28, variant27, variant26, variant25, variant24, variant23, variant22, variant21, variant20, variant19, variant18, variant17, variant16, variant15, variant14, variant13, variant12, variant11, variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01 Type: array Items: Type: string Enum: variant32, variant31, variant30, variant29, variant28, variant27, variant26, variant25, variant24, variant23, variant22, variant21, variant20, variant19, variant18, variant17, variant16, variant15, variant14, variant13, variant12, variant11, variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

cheek Cheek Default: variant06, variant05, variant04, variant03, variant02, variant01 Type: array Items: Type: string Enum: variant06, variant05, variant04, variant03, variant02, variant01

cheekProbability Cheek Probability Default: 50 Type: integer Minimum: 0 Maximum: 100

nose Nose Default: variant12, variant11, variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01 Type: array Items: Type: string Enum: variant12, variant11, variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

sideburn Sideburn Default: variant07, variant06, variant05, variant04, variant03, variant02, variant01 Type: array Items: Type: string Enum: variant07, variant06, variant05, variant04, variant03, variant02, variant01

frontHair Front Hair Default: variant12, variant11, variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01 Type: array Items: Type: string Enum: variant12, variant11, variant10, variant09, variant08, variant07, variant06, variant05, variant04, variant03, variant02, variant01

hairColor Hair Color Default: variant01, variant02, variant03, variant04, variant05, variant06, variant07, variant08, variant09, variant10 Type: array Items: Type: string Enum: variant01, variant02, variant03, variant04, variant05, variant06, variant07, variant08, variant09, variant10 or Type: string Pattern: ^#([a-fA-F0-9]{3}|[a-fA-F0-9]{4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$

skinColor Skin Color Default: variant01, variant02, variant03, variant04, variant05 Type: array Items: Type: string Enum: variant01, variant02, variant03, variant04, variant05 or Type: string Pattern: ^#([a-fA-F0-9]{3}|[a-fA-F0-9]{4}|[a-fA-F0-9]{6}|[a-fA-F0-9]{8})$