Package Exports

image-to-ascii

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (image-to-ascii) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Image to ASCII

A Node.JS module that converts images to ASCII art.

Installation

Install Graphics Magick.

# Ubuntu
$ sudo apt-get install graphicsmagick

# OS X
$ brew install graphicsmagick

# Chocolatey (package manager for Windows)
# (Restart of cmd/PowerShell is required)
$ choco install graphicsmagick

Then you can use this library.

$ npm install image-to-ascii

Example

var ImageToAscii = require("../lib/index");

ImageToAscii(__dirname + "/octocat.png", function(err, converted) {
    console.log(err || converted);
});

Example

Documentation

`ImageToAscii(options, callback)`

Converts the provided image in ASCII art.

Params

Object|String options: The path to the image or an object containing the following fields:
path (String): The path to the image.
pixels (String|Array): The pixels that will be used to render the ASCII image (default: " .,:;i1tfLCG08@").
pxWidth (Number): The pixel width used for aspect ratio (default: 2).
reverse (Boolean): If true, the pixels will be reversed (default: false).
colored (Boolean): If true, the result will be colored (default: true).
aRatio (Boolean): If true, the aspect ratio will be kept (default: false).
size (Object): The size of the result image (ASCII art):
- height (Number|String): The height value (default: "100%").
- width (Number|String): The width value (default: computed value to keep aspect ratio).
Function callback: The callback function.

How to contribute

File an issue in the repository, using the bug tracker, describing the contribution you'd like to make. This will help us to get you started on the right foot.
Fork the project in your account and create a new branch: your-great-feature.
Commit your changes in that branch.
Open a pull request, and reference the initial issue in the pull request message.

Changelog

See the releases page.

License

See the LICENSE file.