/ascii-art-image

create ascii-art from images

Primary LanguageJavaScript

                   _  _                       _
                  (_)(_)                     | |
  __ _  ___   ___  _  _  ______   __ _  _ __ | |_
 / _` |/ __| / __|| || ||______| / _` || '__|| __|
| (_| |\__ \| (__ | || |        | (_| || |   | |_
 \__,_||___/ \___||_||_|         \__,_||_|    \__|

ascii-art-image.js

NPM version npm Travis

Installation

npm install ascii-art-image

Usage

require('ascii-art-image')

To do anything with it, you'll need to include the library:

const Image = require('ascii-art-image');

new Image(options)

the constructor takes an options argument

Kind: static property of ascii-art-image

Param Type Description
options Object the set of options being passed
options.alphabet string characters used to draw the image. One of: variant1, variant2, variant3, variant4, ultra-wide, wide, hatching, bits, binary, greyscale, blocks
options.filepath string The path of the image
options.width Int The width to render the image
options.height Int The height to render the image
options.distance function a function which takes in 6 args (2x rgb) and returns a measure of distance between these two colors

Examples

Image.create(options, callback)

Map through an ansi string one character at a time, without any of those characters being styles.

Kind: static property of ascii-art-image

Param Type Description
options Object the set of options being passed
options.alphabet string characters used to draw the image. One of: variant1, variant2, variant3, variant4, ultra-wide, wide, hatching, bits, binary, greyscale, blocks
options.filepath string The path of the image
options.width Int The width to render the image
options.height Int The height to render the image
options.distance function a function which takes in 6 args (2x rgb) and returns a measure of distance between these two colors

Examples

for example, say we want to generate a copy of a metropolis poster:

Image Output

You just need to do something like this:

var Image = require('ascii-art-image');

var image = new Image({
    filepath: '~/Images/metropolis.jpg',
    alphabet:'variant4'
});

image.write(function(err, rendered){
    console.log(rendered);
})

Image Output