pixelart 1.3.5 → 1.3.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43bc0ad17527099593a49e143036c875bf93fc61873d551252a19376490734fd
-  data.tar.gz: c57fdb4d5241915767f4480a698f3f362d25c53f99805050b8c8dd4c2ca9ec27
+  metadata.gz: 931c4aa26d5a0594b4aec85f532d16e93d3dd505f4d2f9729b24e3fd45c662c4
+  data.tar.gz: 5dc8936fc9a0f76b05cf4209ad69ebeba87f25bd3c0290cad59e961760aa5782
 SHA512:
-  metadata.gz: 742db57f909288c2a19105244951f676c99723544be749e60544d3576f326f323ec00bcdf0ea9fbeef0e6a6a0d55771f5ad06a7e5fe1a32814b6f509bc472be4
-  data.tar.gz: 2b7d05f9e4ab9a4f4348b3fb7b7f1f5b36ee884b4db3bae901479c84c4dac0207f67f56ba140319a45bd1704c9af14075ef7dfc3ef20897476dfc5bf242a509c
+  metadata.gz: 3189094ecb75f30d1ccd52bafc83b6ece3319b0b5c4f769ab02110212b5674adc59a816dc2abfa8be3d9a6a344bd253471677d5802391325b681987eb9d5ece0
+  data.tar.gz: a1e6e2ea6c25ac1ed7f2542ff8039a8ac1b5232001539611a151302959563e623d879e9c6590aa4cc1468d7716eb7ffaa8faeeed9360589570664a94f512aa48

data/Manifest.txt

@@ -10,8 +10,10 @@ lib/pixelart/composite.rb
 lib/pixelart/convert.rb
 lib/pixelart/generator.rb
 lib/pixelart/image.rb
+lib/pixelart/invert.rb
 lib/pixelart/led.rb
 lib/pixelart/misc.rb
+lib/pixelart/orc721/generator.rb
 lib/pixelart/pixelator.rb
 lib/pixelart/sample.rb
 lib/pixelart/silhouette.rb

data/README.md

@@ -1,10 +1,10 @@
 # Pixel Art
 
-pixelart  - mint your own pixel art images off chain using any design (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes
+pixelart  - yes, you can! generate your own pixel art images (off-blockchain) using any design (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes
 
 
-* home  :: [github.com/pixelartexchange/pixelart](https://github.com/pixelartexchange/pixelart)
-* bugs  :: [github.com/pixelartexchange/pixelart/issues](https://github.com/pixelartexchange/pixelart/issues)
+* home  :: [github.com/learnpixelart/pixelart](https://github.com/learnpixelart/pixelart)
+* bugs  :: [github.com/learnpixelart/pixelart/issues](https://github.com/learnpixelart/pixelart/issues)
 * gem   :: [rubygems.org/gems/pixelart](https://rubygems.org/gems/pixelart)
 * rdoc  :: [rubydoc.info/gems/pixelart](http://rubydoc.info/gems/pixelart)
 
@@ -71,8 +71,8 @@ img3x.save( './i/mooncat_white-3x.png' )
 
 Voila!
 
-![](https://github.com/pixelartexchange/pixelart/raw/master/pixelart/i/mooncat_white.png)
-![](https://github.com/pixelartexchange/pixelart/raw/master/pixelart/i/mooncat_white-3x.png)
+![](https://github.com/learnpixelart/pixelart/raw/master/pixelart/i/mooncat_white.png)
+![](https://github.com/learnpixelart/pixelart/raw/master/pixelart/i/mooncat_white-3x.png)
 
 
 
@@ -100,8 +100,8 @@ img3x.save( './i/mooncat_black-3x.png' )
 
 Voila! Black is the new White!
 
-![](https://github.com/pixelartexchange/pixelart/raw/master/pixelart/i/mooncat_black.png)
-![](https://github.com/pixelartexchange/pixelart/raw/master/pixelart/i/mooncat_black-3x.png)
+![](https://github.com/learnpixelart/pixelart/raw/master/pixelart/i/mooncat_black.png)
+![](https://github.com/learnpixelart/pixelart/raw/master/pixelart/i/mooncat_black-3x.png)
 
 
 
@@ -227,8 +227,8 @@ img5x.save( './i/vader5x.png' )
 
 Voila!
 
-![](https://github.com/pixelartexchange/pixelart/raw/master/pixelart/i/vader.png)
-![](https://github.com/pixelartexchange/pixelart/raw/master/pixelart/i/vader5x.png)
+![](https://github.com/learnpixelart/pixelart/raw/master/pixelart/i/vader.png)
+![](https://github.com/learnpixelart/pixelart/raw/master/pixelart/i/vader5x.png)
 
 
 
@@ -291,6 +291,9 @@ Use it as you please with no restrictions whatsoever.
 
 
 
+
 ## Questions? Comments?
 
-Post them on the [D.I.Y. Punk (Pixel) Art reddit](https://old.reddit.com/r/DIYPunkArt). Thanks.
+Post them over at the [Help & Support](https://github.com/geraldb/help) page. Thanks.
+
+

data/Rakefile

@@ -5,13 +5,13 @@ Hoe.spec 'pixelart' do
 
   self.version = Pixelart::VERSION
 
-  self.summary = "pixelart - mint your own pixel art images off chain using any design (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes"
+  self.summary = "pixelart - yes, you can! generate your own pixel art images (off-blockchain) using any design (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes"
   self.description = summary
 
-  self.urls    = { home: 'https://github.com/pixelartexchange/pixelart' }
+  self.urls    = { home: 'https://github.com/learnpixelart/pixelart' }
 
   self.author  = 'Gerald Bauer'
-  self.email   = 'wwwmake@googlegroups.com'
+  self.email   = 'gerald.bauer@gmail.com'
 
   # switch extension to .markdown for gihub formatting
   self.readme_file  = 'README.md'

data/lib/pixelart/base.rb

@@ -42,6 +42,7 @@ require 'pixelart/led'
 require 'pixelart/sketch'
 require 'pixelart/transparent'
 require 'pixelart/silhouette'
+require 'pixelart/invert'
 require 'pixelart/ukraine'
 
 
@@ -69,4 +70,9 @@ require 'pixelart/convert'
 
 
 
+####
+#  add orc-721 - why? why not?
+require 'pixelart/orc721/generator'
+
+
 puts Pixelart.banner    # say hello

data/lib/pixelart/composite.rb

@@ -10,7 +10,7 @@ class ImageComposite < Image  # check: (re)name to Collage, Sheet, Sprites, or s
   def self.read( path, width: TILE_WIDTH, height: TILE_WIDTH )   ## convenience helper
     img = ChunkyPNG::Image.from_file( path )
     new( img, width:  width,
-              height: width )
+              height: height )
   end
 
 

data/lib/pixelart/convert.rb

@@ -36,15 +36,18 @@ def self.convert( dir, from: 'jpg',
       system( cmd )
 
       if from == 'gif'
-        ## assume multi-images for gif
+        ## check for multi-images for gif
         ##   save  image-0.png  to  image.png
         path0 = "#{outdir}/#{basename}-0.#{to}"
         path  = "#{outdir}/#{basename}.#{to}"
 
-        puts "   saving #{path0} to #{path}..."
+        ##  note:  image-0.png only exists (gets generated) for multi-images
+        if File.exist?( path0 )
+          puts "   saving #{path0} to #{path}..."
 
-        blob = File.open( path0, 'rb' ) { |f| f.read }
-        File.open( path, 'wb' ) { |f| f.write( blob ) }
+          blob = File.open( path0, 'rb' ) { |f| f.read }
+          File.open( path, 'wb' ) { |f| f.write( blob ) }
+        end
       end
     end
 end

data/lib/pixelart/image.rb

@@ -23,28 +23,37 @@ end
 
 
 
-
 def self.read( path )   ## convenience helper
   img_inner = ChunkyPNG::Image.from_file( path )
-  img = new( img_inner.width, img_inner.height, img_inner )
-  img
+  new( img_inner.width, img_inner.height, img_inner )
 end
 
 def self.parse_base64( str )
   blob = Base64.decode64( str )
   img_inner = ChunkyPNG::Image.from_blob( blob )
-  img = new( img_inner.width, img_inner.height, img_inner )
-  img
+  new( img_inner.width, img_inner.height, img_inner )
+end
+
+def self.blob( blob )
+  img_inner = ChunkyPNG::Image.from_blob( blob )
+  new( img_inner.width, img_inner.height, img_inner )
+end
+
+class << self
+   alias_method :from_blob, :blob
 end
 
 
 
 
+
 CHARS = '.@xo^~%*+=:'     ## todo/check: rename to default chars or such? why? why not?
 
 ## todo/check: support default chars encoding auto-of-the-box always
 ##                  or require user-defined chars to be passed in - why? why not?
-def self.parse( pixels, colors:, chars: CHARS )
+def self.parse( pixels, colors:,
+                        background: Color::TRANSPARENT,
+                        chars: CHARS )
   has_keys  = colors.is_a?(Hash)   ## check if passed-in user-defined keys (via hash table)?
 
   colors = parse_colors( colors )
@@ -53,6 +62,8 @@ def self.parse( pixels, colors:, chars: CHARS )
   width  = pixels.reduce(1) {|width,row| row.size > width ? row.size : width }
   height = pixels.size
 
+   background = Color.parse( background )   unless background.is_a?( Integer )
+
   img = new( width, height )
 
   pixels.each_with_index do |row,y|
@@ -70,7 +81,13 @@ def self.parse( pixels, colors:, chars: CHARS )
                 end
               end
 
-      img[x,y] = pixel
+
+      img[x,y] = if background && background != Color::TRANSPARENT &&
+                                  pixel == Color::TRANSPARENT
+                   background   ## note: auto-fill transparent with background color
+                 else
+                   pixel
+                 end
     end # each row
   end # each data
 
@@ -133,7 +150,10 @@ def left( left )
 end
 
 
-
+def to_blob
+  @img.to_blob
+end
+alias_method :blob, :to_blob
 
 
 #######################
@@ -149,6 +169,11 @@ alias_method :greyscale, :grayscale
 ######################
 #  flip horizontally on x-axis (top-to-bottom/bottom-to-top)
 #    e.g. pixels on the top will now be pixels on the bottom
+#
+#  todo/check:   commom use is reverse?
+#     e.g. flip_vertically is top-to-bottom!!!
+#      use flip_y_axis, flip_x_axis or something else - why? why not?
+#    check photoshop and gimp terminology and update later if different - why? why not?
 def flip_horizontally
   img = @img.flip_horizontally
   Image.new( img.width, img.height, img )
@@ -158,6 +183,7 @@ end
 alias_method :flop, :flip_horizontally
 
 
+
 ###
 #  flip vertially on y-axis (right-to-left/left-to-right)
 #     e.g. pixels on the left will now be pixels on the right
@@ -295,17 +321,28 @@ def image()        @img; end
 ######
 # helpers
 def self.parse_pixels( pixels )
-  data = []
-  pixels.each_line do |line|
-    line = line.strip
-    next if line.start_with?( '#' ) || line.empty?   ## note: allow comments and empty lines
-
-    ## note: allow multiple spaces or tabs to separate pixel codes
-    ##  e.g.   o o o o o o o o o o o o dg lg w w lg w lg lg dg dg w w  lg dg o o o o o o o o o o o
-    ##    or
-    data << line.split( /[ \t]+/)
- end
- data
+  if pixels.is_a?( Array )  ## assume array of string (lines)
+      data = []
+      pixels.each do |line|
+        ##  convert (string) line into indidual chars
+        data << line.each_char.reduce( [] ) { |mem, c| mem << c; mem }
+      end
+      data
+  else  ## assume it's a (multi-line) string (with newlines)
+        ##  assert and throw ArgumentError if not? - why? why not?
+      data = []
+      pixels.each_line do |line|
+        line = line.strip
+        next if line.start_with?( '#' ) || line.empty?   ## note: allow comments and empty lines
+
+        ## note: allow multiple spaces or tabs
+        ##   to separate pixel codes
+        ##  e.g.   o o o o o o o o o o o o dg lg w w lg w lg lg dg dg w w  lg dg o o o o o o o o o o o
+        ##    or
+        data << line.split( /[ \t]+/)
+     end
+    data
+  end
 end
 
 

data/lib/pixelart/invert.rb

@@ -0,0 +1,40 @@
+module Pixelart
+
+
+## todo/check:
+##   use a different name for invert
+##    - why not  - negate ???
+
+
+class Image
+  ## note: invert will only invert r/g/b - and NOT the a(lpha) channel
+  ##        the a(lpha) channel get passed on as is (1:1)
+  def invert
+    img = Image.new( @img.width, @img.height )
+
+    @img.width.times do |x|
+      @img.height.times do |y|
+        pixel = @img[x,y]
+
+        ## note: xor (^) with 0 returns the original value unmodified.
+        ##       xor (^) with 0xff flips the bits.
+        ##         that is we are flipping/inverting r, g and b.
+        ##             and keep the a(lpha) channel as is.
+
+        ## hack - why? why not?
+        ##   if transparent e.g. 0x0 than keep as is
+        ##                 do not use 0xffffff00  - makes a difference?
+
+        img[x,y] = if pixel == Color::TRANSPARENT  # transparent (0)
+                       Color::TRANSPARENT
+                   else
+                       pixel ^ 0xffffff00
+                   end
+    end
+  end
+  img
+end
+
+end  # class Image
+
+end # module Pixelart

data/lib/pixelart/orc721/generator.rb

@@ -0,0 +1,51 @@
+
+
+module Orc721
+class Generator
+   ###################
+   ## convenience setup helper(s)
+   def self.read( path, width: 24, height: 24 )
+       new( Pixelart::ImageComposite.read( path,
+                                           width: width,
+                                           height: height ))
+   end
+
+
+   def initialize( spritesheet )
+     ### todo: check for composite image type? - why? why not?
+     @spritesheet = spritesheet
+   end
+
+   def _parse( spec )
+     ## for delimiter allow for now:  - why? why not?
+     ##     (multiple) space ( )
+     ##      command or semicolon
+     spec.strip.split( %r{[ ,;/_-]+} ).map {|v| v.to_i(10) }
+   end
+
+   def parse( spec )
+      ## convenience helper
+      ##   parses g spec in various (delimited) formats
+      g = _parse( spec )
+      generate( *g )
+   end
+
+   def generate( *attributes )
+     img = Pixelart::Image.new( width, height )
+     attributes.each do |num|
+       img.compose!( @spritesheet[ num ] )
+     end
+     img
+   end
+   alias_method :g, :generate
+
+   def width()   @spritesheet.tile_width; end
+   def height()  @spritesheet.tile_height; end
+   def count()   @spritesheet.count; end
+end  # class Generator
+end # module Orc721
+
+
+######
+##  add convenience aliases - why? why not?
+ORC721 = Orc721

data/lib/pixelart/sketch.rb

@@ -3,14 +3,24 @@ module Pixelart
 
 
 class Image
-  def sketch( sketch=4, line: 1 )
+  def sketch( sketch=4, line: 1,
+                        line_color: Color::BLACK,
+                        colorize: false )
+      ## todo/check: rename color option to fill or such - why? why not?
+
        # todo: line - find a better name eg. line_strenght/width or such?
       width  = @img.width*sketch  + (@img.width+1)*line
       height = @img.height*sketch + (@img.height+1)*line
 
       puts "  #{width}x#{height}"
 
-      img = Image.new( width, height, Color::WHITE )
+
+      background_color = colorize ? Color::TRANSPARENT
+                                  : Color::WHITE
+
+
+      img = Image.new( width, height, background_color )
+
 
       @img.width.times do |x|
         @img.height.times do |y|
@@ -19,12 +29,13 @@ class Image
           ## get surrounding pixels - if "out-of-bound" use transparent (0)
           left   =  x == 0  ? Color::TRANSPARENT : @img[x-1,y]
           top    =  y == 0  ? Color::TRANSPARENT : @img[x  ,y-1]
+          diag   =  (x==0 || y== 0) ? Color::TRANSPARENT : @img[x-1,y-1]
 
           if pixel != left   ## draw vertical line
-              (sketch+line*2).times do |n|
-                line.times do |m|
-                  img[    x*sketch + line*x + m,
-                      n + y*sketch + line*y] = Color::BLACK
+            line.times do |n|
+              (sketch+line*2).times do |m|
+                  img[    x*sketch + line*x + n,
+                      m + y*sketch + line*y] = line_color
                 end
               end
           end
@@ -33,7 +44,7 @@ class Image
              (sketch+line*2).times do |n|
                line.times do |m|
                  img[n + x*sketch + line*x,
-                         y*sketch + line*y + m] = Color::BLACK
+                         y*sketch + line*y + m] = line_color
                 end
              end
           end
@@ -42,10 +53,10 @@ class Image
           ## check special edge case for x and y to add "finish-up" right and bottom line
           if x == @img.width-1 && pixel != Color::TRANSPARENT
              ## draw vertical line
-             (sketch+line*2).times do |n|
-              line.times do |m|
-                img[    (x+1)*sketch + line*(x+1) + m,
-                    n + y*sketch + line*y] = Color::BLACK
+             line.times do |n|
+              (sketch+line*2).times do |m|
+                img[    (x+1)*sketch + line*(x+1) + n,
+                    m + y*sketch + line*y] = line_color
               end
              end
           end
@@ -55,12 +66,56 @@ class Image
             (sketch+line*2).times do |n|
               line.times do |m|
                 img[n + x*sketch + line*x,
-                        (y+1)*sketch + line*(y+1) + m] = Color::BLACK
+                        (y+1)*sketch + line*(y+1) + m] = line_color
               end
             end
           end
-        end
-      end
+
+          ###############
+          ## fill with pixel color if color true (default is false)
+          if colorize && pixel != Color::TRANSPARENT
+            sketch.times do |n|
+              sketch.times do |m|
+                img[x*sketch + line*(x+1) + n,
+                    y*sketch + line*(y+1) + m] = pixel
+              end
+            end
+
+            if pixel == left   ## draw vertical line
+              line.times do |n|
+                sketch.times do |m|
+                  img[x*sketch + line*x + n,
+                      y*sketch + line*(y+1) + m]  = pixel
+                      # (y%2==0 ? 0x0000ffff : 0x000088ff )  # (for debugging)
+                end
+              end
+            end
+
+            if pixel == top   ## draw horizontal line
+              sketch.times do |n|
+                line.times do |m|
+                  img[x*sketch + line*(x+1) + n,
+                      y*sketch + line*y + m]   = pixel
+                      # (x%2==0 ? 0xff0000ff : 0x880000ff ) # (for debugging)
+                 end
+              end
+           end
+
+           ## check all four same color (00,01)
+           ##                           (10, x)  - bingo!
+           if pixel == left && pixel == top && pixel == diag
+              line.times do |n|
+                line.times do |m|
+                  img[x*sketch + line*x + n,
+                      y*sketch + line*y + m]  = pixel
+                  # 0xffff00ff  # (for debugging)
+                 end
+              end
+           end
+          end  # colorize?
+
+        end #  height.times
+      end   #  width.times
 
       img
   end

data/lib/pixelart/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pixelart
 version: !ruby/object:Gem::Version
-  version: 1.3.5
+  version: 1.3.7
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-08-03 00:00:00.000000000 Z
+date: 2023-06-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cocos
@@ -100,9 +100,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.23'
-description: pixelart - mint your own pixel art images off chain using any design
-  (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes
-email: wwwmake@googlegroups.com
+description: pixelart - yes, you can! generate your own pixel art images (off-blockchain)
+  using any design (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes
+email: gerald.bauer@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files:
@@ -122,8 +122,10 @@ files:
 - lib/pixelart/convert.rb
 - lib/pixelart/generator.rb
 - lib/pixelart/image.rb
+- lib/pixelart/invert.rb
 - lib/pixelart/led.rb
 - lib/pixelart/misc.rb
+- lib/pixelart/orc721/generator.rb
 - lib/pixelart/pixelator.rb
 - lib/pixelart/sample.rb
 - lib/pixelart/silhouette.rb
@@ -134,7 +136,7 @@ files:
 - lib/pixelart/ukraine.rb
 - lib/pixelart/vector.rb
 - lib/pixelart/version.rb
-homepage: https://github.com/pixelartexchange/pixelart
+homepage: https://github.com/learnpixelart/pixelart
 licenses:
 - Public Domain
 metadata: {}
@@ -158,6 +160,6 @@ requirements: []
 rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
-summary: pixelart - mint your own pixel art images off chain using any design (in
-  ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes
+summary: pixelart - yes, you can! generate your own pixel art images (off-blockchain)
+  using any design (in ascii text) in any colors; incl. 2x/4x/8x zoom for bigger sizes
 test_files: []