mooncats 0.1.2 → 1.1.1

data/config/v2/014.txt

@@ -0,0 +1,27 @@
+##############################
+# design: 14 - Pouncing Smiling Tortie Left
+# size: 17x22
+###########################
+
+0 0 0 1 0 0 0 0 0 1 1 0 0 0 0 0 0
+0 0 1 2 1 0 0 0 1 3 1 0 0 0 0 0 0
+0 0 1 4 2 1 1 1 3 4 1 0 0 0 0 0 0
+0 1 1 2 2 2 3 3 3 3 1 1 0 0 0 0 0
+0 1 2 2 2 2 2 3 3 3 3 1 0 0 0 0 0
+0 1 2 5 1 2 2 5 1 3 3 1 0 0 0 0 0
+0 1 2 2 2 2 2 2 3 3 3 1 0 0 0 0 0
+0 1 2 2 1 2 1 2 1 3 3 1 0 0 0 0 0
+0 1 2 2 2 1 2 1 3 3 3 1 0 0 0 0 0
+0 0 1 2 2 2 2 2 3 3 1 1 0 0 0 0 0
+1 1 3 1 1 1 1 1 1 1 3 1 1 1 0 0 0
+1 4 3 3 3 3 3 3 3 3 3 3 1 3 1 1 0
+1 1 1 3 3 1 1 1 2 3 3 3 1 1 3 1 0
+0 0 1 1 3 1 4 2 2 2 3 3 3 1 3 1 1
+0 0 0 1 3 3 1 1 2 2 3 3 3 1 1 3 1
+0 0 0 1 3 4 4 4 3 3 3 3 3 1 1 3 1
+0 0 0 1 1 4 4 4 3 1 1 1 2 1 2 2 1
+0 0 0 0 1 4 4 4 3 1 3 2 2 1 2 1 1
+0 0 0 0 1 2 4 4 3 3 3 2 2 2 1 1 0
+0 0 0 0 1 2 2 1 1 3 3 2 1 1 1 0 0
+0 0 0 0 1 1 4 1 1 1 1 2 1 0 0 0 0
+0 0 0 0 0 1 1 0 0 0 1 1 1 0 0 0 0

data/config/v2/015.txt

@@ -0,0 +1,29 @@
+##############################
+# design: 15 - Stalking Smiling Tortie Left
+# size: 20x21
+###########################
+
+0 0 0 0 0 0 0 0 0 0 1 1 1 1 1 1 0 0 0 0
+0 0 0 0 0 0 0 0 0 0 1 3 3 3 3 1 1 1 0 0
+0 0 0 0 0 0 0 0 0 0 1 3 1 1 3 3 3 1 0 0
+0 0 0 0 0 0 0 0 0 0 1 1 0 0 1 1 2 1 0 0
+0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 2 1 1 0
+0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 2 2 1 0
+0 0 1 1 0 0 0 0 1 1 0 0 0 1 1 1 1 1 1 0
+0 1 2 1 0 0 0 1 3 1 0 0 1 1 2 2 2 2 1 1
+1 2 4 2 1 1 1 3 4 3 1 1 1 3 3 2 2 2 3 1
+1 2 2 2 2 3 3 3 3 3 1 1 3 3 3 3 3 3 3 1
+1 2 2 2 2 2 3 3 3 3 1 3 3 3 3 3 3 3 3 1
+1 2 5 1 2 2 5 1 3 3 1 3 3 3 3 3 3 3 1 1
+1 2 2 2 2 2 2 3 3 3 1 3 3 3 3 3 3 3 1 0
+1 2 2 1 2 1 2 1 3 3 1 2 2 2 3 4 3 3 1 0
+1 2 2 2 1 2 1 3 3 3 1 2 2 4 4 4 3 3 1 0
+0 1 2 2 2 2 2 3 3 1 1 2 4 4 4 1 3 3 3 1
+0 0 1 1 1 1 1 1 1 2 2 2 1 1 1 1 1 2 3 1
+0 1 1 3 3 3 2 2 2 2 1 1 1 3 3 1 1 2 1 1
+1 1 3 3 3 1 2 2 1 1 1 1 4 3 1 1 2 2 1 0
+1 4 3 1 1 1 4 1 1 0 0 1 1 1 1 2 2 1 1 0
+1 1 1 1 0 1 1 1 0 0 0 0 0 0 1 1 1 1 0 0
+
+
+

data/lib/mooncats.rb

@@ -1,10 +1,9 @@
 ## 3rd party
-require 'chunky_png'
+require 'pixelart/base'
 require 'csvreader'
 
 
 ## extra stdlibs
-require 'fileutils'
 require 'optparse'
 
 
@@ -13,6 +12,7 @@ require 'optparse'
 require 'mooncats/version'    # note: let version always go first
 require 'mooncats/designs'
 require 'mooncats/structs'
+require 'mooncats/design'
 require 'mooncats/image'
 require 'mooncats/composite'
 require 'mooncats/dataset'
@@ -63,15 +63,20 @@ module Mooncats
         ## note: cut-off optionial 0x
         cat_id = cat_id[2..-1]   if cat_id.start_with?( '0x')
 
+        cat = Image.generate( cat_id )
+
         cat_name  = "mooncat-#{cat_id}"
 
         ##  if zoom - add x2,x4 or such
-        cat_name << "_x#{opts[:zoom]}"   if opts[:zoom] != 1
+        if opts[:zoom] != 1
+          cat = cat.zoom( opts[:zoom] )
+          cat_name << "_x#{opts[:zoom]}"
+        end
 
         path  = "#{opts[:outdir]}/#{cat_name}.png"
         puts "==> (#{index+1}/#{args.size}) minting mooncat 0x#{cat_id}; writing to >#{path}<..."
 
-        Image.generate( cat_id, zoom: opts[:zoom] ).save( path )
+        cat.save( path )
       end
 
       puts "done"
@@ -82,11 +87,24 @@ module Mooncats
   def self.main( args=ARGV )
     Tool.new.run( args )
   end
-  end ## module Mooncats
+end ## module Mooncats
+
+
+
+### add more built-in (load on demand) design series / collections
+DESIGNS_V2         = Mooncats::DesignSeries.new( "#{Mooncats.root}/config/v2" )
+DESIGNS_CRYPTOCATS = Mooncats::DesignSeries.new( "#{Mooncats.root}/config/cryptocats" )
 
 
 ### add some convenience shortcuts
 MoonCats = Mooncats
 
 
+
+
+###
+# note: for convenience auto include Pixelart namespace!!! - why? why not?
+include Pixelart
+
+
 puts Mooncats.banner    # say hello

data/lib/mooncats/composite.rb

@@ -10,7 +10,7 @@ CANVAS_HEIGHT = 24
 def initialize( cols=100, rows=255 )
     @composite = ChunkyPNG::Image.new( cols*CANVAS_WIDTH,
                                        rows*CANVAS_HEIGHT,
-                                       ChunkyPNG::Color::WHITE ) # why? why not? - use TRANSPARENT (is default?)
+                                       ChunkyPNG::Color::TRANSPARENT ) # why? why not? - use TRANSPARENT (is default?)
 
     ## todo/check - find a better name for cols/rows - why? why not?
     @cols = cols

data/lib/mooncats/dataset.rb

@@ -31,9 +31,17 @@ module Mooncats
         ## note: skip all derived column from id e.g.
         ##        - r,g,b, etc.
 
-        mint  = row['mint'].to_i
-
-        mooncats << Metadata.new( id )
+        ## add some more (extra) columns
+        mint      = row['mint'].to_i
+        block     = row['block'].to_i
+        ## expected timestamp format like
+        ##   2017-09-06 15:03:43 UTC
+        timestamp = DateTime.strptime( row['timestamp'], '%Y-%m-%d %H:%M:%S %z')
+
+        mooncats << Metadata.new( id,
+                                  mint:      mint,
+                                  block:     block,
+                                  timestamp: timestamp )
       end
       ## print "\n"   ## add progress
 

data/lib/mooncats/design.rb

@@ -0,0 +1,127 @@
+
+module Mooncats
+
+
+class Design
+def self.find( num )   ## pass in design index number (0 to 127)
+  ## todo: add cache (memoize) - why? why not?
+  design = parse( DESIGNS[ num ] )
+
+  puts "    design ##{num} (#{design.width}x#{design.height})"
+  ## pp design.data
+  ## puts
+
+  design
+end
+
+
+def self.read( path )
+  text = File.open( path, 'r:utf-8') { |f| f.read }
+  parse( text )
+end
+
+def self.parse( str )
+  ## support original "classic" compact single-line format
+  ##   e.g. 00011111100000000.01113333310000000.13533333331110000....
+  ##  note: this format needs to get rotated by 90 degree!!!
+  if str.start_with?( /[0-5]+\.[0-5]+\.[0-5]+/ )  ## quick (and dirty) heuristic check
+    data = str.split('.')
+
+    ## note: map colors encoded as a string to an array of integers - why? why not?
+    ##  e.g. "00011111133344411"
+    ##          =>
+    ##       [0,0,0,1,1,1,1,1,1,3,3,3,4,4,4,1,1]
+    data = data.map do |row|
+             row.chars.map do |color|
+                color.to_i
+             end
+           end
+    data = data.transpose   ## note: rotate by 90 degree!!!!!
+  else  ## assume "modern" pixelart format
+     ## todo/check: delegate to pixelart parse or such - why? why not?
+
+     data = []
+     str.each_line do |line|
+       line = line.strip
+       next if line.empty?               ## skipping empty line in pixel art source
+       next if line.start_with?( '#' )   ## skipping comment line in pixel art source
+
+       ## note: allow multiple spaces or tabs to separate pixel codes
+       data << line.split( /[ \t]+/)
+     end
+     ## todo/check: change to use strings (instead of nummbers) in the future?
+     ##                 why? why not?  stay "compatible" to pixel art format/machinery?
+     data = data.map do |row|
+       row.map do |color|
+          color.to_i
+       end
+     end
+  end
+  new( data )
+end
+
+
+def initialize( data )
+ @data = data
+end
+
+def width
+  ## todo/check: use/find max - why? why not? lets you you used "unbalanced" / shortcut lines too
+  @data[0].size
+end
+def height() @data.size; end
+
+
+def each_with_index( &blk )
+  @data.each_with_index { |row, y| blk.call( row, y ) }
+end
+def each( &blk )
+  @data.each { |row| blk.call( row ) }
+end
+
+
+
+def to_txt
+  buf = String.new('')
+
+  @data.each do |row|
+    buf << row.join( ' ' )
+    buf << "\n"
+  end
+  buf
+end
+end # class Design
+
+
+
+###############
+## todo/check:
+##    find a better way to (auto?) include more designs?
+class DesignSeries    ## find a better name for class - why? why not?
+  def self.build( dir )
+    data = {}
+    paths =  Dir.glob( "#{dir}/**.txt" )
+    paths.each do |path|
+      basename = File.basename( path, File.extname( path ) )
+      num  = basename.to_i( 10 )  ## use base 10 (e.g. 001 => 1, 002 => 2, etc.)
+      text = File.open( path, 'r:utf-8' ) { |f| f.read }
+      ## todo/check: auto-parse "ahead of time" here
+      ##              or keep "raw" text - why? why not?
+      data[ num ] = text
+    end
+    data
+  end
+
+  def initialize( dir )
+    @dir = dir  # e.g. "#{Mooncats.root}/config/v2"
+  end
+
+  def data
+    ## note: lazy load / build on first demand only
+    @data ||= self.class.build( @dir )
+  end
+
+  def [](index) data[ index ]; end
+  def size()    data.size; end
+end   # class DesignSeries
+end # module Mooncats

data/lib/mooncats/image.rb

@@ -1,13 +1,15 @@
 
 module Mooncats
-class Image
+
+
+class Image <  Pixelart::Image
 
 
 COLORS_GENESIS_WHITE = ['#555555', '#d3d3d3', '#ffffff', '#aaaaaa', '#ff9999']
 COLORS_GENESIS_BLACK = ['#555555', '#222222', '#111111', '#bbbbbb', '#ff9999']
 
 
-def self.generate( id, zoom: 1 )
+def self.generate( id )
   meta = Metadata.new( id )
 
   design = meta.design.to_i   # note: meta.design is a struct/object - keep/use a local int !!!
@@ -20,14 +22,14 @@ def self.generate( id, zoom: 1 )
                  COLORS_GENESIS_BLACK
               end
            else
-             derive_palette( meta.r,
-                             meta.g,
-                             meta.b, invert: meta.invert? )
+             derive_palette( r: meta.r,
+                             g: meta.g,
+                             b: meta.b,
+                             invert: meta.invert? )
            end
 
   new( design: design,
-       colors: colors,
-       zoom:   zoom )
+       colors: colors )
 end
 
 ### add more (convenience) aliases
@@ -36,80 +38,92 @@ class << self
 end
 
 
+def self.read( path )   ## convenience helper
+  img = ChunkyPNG::Image.from_file( path )
+  new( img )
+end
 
 
-def initialize( design: 0,
-                colors: COLORS_GENESIS_WHITE,
-                zoom: 1 )
-
-    ## puts "==> [Mooncats] Image.new zoom: #{zoom}"
-
-    design =  if design.is_a?( String )
-                 Design.parse( design )
-              elsif design.is_a?( Array )
-                 Design.new( design )
-              elsif design.is_a?( Design )
-                 design  ## pass through as is 1:1
-              else  ## assume integer nuber
-                 design_num = design  ## note: for convenience "porcelain" param is named design (NOT design_num)
-                 Design.find( design_num )
-              end
-
-    ## note: first color (index 0) is always nil (default/white or transparent)
-    colors = [ nil ] + parse_colors( colors )
-
-    ## puts " colors:"
-    ## pp colors
-
-  @cat = ChunkyPNG::Image.new( design.width*zoom,
-                               design.height*zoom,
-                               ChunkyPNG::Color::WHITE ) # why? why not?
-
-    design.each_with_index do |row, x|
-      row.each_with_index do |color, y|
-        if color > 0
-          pixel = colors[ color ]
-          zoom.times do |n|
-            zoom.times do |m|
-              @cat[n+zoom*x,m+zoom*y] = pixel
-            end
-          end
-        end # has color?
-      end # each row
-    end # each data
-end
 
-#####
-# (image) delegates
-##   todo/check: add some more??
-def save( path, constraints = {} )
-  @cat.save( path, constraints )
+def initialize( initial=nil, design: nil,
+                             colors: nil )
+    if initial
+      ## pass image through as-is
+      img = inital
+    else
+      design ||= 0
+      colors ||= COLORS_GENESIS_WHITE
+
+      design =  if design.is_a?( String )
+                  Design.parse( design )
+                elsif design.is_a?( Array )
+                   Design.new( design )
+                elsif design.is_a?( Design )
+                   design  ## pass through as is 1:1
+                else  ## assume integer nuber
+                   design_num = design  ## note: for convenience "porcelain" param is named design (NOT design_num)
+                   Design.find( design_num )
+                end
+
+      ## note: first color (index 0) is always nil (default/white or transparent)
+      colors = [ nil ] + colors.map { |color| Pixelart::Color.parse( color ) }
+
+      ## puts " colors:"
+      ## pp colors
+
+      img = ChunkyPNG::Image.new( design.width,
+                                  design.height,
+                                  ChunkyPNG::Color::TRANSPARENT ) # why? why not?
+
+      design.each_with_index do |row, y|
+        row.each_with_index do |color, x|
+          if color > 0
+            pixel = colors[ color ]
+
+            ## note: special built-in color palette black & white "hack"
+            ##         only active if colors 6 & 7 NOT defined
+            ##    color 6 => black (000000 / ff) rgb / a(lpha)
+            ##    color 7 => white (ffffff / ff) rgb / a(lpha)
+            pixel = 0xff       if pixel.nil? && color == 6
+            pixel = 0xffffffff if pixel.nil? && color == 7
+
+            img[x,y] = pixel
+          end # has color?
+        end # each row
+      end # each data
+    end
+
+    super( img.width, img.height, img )
 end
 
-def width()        @cat.width; end
-def height()       @cat.height; end
-
-## return image ref - use a different name - why? why not?
-def image()        @cat; end
 
 
 ##################
 #  (static) helpers
-def self.derive_palette( r, g, b, invert: false )
-  ## note: Color.rgb returns an Integer (e.g. 34113279 - true color or just hex rgba or?)
-  rgb = ChunkyPNG::Color.rgb( r, g, b )
-
-   # to_hsl(color, include_alpha = false) ⇒ Array<Fixnum>[0], ...
-   #   Returns an array with the separate HSL components of a color.
-  hsl = ChunkyPNG::Color.to_hsl( rgb )
-  #=> [237, 0.9705882352941178, 0.26666666666666666]
-
-  h = hsl[0]
-  s = hsl[1]
-  l = hsl[2]
-
-  hx = h % 360
-  hy = (h + 320) % 360
+def self.derive_palette( r: nil, g: nil, b: nil,
+                         hue: nil,
+                         invert: false )
+
+   if hue
+     ## pass through as is 1:1
+   else ## assume r, g, b
+      ## note: Color.rgb returns an Integer (e.g. 34113279 - true color or just hex rgba or?)
+      rgb = ChunkyPNG::Color.rgb( r, g, b )
+
+      # to_hsl(color, include_alpha = false) ⇒ Array<Fixnum>[0], ...
+       #   Returns an array with the separate HSL components of a color.
+      hsl = ChunkyPNG::Color.to_hsl( rgb )
+      #=> [237, 0.9705882352941178, 0.26666666666666666]
+
+      # h = hsl[0]
+      # s = hsl[1]
+      # l = hsl[2]
+
+      hue = hsl[0]
+   end
+
+   hx = hue % 360      ## note: makes sure number is always POSITIVE (e.g. -13 % 360 => 347)
+   hy = (hue + 320) % 360
   #=> e.g. hx: 237, hy: 197
 
   c1 = ChunkyPNG::Color.from_hsl( hx, 1, 0.1 )
@@ -131,75 +145,6 @@ def self.derive_palette( r, g, b, invert: false )
 end
 
 
-######
-# helpers
-def parse_colors( colors )
-  ## convert into ChunkyPNG::Color
-  colors.map { |color| parse_color( color ) }
-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)
-    ## note: return an Integer !!! (not a Color class or such!!! )
-    ChunkyPNG::Color.from_hex( color )
-  else
-    raise ArgumentError, "unknown color format; cannot parse - expected rgb hex string e.g. d3d3d3"
-  end
-end
 end # class Image
-
-
-
-class Design
-def self.find( num )   ## pass in design index number (0 to 127)
-  ## todo: add cache (memoize) - why? why not?
-  str = DESIGNS[ num ]
-  design = parse( str )
-
-  puts "    design ##{num} (#{design.width}x#{design.height})"
-  ## pp design.data
-  ## puts
-
-  design
-end
-
-
-def self.parse( str )
-  data = str.split('.')
-  new( data )
-end
-
-def initialize( data )
- ## todo: add cache (memoize) - why? why not?
-
- ## note: map colors encoded as a string to an array of integers - why? why not?
- ##  e.g. "00011111133344411"
- ##          =>
- ##       [0,0,0,1,1,1,1,1,1,3,3,3,4,4,4,1,1]
-
- @data = data.map do |row|
-            row.chars.map do |color|
-             color.to_i
-            end
-          end
-end
-
-## note: design data stored mirrored (data.size is the width NOT height)
-def width() @data.size; end
-def height() @data[0].size; end
-
-def data() @data; end
-
-def each_with_index( &blk )
-  ## note: y,x is reversed - keep for now
-  ##  (todo/fix later? and "pivot" raw data on init - why? why not?)
-  @data.each_with_index do |row, x|
-    blk.call( row, x )
-  end
-end
-end # class Design
-
 end # module Mooncats