mooncats 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 73a562781defbd28b7cd681aae41379de40fbf3704a5a97834ce530d71dda15f
-  data.tar.gz: 8abb18f6713ab38a9e68a84acff16ca3f3e71fb57edc93cb15f204b612c88804
+  metadata.gz: a440b059c12270381d0f9b58b277a3f06b7e44d1cc1cdc503965ac2f888a2cb9
+  data.tar.gz: e153163695f9e23a07d105f9eccba2d7c666bed7b234f18dead8ca0c1a659ae7
 SHA512:
-  metadata.gz: 34f9b2e6117b7a8fe4134dc20cbdb9541cbb97500e278853d76defeca1d48b6fa32d312de84ec557701ccf5835108e4bffbfc1b12bb27f71f031fb6aa6899c13
-  data.tar.gz: aef96b644a304e287ee44b7539ea2705b7c98c2d9a40cdb4c3ef76ff1b59b96ec380ee3b5ec22d0acf70ed760748fefdfcd554e3eb30ad1cdab79b66362322ec
+  metadata.gz: 936a405f9b9abf5cb4118be4c6a3b0d9f49925099a20e56667925b2275c2bcb6a5498055e3c3be2e0c3781297eacb8b616da681a856c061fd553ec533b82344f
+  data.tar.gz: 602fe2482ca77d1004368a809080239b66a01456f529d4b4aa30138eed2ca2f852dd2ab57dc38acaf6c3595f493b05156ffaf4b51b29b1821ad5232ae9f291cf

data/Manifest.txt

@@ -5,6 +5,9 @@ README.md
 Rakefile
 bin/mooncat
 lib/mooncats.rb
+lib/mooncats/composite.rb
+lib/mooncats/dataset.rb
 lib/mooncats/designs.rb
 lib/mooncats/image.rb
+lib/mooncats/structs.rb
 lib/mooncats/version.rb

data/lib/mooncats.rb

@@ -12,8 +12,10 @@ require 'optparse'
 ## our own code
 require 'mooncats/version'    # note: let version always go first
 require 'mooncats/designs'
+require 'mooncats/structs'
 require 'mooncats/image'
-
+require 'mooncats/composite'
+require 'mooncats/dataset'
 
 
 

data/lib/mooncats/composite.rb

@@ -0,0 +1,69 @@
+
+module Mooncats
+class Image
+class Composite    ## nest Composite inside Image - why? why not?
+
+
+CANVAS_WIDTH  = 24    ## sorry - for now "hard-coded" / fixed - 24x24
+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?)
+
+    ## todo/check - find a better name for cols/rows - why? why not?
+    @cols = cols
+    @rows = rows
+
+    @i = 0  # (track) current index (of added images)
+end
+
+
+def add( image )
+  y, x =  @i.divmod( @cols )
+
+  puts "    width: #{image.width}, height: #{image.height}"
+
+  ## try to center image (identicon) in 24x24 canvas
+  ##   the 4 formats are
+  ##   - 21×17 - Standing
+  ##   - 20×14 - Sleeping
+  ##   - 17×22 - Pouncing
+  ##   - 20×21 - Stalking
+  ## e.g. add left padding (x_center) and
+  ##          top padding (y_center)
+  x_center, y_center = case [image.width, image.height]
+                       when [21,17] then [1,3]
+                       when [20,14] then [2,5]
+                       when [17,22] then [3,1]
+                       when [20,21] then [2,1]
+                       ## todo/fix: report unknown image format/size!!!!
+                       end
+
+  ## note: image.image  - "unwrap" the "raw" ChunkyPNG::Image
+  @composite.compose!( image.image, x*CANVAS_WIDTH+x_center, y*CANVAS_HEIGHT+y_center )
+  @i += 1
+end
+
+alias_method :<<, :add
+
+
+
+#####
+# (image) delegates
+##   todo/check: add some more??
+def save( path, constraints = {} )
+  @composite.save( path, constraints )
+end
+
+def width()        @composite.width; end
+def height()       @composite.height; end
+
+## return image ref - use a different name - why? why not?
+def image()        @composite; end
+
+
+end # class Composite
+end # class Image
+end # module Mooncats

data/lib/mooncats/dataset.rb

@@ -0,0 +1,45 @@
+
+
+module Mooncats
+  module Dataset
+
+    def self.read( path='./datasets/mooncats/*.csv' )
+
+      datasets = Dir.glob( path )
+      ## pp datasets
+      #=> ["./datasets/mooncats/00.csv",
+      #    "./datasets/mooncats/01.csv",
+      #    "./datasets/mooncats/02.csv",
+      #    "./datasets/mooncats/03.csv",
+      #    "./datasets/mooncats/04.csv",
+      #     ...]
+
+      rows = []
+      datasets.each do |dataset|
+        rows += CsvHash.read( dataset )
+      end
+
+      ## puts "  #{rows.size} rows(s)"
+      #=> 25440 rows(s)
+
+
+      ### wrap in mooncat struct for easier access
+      mooncats = []
+      rows.each_with_index do |row,i|
+        ## print "."  if i % 100
+        id    = row['id']
+        ## note: skip all derived column from id e.g.
+        ##        - r,g,b, etc.
+
+        mint  = row['mint'].to_i
+
+        mooncats << Metadata.new( id )
+      end
+      ## print "\n"   ## add progress
+
+      mooncats
+    end
+  end  # module Dataset
+end  # module Mooncat
+
+

data/lib/mooncats/image.rb

@@ -7,27 +7,22 @@ COLORS_GENESIS_WHITE = ['#555555', '#d3d3d3', '#ffffff', '#aaaaaa', '#ff9999']
 COLORS_GENESIS_BLACK = ['#555555', '#222222', '#111111', '#bbbbbb', '#ff9999']
 
 
-def self.generate( cat_id, zoom: 1 )
-  bytes = hex_to_bytes( cat_id )
+def self.generate( id, zoom: 1 )
+  meta = Metadata.new( id )
 
-  genesis = bytes[0] != 0   ## note: convert to bool (if zero assume NOT genesis)
-  k       = bytes[1]
-  r       = bytes[2]
-  g       = bytes[3]
-  b       = bytes[4]
+  design = meta.design.to_i   # note: meta.design is a struct/object - keep/use a local int !!!
 
-  invert = k >= 128
-  design = k % 128
-
-  colors = if genesis
-              if design % 2 === 0 && invert ||
-                 design % 2 === 1 && !invert
+  colors = if meta.genesis?
+              if design % 2 == 0 && meta.invert? ||
+                 design % 2 == 1 && !meta.invert?
                  COLORS_GENESIS_WHITE
               else
                  COLORS_GENESIS_BLACK
               end
            else
-             derive_palette( r, g, b, invert: invert )
+             derive_palette( meta.r,
+                             meta.g,
+                             meta.b, invert: meta.invert? )
            end
 
   new( design: design,
@@ -35,6 +30,13 @@ def self.generate( cat_id, zoom: 1 )
        zoom:   zoom )
 end
 
+### add more (convenience) aliases
+class << self
+  alias_method :mint, :generate
+end
+
+
+
 
 def initialize( design: 0,
                 colors: COLORS_GENESIS_WHITE,
@@ -80,31 +82,19 @@ end
 #####
 # (image) delegates
 ##   todo/check: add some more??
-def save( path )   @cat.save( path ); end
+def save( path, constraints = {} )
+  @cat.save( path, constraints )
+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.hex_to_bytes( str_or_num )
-  if str_or_num.is_a?( Integer )  ## allow passing in of integer to e.g. 0x... etc.
-     num = str_or_num
-     str = '%010x' % num    # 5 bytes (10 hex digits/chars)
-  else ## assume string
-     ## cut-off optionial 0x
-     str = str_or_num
-     str = str.downcase
-     str = str[2..-1]  if str.start_with?( '0x')
-  end
-
-  raise ArgumentError, "expected 5 byte hex string (10 digits/chars); got #{str_or_num}"   if str.size != 10
-
-  bytes = [str].pack('H*').bytes
-  bytes
-end
-
 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 )

data/lib/mooncats/structs.rb

@@ -0,0 +1,151 @@
+
+module Mooncats
+
+### wrap metadata (e.g. pose, fur, facing, color, etc.)
+##     in structs for easy/easier access)
+
+POSES = [
+  'Standing',  ## 00
+  'Sleeping',  ## 01
+  'Pouncing',  ## 10
+  'Stalking',  ## 11
+]
+
+FACES = [
+  'Smile',              ## 00
+  'Frown (Look Down)',  ## 01
+  'Frown (Look Up)',    ## 10
+  'Flat Whiskers',      ## 11
+]
+
+FURS = [
+  'Solid',      ## 00
+  'Striped',    ## 01
+  'Eyepatch',   ## 10
+  'Half/Half',  ## 11
+]
+
+FACINGS = [
+  'Left',   # 0
+  'Right',  # 1
+]
+
+
+
+class Metadata
+
+  class Design ## nested classed  - why? lets you use Metadata::Design "standalone", that is, without 5-byte id
+    def initialize( num )   # 0-127 design num(ber)
+      @num = num
+    end
+
+    def to_i() @num; end
+
+    def bits  ## keep private / internal - why? why not?
+      ## keep 128 possible designs 0 to 127
+      ##   as 7 bit string e.g. 01010111  for now - why? why not?
+      @bits ||= '%08b' % @num
+    end
+
+    def facing
+      @facing ||= FACINGS[ bits[1,1].to_i(2) ]  ## use desgin > 63 instead  - why? why not?
+    end
+    def face
+      @face ||= FACES[ bits[2,2].to_i(2) ]
+    end
+    def fur
+      @fur ||= FURS[ bits[4,2].to_i(2) ]
+    end
+    def pose
+      @poses ||= POSES[ bits[6,2].to_i(2) ]   ##  use design % 4 instead - why? why not?
+    end
+  end  ## (nested) class Metadata::Design
+
+
+
+
+  def initialize( id, **more )
+    @bytes = self.class.hex_to_bytes( id )
+
+    ## add support for more "external" meta data
+    ##   ## e.g. mint, mint_block, etc.
+    @more = more
+  end
+
+  def id
+    @id ||= @bytes.map { |byte| '%02x' % byte }.join
+  end
+
+  def genesis?
+    @bytes[0] != 0   ## note: convert to bool (if zero assume NOT genesis)
+  end
+  def k() @bytes[1]; end
+  def r() @bytes[2]; end
+  def g() @bytes[3]; end
+  def b() @bytes[4]; end
+
+  def rgb() [r,g,b]; end   ## add rgb shortcut helper - why? why not?
+
+  def invert?() k >= 128; end
+  def pattern() k % 64; end   ## treat facing left|right as the same
+
+
+  def design
+    @design ||= Design.new( k % 128 )
+  end
+
+  def facing()  design.facing; end
+  def face()    design.face; end
+  def fur()     design.fur; end
+  def pose()    design.pose; end
+
+
+  ####
+  # more "external" attributes
+  def mint()   @more[:mint]; end
+
+  #####
+  # enable array-like access to - why? why not?
+  def []( key )
+     case key.to_sym
+     when :id      then id
+     when :genesis then genesis?
+     when :k       then k
+     when :r       then r
+     when :g       then g
+     when :b       then b
+     when :rgb     then rgb
+     when :invert  then invert?
+     when :design  then design.to_i
+     when :pattern then pattern
+     when :facing  then facing
+     when :face    then face
+     when :fur     then fur
+     when :pose    then pose
+     else
+       @more[ key ]
+     end
+  end
+
+
+  ##################
+  #  (static) helpers
+  def self.hex_to_bytes( str_or_num )
+    if str_or_num.is_a?( Integer )  ## allow passing in of integer to e.g. 0x... etc.
+       num = str_or_num
+       str = '%010x' % num    # 5 bytes (10 hex digits/chars)
+    else ## assume string
+       ## cut-off optionial 0x
+       str = str_or_num
+       str = str.downcase
+       str = str[2..-1]  if str.start_with?( '0x')
+    end
+
+    raise ArgumentError, "expected 5 byte hex string (10 digits/chars); got #{str_or_num}"   if str.size != 10
+
+    bytes = [str].pack('H*').bytes
+    bytes
+  end
+end # class Metadata
+
+end  # module Mooncats

data/lib/mooncats/version.rb

@@ -3,7 +3,7 @@ module Mooncats
 
   MAJOR = 0
   MINOR = 1
-  PATCH = 0
+  PATCH = 2
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mooncats
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-03-16 00:00:00.000000000 Z
+date: 2021-03-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chunky_png
@@ -92,8 +92,11 @@ files:
 - Rakefile
 - bin/mooncat
 - lib/mooncats.rb
+- lib/mooncats/composite.rb
+- lib/mooncats/dataset.rb
 - lib/mooncats/designs.rb
 - lib/mooncats/image.rb
+- lib/mooncats/structs.rb
 - lib/mooncats/version.rb
 homepage: https://github.com/cryptocopycats/mooncats
 licenses: