pixelart 1.2.0 → 1.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 798a4eb7b61556c0c79889d01d404a499598286779e009fa71304986f4d68c31
-  data.tar.gz: 9b17446fe914c1b62135c1e1432bc2debf74037ca9e602feb25e71ec7088b117
+  metadata.gz: cfdb6f457e12b2e76af0f8ad601d884e763b111a42031cb4ca687026e26fec9d
+  data.tar.gz: 920c3d4d76effc32b6b37c865f960bd1d9b2a5711d5355a5ec681f2d0d38778f
 SHA512:
-  metadata.gz: 8073e67ffd10361088fd66b768d4aa5927c2f65cdd54389615b980c2181ec8cde2a2ad21eced1fe7a756af7ce2e7c681b2aea4a89aed2c869ad04a956388d54a
-  data.tar.gz: b69918e012f6270a9aa0817d69e094bb52cd12ed05399ac566872efdd2174af9c9534ef2e72f4f34f4d3f1bbe4d5062aedcbb42deb67ff55c52a005965b2d969
+  metadata.gz: a584e986e1ada98617770a43979bd0f808105aac525e947e23549c5ad2dc89cfd3445380dce8773cbf8a9682c49e0ffba35642270c27db33ac76315c744ef203
+  data.tar.gz: c427b35da5186c6505af7364c64c71992174b8f5c3c7ea4330d8599caa55d6d7ef7554f0e154401eb8602c924be6045249af8212c76be37b7da60ca930c8a49c

data/Manifest.txt

@@ -5,6 +5,7 @@ Rakefile
 lib/pixelart.rb
 lib/pixelart/base.rb
 lib/pixelart/blur.rb
+lib/pixelart/circle.rb
 lib/pixelart/color.rb
 lib/pixelart/composite.rb
 lib/pixelart/gradient.rb
@@ -13,7 +14,10 @@ lib/pixelart/led.rb
 lib/pixelart/misc.rb
 lib/pixelart/palette.rb
 lib/pixelart/pixelator.rb
+lib/pixelart/silhouette.rb
 lib/pixelart/sketch.rb
 lib/pixelart/spots.rb
+lib/pixelart/transparent.rb
+lib/pixelart/ukraine.rb
 lib/pixelart/vector.rb
 lib/pixelart/version.rb

data/README.md

@@ -3,8 +3,8 @@
 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
 
 
-* home  :: [github.com/rubycoco/pixel](https://github.com/rubycoco/pixel)
-* bugs  :: [github.com/rubycoco/pixel/issues](https://github.com/rubycoco/pixel/issues)
+* home  :: [github.com/pixelartexchange/pixel](https://github.com/pixelartexchange/pixel)
+* bugs  :: [github.com/pixelartexchange/pixel/issues](https://github.com/pixelartexchange/pixel/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/rubycoco/pixel/raw/master/pixelart/i/mooncat_white.png)
-![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/mooncat_white-3x.png)
+![](https://github.com/pixelartexchange/pixel/raw/master/pixelart/i/mooncat_white.png)
+![](https://github.com/pixelartexchange/pixel/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/rubycoco/pixel/raw/master/pixelart/i/mooncat_black.png)
-![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/mooncat_black-3x.png)
+![](https://github.com/pixelartexchange/pixel/raw/master/pixelart/i/mooncat_black.png)
+![](https://github.com/pixelartexchange/pixel/raw/master/pixelart/i/mooncat_black-3x.png)
 
 
 
@@ -227,8 +227,8 @@ img5x.save( './i/vader5x.png' )
 
 Voila!
 
-![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/vader.png)
-![](https://github.com/rubycoco/pixel/raw/master/pixelart/i/vader5x.png)
+![](https://github.com/pixelartexchange/pixel/raw/master/pixelart/i/vader.png)
+![](https://github.com/pixelartexchange/pixel/raw/master/pixelart/i/vader5x.png)
 
 
 
@@ -288,4 +288,3 @@ Just install the gem:
 
 The scripts are dedicated to the public domain.
 Use it as you please with no restrictions whatsoever.
-

data/Rakefile

@@ -8,7 +8,7 @@ Hoe.spec 'pixelart' do
   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.description = summary
 
-  self.urls    = { home: 'https://github.com/rubycoco/pixel' }
+  self.urls    = { home: 'https://github.com/pixelartexchange/pixel' }
 
   self.author  = 'Gerald Bauer'
   self.email   = 'wwwmake@googlegroups.com'
@@ -20,6 +20,7 @@ Hoe.spec 'pixelart' do
   self.extra_deps = [
     ['chunky_png'],
     ['mini_magick'],
+    ['csvreader'],
   ]
 
   self.licenses = ['Public Domain']

data/lib/pixelart/base.rb

@@ -7,6 +7,9 @@ require 'chunky_png'
 require 'mini_magick'
 
 
+# bonus / prologue / convenience 3rd party
+require 'csvreader'
+
 
 ## stdlib
 require 'pp'
@@ -34,9 +37,14 @@ require 'pixelart/pixelator'
 require 'pixelart/misc'   ## misc helpers
 
 #########################
-# (special) effects / filters
+# (special) effects / filters / etc
+require 'pixelart/circle'
 require 'pixelart/led'
 require 'pixelart/sketch'
+require 'pixelart/transparent'
+require 'pixelart/silhouette'
+require 'pixelart/ukraine'
+
 
 ## (special) effects / filters that require imagemagick
 

data/lib/pixelart/circle.rb

@@ -0,0 +1,46 @@
+###
+#
+#  add more circle aliases
+#    e.g.  circular / round or such - why? why not?
+
+
+module Pixelart
+
+class Image
+  def circle
+    ### for radius use min of width / height
+    r = [@img.width, @img.height].min / 2
+
+    center_x = width  / 2
+    center_y = height / 2
+
+    ################
+    #  try with 96x96
+    #    center_x:  96 / 2 = 48
+    #    center_y:  96 / 2 = 48
+    #
+    #     r:    96 / 2 = 48
+
+    img = Image.new( @img.width, @img.height )
+
+    @img.width.times do |x|
+      @img.height.times do |y|
+
+        ## change to float calcuation (instead of ints) - why? why not?
+        xx, yy, rr = x - center_x,
+                     y - center_y,
+                     r
+
+        img[ x, y] = if xx*xx+yy*yy < rr*rr
+                           @img[ x, y ]
+                     else
+                           0  ## transparent - alpha(0)
+                     end
+      end
+    end
+
+    img
+  end
+end  # class Image
+
+end # module Pixelart

data/lib/pixelart/composite.rb

@@ -18,6 +18,20 @@ class ImageComposite < Image  # check: (re)name to Collage, Sheet, Sprites, or s
     @tile_width  = kwargs[:width]  || kwargs[:tile_width]  || TILE_WIDTH
     @tile_height = kwargs[:height] || kwargs[:tile_height] || TILE_HEIGHT
 
+    ## check for background
+    background = kwargs[:background] || kwargs[:tile_background]
+
+    if background
+      ## wrap into an array if not already an array
+      ##  and convert all colors to true rgba colors as integer numbers
+      background = [background]   unless background.is_a?( Array )
+      @background_colors = background.map { |color| Color.parse( color ) }
+    else
+      ## todo/check: use empty array instead of nil - why? why not?
+      @background_colors = nil
+    end
+
+
     ## todo/fix: check type - args[0] is Image!!!
     if args.size == 1   ## assume "copy" c'tor with passed in image
        img = args[0]    ## pass image through as-is
@@ -32,12 +46,25 @@ class ImageComposite < Image  # check: (re)name to Collage, Sheet, Sprites, or s
        @tile_rows = args[1] || 3
        @tile_count = 0   # (track) current index (of added images)
 
-       img = ChunkyPNG::Image.new( @tile_cols * @tile_width,
-                                   @tile_rows * @tile_height )
+       background_color = if @background_colors && @background_colors.size == 1
+                             @background_colors[0]
+                          else
+                             0  # note: 0 is transparent (0) true color
+                          end
+
+        ## todo/check - always auto-fill complete image (even if empty/no tiles)
+        ##                with background color if only one background color
+        ##                   why? why not??? or always follow the "model"
+        ##                                       with more than one background color???
+        img = ChunkyPNG::Image.new( @tile_cols * @tile_width,
+                                    @tile_rows * @tile_height,
+                                    background_color )
+
     else
        raise ArgumentError, "cols, rows or image arguments expected; got: #{args.inspect}"
     end
 
+
     puts "     #{img.height}x#{img.width} (height x width)"
 
     super( nil, nil, img )
@@ -46,19 +73,46 @@ class ImageComposite < Image  # check: (re)name to Collage, Sheet, Sprites, or s
 
   def count() @tile_count; end
   alias_method :size, :count   ## add size alias (confusing if starting with 0?) - why? why not?
+  alias_method :tile_count, :count
+
+  def tile_width() @tile_width; end
+  def tile_height() @tile_height; end
+
+
 
   #####
   # set / add tile
-
-  def add( image )
+  def _add( image )
     y, x =  @tile_count.divmod( @tile_cols )
 
     puts "    [#{@tile_count}] @ (#{x}/#{y}) #{image.width}x#{image.height} (height x width)"
 
+    ## note: only used if more than one background color specified
+    ##        needs to cycle through
+    if @background_colors && @background_colors.size > 1
+      i = x + y*@tile_cols
+
+      ## note: cycle through background color for now
+      background_color = @background_colors[i % @background_colors.size]
+      background = Image.new( @tile_width, @tile_height, background_color )  ## todo/chekc: use "raw" ChunkyPNG:Image here - why? why not?
+      background.compose!( image )
+      image = background    ## switch - make image with background new image
+    end
+
     ## note: image.image  - "unwrap" the "raw" ChunkyPNG::Image
     @img.compose!( image.image, x*@tile_width, y*@tile_height )
     @tile_count += 1
   end
+
+  def add( image_or_images )   ## note: allow adding of image OR array of images
+    if image_or_images.is_a?( Array )
+      images = image_or_images
+      images.each { |image| _add( image ) }
+    else
+      image = image_or_images
+      _add( image )
+    end
+  end
   alias_method :<<, :add
 
 

data/lib/pixelart/image.rb

@@ -64,18 +64,21 @@ end
 
 
 
-def zoom( zoom=2 )
+def zoom( zoom=2, spacing: 0 )
   ## create a new zoom factor x image (2x, 3x, etc.)
 
-  img = Image.new( @img.width*zoom,
-                   @img.height*zoom )
+  width  = @img.width*zoom+(@img.width-1)*spacing
+  height = @img.height*zoom+(@img.height-1)*spacing
 
-  @img.height.times do |y|
-    @img.width.times do |x|
+  img = Image.new( width, height )
+
+  @img.width.times do |x|
+    @img.height.times do |y|
       pixel = @img[x,y]
       zoom.times do |n|
         zoom.times do |m|
-          img[n+zoom*x,m+zoom*y] = pixel
+          img[n+zoom*x+spacing*x,
+              m+zoom*y+spacing*y] = pixel
         end
       end
     end # each x
@@ -86,6 +89,12 @@ end
 alias_method :scale, :zoom
 
 
+def crop( x, y, crop_width, crop_height )
+  Image.new( nil, nil,
+              image.crop( x,y, crop_width, crop_height ) )
+end
+
+
 
 #######################
 ## filter / effects
@@ -112,6 +121,17 @@ alias_method :flip_vertically, :mirror
 alias_method :flop,            :mirror
 
 
+def rotate_counter_clockwise   # 90 degrees
+  img = @img.rotate_counter_clockwise
+  Image.new( img.width, img.height, img )
+end
+alias_method :rotate_left, :rotate_counter_clockwise
+
+def rotate_clockwise      # 90 degrees
+  img = @img.rotate_clockwise
+  Image.new( img.width, img.height, img )
+end
+alias_method :rotate_right, :rotate_clockwise
 
 
 

data/lib/pixelart/silhouette.rb

@@ -0,0 +1,35 @@
+module Pixelart
+
+
+## todo/check:
+##   use a different name for silhouette
+##    - why not  - outline ???
+##           or  - shadow  ???
+##           or  - profile ???
+##           or  - figure  ???
+##           or  - shape   ???
+##           or  - form    ???
+
+class Image
+  def silhouette( color='#000000' )
+    color = Color.parse( color )
+
+    img = Image.new( @img.width, @img.height )
+
+    @img.width.times do |x|
+      @img.height.times do |y|
+        pixel = @img[x,y]
+
+        img[x,y] = if pixel == Color::TRANSPARENT  # transparent (0)
+                       Color::TRANSPARENT
+                   else
+                       color
+                   end
+    end
+  end
+  img
+end
+
+end  # class Image
+
+end # module Pixelart

data/lib/pixelart/transparent.rb

@@ -0,0 +1,60 @@
+
+module Pixelart
+class Image
+
+  def transparent( style = :solid, fuzzy: false )
+    img = Image.new( width, height )
+
+
+    background = self[0,0]
+
+    bh,bs,bl =  Color.to_hsl( background )
+    bh = (bh % 360)  ## might might negative degree (always make positive)
+
+    height.times do |y|
+        if style == :linear
+          background = self[0,y]
+
+          bh,bs,bl =  Color.to_hsl( background )
+          bh = (bh % 360)  ## might might negative degree (always make positive)
+        end
+      width.times do |x|
+        pixel = self[x,y]
+
+        if background == 0  ## special case if background is already transparent keep going
+          img[x,y] =  pixel
+        elsif fuzzy
+          ## check for more transparents
+            ##   not s  is 0.0 to 0.99  (100%)
+            ##   and l  is 0.0 to 0.99  (100%)
+          h,s,l =  Color.to_hsl( pixel )
+          h = (h % 360)  ## might might negative degree (always make positive)
+
+          ## try some kind-of fuzzy "heuristic" match on background color
+          if ((h >= bh-5) && (h <= bh+5)) &&
+             ((s >= bs-0.07) && (s <= bs+0.07)) &&
+             ((l >= bl-0.07) && (l <= bl+0.07))
+           img[x,y] = 0  ## Color::TRANSPARENT
+
+           if h != bh || s != bs || l != bl
+              # report fuzzy background color
+              puts "  #{x}/#{y} fuzzy background #{[h,s,l]} ~= #{[bh,bs,bl]}"
+           end
+          else
+            img[x,y] =  pixel
+          end
+        else
+           if pixel == background
+            img[x,y] = 0   ## Color::TRANSPARENT
+           else
+             img[x,y] =  pixel
+           end
+        end
+      end
+    end
+    img
+  end # method transparent
+
+
+end   # class Image
+end  # module Pixelart

data/lib/pixelart/ukraine.rb

@@ -0,0 +1,33 @@
+#######
+#
+#  Glory To Ukraine! Fuck (Vladimir) Putin! Stop the War!
+#   Send A Stop The War Message To The World With Your Pixel Art Images
+#
+
+
+module Pixelart
+
+class Image
+  def ukraine
+    ### move colors to (reusable) constants e.g.
+    ###   UKRAINE_BLUE
+    ###   UKRAINE_YELLOW  - why? why not?
+    ukraine_blue   = Color.parse( '#0057b7' )
+    ukraine_yellow = Color.parse( '#ffdd00' )
+
+    img = Image.new( @img.width, @img.height )
+
+    @img.height.times do |y|
+      color = (y < @img.height/2) ? ukraine_blue : ukraine_yellow
+      @img.width.times do |x|
+        img[x,y] = color
+      end
+    end
+
+    img.compose!( self )  ## paste/compose image onto backgorund
+    img
+  end
+end  # class Image
+
+end # module Pixelart
+

data/lib/pixelart/vector.rb

@@ -25,6 +25,53 @@ class Vector   # holds a vector graphics image (in source)
     end
   end # class Circle
 
+  class Path < Shape
+    def initialize( fill:, stroke: )
+      @commands = []
+      @fill     = fill
+      @stroke   = stroke
+    end
+
+    def move_to( x, y )   ## add a move_to instruction
+      @commands << ['M', x, y]
+      self
+    end
+
+    def line_to( x, y )
+      @commands << ['L', x, y]
+      self
+    end
+
+    def line( *coords )  ## move_to/line_to all-in-one shortcut
+      ## todo/check - assert coords has at least two x/y pairs - why? why not?
+      move_to( *coords[0..1] )
+      coords[2..-1].each_slice( 2) do |coord|
+        line_to( *coord )
+      end
+      self
+    end
+
+
+
+    def to_svg
+       buf =  %Q{<path style="stroke: #{@stroke}; fill: #{@fill || 'none'};" }
+       buf << %Q{d="}
+       last_command = ''
+       @commands.each_with_index do |command,i|
+          buf << " "  if i > 0  # add space separator
+
+          ## "optimize" - that is, do not repead command if same as before
+          buf << command[0]   if command[0] != last_command
+          buf << "#{command[1]} #{command[2]}"
+          last_command = command[0]
+       end
+
+       buf << %Q{"}
+       buf << "/>"
+       buf
+    end
+  end # class Path
+
 
 
   def initialize( width, height, header: nil )
@@ -39,6 +86,14 @@ class Vector   # holds a vector graphics image (in source)
      @shapes << Circle.new( cx, cy, r, fill: fill )
   end
 
+  ## note: default stroke (color) to black (#000000) for now - why? why not?
+  def path( stroke: '#000000', fill: nil )
+     path = Path.new( stroke: stroke, fill: fill )
+     @shapes << path
+
+     path   ## note: MUST return "inner" path shape for chaining "dsl-like" methods / commands
+  end
+
 
 
   def to_image

data/lib/pixelart/version.rb

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

data/lib/pixelart.rb

@@ -8,3 +8,5 @@ require 'pixelart/base'   # aka "strict(er)" version
 #    make Image, Color, Palette8bit, etc top-level
 include Pixelart
 
+
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pixelart
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.2.3
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-10-02 00:00:00.000000000 Z
+date: 2022-03-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: chunky_png
@@ -38,6 +38,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: csvreader
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
@@ -89,6 +103,7 @@ files:
 - lib/pixelart.rb
 - lib/pixelart/base.rb
 - lib/pixelart/blur.rb
+- lib/pixelart/circle.rb
 - lib/pixelart/color.rb
 - lib/pixelart/composite.rb
 - lib/pixelart/gradient.rb
@@ -97,11 +112,14 @@ files:
 - lib/pixelart/misc.rb
 - lib/pixelart/palette.rb
 - lib/pixelart/pixelator.rb
+- lib/pixelart/silhouette.rb
 - lib/pixelart/sketch.rb
 - lib/pixelart/spots.rb
+- lib/pixelart/transparent.rb
+- lib/pixelart/ukraine.rb
 - lib/pixelart/vector.rb
 - lib/pixelart/version.rb
-homepage: https://github.com/rubycoco/pixel
+homepage: https://github.com/pixelartexchange/pixel
 licenses:
 - Public Domain
 metadata: {}