ordinals 1.0.3 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e10555694ad5291381edc71af98ba868a6f1f51a42236445873a27e4afbcd177
-  data.tar.gz: a751e7a56a4437d162f055fcf838acbf926a8ab0d89ac7559e99ec2a6f312882
+  metadata.gz: 586a022b2167110472eaea7be6d88e4f21fe72ea1f05ed6465ce29913a10cc15
+  data.tar.gz: fe6f05e73dfdfd42560607c0721b0bdf642718debc83f48e0c36ba2a0ac82db2
 SHA512:
-  metadata.gz: f40f08b9217c1b85a45b3310f21b5acdd14a01d051b989d8abc78cdd88198ec76184b35488fc1f4f5f849224c1793b8e6b23b3ac38b4f36e723b5518b6db8fd6
-  data.tar.gz: bf8d701dd8d75045dc049a7aad636328f616c3a07a5d2a14781b4ac1953dd8a29dfdbea830693ba3e75390fc598e5aa2e06f58d8e6d209e65a19058c5e18b901
+  metadata.gz: 0b7550126e529e67d821042f6fa5d2092f8e93460d4b6e892fe9d21e7bd4e7e5f83673beb39557dafbb1617eb7527569c2b4347e57cf6ce61090e1c00979d335
+  data.tar.gz: 452fc65024f99d80bddf2254e2177a4397b816525d43cf8e42c7e914b95706c4f1a5b4086e5a2e2135792cfe895edcd9dca9e39190c95c74c63cee1550a0da41

data/CHANGELOG.md

@@ -1,3 +1,5 @@
+### 1.1.1
+
 ### 0.0.1 / 2023-03-23
 
 * Everything is new. First release

data/Manifest.txt

@@ -4,4 +4,7 @@ README.md
 Rakefile
 lib/ordinals.rb
 lib/ordinals/api.rb
+lib/ordinals/recursive/composite.rb
+lib/ordinals/recursive/generator.rb
+lib/ordinals/recursive/image.rb
 lib/ordinals/stats.rb

data/README.md

@@ -97,11 +97,238 @@ pp data
 #    "offset"=>"0"}
 ```
 
-That's it for now.
+That's it.
 
 
+### Bonus - Recursive Images  - Generate .SVG Inscriptions
 
-## Bonus: Ordinal Pixel Art Collections
+Ordinal helper classes for generating recursive images include:
+- `RecursiveImage`
+- `RecursiveImageComposite`
+- `RecursiveGenerator`
+
+
+#### Sample No 1 - (Recursive) D.I.Y. Martians - Aliens Vol. 2
+
+
+```ruby
+require 'ordinals'
+
+## 50 .PNG "one-by-one" images - each 24×24px
+inscribes = [
+    '0829dc471f8bb92a971dfdfb00a71c016b833c8f1d5f39dcb15aa5535d08fc15i0',
+    '9482552ec759b76577b28923741eb4bfc7770cead528755bf8fa44196ae9318ci0',
+    '5b8eb4a05f13fffc49f824f457fb080b67e4fdc312fbbf2f804cef59e6d5fad2i0',
+    '85e0efd6cc2801ab7e1fe28e23110441348ca40481599f880c571ff4f69f066fi0',
+    '7953ccb6614a41e7b4c4ed2a2b112b52feda387de92de2c1a314f03d5da41955i0',
+    '2f1219924cfa01f9816581e8a39e201f15e19ab447e852ff9b43b13fa7b0c75di0',
+    'e60f597ec41c50e823ea382c101dfc2f30c13a927222be3b73cedd88bd1b9237i0',
+    '5ce9f89ad571e5380baa5b5ee387f08ea313421e7e54662b3899d411c39321ddi0',
+    '3459b14a4fcb7bce1df0465abc711b556caba6f7b42d4f925f1ddf830be47125i0',
+    '1355524a2aab576e069bac91227b0e52d227d65d84c5535377d3a0ea4e44d470i0',
+    'a6b4b81f69e8c217db24f0a71954195d67ced49a819b67a4daf9f3ca7fa1b971i0',
+    '83827ec13cb55a35fe3adca5acf67caf943c3bd6810f8fa893b067e8015c8f19i0',
+    '5b1e638c050318bec23f17b8b7758ccf13945e422516da6c722c67ae5ed4e26di0',
+    '5dcf96b13e5762d5a288d8bee36deb933fe192a55475199fe9a39ae29dd16853i0',
+    '5760ce05009e94a750a7245cac994fa9ffd388eadc757929ac17737811455429i0',
+    '0bd902941392ea138adb7db30cecdf5bc09a92c80e3e1bc3ecdf3c2d0abf6631i0',
+    '7c2fd41b52624ddb1ba11fe1c6d95475f2e42c4b53d6aaf6a16a09064acebe38i0',
+    '0f473c9dcd14e3f43a6599b038d810eac16bc6394edcfcf6b32f8df992ab6791i0',
+    'd32c50c23693a028e2381d6f756746a9ff684f2028edf694ab7b1b6cde78e2cdi0',
+    'd61fc2a89ecc6ae65cf91cdfac9edc37fd60c38621dac211f3a70891ef79b69ai0',
+    '680e2ee8cad86aa174b4f3373d733370c9a6fc4230b9708d520a0f6bcb8e72a6i0',
+    '56d3f4f661b2b4a9fc17755171d7cf4da74e570614b6b45de0cc87a809c3eb3ci0',
+    'fe4321178bd841e52fdeb72ce4456c5b7596c0d611b19da15ba75ec63b5314cai0',
+    'eddc1242f0fd290e130332e046897ad41dce1e7e112df48ecf2168e43172d383i0',
+    'a2110fb4afaa29bc70bcfac445f750ecb5e81777e8d080be2d2b07eb030ba0ffi0',
+    'c1277df4b986067b2a3f006d717b7f6d042896840c8b592e5a8b9ff22444b08fi0',
+    '722dfdc90a67ff7eb892d13393a8a5b360b8a109f3d809600919684a600ff60ei0',
+    'a0d11e78978a9dd5f1d891b71f06bd2d411c08372eba1f23e8b0722474388130i0',
+    '2c2d812754b9374ffb699173da7f6d476af138a99906b66b8453cc4343305167i0',
+    '964c52312f1db9025695b181d5f631292d29bec63ff9587138a589cb5ff8c26di0',
+    '545fd4d45d2f6d732d48accc082f72b67a00d19f88517320f814bf1fe827c816i0',
+    '72fe7ebda802852f499dca865ec22ac43eacfcf4796d761969ae8358791e943ci0',
+    '4db2e931b5cd489d8007d111d20ab97d84161b84c8f7ff3038e1afe79567b9afi0',
+    '4869c9bb7cf23e68ad94da5b1e9de1feff1ebdcaf9a08fccca5f1887dd40e239i0',
+    '06136a5b4fb585069ef6265a0fde3baf67ee914b9f784d2c951f3a8187800d54i0',
+    '8043604c7c96a5a43a97e251b246102ca40c0203431ff21bd26f23330dfa554ci0',
+    '92e7f48454546718f98103d7464d954033adbee21855f06584be06faa3e291ddi0',
+    'a01012b213ed425c5d4038bc36016f19f4f342ca052ff9bf6971672164e1a402i0',
+    '87d89d290ebde5d5b7aa75b4c8d0359515e25ea1542bc0646dc3f5b0b2fc55fdi0',
+    'aab67a4269ca0bda649fe341bd88c862aba2e9bf6e0826b9dfa5c4ba8fe62c2di0',
+    '189b02ffc8aac68a45102e9837a1ca92e422bf5544d9011a863626cf6b0abeeai0',
+    '43e93e43f2dac75b141baaa5b08df440e0b6ec5755577a9554a7af6540447bb7i0',
+    '39d774f7d7514371c88bc4f939346f6b23000c9892ac4ae8ea36c76694e3b842i0',
+    'b268b2acccd6b04680c2aa3130863ffbaa450f6870f100af678428cd07212ef6i0',
+    'ac810c9098681e100964166b7510d1ac371c147861b0ae2a862da3a8b8256037i0',
+    '4b9f880df07b072a4147a62acdd0881d024d14da6d84174db9b5ac555b71b346i0',
+    '014ad6ed6297bc4ed624b2856e036c6bde115d51eb7200b14e3b3413ad53db08i0',
+    'e139b5b0649186772cbf044bb8d3c5e43b77e3cf0472008ce2aaf52966c921eci0',
+    '6eb271ad3fdd15cc2ec34dda462e71aaa8a7ef7e306cfd189931ef37216a9c60i0',
+    '47cb34f1d73371df0b27ca0a259927fa80e2b2d9ee0e1d487fca5c9029b67b49i0',  
+]
+
+diymartians = RecursiveGenerator.new( 24, 24, 
+                                      inscribes: inscribes )
+
+
+[
+  '41 0 39 37 23 8',
+  '44 1 10 23',
+  '46 3 21 15',
+  '47 2 39 26 37',
+  '47 4 39 20 33 35 36',
+  '41 0 32 35 13 36',
+  '44 6 16 28 37 34 35',
+  '41 0 10 33 34 35 36 8 7',
+  '48 2 33 8 34 35 37 14',
+  '49 3 21 14 35 34 35 37 18 14',
+].each_with_index do |spec,i|
+    img = diymartians.generate( spec )
+    write_text( "./diymartian#{i}.svg", img.to_svg )
+end
+```
+
+resulting in (hosted on ordtest - Ordinals (Recursive) Testing Sandbox):
+
+- <https://ordtest.github.io/diymartian0.svg>    - d.i.y. martian no. 0
+- <https://ordtest.github.io/diymartian1.svg>    - d.i.y. martian no. 1
+- <https://ordtest.github.io/diymartian2.svg> 
+- <https://ordtest.github.io/diymartian3.svg> 
+- <https://ordtest.github.io/diymartian4.svg> 
+- <https://ordtest.github.io/diymartian5.svg> 
+- <https://ordtest.github.io/diymartian6.svg> 
+- <https://ordtest.github.io/diymartian7.svg> 
+- <https://ordtest.github.io/diymartian8.svg> 
+- <https://ordtest.github.io/diymartian9.svg> 
+
+
+Tip:  If you select "show source" in the "right-click" menu in your web browser you will see the "magic" recursive .SVG source text.
+
+
+
+#### Sample No 2 - (Recursive) D.I.Y. Maxi Biz (Punks)
+
+```ruby
+require 'ordinals'
+
+## all-in-one spritesheet .PNG image 240×216px (10×9 grid - 24×24px each)  
+inscribes = [
+    ['ad56d4f242677ac334844002f1c27b9b636ba71f68590cdc0cc5a2cbce080990i0', { width: 240, height: 216 }],
+]
+
+diymaxibiz = RecursiveGenerator.new( 24, 24, 
+                                      inscribes: inscribes )
+
+
+[
+   '87 6 25 41 74 59',
+   '87 6 25 41 74',
+   '87 6 25 41',
+   '84 13 68 33 73',
+   '87 12 21 38 46 73',
+   '84 14 66 35 73',
+   '84 11 35 69 72',
+   '84 1 44 73 40',
+   '87 3 40 43 73',
+   '87 83 77',
+].each_with_index do |spec,i|
+    img = diymaxibiz.generate( spec )
+    write_text( "./diymaxibiz#{i}.svg", img.to_svg )
+end
+```
+
+resulting in (hosted on ordtest - Ordinals (Recursive) Testing Sandbox):
+
+- <https://ordtest.github.io/diymaxibiz0.svg>
+- <https://ordtest.github.io/diymaxibiz1.svg>
+- <https://ordtest.github.io/diymaxibiz2.svg>
+- <https://ordtest.github.io/diymaxibiz3.svg>
+- <https://ordtest.github.io/diymaxibiz4.svg>
+- <https://ordtest.github.io/diymaxibiz5.svg>
+- <https://ordtest.github.io/diymaxibiz6.svg>
+- <https://ordtest.github.io/diymaxibiz7.svg>
+- <https://ordtest.github.io/diymaxibiz8.svg>
+- <https://ordtest.github.io/diymaxibiz9.svg>
+
+
+
+#### Sample No 3 - All-In-One 100 Ordinal Punks Composite
+
+_100 recursions each 96×96px in 10×10 grid_
+
+```ruby
+require 'ordinals'
+
+
+composite = RecursiveImageComposite.new( 10, 10, width: 96,
+                                                 height: 96 )
+
+data = read_json( "./ordinalpunks.json" )
+puts "  #{data['items'].size} inscribe(s)"
+
+data['items'].each_with_index do |rec|
+   id      = rec['inscription_id']
+   comment = rec['name'] 
+
+   composite << [id, {pixelate: true,
+                      comment:  comment}]
+end
+
+write_text( "./ordinalpunks.svg", composite.to_svg )
+```
+
+resulting in (hosted on ordtest - Ordinals (Recursive) Testing Sandbox):
+
+-  <https://ordtest.github.io/ordinalpunks.svg>
+
+
+
+#### Sample No 4 - Nine D.I.Y. Punks Composite
+
+_9 recursions each 24×24px in 3×3 grid_
+
+```ruby
+require 'ordinals'
+
+## all-in-one spritesheet .PNG image 240×144px (10×6 grid - 24×24px each)
+inscribes = [
+    ['cf5df319bbe23fa3d012e5ee0810700c8e82aebff41164246f0d87d7b60a9903i0', { width: 240, height: 144 }],
+]
+
+diypunks = RecursiveGenerator.new( 24, 24, 
+                                    inscribes: inscribes )
+
+
+composite = RecursiveImageComposite.new( 3, 3, width: 24,
+                                               height: 24)
+
+[
+  '59 0',  
+  '59 1',  
+  '59 2',  
+  '59 3',  
+  '59 4',  
+  '59 5',  
+  '59 6',  
+  '59 7',  
+  '59 8',  
+].each do |spec|
+    img = diypunks.generate( spec )
+    composite << img
+end
+
+write_text( "./diypunks.svg", composite.to_svg )
+```
+
+resulting in (hosted on ordtest - Ordinals (Recursive) Testing Sandbox):
+
+-  <https://ordtest.github.io/diypunks.svg> 
+
+
+
+
+## Appendix: Ordinal Pixel Art Collections
 
 
 See the [**Ordinals (Pixel Art) Sandbox (& Cache)**](https://github.com/ordbase/ordinals.sandbox)
@@ -120,8 +347,15 @@ The scripts are dedicated to the public domain.
 Use it as you please with no restrictions whatsoever.
 
 
+
+
+
 ## Questions? Comments?
 
-Post them over at the [Help & Support](https://github.com/geraldb/help) page. Thanks.
+Join us in the [Ordgen / ORC-721 discord (chat server)](https://discord.gg/dDhvHKjm2t). Yes you can.
+Your questions and commetary welcome.
+
+
+Or post them over at the [Help & Support](https://github.com/geraldb/help) page. Thanks.
 
 

data/Rakefile

@@ -3,14 +3,14 @@ require 'hoe'
 
 ###
 # hack/ quick fix for broken intuit_values - overwrite with dummy
-class Hoe
-  def intuit_values( input ); end
-end
+# class Hoe
+#  def intuit_values( input ); end
+# end
 
 
 Hoe.spec 'ordinals' do
 
-  self.version = '1.0.3'
+  self.version = '1.1.1'
 
   self.summary = 'ordinals gem - ordinals (inscription) api wrapper & helpers for Bitcoin, Litecoin, Dogecoin & co.'
   self.description = summary

data/lib/ordinals/recursive/composite.rb

@@ -0,0 +1,78 @@
+###
+# helpers for recursive images (in .SVG)
+
+
+class RecursiveImageComposite
+  def initialize( cols, rows, 
+                  width: 100, height: 100 )
+     @tile_cols = cols
+     @tile_rows = rows
+ 
+     @tile_width  = width
+     @tile_height = height
+
+     @recursions = []
+  end
+
+
+  def count() @recursions.size; end
+  alias_method :size, :count   ## add size alias (confusing if starting with 0?) - why? why not?
+ 
+  def tile_width() @tile_width; end
+  def tile_height() @tile_height; end
+  def width() @tile_width*@tile_cols; end
+  def height() @tile_height*@tile_rows; end
+
+  def add( obj ) @recursions << obj; end
+  alias_method :<<, :add
+
+  def to_svg 
+buf =<<TXT
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="100%" height="100%"
+  viewBox="0 0 #{width} #{height}">
+TXT
+
+@recursions.each_with_index do |recursion,i|
+    y,x = i.divmod( @tile_cols ) 
+
+    if recursion.is_a?( RecursiveImage )
+      comment  =  "№#{i} @ (#{x}/#{y})"
+buf += <<TXT 
+  <g transform="translate(#{x*@tile_width},#{y*@tile_height})">
+   <!-- #{comment} -->
+   #{recursion.to_svg( :inline )}
+  </g>
+TXT
+    else
+      id, opts =  recursion.is_a?( Array )? recursion : [recursion, {}]
+
+      pixelate = opts.has_key?(:pixelate) ? opts[:pixelate]
+                                          : false
+      comment  = opts.has_key?(:comment) ? opts[:comment]
+                                         : "№#{i} @ (#{x}/#{y})"
+                            
+    
+      style = pixelate ? %Q[style="image-rendering: pixelated;"] : ''
+
+buf += <<TXT 
+  <g transform="translate(#{x*@tile_width},#{y*@tile_height})">
+   <!-- #{comment} -->
+   <image
+     width="#{@tile_width}" height="#{@tile_height}"
+     href="/content/#{id}"
+     #{style} />
+  </g>
+TXT
+    end
+end
+
+
+buf += <<TXT
+</svg>
+TXT
+
+    buf
+  end
+end # class RecursiveImageComposite

data/lib/ordinals/recursive/generator.rb

@@ -0,0 +1,69 @@
+
+
+class RecursiveGenerator
+    def initialize( width, height,
+                    pixelate: true,
+                    inscribes:  )
+        @width  = width
+        @height = height
+        @recursions  = _prepare( inscribes )
+        @pixelate   = pixelate
+    end
+
+    def [](index)  ## return recursion (config) as array
+      @recursions[index]
+    end
+
+    def count() @recursions.size; end
+    alias_method :size, :count   ## add size alias (confusing if starting with 0?) - why? why not?
+   
+    def width() @width; end
+    def height() @height; end
+     
+
+    def _prepare( inscribes)
+         ## prepare (flatten) recursion lookup table indexed 0,1,2,3, etc.
+         index = []
+         inscribes.each do |rec|
+            if rec.is_a?( Array )  ## assume spritesheet 
+               id = rec[0]
+               opts = rec[1]
+               cols = opts[:width] / width
+               rows = opts[:height] / height
+               count = cols*rows
+               count.times do |num| 
+                 index << [id, {  spritesheet: [opts[:width],opts[:height]],
+                                  num: num }
+                          ]
+               end
+            else ## assume "standalone / one-by-one" inscribe
+               id = rec
+               index << [id, {}]  
+            end
+         end
+        index
+    end
+
+
+    SEP_RX = %r{[ \t/,;*+_-]+
+               }x
+
+    def _parse( str )
+        str.strip.split( SEP_RX ).map { |str| str.to_i(10) }
+    end
+
+    def generate( *args )
+       g = if args.size==1 && args.is_a?( String )
+              _parse( args[0] )
+           else  ## assume integer numbers
+              args
+           end
+       img = RecursiveImage.new( @width, @height )
+       g.each do |num|
+          id, opts = @recursions[num]
+          img << [id, opts.merge( {pixelate: @pixelate} )]
+       end
+       img 
+    end    
+end # class RecursiveGenerator
+

data/lib/ordinals/recursive/image.rb

@@ -0,0 +1,77 @@
+###
+# helpers for recursive images (in .SVG)
+
+
+class RecursiveImage
+  def initialize( width, height )
+     @width  = width
+     @height = height 
+
+     @recursions = []
+  end
+
+  def add( obj ) @recursions << obj; end
+  alias_method :<<, :add
+
+  def count() @recursions.size; end
+  alias_method :size, :count   ## add size alias (confusing if starting with 0?) - why? why not?
+ 
+  def width() @width; end
+  def height() @height; end
+
+
+  def to_svg( format=:standalone )
+       buf = ''
+     
+  if [:standalone].include?( format.downcase.to_sym )
+        buf +=<<TXT
+<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="100%" height="100%"
+  viewBox="0 0 #{width} #{height}">
+TXT
+  else  ## assume :inline/:embed or such
+      ## todo/check:  add px e.g. 100 => 100px - why? why not?
+       buf +=<<TXT
+  <svg width="#{width}" height="#{height}">
+TXT
+    end
+
+@recursions.each_with_index do |recursion,i|
+    id, opts =  recursion.is_a?( Array )? recursion : [recursion, {}]
+
+    pixelate = opts.has_key?(:pixelate) ? opts[:pixelate]
+                                        : false
+                               
+    style = pixelate ? %Q[style="image-rendering: pixelated;"] : ''
+
+    ## note: assumes spritesheet has tile of same size as image itself!!!!
+    spritesheet = opts[:spritesheet]
+    if spritesheet
+        num = opts[:num] || opts[:tile]
+        spritesheet_width = spritesheet[0] 
+        tile_cols = spritesheet_width/width
+        y,x = num.divmod( tile_cols ) 
+      
+buf += <<TXT 
+    <svg viewBox="#{x*width} #{y*height} #{width} #{height}">
+      <image href="/content/#{id}"
+        #{style} />
+    </svg>
+TXT
+    else
+buf += <<TXT 
+   <image href="/content/#{id}"
+     #{style} />
+TXT
+    end
+end
+
+       buf += <<TXT
+</svg>
+TXT
+      buf
+  end # method to_svg
+end # class RecursiveImage
+
+

data/lib/ordinals.rb

@@ -88,4 +88,13 @@ require_relative 'ordinals/api'
 require_relative 'ordinals/stats'
 
 
+### add recursive image helpers
+require_relative 'ordinals/recursive/image'
+require_relative 'ordinals/recursive/composite'
+require_relative 'ordinals/recursive/generator'
+
+
+## add conveniecen shortcuts/alias - why? why not?
+RcsvImage          = RecursiveImage
+RcsvImageComposite = RecursiveImageComposite
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ordinals
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.1.1
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-04-17 00:00:00.000000000 Z
+date: 2023-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cocos
@@ -64,14 +64,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.23'
+        version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.23'
+        version: '4.0'
 description: ordinals gem - ordinals (inscription) api wrapper & helpers for Bitcoin,
   Litecoin, Dogecoin & co.
 email: gerald.bauer@gmail.com
@@ -88,6 +88,9 @@ files:
 - Rakefile
 - lib/ordinals.rb
 - lib/ordinals/api.rb
+- lib/ordinals/recursive/composite.rb
+- lib/ordinals/recursive/generator.rb
+- lib/ordinals/recursive/image.rb
 - lib/ordinals/stats.rb
 homepage: https://github.com/ordbase/ordbase
 licenses:
@@ -110,7 +113,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
+rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
 summary: ordinals gem - ordinals (inscription) api wrapper & helpers for Bitcoin,