0.02
No commit activity in last 3 years
No release in over 3 years
A Ruby gem to convert images into ASCII for your awesome command-line applications
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 3.0.0, ~> 3.0
>= 2.16.0, ~> 2.16
 Project Readme

ascii-image

Gem Version
A Ruby gem to convert images into ASCII for your awesome command-line applications.
This is my first Ruby gem

Installation

This gem relies on RMagick, so you will need to ensure you install the prerequisites (ImageMagick).

Install in your terminal with:

gem install ascii-image

Or in your Gemfile:

gem 'ascii-image'

Example

Convert an image to ASCII and print it using 20 columns of the console:

ascii = ASCII_Image.new("~/my_image.jpg")
ascii.build(20)

or open the image from the web:

ascii = ASCII_Image.new("http://www.levihackwith.com/wp-content/uploads/2011/10/github-logo.png")
ascii.build(60)

License

This library is licensed under the GPLv3 license.

ascii-image - A Ruby gem to convert images into ASCII. Copyright (C) 2012 Nathan Campos

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.