bitgen 0.0.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9d23acf3d75011e1eff3f5590cea308f609062716dce4f36fe9a84e16730b34
-  data.tar.gz: 7ef652cb8f0ed2657d9690b730c063792f7dc901bd6ba63dd2772dae90c4988d
+  metadata.gz: 02cf958fb6681cad6283d1face9ec2072ed49b27cb90d2bb32059699a0882c5d
+  data.tar.gz: dc7cfb96e82b7f16c7aa9ff7fcad31e84da8c0cc80dce037a874b1e3cc4c6a18
 SHA512:
-  metadata.gz: d710bbb59d44b5bfb3f69b99d7efe0052b6d732b5baa145059e275ff1e43cbf138b6f8786e491829c9165c889d28c6dc98bc32d0a8a67032f46c543c9b42097f
-  data.tar.gz: 2997033f71ceba39840ef40b5a1bd84dfbedd8c9362903ab171d131ff2fc99aa50ff0b93f11c3db147a7192b821ea03cd206689308ccb41cd62cfaa42606a349
+  metadata.gz: 910e7cf281efd19756244e6641cef2be923079d5929abf1107181eede076bc340aed09a4838604ea37917f102f61b0da33bcfc7d9f3fd9113c784116f6d78fe5
+  data.tar.gz: 3c76e587ba026d2c076d38d2165d4886030978ce61c3de6e827562d73727105614b8d27c74f872bb400c08fdfd5b3b1cbf9e8a6ce376a34b8f67df25e33d5eb1

data/CHANGELOG.md

@@ -1,3 +1,4 @@
+### 1.0.0 / 2023-07-31
 ### 0.0.1 / 2023-07-30
 
 * Everything is new. First release

data/README.md

@@ -12,9 +12,312 @@ bitgen - bitcoin (inscription) generative image machinery incl gen-brc721 & co
 
 ##  Usage
 
-To be done
+### Generative BRC-721 (Gen BRC-721 or GBRC-721)
 
+(historic) ordinal (bitcoin) protocol by [Jerry Fanelli](https://github.com/jerryfane) proposed / published in mid-May 2023
 
+- Generative BRC-721 Proposol - <https://github.com/jerryfane/generative-brc-721>
+- Analytics (Dune) Dashboard -  <https://dune.com/j543/generative-brc-721>
+
+
+note:  Gen BRC-721 is ded. Jerry Fanelli proposed BRC-69 as
+the official successor in July 2023
+BUT yes, [Ordgen / ORC-721](https://github.com/ordbase/generative-orc-721) may be the better (generative) alternative protocol / winner.
+
+
+Let's try some (historic) Gen BRC-721 collections...
+
+
+#### Collection №1 - 1000 Ordibots (32×32px)
+
+_The world's first gen-brc-721_
+
+Find the deploy text @ [inscription no 8326719](https://ordinals.com/inscription/b7205d40f3b1b1486567f0d6e53ff2812983db4c03ad7d3606812cd150c64802i0) - May 21, 2023 by Jerry Fanelli.
+
+
+Let's generate some ulta-rare never-before-seen (do-it-yourself) ordibots.
+
+``` ruby
+require 'bitgen'
+
+## step 1: read in the deploy text (incl the base64-encoded generative images)
+gen = Bitgen::Generator.read( './ordibots.json' )
+
+
+## step 2:  generate your images
+bot = gen.generate( accessories: 'antenna',
+                    body: 'gold-oval',
+                    belly: 'chess',
+                    face: 'happy'
+                  )
+
+bot.save( "./bot1.png" )
+
+
+bot = gen.generate( background: 'bitcoin-orange',
+                    accessories: 'rainbow',
+                    body: 'standard-square',
+                    belly: 'empty',
+                    face: 'unimpressed'
+                  )
+
+bot.save( "./bot2.png" )
+
+
+bot = gen.generate( background: 'bitcoin-orange',
+                    accessories: 'rainbow',
+                    body: 'black-and-white-triangular',
+                    belly: 'square',
+                    face: 'happy'
+                  )
+
+bot.save( "./bot3.png" )
+```
+
+resulting in:
+
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/bot1.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/bot2.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/bot3.png)
+
+in 4x:
+
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/bot1@4x.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/bot2@4x.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/bot3@4x.png)
+
+
+If you wonder what categories and names can I use?
+Print  the cheatsheet returned by `Catalog#cheat`.
+
+
+``` ruby
+catalog = Bitgen::Catalog.read( './ordibots.json' )
+puts catalog.cheat
+```
+
+resulting in:
+
+```
+0 - background (4)
+    0 - blue
+    1 - bitcoin-orange
+    2 - brown
+    3 - purple
+1 - accessories (3)
+    0 - antenna
+    1 - none
+    2 - rainbow
+2 - body (9)
+    0 - standard-triangular
+    1 - standard-square
+    2 - standard-oval
+    3 - gold-oval
+    4 - black-and-white-square
+    5 - black-and-white-oval
+    6 - black-and-white-triangular
+    7 - gold-square
+    8 - gold-triangular
+3 - belly (3)
+    0 - empty
+    1 - chess
+    2 - square
+4 - face (7)
+    0 - happy
+    1 - neutral
+    2 - surprised
+    3 - unimpressed
+    4 - angry
+    5 - bored-green
+    6 - bored-red
+```
+
+Now if you wonder what do these look in pixels?
+Export all images (in 1x and 8x) using `Catalog#export` for browsing
+using your local image viewer / file explorer.
+
+``` ruby
+catalog = Bitgen::Catalog.read( './ordibots.json' )
+catalog.export
+```
+
+resulting in:
+
+```
+/ordibots
+ +---0_background
+ |       0_blue.png
+ |       1_bitcoin-orange.png
+ |       2_brown.png
+ |       3_purple.png
+ |
+ +---1_accessories
+ |       0_antenna.png
+ |       1_none.png
+ |       2_rainbow.png
+ |
+ +---2_body
+ |       0_standard-triangular.png
+ |       1_standard-square.png
+ |       2_standard-oval.png
+ |       3_gold-oval.png
+ |       4_black-and-white-square.png
+ |       5_black-and-white-oval.png
+ |       6_black-and-white-triangular.png
+ |       7_gold-square.png
+ |       8_gold-triangular.png
+ |
+ +---3_belly
+ |       0_empty.png
+ |       1_chess.png
+ |       2_square.png
+ |
+ \---4_face
+         0_happy.png
+         1_neutral.png
+         2_surprised.png
+         3_unimpressed.png
+         4_angry.png
+         5_bored-green.png
+         6_bored-red.png
+```
+
+
+#### Collection №2 - 400 Satoshi's Pets (630×630px = 45×45px@14X)
+
+_The world's second (?) gen-brc-721_
+
+Find the deploy text @ [inscription no 9324087](https://ordinals.com/inscription/5a3488d19fec02c6629255a43f0615bfc1f4461d5087d6671a2222803966c871i0) - May 27, 2023 by Miek Brantovskii.
+
+
+Let's generate some ulta-rare never-before-seen (do-it-yourself) satoshi's pets (cat, dog, mouse, rabbit, monkey).
+
+``` ruby
+require 'bitgen'
+
+## step 1: read in the deploy text (incl the base64-encoded generative images)
+gen = Bitgen::Generator.read( './satoshipets.json' )
+
+## step 2:  generate your images
+pet = gen.generate( background: 'aube',
+                    pets: 'monkey',
+                    stuff: 'star',
+                    eyes: 'normal'
+                  )
+
+pet.save( "./pet1.png" )
+
+
+pet = gen.generate( background: 'twilight',
+                    pets: 'rabbit',
+                    stuff: 'rainbow',
+                    eyes: 'mask'
+                  )
+
+pet.save( "./pet2.png" )
+
+
+pet = gen.generate( pets: 'monkey',
+                    eyes: 'normal'
+                )
+
+pet.save( "./pet1a.png" )
+
+
+pet = gen.generate( pets: 'rabbit',
+                    eyes: 'mask'
+                  )
+
+pet.save( "./pet2a.png" )
+```
+
+resulting in:
+
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/pet1.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/pet2.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/pet1a.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/pet2a.png)
+
+4x
+
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/pet1@4x.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/pet2@4x.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/pet1a@4x.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/pet2a@4x.png)
+
+
+
+#### Collection №3 - 20 000 Blooming Flower (80×80px)
+
+Find the deploy text @ [inscription no 17707699](https://ordinals.com/inscription/1a1427e31c91566fe7fb47d7f5c1b2130bea31219a08e1de794d45512319ee61i0) - July 17, 2023.
+
+
+Let's generate some ulta-rare never-before-seen (do-it-yourself) blooming flowers.
+
+``` ruby
+require 'bitgen'
+
+## step 1: read in the deploy text (incl the base64-encoded generative images)
+gen = Bitgen::Generator.read( './blooming-flower.json' )
+
+## step 2:  generate your images
+flower = gen.generate( background: 'new-moon',
+                       window: 'simple-yellow',
+                       table: 'metal',
+                       flowerpot: 'ceramics-red',
+                       rose: 'bud-red'
+                     )
+
+flower.save( "./flower1.png" )
+
+
+flower = gen.generate( background: 'autumn',
+                       window: 'sliding-yellow',
+                       table: 'wood',
+                       flowerpot: 'ceramics-blue',
+                       rose: 'bud-white'
+                     )
+
+flower.save( "./flower2.png" )
+
+
+flower = gen.generate(  flowerpot: 'ceramics-red',
+                        rose: 'bud-red'
+                     )
+
+flower.save( "./flower1a.png" )
+
+
+flower = gen.generate( flowerpot: 'ceramics-blue',
+                       rose: 'bud-white'
+                     )
+
+flower.save( "./flower2a.png" )
+```
+
+resulting in:
+
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/flower1.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/flower2.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/flower1a.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/flower2a.png)
+
+in 4x:
+
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/flower1@4x.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/flower2@4x.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/flower1a@4x.png)
+![](https://github.com/ordbase/ordbase/raw/master/bitgen/i/flower2a@4x.png)
+
+
+
+
+That's it. For more collections try:
+
+- 1000 Ordi Bot Mrs (32×32) @ [inscribe no. 9893590](https://ordinals.com/inscription/fd0d94695fc30af6238732c2b71aa4330511c5d2dd0ace2da05660c2ad57076di0) - May 29th, 2023 by Kelvin Liang
+- 4210 (GBRC721) Bit Punks (24×24) @  [inscribe no. 9950751](https://ordinals.com/inscription/c3915284759eaba761f6e5acf64b50e1089fe62448b595f61a40407d71bfb85ei0) - May 29th, 2023
+- 690 Ordinals Egg (60×60)  @ [inscribe no. 10265255](https://ordinals.com/inscription/15e0a8e0a6adde4388f14d6385db7ac63d55acb1c5a5b67aa4f8de3d5ad5dacci0) - May 31st, 2023 
+- 10 000 Unemployed Artist (24×24) @ [inscribe no. 11673452](https://ordinals.com/inscription/c11e21e4ac155b88d8cc4cb7e11d8c4f66112e95cac04c4cb14e9361d93aac16i0) - June 13th, 2023 
 
 
 

data/Rakefile

@@ -3,7 +3,7 @@ require 'hoe'
 
 Hoe.spec 'bitgen' do
 
-  self.version =   '0.0.1'  ## Pixelart::Module::Bitgen::VERSION
+  self.version =   '1.0.0'  ## Pixelart::Module::Bitgen::VERSION
 
 
   self.summary = "bitgen - bitcoin generative (inscription) image machinery incl. gen-brc721 & co"

data/lib/bitgen.rb

@@ -1,2 +1,132 @@
+require 'pixelart'
+
+
+module Bitgen
+
+class Catalog   ## change/rename to Spritesheet / Atlas / Deploy or such - why? why not?
+  def self.read( path )
+    data = read_json( path  )
+    # pp data
+  
+    meta = {
+       'slug' => data['slug'].downcase,  ## note: always downcase slug for now (e.g. OrdinalsEgg => ordinalsegg)
+       'name' => data['name'],
+       'dim'  => data['dim'] 
+    }
+   
+    attributes = {}
+
+    ## note: use/access via trait_types array
+    ##         for (restoring  insertion) order!!!
+    data['trait_types'].each do |category_name|
+      h = data['traits'][category_name]
+      puts "==> #{category_name} - #{h.size} record(s)..."
+  
+      h.each_with_index do |(name, h), i|
+         puts "   #{i} - #{name} (#{h['name']}):"
+  
+         img = Image.parse_base64(  h['base64'] )
+  
+         ## note: always downcase category_name for now 
+         ##    (e.g. Background => background  in OrdinalsEgg for example)
+         cat = attributes[ category_name.downcase ] ||= {}
+         cat[ name ] = img
+      end
+    end
+
+  
+    new( meta: meta,
+         attributes: attributes )
+  end
+
+  def initialize( meta: {},
+                  attributes: {} )
+    @meta = meta
+    @attributes = attributes
+  end
+
+  def name() @meta['name']; end
+  def slug() @meta['slug']; end
+  
+  def dim()  @meta['dim']; end
+  def width()  @meta['dim'] ? @meta['dim'][0] : nil; end
+  def height()  @meta['dim'] ? @meta['dim'][1] : nil; end
+
+
+  def categories()  @attributes.keys; end
+  def [](name) @attributes[name]; end
+
+  def cheat  ## print cheat sheet   
+    buf = '' 
+    @attributes.each_with_index do |(category_name, cat),i|
+        buf << "#{i} - #{category_name} (#{cat.size})\n"
+        cat.each_with_index do |(attribute_name, _),j|
+            buf << "    #{j} - #{attribute_name}\n"
+        end
+    end
+    buf
+  end
+
+  def export
+    @attributes.each_with_index do |(category_name, cat),i|
+      puts "==> #{category_name} - #{cat.size} record(s)..."
+      cat.each_with_index do |(attribute_name, img), j|
+        puts "   #{j} - #{attribute_name} (#{img.width}x#{img.height})"
+    
+        path = "./tmp/#{slug}/#{i}_#{category_name}/#{j}_#{attribute_name}"
+        puts path
+
+        img.save( path+".png" )
+        ## note - only auto-add zoom  if  width < 100px
+        ##  e.g. sathoshi's pet is 630px
+        img.zoom(8).save( path+"@8x.png" )  if img.width < 100
+      end
+    end
+  end # method export
+end  # class Catalog
+
+
+
+class Generator
+  def self.read( path )
+    catalog = Catalog.read( path )
+    new( catalog )
+  end
+
+  attr_reader :catalog
+
+  def initialize( catalog )
+    @catalog = catalog
+  end
+
+  def generate( **kwargs )
+    img = nil
+    kwargs.each do |category, name|
+       cat = @catalog[ category.to_s] 
+       attribute_img = cat[name.to_s]
+ 
+       if attribute_img.nil?
+         puts "!! WARN - attribute >#{name}< in >#{category}< not found; sorry"
+         puts "  availbable options in #{category}:"
+         pp cat.keys
+       end
+ 
+       img = Image.new( attribute_img.width, attribute_img.height )  if img.nil?
+
+       img.compose!( attribute_img )
+    end
+    img
+ end  # method generate
+
+  ################
+  ## more convenience helpers
+  def cheat() @catalog.cheat; end
+
+end  # class Generator
+
+end # module Bitgen
+
+
+
+
 
-puts "hello, bitgen!"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bitgen
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-07-30 00:00:00.000000000 Z
+date: 2023-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pixelart