mooncats 0.1.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 73a562781defbd28b7cd681aae41379de40fbf3704a5a97834ce530d71dda15f
-  data.tar.gz: 8abb18f6713ab38a9e68a84acff16ca3f3e71fb57edc93cb15f204b612c88804
+  metadata.gz: bf22f607c257a0cef8877f44594782f1c6f704a9c580c01af96a39d49f985209
+  data.tar.gz: f6b10d2506c5b3dc05477ad4d8ba18c24eada0382cbcc29fdbfa0c572a04c892
 SHA512:
-  metadata.gz: 34f9b2e6117b7a8fe4134dc20cbdb9541cbb97500e278853d76defeca1d48b6fa32d312de84ec557701ccf5835108e4bffbfc1b12bb27f71f031fb6aa6899c13
-  data.tar.gz: aef96b644a304e287ee44b7539ea2705b7c98c2d9a40cdb4c3ef76ff1b59b96ec380ee3b5ec22d0acf70ed760748fefdfcd554e3eb30ad1cdab79b66362322ec
+  metadata.gz: 4e20d5394cd29624a64d0b7a830fbf7bc0b0890c021a25c077a7c51771600b9d7187220abd2e76c5a94b2f1a50d66fae040727950fca4be859db8a821791082a
+  data.tar.gz: 6028eadc62a9861e3e9c5be6215ec0bb142701cffd15e88d681ce4c30cfc137df4ee102f9b09de0c41f9d1a4715771d631d488a1b49326a8fba96bf211615e08

data/Manifest.txt

@@ -1,10 +1,13 @@
 CHANGELOG.md
-LICENSE.md
 Manifest.txt
 README.md
 Rakefile
 bin/mooncat
 lib/mooncats.rb
+lib/mooncats/composite.rb
+lib/mooncats/dataset.rb
+lib/mooncats/design.rb
 lib/mooncats/designs.rb
 lib/mooncats/image.rb
+lib/mooncats/structs.rb
 lib/mooncats/version.rb

data/README.md

@@ -25,12 +25,12 @@ resulting in:
 
 ```
 Usage: mooncat [options] IDs
-  Mint mooncats from original designs - for IDs use 5 byte hexstrings (e.g 0x004fc21270)
+ Mint mooncats from original designs - for IDs use 5 byte hexstrings (e.g 0x004fc21270)
 
-  Options:
-    -z, --zoom=ZOOM     Zoom factor x2, x4, x8, etc. (default: 1)
-    -d, --dir=DIR       Output directory (default: .)
-    -h, --help          Prints this help
+ Options:
+   -z, --zoom=ZOOM     Zoom factor x2, x4, x8, etc. (default: 1)
+   -d, --dir=DIR       Output directory (default: .)
+   -h, --help          Prints this help
 ```
 
 
@@ -55,9 +55,9 @@ printing:
 
 And voila!
 
-![](i/mooncat-00000800fa.png)
-![](i/mooncat-0077c8278d.png)
-![](i/mooncat-ff5f000ca7.png)
+![](https://github.com/cryptocopycats/mooncats/raw/master/mooncats/i/mooncat-00000800fa.png)
+![](https://github.com/cryptocopycats/mooncats/raw/master/mooncats/i/mooncat-0077c8278d.png)
+![](https://github.com/cryptocopycats/mooncats/raw/master/mooncats/i/mooncat-ff5f000ca7.png)
 
 
 
@@ -86,23 +86,24 @@ printing:
 
 And voila!
 
-![](i/mooncat-00000800fa_x2.png)
-![](i/mooncat-0077c8278d_x2.png)
-![](i/mooncat-ff5f000ca7_x2.png)
+![](https://github.com/cryptocopycats/mooncats/raw/master/mooncats/i/mooncat-00000800fa_x2.png)
+![](https://github.com/cryptocopycats/mooncats/raw/master/mooncats/i/mooncat-0077c8278d_x2.png)
+![](https://github.com/cryptocopycats/mooncats/raw/master/mooncats/i/mooncat-ff5f000ca7_x2.png)
 
 
 And x4:
 
-![](i/mooncat-00000800fa_x4.png)
-![](i/mooncat-0077c8278d_x4.png)
-![](i/mooncat-ff5f000ca7_x4.png)
+![](https://github.com/cryptocopycats/mooncats/raw/master/mooncats/i/mooncat-00000800fa_x4.png)
+![](https://github.com/cryptocopycats/mooncats/raw/master/mooncats/i/mooncat-0077c8278d_x4.png)
+![](https://github.com/cryptocopycats/mooncats/raw/master/mooncats/i/mooncat-ff5f000ca7_x4.png)
 
 
 And x8:
 
-![](i/mooncat-00000800fa_x8.png)
-![](i/mooncat-0077c8278d_x8.png)
-![](i/mooncat-ff5f000ca7_x8.png)
+![](https://github.com/cryptocopycats/mooncats/raw/master/mooncats/i/mooncat-00000800fa_x8.png)
+![](https://github.com/cryptocopycats/mooncats/raw/master/mooncats/i/mooncat-0077c8278d_x8.png)
+![](https://github.com/cryptocopycats/mooncats/raw/master/mooncats/i/mooncat-ff5f000ca7_x8.png)
+
 
 
 
@@ -115,7 +116,7 @@ And so on.
 Yes, you can mint mooncats in your own scripts
 and much more.
 See the
-[**Programming Mooncats Step-by-Step Booklet / Guide »**](https://github.com/cryptopunksnotdead/programming-mooncats)  - Upcoming
+[**Programming MoonCats & MarsCats Step-by-Step Booklet / Guide »**](https://github.com/cryptocopycats/programming-mooncats)
 
 
 

data/Rakefile

@@ -18,7 +18,7 @@ Hoe.spec 'mooncats' do
   self.history_file = 'CHANGELOG.md'
 
   self.extra_deps = [
-    ['chunky_png'],
+    ['pixelart'],
     ['csvreader'],
   ]
 

data/lib/mooncats.rb

@@ -1,10 +1,9 @@
 ## 3rd party
-require 'chunky_png'
+require 'pixelart/base'
 require 'csvreader'
 
 
 ## extra stdlibs
-require 'fileutils'
 require 'optparse'
 
 
@@ -12,8 +11,11 @@ require 'optparse'
 ## our own code
 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'
 
 
 
@@ -61,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"
@@ -87,4 +94,11 @@ module Mooncats
 MoonCats = Mooncats
 
 
+
+
+###
+# note: for convenience auto include Pixelart namespace!!! - why? why not?
+include Pixelart
+
+
 puts Mooncats.banner    # say hello

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::TRANSPARENT ) # 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,53 @@
+
+
+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.
+
+        ## 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
+
+      mooncats
+    end
+  end  # module Dataset
+end  # module Mooncat
+
+

data/lib/mooncats/design.rb

@@ -0,0 +1,92 @@
+
+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.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
+end # module Mooncats

data/lib/mooncats/image.rb

@@ -1,46 +1,46 @@
 
 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( cat_id, zoom: 1 )
-  bytes = hex_to_bytes( cat_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]
+def self.generate( id )
+  meta = Metadata.new( id )
 
-  invert = k >= 128
-  design = k % 128
+  design = meta.design.to_i   # note: meta.design is a struct/object - keep/use a local int !!!
 
-  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( 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
+class << self
+  alias_method :mint, :generate
+end
 
-def initialize( design: 0,
-                colors: COLORS_GENESIS_WHITE,
-                zoom: 1 )
 
-    ## puts "==> [Mooncats] Image.new zoom: #{zoom}"
+
+def initialize( design: 0,
+                colors: COLORS_GENESIS_WHITE )
 
     design =  if design.is_a?( String )
                  Design.parse( design )
@@ -54,72 +54,55 @@ def initialize( design: 0,
               end
 
     ## note: first color (index 0) is always nil (default/white or transparent)
-    colors = [ nil ] + parse_colors( colors )
+    colors = [ nil ] + colors.map { |color| Pixelart::Color.parse( color ) }
 
     ## puts " colors:"
     ## pp colors
 
-  @cat = ChunkyPNG::Image.new( design.width*zoom,
-                               design.height*zoom,
-                               ChunkyPNG::Color::WHITE ) # why? why not?
+  img = ChunkyPNG::Image.new( design.width,
+                              design.height,
+                              ChunkyPNG::Color::TRANSPARENT ) # why? why not?
 
-    design.each_with_index do |row, x|
-      row.each_with_index do |color, y|
+    design.each_with_index do |row, y|
+      row.each_with_index do |color, x|
         if color > 0
           pixel = colors[ color ]
-          zoom.times do |n|
-            zoom.times do |m|
-              @cat[n+zoom*x,m+zoom*y] = pixel
-            end
-          end
+          img[x,y] = pixel
         end # has color?
       end # each row
     end # each data
-end
 
-#####
-# (image) delegates
-##   todo/check: add some more??
-def save( path )   @cat.save( path ); end
-def width()        @cat.width; end
-def height()       @cat.height; end
+    super( img.width, img.height, img )
+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 )
-
-   # 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 )
@@ -141,75 +124,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
 

data/lib/mooncats/structs.rb

@@ -0,0 +1,242 @@
+
+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
+]
+
+
+OLD_FACES = [   ## old names for face (expressions)
+  'Smile',              ## 00
+  'Frown (Look Down)',  ## 01
+  'Frown (Look Up)',    ## 10
+  'Flat Whiskers',      ## 11
+]
+
+FACES = [  ## face expressions
+  'Smiling',            ## 00
+  'Grumpy',             ## 01
+  'Pouting',            ## 10
+  'Shy',                ## 11
+]
+
+
+OLD_FURS = [    ## old names for fur (patterns)
+  'Solid',      ## 00
+  'Striped',    ## 01
+  'Eyepatch',   ## 10
+  'Half/Half',  ## 11
+]
+
+FURS = [    ##  fur (patterns)
+  'Pure',      ## 00
+  'Tabby',     ## 01
+  'Spotted',   ## 10
+  'Tortie',    ## 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 (expression)
+      @face ||= FACES[ bits[2,2].to_i(2) ]
+    end
+    alias_method :expression, :face
+
+    def fur    ## fur (pattern)   - add pattern alias - why? why not?
+      @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
+  alias_method :pale?, :invert?
+
+
+  def pattern() k % 64; end   ## treat facing left|right as the same - note: conflicts with fur (pattern) - find a better/different name?
+
+
+  def hue
+    @hue ||= begin
+       ## note: hsl[0], that is, hue MIGHT BE NEGATIVE!
+       ##   e.g. try rbg( 91, 27, 41 )
+       ##         resulting in
+       ##          hsl( -13, 0.5423728813559322, 0.23137254901960785 )
+       ##  remember: always use % 360 to make positive!!!
+       ##    e.g.   -13 % 360   => 347
+       ##           -25 % 360   => 335
+               rgb = ChunkyPNG::Color.rgb( r, g, b )
+               hsl = ChunkyPNG::Color.to_hsl( rgb )
+               hsl[0] % 360    ## make sure number is always POSITIVE!!!
+             end
+  end
+
+
+  def color
+    case hue
+    when 345..359,
+           0..14   then 'Red'
+    when  15..44   then 'Orange'
+    when  45..74   then 'Yellow'
+    when  75..104  then 'Chartreuse'
+    when 105..134  then 'Green'
+    when 135..164  then 'Teal'
+    when 165..194  then 'Cyan'
+    when 195..224  then 'Sky Blue'
+    when 225..254  then 'Blue'
+    when 255..284  then 'Purple'
+    when 285..314  then 'Magenta'
+    when 315..344  then 'Fuchsia'
+    else
+      puts "!! ERROR - unexpected hue (in degress); got #{hue} - expected 0 to 359"
+      exit 1
+    end
+ end
+
+
+  def xxx_color_old_formula   ## remove - move to attic??
+    case hue
+    when   0..29  then 'Red'
+    when  30..59  then 'Orange'
+    when  60..89  then 'Yellow'
+    when  90..119 then 'Chartreuse'
+    when 120..149 then 'Green'
+    when 150..179 then 'Lime Green'    ## now renamed to Teal
+    when 180..209 then 'Cyan'
+    when 210..239 then 'Sky Blue'
+    when 240..269 then 'Blue'
+    when 270..299 then 'Purple'
+    when 300..329 then 'Magenta'
+    when 330..359 then 'Fuchsia'
+    else
+     puts "!! ERROR - unexpected hue (in degress); got #{hue} - expected 0 to 359"
+     exit 1
+    end
+  end
+
+
+  def design
+    @design ||= Design.new( k % 128 )
+  end
+
+  def facing()  design.facing; end
+  def face()    design.face; end
+  alias_method :expression, :face
+  def fur()     design.fur; end
+  def pose()    design.pose; end
+
+
+  ####
+  # more "external" attributes
+  def mint()      @more[:mint]; end
+  def block()     @more[:block]; end
+  def timestamp() @more[:timestamp]; end
+  def year()      timestamp ? timestamp.year : nil; 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,
+          :pale       then invert?
+     when :hue        then hue
+     when :color      then color
+     when :design     then design.to_i
+     when :pattern    then pattern
+     when :facing     then facing
+     when :face,
+          :expression then face
+     when :fur        then fur
+     when :pose       then pose
+     when :year       then year    # note: from more via timestamp
+     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

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

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: mooncats
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-03-16 00:00:00.000000000 Z
+date: 2021-04-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: chunky_png
+  name: pixelart
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -81,19 +81,21 @@ executables:
 extensions: []
 extra_rdoc_files:
 - CHANGELOG.md
-- LICENSE.md
 - Manifest.txt
 - README.md
 files:
 - CHANGELOG.md
-- LICENSE.md
 - Manifest.txt
 - README.md
 - Rakefile
 - bin/mooncat
 - lib/mooncats.rb
+- lib/mooncats/composite.rb
+- lib/mooncats/dataset.rb
+- lib/mooncats/design.rb
 - lib/mooncats/designs.rb
 - lib/mooncats/image.rb
+- lib/mooncats/structs.rb
 - lib/mooncats/version.rb
 homepage: https://github.com/cryptocopycats/mooncats
 licenses:

data/LICENSE.md

@@ -1,116 +0,0 @@
-CC0 1.0 Universal
-
-Statement of Purpose
-
-The laws of most jurisdictions throughout the world automatically confer
-exclusive Copyright and Related Rights (defined below) upon the creator and
-subsequent owner(s) (each and all, an "owner") of an original work of
-authorship and/or a database (each, a "Work").
-
-Certain owners wish to permanently relinquish those rights to a Work for the
-purpose of contributing to a commons of creative, cultural and scientific
-works ("Commons") that the public can reliably and without fear of later
-claims of infringement build upon, modify, incorporate in other works, reuse
-and redistribute as freely as possible in any form whatsoever and for any
-purposes, including without limitation commercial purposes. These owners may
-contribute to the Commons to promote the ideal of a free culture and the
-further production of creative, cultural and scientific works, or to gain
-reputation or greater distribution for their Work in part through the use and
-efforts of others.
-
-For these and/or other purposes and motivations, and without any expectation
-of additional consideration or compensation, the person associating CC0 with a
-Work (the "Affirmer"), to the extent that he or she is an owner of Copyright
-and Related Rights in the Work, voluntarily elects to apply CC0 to the Work
-and publicly distribute the Work under its terms, with knowledge of his or her
-Copyright and Related Rights in the Work and the meaning and intended legal
-effect of CC0 on those rights.
-
-1. Copyright and Related Rights. A Work made available under CC0 may be
-protected by copyright and related or neighboring rights ("Copyright and
-Related Rights"). Copyright and Related Rights include, but are not limited
-to, the following:
-
-  i. the right to reproduce, adapt, distribute, perform, display, communicate,
-  and translate a Work;
-
-  ii. moral rights retained by the original author(s) and/or performer(s);
-
-  iii. publicity and privacy rights pertaining to a person's image or likeness
-  depicted in a Work;
-
-  iv. rights protecting against unfair competition in regards to a Work,
-  subject to the limitations in paragraph 4(a), below;
-
-  v. rights protecting the extraction, dissemination, use and reuse of data in
-  a Work;
-
-  vi. database rights (such as those arising under Directive 96/9/EC of the
-  European Parliament and of the Council of 11 March 1996 on the legal
-  protection of databases, and under any national implementation thereof,
-  including any amended or successor version of such directive); and
-
-  vii. other similar, equivalent or corresponding rights throughout the world
-  based on applicable law or treaty, and any national implementations thereof.
-
-2. Waiver. To the greatest extent permitted by, but not in contravention of,
-applicable law, Affirmer hereby overtly, fully, permanently, irrevocably and
-unconditionally waives, abandons, and surrenders all of Affirmer's Copyright
-and Related Rights and associated claims and causes of action, whether now
-known or unknown (including existing as well as future claims and causes of
-action), in the Work (i) in all territories worldwide, (ii) for the maximum
-duration provided by applicable law or treaty (including future time
-extensions), (iii) in any current or future medium and for any number of
-copies, and (iv) for any purpose whatsoever, including without limitation
-commercial, advertising or promotional purposes (the "Waiver"). Affirmer makes
-the Waiver for the benefit of each member of the public at large and to the
-detriment of Affirmer's heirs and successors, fully intending that such Waiver
-shall not be subject to revocation, rescission, cancellation, termination, or
-any other legal or equitable action to disrupt the quiet enjoyment of the Work
-by the public as contemplated by Affirmer's express Statement of Purpose.
-
-3. Public License Fallback. Should any part of the Waiver for any reason be
-judged legally invalid or ineffective under applicable law, then the Waiver
-shall be preserved to the maximum extent permitted taking into account
-Affirmer's express Statement of Purpose. In addition, to the extent the Waiver
-is so judged Affirmer hereby grants to each affected person a royalty-free,
-non transferable, non sublicensable, non exclusive, irrevocable and
-unconditional license to exercise Affirmer's Copyright and Related Rights in
-the Work (i) in all territories worldwide, (ii) for the maximum duration
-provided by applicable law or treaty (including future time extensions), (iii)
-in any current or future medium and for any number of copies, and (iv) for any
-purpose whatsoever, including without limitation commercial, advertising or
-promotional purposes (the "License"). The License shall be deemed effective as
-of the date CC0 was applied by Affirmer to the Work. Should any part of the
-License for any reason be judged legally invalid or ineffective under
-applicable law, such partial invalidity or ineffectiveness shall not
-invalidate the remainder of the License, and in such case Affirmer hereby
-affirms that he or she will not (i) exercise any of his or her remaining
-Copyright and Related Rights in the Work or (ii) assert any associated claims
-and causes of action with respect to the Work, in either case contrary to
-Affirmer's express Statement of Purpose.
-
-4. Limitations and Disclaimers.
-
-  a. No trademark or patent rights held by Affirmer are waived, abandoned,
-  surrendered, licensed or otherwise affected by this document.
-
-  b. Affirmer offers the Work as-is and makes no representations or warranties
-  of any kind concerning the Work, express, implied, statutory or otherwise,
-  including without limitation warranties of title, merchantability, fitness
-  for a particular purpose, non infringement, or the absence of latent or
-  other defects, accuracy, or the present or absence of errors, whether or not
-  discoverable, all to the greatest extent permissible under applicable law.
-
-  c. Affirmer disclaims responsibility for clearing rights of other persons
-  that may apply to the Work or any use thereof, including without limitation
-  any person's Copyright and Related Rights in the Work. Further, Affirmer
-  disclaims responsibility for obtaining any necessary consents, permissions
-  or other rights required for any use of the Work.
-
-  d. Affirmer understands and acknowledges that Creative Commons is not a
-  party to this document and has no duty or obligation with respect to this
-  CC0 or use of the Work.
-
-For more information, please see
-<http://creativecommons.org/publicdomain/zero/1.0/>