image2ascii 1.1.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 71a51c97ec1912badd506a37658d8187d74443cefafea2c1682192827185fb22
+  data.tar.gz: a454214604deff3235a94750af750c868db33fc0c9c19b1fcd610dae8d08e40d
+SHA512:
+  metadata.gz: 9012fe24c4a8888f22a5902921c5cabe047bc7c71d16df26f0520769c5f7576b229dfba09b7a58df8c9a121be9a7ff3d8ae78befda3cf0379125622ecdbf2c67
+  data.tar.gz: 220eaf2e542d95f1acae107933fa571b0f13c89592dda98dce08461997252be7019b8b026b695bd5d8a0c3dcd63dac80cc40b52db476c9a3625a1b0ac9879245

data/bin/image2ascii

@@ -0,0 +1,58 @@
+#!/usr/bin/env ruby
+require 'optparse'
+require 'image2ascii'
+
+options = {}
+OptionParser.new do |parser|
+  parser.banner = "Usage: image2ascii [image] [options]"
+
+  parser.on("-w", "--width N", Integer, "Width (in characters)") do |w|
+    options[:width] = w
+  end
+
+  parser.on("-t", "--terminal-percent N", Integer, "Width as percent of terminal size") do |t|
+    options[:term_width] = t
+  end
+
+  parser.on("-c COLOR", "--color COLOR", "Color in hex, rgb, or by name [examples: 'red', '255, 255, 255', '#FFFFFF']") do |c|
+    if c.include? ","
+        options[:color] = c.split(",").map{|x| x.to_i}
+    elsif c.include? "#"
+       options[:color] = c
+    else
+        options[:color] = c.to_sym
+    end
+  end
+
+  parser.on("-x CHARS", "--custom CHARS", "Custom characters in order of descending relative brightness [example: '@#-.']") do |x|
+    options[:chars] = x
+  end
+
+  parser.on("-i", '--invert', "Invert ASCII character order") do |i|
+    options[:invert] = true
+  end
+
+  parser.on("-b", "--block", "Print ASCII in block form") do |b|
+    options[:block] = true
+  end
+
+  parser.on("-g", "--greyscale", "Print ASCII in greyscale") do |b|
+    options[:color] = "greyscale"
+  end
+
+  parser.on("-h", "--help", "Prints this help") do
+    puts parser
+    exit
+  end
+
+end.parse!
+
+ascii = Image2ASCII.new(ARGV.pop)
+options[:width] = (ascii.winsize * (options[:term_width].to_f / 100)).to_i if options[:term_width]
+ascii.chars = options[:chars] if options[:chars]
+ascii.chars = ascii.chars.reverse if options[:invert]
+ascii.generate({
+    :width => options[:width],
+    :color => options[:color],
+    :block => options[:block]
+})

data/lib/image2ascii.rb

@@ -0,0 +1,82 @@
+#!/usr/bin/env ruby
+require 'io/console'
+require 'rmagick'
+require 'rainbow'
+require 'open-uri'
+
+
+class Image2ASCII
+
+    attr_reader :winsize
+    attr_accessor :chars
+
+    def initialize(uri)
+        @uri = uri
+        @winsize = IO.console.winsize[1]
+        @chars = %($@B%8&WM#*oahkbdpqwmZO0QLCJUYXzcvunxrjft/\\|()1{}[]?-_+~<>i!lI;:,"^`'.).reverse
+        #quantum conversion factor for dealing with quantum depth color values
+        @qcf = 1 
+        
+        if Magick::MAGICKCORE_QUANTUM_DEPTH > 16
+            raise "ImageMagick quantum depth is set to #{Magick::MAGICKCORE_QUANTUM_DEPTH}. It needs to be 16 or less"
+        elsif Magick::MAGICKCORE_QUANTUM_DEPTH == 16
+            #divides quantum depth color space into useable rgb values
+            @qcf = 257
+        end
+    end
+
+    def generate(args={})
+
+        args[:width]   ||= @winsize
+        args[:color]   ||= "full"
+        args[:hidden]  ||= false
+        args[:block]   ||= false
+        as_string = ""
+
+        #load the image
+        resource = URI.open(@uri)
+        img = Magick::ImageList.new
+        img.from_blob(resource.read)
+
+        #correct aspect ratio
+        img = img.scale(args[:width] / img.columns.to_f)
+        img = img.scale(img.columns, img.rows / 2)
+
+        img.each_pixel do |pixel, col, row|
+
+            #get RGB values and brightness of pixels
+            r = pixel.red / @qcf
+            g = pixel.green / @qcf
+            b = pixel.blue / @qcf
+            brightness = (0.2126*r + 0.7152*g + 0.0722*b)
+            #select from chars that are already pre-ordered in brightness
+            char_index = brightness / (255.0 / @chars.length)
+            char = @chars[char_index.floor]
+            as_string << char
+
+            chosen_color =
+            if args[:color] == "full"
+                [r, g, b]
+            elsif args[:color] == "greyscale"
+                [brightness, brightness, brightness]
+            else
+                args[:color]
+            end
+
+            if args[:block]
+                print Rainbow(" ").background(*chosen_color) if !args[:hidden]
+            else
+                print Rainbow(char).color(*chosen_color) if !args[:hidden]
+            end
+
+            #add line wrap once desired width is reached
+            if (col % (args[:width] - 1) == 0) and (col != 0)
+                print "\n" if !args[:hidden]
+                as_string << "\n"
+            end
+
+        end
+
+        return as_string
+    end 
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: image2ascii
+version: !ruby/object:Gem::Version
+  version: 1.1.4
+platform: ruby
+authors:
+- Michael Kofron
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-12-29 00:00:00.000000000 Z
+dependencies: []
+description: An RMagick-based ASCII art generator that allows custom characters, colors,
+  ands widths. Can also detect terminal window size for responsive output. Use with
+  code or with or in the command-line.
+email: kofronmichael@gmail.com
+executables:
+- image2ascii
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/image2ascii
+- lib/image2ascii.rb
+homepage: https://rubygems.org/gems/image2ascii
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/michaelkofron/image2ascii
+  documentation_uri: https://github.com/michaelkofron/image2ascii#image2ascii
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.3
+signing_key:
+specification_version: 4
+summary: Convert images to custom ASCII art with code or from the command-line
+test_files: []