pixelart 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 61a062dde7cebbcee3dfcf1f39e4ff384961bd773736f54c4959efc8d7c0a768
+  data.tar.gz: 0d533bfef5d9b4cc13c3323a64acba128a39ba0d97d5c87748033c7c2f2ceba6
+SHA512:
+  metadata.gz: 3dccdefa4552f08db7b118f63e6d33d9c0925ccd05bb0b4b6b92e5f419400ad313837e0c38afa9d74a7e8dd9a39bd8919ad4069563ff35901f8f1d18e877c035
+  data.tar.gz: fc33580f828311ffc4f73b329f2e22d93d387dc7d3b7146aa15d0045d048289860d4639469479fad057f6c3a1ca49124db474311540984a8f7ddef7ed00a172e

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+### 0.0.1 / 2021-04-08
+
+* Everything is new. First release

data/Manifest.txt

@@ -0,0 +1,6 @@
+CHANGELOG.md
+Manifest.txt
+README.md
+Rakefile
+lib/pixelart.rb
+lib/pixelart/version.rb

data/README.md

@@ -0,0 +1,246 @@
+# Pixel Art
+
+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)
+* gem   :: [rubygems.org/gems/pixelart](https://rubygems.org/gems/pixelart)
+* rdoc  :: [rubydoc.info/gems/pixelart](http://rubydoc.info/gems/pixelart)
+
+
+
+##  Usage
+
+Let's use the mooncat design #0 (Standing·Smile·Solid·Left)
+in the original 21×17 pixel format in ascii text:
+
+
+```ruby
+require 'pixelart'
+
+pixels =<<PIXELS
+0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 1 0 0
+0 0 0 0 0 0 0 0 0 0 0 1 3 1 0 0 0 1 3 1 0
+0 0 0 0 0 0 0 0 0 0 0 1 5 3 1 1 1 3 5 1 0
+0 1 1 1 0 0 0 0 0 0 1 1 3 3 3 3 3 3 3 1 1
+0 1 3 1 0 0 0 0 0 0 1 3 3 3 3 3 3 3 3 3 1
+1 3 1 1 0 1 1 1 1 1 1 3 3 1 3 3 3 1 3 3 1
+1 3 1 0 1 1 3 3 3 3 1 3 3 3 3 3 3 3 3 3 1
+1 3 1 0 1 3 3 3 3 3 1 3 3 4 3 5 3 4 3 3 1
+1 3 1 1 1 3 3 3 3 3 1 3 3 3 4 3 4 3 3 3 1
+1 1 3 3 3 3 3 3 3 3 3 1 3 3 3 3 3 3 3 1 0
+0 1 1 1 3 3 3 3 3 3 3 3 1 1 1 1 1 1 1 0 0
+0 0 0 1 3 3 3 3 3 3 3 3 3 3 3 3 3 3 1 0 0
+0 0 0 1 1 3 3 3 1 4 4 4 1 3 3 3 3 3 1 0 0
+0 0 0 0 1 1 3 3 3 1 4 1 3 3 1 3 3 1 0 0 0
+0 0 0 0 0 1 1 3 3 1 4 1 3 1 1 3 1 0 0 0 0
+0 0 0 0 0 0 1 1 3 5 1 1 5 1 1 5 1 0 0 0 0
+0 0 0 0 0 0 0 1 1 1 1 1 1 1 1 1 1 0 0 0 0
+PIXELS
+```
+
+And let's use the genesis white color scheme - super rare only 48 exist in the official MoonCatRescue blockchain contract state storage ;-):
+
+``` ruby
+colors = [
+  '#555555',   # color 1
+  '#d3d3d3',   # color 2
+  '#ffffff',   # color 3
+  '#aaaaaa',   # color 4
+  '#ff9999'    # color 5
+]
+```
+
+Note: The color 0 (transparent) is auto-magically added / defined.
+
+
+And let's mint a mooncat image:
+
+``` ruby
+img = Pixelart::Image.new( pixels, colors: colors )
+img.save( './i/mooncat_white.png' )
+```
+
+And let's try a 3x zoom factor:
+
+``` ruby
+img = Pixelart::Image.new( pixels, colors: colors, zoom: 3 )
+img.save( './i/mooncat_white-3x.png' )
+```
+
+Voila!
+
+![](i/mooncat_white.png)
+![](i/mooncat_white-3x.png)
+
+
+Let's change the colors to use the genesis black color scheme:
+
+``` ruby
+colors = [
+  '#555555',   # color 1
+  '#222222',   # color 2
+  '#111111',   # color 3
+  '#bbbbbb',   # color 4
+  '#ff9999'    # color 5
+]
+```
+
+And let's start minting:
+
+``` ruby
+img = Pixelart::Image.new( pixels, colors: colors )
+img.save( './i/mooncat_black.png' )
+
+img = Pixelart::Image.new( pixels, colors: colors, zoom: 3 )
+img.save( './i/mooncat_black-3x.png' )
+```
+
+Voila! Black is the new White!
+
+![](i/mooncat_black.png)
+![](i/mooncat_black-3x.png)
+
+
+
+
+## Yes, You Can - Use Your Own Pixel Designs
+
+Let's use the Darth Vader pixel art originally designed by
+Aral Tasher in CSS. See the [online demo »](https://codepen.io/araltasher/pen/ajdzNE)
+
+Let's cut-n-paste the pixel art matrix:
+
+
+``` ruby
+pixels = <<PIXELS
+o o o o o o o o o o o o o o o o o lg lg lg dg o o o o o o o o o o o o o o o o o
+o o o o o o o o o o o o o o dg lg lg w lg lg dg dg lg dg o o o o o o o o o o o o o o
+o o o o o o o o o o o o o dg lg w lg w lg lg dg dg w lg  dg o o o o o o o o o o o o o
+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
+o o o o o o o o o o o o dg dg w w lg w lg lg dg dg w w  dg dg o o o o o o o o o o o
+o o o o o o o o o o o dg dg dg lg w lg w lg lg dg dg w lg dg dg dg o o o o o o o o o o
+o o o o o o o o o o o dg dg dg w lg lg w lg lg dg dg lg w dg dg dg o o o o o o o o o o
+o o o o o o o o o o o dg dg w lg lg lg w lg lg dg dg lg lg w dg dg o o o o o o o o o o
+o o o o o o o o o o o dg lg lg b b b lg dg dg lg b b b lg lg dg o o o o o o o o o o
+o o o o o o o o o o o dg lg b b b b b lg lg b b b b b lg dg o o o o o o o o o o
+o o o o o o o o o o o lg b b db lg db b dg dg b lg db db b b lg o o o o o o o o o o
+o o o o o o o o o o lg b b b db db db b lg lg b db db db b b b lg o o o o o o o o o
+o o o o o o o o o o lg b b dg lg lg lg lg b b lg lg lg lg dg b b lg o o o o o o o o o
+o o o o o o o o o lg b b b dg dg dg dg lg b b lg dg dg dg dg b b b lg o o o o o o o o
+o o o o o o o o o lg b b b dg dg dg lg b b b b lg dg dg dg b b b lg o o o o o o o o
+o o o o o o o o lg b b b b b dg dg b dg b dg b b lg dg b b b b b lg o o o o o o o
+o o o o o o o o b b b b b b w b b dg b dg b dg b w b b b b b b o o o o o o o
+o o o o o o o o b b b b b b dg dg dg dg dg dg dg dg dg dg b b b b b b o o o o o o o
+o o o o o o o o o b b b b lg b b b b b b b b b b b b b b b o o o o o o o o
+o o o o o o o o o o o o b lg lg dg dg b b b b dg dg b b b o o o o o o o o o o o
+o o o o o o o o o o o o lg lg dg dg dg dg b b b dg dg dg dg b b o o o o o o o o o o
+o o o o o o o o o dg dg b dg dg dg dg dg dg dg dg dg dg dg dg dg dg dg b dg dg o o o o o o o
+o o o o o o o o dg dg b b lg lg lg lg lg lg lg lg lg lg lg lg lg lg lg b b dg dg o o o o o o
+o o o o o o o dg dg b lg b lg dg lg lg dg dg lg lg dg dg lg lg dg dg lg b lg b dg dg o o o o o
+o o o o o o dg dg b lg lg b lg dg lg lg dg dg lg lg dg dg lg lg dg dg lg b lg lg b dg dg o o o o
+o o o o o dg dg b b b b b lg dg lg lg dg dg lg lg dg dg lg lg dg dg lg b b b b b dg dg
+o o o o dg dg dg b dg dg b b b b lg lg dg dg lg lg dg dg lg lg b b b b dg dg dg b dg dg dg
+o o o dg dg dg b dg dg dg b b b dg b b dg dg lg lg dg dg b b b dg b b b dg dg dg b dg dg dg
+o o o dg dg b dg dg dg b b b dg dg dg b b b lg lg b b b dg dg dg b b b b dg dg dg b dg dg
+o o dg dg dg b dg dg b b b b dg dg dg b lg lg b b lg lg dg dg dg dg b b b b b dg dg b dg dg dg
+o o dg dg dg b dg b b b b b dg dg dg b b b b b b b dg b dg dg b b b b b b dg b dg dg dg
+o dg dg dg dg b dg b b b b b dg b dg b b lg lg b r b dg b dg dg b b b b b b dg b dg dg dg dg
+o dg dg dg dg b dg lg b b b b dg b dg b b b b b b b dg b dg dg b b b b b lg dg b dg dg dg dg
+o dg dg dg dg b lg dg lg b b b dg b dg b b lg lg b blu b dg b dg dg b b b b lg dg lg b dg dg dg dg
+o dg dg dg dg b dg lg dg lg b b dg b dg b b b b b b b dg b dg dg b b b lg dg lg dg b dg dg dg dg
+o dg dg dg dg b dg dg lg dg lg b dg b dg b lg lg lg lg lg lg b b dg dg b b lg dg lg dg dg b dg dg dg dg
+o dg dg dg dg b b dg dg lg dg b b b b b b b b b b b b b b b b b dg lg dg dg b b dg dg dg dg
+o dg dg dg dg b b b dg dg dg b lg b g b b lg lg lg lg b b g b lg b b dg dg dg b b b dg dg dg dg
+o dg dg dg dg b b b b dg b b b b b b b dg dg lg lg b b b b b b b b dg b b b b dg dg dg dg
+o dg dg dg dg b b b b b b b b b b b b b b b b b b b b b b b b b b b b b dg dg dg dg
+o dg dg dg dg b b b b b b b dg b dg b dg dg dg dg dg dg b dg b lg b b b b b b b b dg dg dg dg
+o dg dg dg b b b b b b b b dg b dg b dg dg dg dg dg dg b dg b lg dg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b b dg dg b dg dg dg dg dg dg b dg b dg dg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b b dg dg b b dg dg dg dg b b dg b w lg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b b dg dg b b dg dg dg dg b b dg b w lg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b b dg dg b dg b dg dg b dg b dg b lg dg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b b dg dg b dg dg b b dg dg b dg b dg dg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b dg dg dg b dg dg b dg dg dg b dg b lg dg b b b b b b b b dg dg dg
+o dg dg dg b b b b b b b b dg dg dg b dg dg b dg dg dg b dg b lg dg b b b b b b b b dg dg dg
+dg dg dg dg b b b b b b b b dg dg dg b dg dg b dg dg dg b dg b lg dg b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg dg dg b dg b b b dg dg b dg b b b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg dg dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg dg dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg b dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg b dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg b dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg b dg b dg b b b dg dg b dg b dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b b b b b dg b b b dg dg b b b b b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg lg dg dg dg b b b dg lg dg dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b b b b b b b dg lg dg dg dg b b b dg lg dg dg dg dg b b b b b b b b b dg dg dg dg
+dg dg dg dg b b o o o o o o b b b dg dg b b b dg dg dg b b b o o o o o o o b b dg dg dg dg
+o o dg dg o o o o o o o b lg lg dg b b b o o b b lg dg dg dg b o o o o o o b b dg dg dg dg
+o o o o o o o o o b lg lg dg dg dg dg dg b o o b dg lg lg dg dg dg b
+o o o o o o o o b dg dg dg dg dg dg dg dg b o o b dg dg dg dg dg dg b b
+o o o o ulg ulg ulg ulg b b b b b b b b b b ulg ulg b b b b b b b b b ulg ulg ulg ulg
+PIXELS
+```
+
+
+Note: Yes, you can use any number (e.g. `0` `1` `2` `3` etc)
+or shortcut (e.g. `o` `b` `ulg` `lg` etc) for pixels.
+Only make sure you have a color map matching your shortcuts.
+
+
+Let's add the color map:
+
+``` ruby
+colors = {
+   o:   'transparent',
+   b:   '#1D191A',
+   ulg: '#eaeaec',
+   lg:  '#747474',
+   db:  '#453C35',
+   dg:  '#343031',
+   w:   '#fff',
+   r:   '#fc3435',
+   blu: '#1F3A93',
+   g:   '#00943b'
+}
+```
+
+
+And let's mint an imperial master image:
+
+``` ruby
+img = Pixelart::Image.new( pixels, colors: colors )
+img.save( './i/vader.png' )
+```
+
+And let's try a 5x zoom factor:
+
+``` ruby
+img = Pixelart::Image.new( pixels, colors: colors, zoom: 5 )
+img.save( './i/vader5x.png' )
+```
+
+Voila!
+
+![](i/vader.png)
+![](i/vader5x.png)
+
+
+
+
+## Install
+
+Just install the gem:
+
+    $ gem install pixelart
+
+
+## License
+
+The scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.
+

data/Rakefile

@@ -0,0 +1,30 @@
+require 'hoe'
+require './lib/pixelart/version.rb'
+
+Hoe.spec 'pixelart' do
+
+  self.version = Pixelart::VERSION
+
+  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.author  = 'Gerald Bauer'
+  self.email   = 'wwwmake@googlegroups.com'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'CHANGELOG.md'
+
+  self.extra_deps = [
+    ['chunky_png'],
+  ]
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+    required_ruby_version: '>= 2.3'
+  }
+
+end

data/lib/pixelart.rb

@@ -0,0 +1,119 @@
+## 3rd party
+require 'chunky_png'
+
+## stdlib
+require 'pp'
+
+## our own code
+require 'pixelart/version'    # note: let version always go first
+
+
+
+module Pixelart
+class Image
+
+def initialize( pixels, colors:, zoom: 1 )
+  @colors = parse_colors( colors )
+  @pixels = parse_pixels( pixels )
+
+  max_width  = @pixels.reduce(1) {|max_width,row| row.size > max_width ? row.size : max_width }
+  max_height = @pixels.size
+
+  @img = ChunkyPNG::Image.new( max_width*zoom,
+                               max_height*zoom,
+                               ChunkyPNG::Color::TRANSPARENT )
+
+  @pixels.each_with_index do |row,y|
+    row.each_with_index do |color,x|
+      pixel = @colors[color]
+      zoom.times do |n|
+        zoom.times do |m|
+          @img[n+zoom*x,m+zoom*y] = pixel
+        end
+      end
+    end # each row
+  end # each data
+end
+
+
+def 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
+
+     ## 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
+     ##    or
+     data << line.split( /[ \t]+/)
+  end
+  data
+end
+
+
+#####
+# (image) delegates
+##   todo/check: add some more??
+def save( path, constraints = {} )
+  @img.save( path, constraints )
+end
+
+def width()        @img.width; end
+def height()       @img.height; end
+
+## return image ref - use a different name - why? why not?
+def image()        @img; end
+
+def colors()       @colors; end     ## todo/check - return color map (hash table) or just color values (array) - why? why not?
+
+
+
+######
+# helpers
+def 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' => ChunkyPNG::Color::TRANSPARENT }
+    colors.each_with_index do |color, i|
+       h[ (i+1).to_s ] = parse_color( color )
+    end
+    h
+  else  ## assume hash table with color map
+    ## convert into ChunkyPNG::Color
+    colors.map do |key,color|
+      ## always convert key to string why? why not?  use symbol?
+      [ key.to_s, parse_color( color ) ]
+    end.to_h
+  end
+end
+
+def parse_color( color )
+  if color.is_a?( Integer )  ## e.g. Assumess ChunkyPNG::Color.rgb() or such
+    color ## pass through as is 1:1
+  elsif color.is_a?(String)
+    if color.downcase == 'transparent'   ## special case for builtin colors
+      ChunkyPNG::Color::TRANSPARENT
+    else
+      ## note: return an Integer !!! (not a Color class or such!!! )
+      ChunkyPNG::Color.from_hex( color )
+    end
+  else
+    raise ArgumentError, "unknown color format; cannot parse - expected rgb hex string e.g. d3d3d3"
+  end
+end
+
+
+end # class Image
+end  # module Pixelart
+
+
+
+### add some convenience shortcuts
+PixelArt = Pixelart
+
+
+
+puts Pixelart.banner    # say hello

data/lib/pixelart/version.rb

@@ -0,0 +1,22 @@
+
+module Pixelart
+
+  MAJOR = 0
+  MINOR = 1
+  PATCH = 0
+  VERSION = [MAJOR,MINOR,PATCH].join('.')
+
+  def self.version
+    VERSION
+  end
+
+  def self.banner
+    "pixelart/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}] in (#{root})"
+  end
+
+  def self.root
+    File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )
+  end
+
+end # module Pixelart
+

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: pixelart
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-04-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: chunky_png
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.22'
+description: 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
+email: wwwmake@googlegroups.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- lib/pixelart.rb
+- lib/pixelart/version.rb
+homepage: https://github.com/cryptocopycats/mooncats
+licenses:
+- Public Domain
+metadata: {}
+post_install_message:
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key:
+specification_version: 4
+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
+test_files: []