img2ascii

KO | EN

gitlite — search

#api #php #hacktoberfest #css #ansible #game #swift #proxy #discourse-plugin #rails #jekyll #information-retrieval

★ 29 Open GitHub ↗

PHP Image-to-Ascii-Art Library

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Img2Asii
===========

> A small PHP library to generate ASCII art from images

Example Output
---------------

![Example Output](https://raw.githubusercontent.com/bylexus/img2ascii/master/example.png)

Installation
---------------

Install it using composer:

```bash
composer require bylexus/img2ascii
```

Usage
--------

```php
// Include the main class in your namespace:
use Img2Ascii\Processor;

$processor = new Processor('path/to/img.png');

// Default Usage: Creates a b/w ascii-art textfile with 10px per char:
$processor->asciify()->result()->writeFile('output.txt');

// If you want to have some more control over the output:
$processor
    ->asciify(5)                      // pixel width per char
    ->result('#@Mm+:-.')              // Chars to use, from darkest to lightest
    ->writeFile('filename.txt','\n'); // filename and line ending char

// If you want to define the final output width instead of
// the pixel block width, use:
$processor->asciifyToWidth(100); // Creates 100 ascii chars in width

// Love colors instead of black/white? go ahead:
$processor
    ->asciify(10)
    ->colorResult('#')                      // In color mode, only a single char is used
    ->writeFile('filename.html','<br />');  // define line ending
```

... To be continued, work in progress ...

img2ascii

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README