pixelart 0.1.4 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 627a2802ea7e3ad7a10490ea4f721d57a4007669fe59a0b6cc17fb798c60b7a7
-  data.tar.gz: 8edd801f96debe5b664f31180510ea103469f1f62e5f4ee88959046718350b7f
+  metadata.gz: 4ebe6ddb193d15d611f37461ebca0f7de77d9df6d14c0078eeb483fcdcaf505e
+  data.tar.gz: 773ab34615671bb06b4e8b8e77096cc9e44588ec5c1b04662474e410a0382223
 SHA512:
-  metadata.gz: 8bdff35694d0212e5c48799be188b1cfeef29bd24e48f46fab6e387f5dcdcde3063105db5fd1cab21f8b03ce12c1420fb5abed0f59ae42801b57164ff6682e08
-  data.tar.gz: de54f3cc88c6dd7e198abdba49eb7549c1ae18c018a24695ccc676dee94360b9fed68f0e415ce92060993fd1323f4c5cfd40831b5411bf7db0fb008d67951f60
+  metadata.gz: 50f927ae70136c40e9d8bcac7c7c87641dc51427fbf5abaf2a88f1312327e83f59689b597b91e0d9003887a349b10fd20ce4be2ba7bf7baf1b9cebd2df2ee7b5
+  data.tar.gz: 6afea4ef51112243f065b7071d26c4ae6a70b3c408015838ab01a02d38a3a53ff3f14f04c7cd9746520c6be10f4153eba8b6533e4a52726dc531a7d54e250c29

data/Manifest.txt

@@ -7,6 +7,8 @@ lib/pixelart/base.rb
 lib/pixelart/color.rb
 lib/pixelart/gradient.rb
 lib/pixelart/image.rb
+lib/pixelart/led.rb
 lib/pixelart/misc.rb
 lib/pixelart/palette.rb
+lib/pixelart/pixelator.rb
 lib/pixelart/version.rb

data/README.md

@@ -3,8 +3,8 @@
 pixelart  - mint your own pixel art images off chain using any design (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes
 
 
-* home  :: [github.com/cryptocopycats/mooncats](https://github.com/cryptocopycats/mooncats)
-* bugs  :: [github.com/cryptocopycats/mooncats/issues](https://github.com/cryptocopycats/mooncats/issues)
+* home  :: [github.com/rubycoco/pixel](https://github.com/rubycoco/pixel)
+* bugs  :: [github.com/rubycoco/pixel/issues](https://github.com/rubycoco/pixel/issues)
 * gem   :: [rubygems.org/gems/pixelart](https://rubygems.org/gems/pixelart)
 * rdoc  :: [rubydoc.info/gems/pixelart](http://rubydoc.info/gems/pixelart)
 
@@ -71,8 +71,8 @@ img3x.save( './i/mooncat_white-3x.png' )
 
 Voila!
 
-![](https://github.com/cryptocopycats/mooncats/raw/master/pixelart/i/mooncat_white.png)
-![](https://github.com/cryptocopycats/mooncats/raw/master/pixelart/i/mooncat_white-3x.png)
+![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/mooncat_white.png)
+![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/mooncat_white-3x.png)
 
 
 
@@ -100,8 +100,8 @@ img3x.save( './i/mooncat_black-3x.png' )
 
 Voila! Black is the new White!
 
-![](https://github.com/cryptocopycats/mooncats/raw/master/pixelart/i/mooncat_black.png)
-![](https://github.com/cryptocopycats/mooncats/raw/master/pixelart/i/mooncat_black-3x.png)
+![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/mooncat_black.png)
+![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/mooncat_black-3x.png)
 
 
 
@@ -227,8 +227,8 @@ img5x.save( './i/vader5x.png' )
 
 Voila!
 
-![](https://github.com/cryptocopycats/mooncats/raw/master/pixelart/i/vader.png)
-![](https://github.com/cryptocopycats/mooncats/raw/master/pixelart/i/vader5x.png)
+![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/vader.png)
+![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/vader5x.png)
 
 
 

data/Rakefile

@@ -8,7 +8,7 @@ Hoe.spec 'pixelart' do
   self.summary = "pixelart - mint your own pixel art images off chain using any design (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes"
   self.description = summary
 
-  self.urls    = { home: 'https://github.com/cryptocopycats/mooncats' }
+  self.urls    = { home: 'https://github.com/rubycoco/pixel' }
 
   self.author  = 'Gerald Bauer'
   self.email   = 'wwwmake@googlegroups.com'

data/lib/pixelart/base.rb

@@ -15,8 +15,14 @@ require 'pixelart/gradient'
 require 'pixelart/palette'
 require 'pixelart/image'
 
+require 'pixelart/pixelator'
+
 require 'pixelart/misc'   ## misc helpers
 
+require 'pixelart/led'    ## (special) effects / filters
+
+
+
 
 ##########
 #  add some spelling convenience variants
@@ -25,9 +31,8 @@ PixelArt = Pixelart
 module Pixelart
   Palette256 = Palette8Bit = Palette8bit
 
-  class Image
-    Palette256 = Palette8Bit = Palette8bit
-  end
+  Palette256Image = Palette8BitImage = Palette8bitImage =
+  ImagePalette256 = ImagePalette8Bit = ImagePalette8bit
 end
 
 

data/lib/pixelart/color.rb

@@ -7,7 +7,6 @@ class Color
   WHITE       = 0xffffffff   # rgba(255,255,255,255)
 
 
-
   def self.parse( color )
     if color.is_a?( Integer )  ## e.g. assumes ChunkyPNG::Color.rgb() or such
       color ## pass through as is 1:1

data/lib/pixelart/image.rb

@@ -9,7 +9,14 @@ def self.read( path )   ## convenience helper
 end
 
 
-def self.parse( pixels, colors: )
+
+CHARS = '.@xo^~%*+=:'     ## todo/check: rename to default chars or such? why? why not?
+
+## todo/check: support default chars encoding auto-of-the-box always
+##                  or require user-defined chars to be passed in - why? why not?
+def self.parse( pixels, colors:, chars: CHARS )
+  has_keys  = colors.is_a?(Hash)   ## check if passed-in user-defined keys (via hash table)?
+
   colors = parse_colors( colors )
   pixels = parse_pixels( pixels )
 
@@ -20,7 +27,19 @@ def self.parse( pixels, colors: )
 
   pixels.each_with_index do |row,y|
     row.each_with_index do |color,x|
-      pixel = colors[color]
+      pixel = if has_keys     ## if passed-in user-defined keys check only the user-defined keys
+                colors[color]
+              else
+                ## try map ascii art char (.@xo etc.) to color index (0,1,2)
+                ##   if no match found - fallback on assuming draw by number (0 1 2 etc.) encoding
+                pos = chars.index( color )
+                if pos
+                  colors[ pos.to_s ]
+                else ## assume nil (not found)
+                  colors[ color ]
+                end
+              end
+
       img[x,y] = pixel
     end # each row
   end # each data
@@ -98,7 +117,7 @@ PALETTE8BIT = {
 
 def change_palette8bit( palette )
   ## step 0: mapping from grayscale to new 8bit palette (256 colors)
-  color_map = if palette.is_a( String ) || palette.is_a( Symbol )
+  color_map = if palette.is_a?( String ) || palette.is_a?( Symbol )
                  PALETTE8BIT[ palette.to_sym ]
                  ## todo/fix: check for missing/undefined palette not found - why? why not?
               else
@@ -170,6 +189,9 @@ def []=( x, y, value )  @img[x,y]=value; end
 
 def pixels()       @img.pixels; end
 
+### todo/check: add colors()  e.g. @img.pixels.uniq  - why? why not?
+
+
 ## return image ref - use a different name - why? why not?
 ##   change to to_image  - why? why not?
 def image()        @img; end
@@ -183,10 +205,7 @@ def self.parse_pixels( pixels )
   data = []
   pixels.each_line do |line|
     line = line.strip
-    if line.empty?
-      puts "!! WARN: skipping empty line in pixel art source"
-      next
-    end
+    next if line.start_with?( '#' ) || line.empty?   ## note: allow comments and empty lines
 
     ## note: allow multiple spaces or tabs to separate pixel codes
     ##  e.g.   o o o o o o o o o o o o dg lg w w lg w lg lg dg dg w w  lg dg o o o o o o o o o o o
@@ -197,12 +216,13 @@ def self.parse_pixels( pixels )
 end
 
 
+
 def self.parse_colors( colors )
   if colors.is_a?( Array )   ## convenience shortcut
     ## note: always auto-add color 0 as pre-defined transparent - why? why not?
     h = { '0' => Color::TRANSPARENT }
     colors.each_with_index do |color, i|
-       h[ (i+1).to_s ] = Color.parse( color )
+      h[ (i+1).to_s ] = Color.parse( color )
     end
     h
   else  ## assume hash table with color map
@@ -215,7 +235,6 @@ def self.parse_colors( colors )
 end
 
 
-
 end # class Image
 end  # module Pixelart
 

data/lib/pixelart/led.rb

@@ -0,0 +1,37 @@
+module Pixelart
+
+
+class Image
+  def led( led=8, spacing: 2, round_corner: false )
+
+    width  = @img.width*led  + (@img.width-1)*spacing
+    height = @img.height*led + (@img.height-1)*spacing
+
+    puts "  #{width}x#{height}"
+
+    img = Image.new( width, height, Color::BLACK )
+
+    @img.width.times do |x|
+      @img.height.times do |y|
+        pixel = @img[x,y]
+        pixel = Color::BLACK  if pixel == Color::TRANSPARENT
+        led.times do |n|
+          led.times do |m|
+            ## round a little - drop all four corners for now
+            next  if round_corner &&
+                    [[0,0],[0,1],[1,0],[1,1],[0,2],[2,0],
+                     [0,led-1],[0,led-2],[1,led-1],[1,led-2],[0,led-3],[2,led-1],
+                     [led-1,0],[led-1,1],[led-2,0],[led-2,1],[led-1,2],[led-3,0],
+                     [led-1,led-1],[led-1,led-2],[led-2,led-1],[led-2,led-2],[led-1,led-3],[led-3,led-1],
+                    ].include?( [n,m] )
+            img[x*led+n + spacing*x,
+                y*led+m + spacing*y] = pixel
+          end
+        end
+      end
+    end
+    img
+  end
+end # class Image
+end # module Pixelart
+

data/lib/pixelart/misc.rb

@@ -1,8 +1,7 @@
 module Pixelart
 
 
-class Image
-class Palette8bit < Image  # or use Palette256 alias?
+class ImagePalette8bit < Image  # or use Palette256 alias?
   def initialize( colors, size: 1, spacing: nil )
     ## todo/check: change size arg to pixel or such? better name/less confusing - why? why not?
 
@@ -16,6 +15,9 @@ class Palette8bit < Image  # or use Palette256 alias?
     img = ChunkyPNG::Image.new( 32*size+(32-1)*spacing,
                                  8*size+(8-1)*spacing )
 
+
+    colors =colors.map {|color| Color.parse( color ) }
+
     colors.each_with_index do |color,i|
       y,x = i.divmod( 32 )
       if size > 1
@@ -32,9 +34,33 @@ class Palette8bit < Image  # or use Palette256 alias?
 
     super( img.width, img.height, img )
   end
-end # class Palette8bit
+end # class ImagePalette8bit
+
+
+
+class ImageColorBar < Image
+  ## make a color bar
+  ##  keep auto-zoom 24x or such - why? why not?
+  def initialize( colors, size: 24 )
+    img = ChunkyPNG::Image.new( colors.size*size,
+                                size,
+                                ChunkyPNG::Color::WHITE ) # why? why not?
+
+    colors = colors.map {|color| Color.parse( color ) }
+
+    colors.each_with_index do |color,i|
+      size.times do |x|
+        size.times do |y|
+          img[x+size*i,y] = color
+        end
+      end
+    end
+
+    super( img.width, img.height, img )
+  end
+end  # class ImageColorBar
+
 
-end # class Image
 end # module Pixelart
 
 

data/lib/pixelart/pixelator.rb

@@ -0,0 +1,117 @@
+module Pixelart
+
+
+class Pixelator    # or use Minifier or such - rename - why? why not?
+
+  def initialize( img, width=24, height=24 )
+    @img    = img.is_a?( Image ) ? img.image : img  ## "unwrap" if Pixelart::Image
+    @width  = width
+    @height = height
+
+    ## calculate pixel size / density / resolution
+    ##   how many pixels per pixel?
+    @xsize, @xoverflow = img.width.divmod( width )
+    @ysize, @yoverflow = img.height.divmod( height )
+
+    puts "minify image size from (#{@img.width}x#{@img.height}) to (#{width}x#{height})"
+    puts "  pixel size (#{@xsize}x#{@ysize}) - #{@xsize*@ysize} pixel(s) per pixel"
+    puts "    overflow x: #{@xoverflow}, y: #{@yoverflow} pixel(s)"    if @xoverflow > 0 || @yoverflow > 0
+  end
+
+
+  def grid( spacing: 10 )
+    width  = @img.width  + (@width-1)*spacing
+    height = @img.height + (@height-1)*spacing
+
+    img = ChunkyPNG::Image.new( width, height, ChunkyPNG::Color::WHITE )
+
+    @img.width.times do |x|
+      xpixel = x/@xsize
+      @img.height.times do |y|
+        ypixel = y/@ysize
+
+        ## clip overflow pixels
+        xpixel = @width-1   if xpixel >= @width
+        ypixel = @height-1  if ypixel >= @height
+
+        color = @img[x,y]
+        img[x + spacing*xpixel,
+            y + spacing*ypixel] = color
+      end
+    end
+
+    Image.new( img.width, img.height, img )  ## wrap in Pixelart::Image - why? why not?
+  end
+
+
+  # pixels by coordinates (x/y) with color statistics / usage
+  def pixels
+    @pixels ||= begin
+                  pixels = []
+                  @img.width.times do |x|
+                    xpixel = x/@xsize
+                    @img.height.times do |y|
+                      ypixel = y/@ysize
+
+                      ## skip/cut off overflow pixels
+                      next if xpixel >= @width || ypixel >= @height
+
+                      color = @img[x,y]
+                      colors = pixels[xpixel+ypixel*@width] ||= Hash.new(0)
+                      colors[ color ] += 1
+                    end
+                  end
+
+                  ## sort pixel colors by usage / count (highest first)
+                  pixels = pixels.map do |pixel|
+                                         pixel.sort do |l,r|
+                                                      r[1] <=> l[1]
+                                                    end.to_h
+                                      end
+                  pixels
+                end
+  end
+
+  def pixel(x,y)  pixels[x+y*@width]; end
+  alias_method :[], :pixel
+
+
+  def can_pixelate?
+    # check if any pixel has NOT a color with a 50% majority?
+    count = 0
+    @width.times do |x|
+      @height.times do |y|
+        pixel = pixel( x, y )
+        sum         = pixel.values.sum
+        color_count = pixel.values[0]
+        if color_count < (sum/2)
+          count += 1
+          ## todo/check: stor warn in a public errors or warns array - why? why not?
+          puts "!! WARN #{count} - pixel (#{x}/#{y}) - no majority (50%) color:"
+          pp pixel
+        end
+      end
+    end
+
+    count == 0    ## return true if not warnings found
+  end
+  alias_method :pixelate?, :can_pixelate?
+
+
+  def pixelate
+    img = ChunkyPNG::Image.new( @width, @height )
+
+    @width.times do |x|
+      @height.times do |y|
+        pixel = pixel( x, y )
+        color = pixel.keys[0]
+        img[x,y] = color
+      end
+    end
+
+    Image.new( img.width, img.height, img )  ## wrap in Pixelart::Image - why? why not?
+  end
+end  # class Pixelator
+end  # module Pixelart
+
+

data/lib/pixelart/version.rb

@@ -2,8 +2,8 @@
 module Pixelart
 
   MAJOR = 0
-  MINOR = 1
-  PATCH = 4
+  MINOR = 2
+  PATCH = 0
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pixelart
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.2.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-04-18 00:00:00.000000000 Z
+date: 2021-05-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chunky_png
@@ -77,10 +77,12 @@ files:
 - lib/pixelart/color.rb
 - lib/pixelart/gradient.rb
 - lib/pixelart/image.rb
+- lib/pixelart/led.rb
 - lib/pixelart/misc.rb
 - lib/pixelart/palette.rb
+- lib/pixelart/pixelator.rb
 - lib/pixelart/version.rb
-homepage: https://github.com/cryptocopycats/mooncats
+homepage: https://github.com/rubycoco/pixel
 licenses:
 - Public Domain
 metadata: {}