ascii-image 0.1.0

data/lib/ascii-image.rb

@@ -0,0 +1,71 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'RMagick'
+require 'rainbow'
+
+# == Summary
+# 
+# This handy Ruby gem will help you to create awesome ASCII art from images
+# for your awesome command-line projects.
+# 
+# == Example
+# 
+#   ascii = ASCII_Image.new("file.jpg")
+#   ascii.build(80)
+# 
+# == Contact
+# 
+# Author:: Nathan Campos (nathanpc@dreamintech.net)
+# Website:: http://about.me/nathanpc
+
+class ASCII_Image
+    # Initialize the ASCII_Image class.
+    # 
+    # An Error is raised if your ImageMagick quantum depth is higher than 8.
+    # 
+    # Arguments:
+    #   file: (String)
+    #   console_width: (Integer)
+    
+    def initialize(file, console_width = 80)
+        @file = file
+        @console_width = console_width
+        
+        if Magick::QuantumDepth > 8
+            raise "Your ImageMagick quantum depth is set to #{Magick::QuantumDepth}. You need to have it set to 8 in order for this app to work."
+        end
+    end
+    
+    # Convert the image into ASCII and print it to the console.
+    # 
+    # An ArgumentError is raised if the +width+ is bigger than the +console_width+
+    # 
+    # Arguments:
+    #   width: (Integer)
+    
+    def build(width)
+        # Open the image file
+        image = Magick::Image.read(@file)[0]
+        
+        # Resize to the desired "text-pixel" size
+        if width > @console_width
+            raise ArgumentError, "The desired width is bigger than the console width"
+        end
+        
+        image = image.scale(width / image.columns.to_f)
+        # Compensate the height of the console "text-pixel"
+        image = image.scale(image.columns, image.rows / 1.7)
+        
+        # Get the pixel array
+        image.each_pixel do |pixel, col, row|
+            print " ".background(pixel.red, pixel.green, pixel.blue)
+            
+            if (col % (width - 1) == 0) and (col != 0)
+                print "\n"
+            end
+        end
+        
+        print "\n"
+    end
+end

metadata

@@ -0,0 +1,46 @@
+--- !ruby/object:Gem::Specification
+name: ascii-image
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Nathan Campos
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-04 00:00:00.000000000 Z
+dependencies: []
+description: A Ruby gem to convert images into ASCII for your awesome command-line
+  applications
+email: nathanpc@dreamintech.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ascii-image.rb
+homepage: https://github.com/nathanpc/ascii-image
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Convert images into ASCII
+test_files: []